diff --git a/README.md b/README.md index df732cd..1298ebf 100644 --- a/README.md +++ b/README.md @@ -13,7 +13,9 @@ The desktop application is named **Rangoon**; Rangoon.si is the product wordmark **Current status:** an experimental native workbench with persistence, immutable skill/workflow revisions, composition, compilation/export/inspection and explicitly consented advisory model paths. The ordinary desktop source enables encrypted-workspace startup by default, with explicit setup/unlock and no plaintext fallback. Encrypted recovery has dated disposable macOS evidence, including recovery into a fresh independently keyed workspace and restart. Windows startup/custody/recovery remains unsupported in the current implementation; Linux GUI/custody and packaged release qualification remain open. Original instruction files and deliberately readable exports are outside workspace encryption. No live agent executor, scheduler, authority adapter or plugin runtime is mounted. -The [October 29 whole-application audit](docs/system-audit.md#october-29-whole-application-viability-and-drift-audit) reconciles current source against earlier architecture and usability checkpoints. The [completion plan](docs/plan.md#october-15-audit-completion-sequence) puts recovery, installed local tasks and usable editing ahead of more disconnected demonstrations. The [development ledger](docs/development.md) records exact validation and limits. Source tests, checksums, model reviews and source CI do not establish runtime enforcement, target-loader compatibility, desktop support or certification. +The [October 29 whole-application audit](docs/system-audit.md#october-29-whole-application-viability-and-drift-audit) reconciles current source against earlier architecture and usability checkpoints. The [completion plan](docs/plan.md#next-phase-packets--november-1-2026) puts recovery, installed local tasks and usable editing ahead of more disconnected demonstrations. The [development ledger](docs/development.md) records exact validation and limits. Source tests, checksums, model reviews and source CI do not establish runtime enforcement, target-loader compatibility, desktop support or certification. + +**Workbench update — November 3:** continue exact saved revisions from Skills or Compose into Compile while preserving dirty drafts and historical pins. Task-oriented controls, 57 original full-color icons, packaged software marks and Recipe/Graph output navigation make the local workflow clearer; long titles and sixteen-output/recovery cases are covered by source and synthetic UI tests. Current source checks pass 670 JavaScript tests; headless software-rendered browser review completes 110 layout profiles and 30 checks while retaining native-select/Lock-pointer gaps. Opt-in memory-only replay also covers saved-result routing, exact revision/focus and dirty/busy/late-result guards; it is not native persistence evidence. Disposable native folder fixtures now bind their exact identity and require newly created manifest-v3 runs; this does not qualify the installed encrypted workflow. See the [publication scope and evidence](docs/development.md#november-3-reviewed-workbench-publication). **Review today:** [the reviewer guide](docs/reviewer-guide.md) provides a short design/source task and a disposable-data native task. Browser samples and playgrounds are synthetic. The local Operations window reads one selected report and shows unverified observations; it is not a live feed. Use disposable data in an explicitly isolated review profile. Earlier macOS recovery evidence does not qualify the current working tree, normal-profile migration or every platform. Broader desktop beta and three-OS release support have separate qualification gates. @@ -25,6 +27,57 @@ Approval management, redacted correlated telemetry and live operations visualiza The [cross-runtime operator-record target](docs/operations-control-plane.md#cross-runtime-operator-record-acceptance-target) defines what Rangoon must show for denied, approved, changed, repeated and uncertain actions. It prioritizes read-only OpenShell observations for this goal while LNSAT evidence remains an independent later gate. No live cross-runtime record exists today. +## Compile setup refinement — November 2, 2026 + +Output format and Compile actions now appear above long saved-skill/history lists, with selected-revision context and nearby stale-selection recovery. Existing action gates and export warnings remain. Local source checks pass 660 tests; eight bounded ARM-browser layout captures completed with clean teardown; complete interaction and native workflow qualification remain open. [Evidence](docs/development.md#ui-c5-compile-control-placement--november-2-2026). + +## Full-color icons and software identities — November 2, 2026 + +The workbench now uses 57 original filled, multi-color object icons, with the original monochrome shapes retained for high-contrast mode. Software identities include locally packaged authentic marks for agentgateway, Cerbos, Permit and Invariant, alongside Claude, Rangoon, LNSAT and VUSL. Existing availability, authorization and action gates are unchanged. View the [color gallery](preview/icon-gallery.html) and [asset provenance](preview/assets/vendors/provenance.json). + +JavaScript checks pass 659 tests and independent rendered visual review passes. Browser runs captured all 44 viewport/theme profiles but failed during repeated Lock input; complete interaction and native-workflow qualification remain open. See the [full-color receipt](docs/development.md#ui-c4-full-color-artwork-and-software-marks--november-2-2026). + +## Visual organization and icons — November 2, 2026 + +The workbench now uses a 57-symbol local icon system for actions, records, storage states and systems. Skills, Compile, Lock and backup/export controls retain their text and behavior. Real packaged software marks identify Claude, Rangoon, LNSAT and VUSL; other software uses generic category symbols beside its name. The [icon gallery](preview/icon-gallery.html) separates identity from connection or support claims. Desktop navigation scrolls while Lock/theme stay reachable, and disabled primary actions use neutral styling. + +JavaScript checks pass 652 tests. Synthetic browser validation completed 44 viewport/theme profiles and 17 checks; qualification remains partial for actual native dropdown input. Current native encrypted workflows and real-user usability require separate proof. See the [inspection and validation receipt](docs/development.md#ui-i3-semantic-icons-and-visual-organization--november-2-2026). + +## Task-focused editing — November 2, 2026 + +Skills now groups tools by task: find or create in the library, edit a revision, continue with its saved version in Compose/Compile, and inspect origin/history. Search stays visible; optional filters retain their state and show active facets. Recovery explanations sit beside relevant controls, and conflict reload appears above the editor. + +Source checks pass 648 tests. Synthetic browser checks completed 14 viewport/theme profiles and 17 interaction/media/controller cases; overall qualification remains partial because native dropdown input is unverified. Native encrypted persistence and the latest desktop artifact still require separate qualification. See the [task-arrangement receipt](docs/development.md#ui-t2-task-arrangement-and-interaction-audit--november-2-2026). + +## Workbench refinement — November 1, 2026 + +Skills keeps revision actions above the editor, with more compact task headers, clearer title typography, responsive content sizing and consistent dark/light surfaces. Existing draft, conflict, history and exact-revision rules stay intact. The native development executable has been rebuilt offline with these frontend changes. + +Isolated synthetic browser checks now cover 14 viewport/theme profiles, including emulated 4K/DPR layouts, and 11 pointer/keyboard/recovery states. All desktop revision actions stayed above the fold and all tested action targets met 44×44 pixels. This is browser/source evidence, not a packaged release or qualified native encrypted workflow. See the [rendered/build receipt](docs/development.md#ui-r1-rendered-workbench-refinement-and-native-rebuild--november-1-2026). + +## Source update — November 1, 2026 + +Skills and Compose now preserve exact saved revisions in both directions: add a saved skill to Compose, then inspect an actual saved output in Skills without silently substituting a newer revision. Native readback precedes result navigation; unsaved edits, busy states, duplicate/full inputs and open drafts retain work and explain recovery. Navigation and Lock reject stale replies. Draft creation, preview, save, review, compilation and export remain explicit. + +The disposable native harness also binds a synthetic folder and exact file inventory to each test run, rejecting mutation/replacement/link/unexpected-child cases before and after phases. The roadmap reconciles local completion with later authenticated peers, credential/key lifecycle and enterprise operation boundaries. Live peers, cloud control and distributed dispatch remain planned. + +These are source changes, not a desktop release. Current rendered/native encrypted-workflow qualification remains open; Windows/Proxmox testing is deferred and Windows custody/startup/recovery still needs implementation. Source tests do not qualify normal user data, provider enforcement or compliance. The [publication receipt](docs/development.md#source-branch-publication--november-1-2026) records the exact scope and evidence. + +## Build direction and next phases — November 1, 2026 + +Rangoon keeps its local-first capability workbench and native Rust trust boundary while improving project/target task continuity. The [prepared packet sequence](docs/plan.md#next-phase-packets--november-1-2026) starts with an artifact-bound encrypted local journey, then exact-revision editing/composition, retained file inspection, reversible instruction-file changes, one verified target-loading handoff and practical bulk organization. Original bytes and revisions stay authoritative; future syntax projections/indexes are derived and versioned. + +Finished radials, bars, icons, packaged system logos and refined abstract Rangoon artwork remain part of the [visual contract](docs/visual-system.md). Metrics must show real scope/counts/freshness and inspectable detail, with complete empty, stale, partial, denied, failure and recovery states. These docs do not claim that the proposed UI or enterprise features are implemented. + +Later [peer/enterprise work](docs/application-architecture.md#enterprise-operation-and-custody-boundaries--november-1-2026) requires verified tenant/actor scope, target-side operation guarantees, current ownership, scoped credentials/key lifecycle and recovery before writes or failover. Cloud hosting, cloud resource management and model inference are distinct profiles. Shared services, KMS/BYOK/federation, live peers and distributed dispatch remain planned; optional engines and VUSL retain their independent boundaries. Local usefulness does not wait for enterprise infrastructure. The [development receipt](docs/development.md#direction-reconciliation--november-1-2026) records this documentation-only reconciliation and remaining gates. + +## Local qualification preparation — October 30, 2026 + +The disposable macOS harness now includes the existing folder-metadata and explicit file-inspection permissions, plus a fixed synthetic folder bound to the run manifest and artifact inventory. It rejects changed contents, replaced entries, links and unexpected children before and after a phase. Input-integrity results remain separate from native UI results; the [manual workflow checklist](docs/reviewer-guide.md#disposable-native-workflow-checklist) still needs a fresh artifact and actual picker, Lock, restart and recovery observations. See the [development receipt](docs/development.md#nq-1-disposable-folder-qualification-preparation--october-30-2026) for validation and limits. + +Windows testing is deferred until the new Proxmox test host is available. Windows encrypted custody/startup/recovery implementation and three-OS GUI qualification remain outstanding. The next local milestones are a repeatable encrypted workflow, retained folder-row inspection, reversible project-file changes and one verified target-loading handoff. + + ## Application source update — October 29, 2026 This update brings the current local workbench into one source snapshot: encrypted default startup and recovery, instruction-history persistence, native lifecycle hardening, bounded Agent files and folder metadata, Markdown review/find, and exact saved-skill handoff to Compile. It preserves the newer public LNSAT offline inspection modules and independent VUSL direction. Rust manifests, local checks and source CI use the same **1.99.1** toolchain. Windows validation resolves the logical Cargo tool through rustup, then uses the returned absolute `.exe` paths; it never falls back to an unrelated compiler on PATH. The default encrypted Windows source build requires OpenSSL headers and the x64 MSVC import library; CI validates the hosted runner’s preinstalled copies explicitly. This build configuration does not enable the still-unsupported Windows workspace startup or key custody. Recovery-journal ownership now explicitly releases its lock at teardown, including when a duplicate handle survives temporarily; active competing owners still refuse access. @@ -35,6 +88,10 @@ Folder browsing returns metadata; inspecting content still requires an explicit **Open in Compile** carries a selected saved skill revision directly from Skills into Compile through an exact native read. Historical selection stays pinned; compilation, format choice and export remain explicit. Dirty edits for that skill, conflicts and pending requests block the handoff with recovery guidance. Navigation and Lock invalidate late reads. This slice has source-test evidence; the full-publication receipt records its additional synthetic rendered checks. Native task qualification remains separate. [Receipt and next steps](docs/development.md#cw-1-saved-revision-compile-handoff--october-29-2026). +**Add to Compose** carries the exact selected saved revision from Skills into Compose after a native read, including historical revisions. Existing inputs and drafts remain intact; unsaved edits, open Compose drafts, busy/unavailable states, duplicate pins and full selections explain why adding is blocked. Draft creation, preview and save remain explicit. Late navigation/selection/Lock replies are discarded. This is source-tested; rendered and native qualification remain open. See the [implementation receipt](docs/development.md#next-02a-saved-revision-compose-handoff--november-1-2026). + +Saved Compose results now open their **exact saved revision** in Skills after native readback, with matching editor focus. Later revisions are not substituted. Unsaved edits for that skill block opening; other drafts remain. Failed or stale reads keep the current workbench. [Source evidence and remaining rendered/native gates](docs/development.md#next-02b-exact-saved-result-continuation--november-1-2026). + Agent files already has bounded native folder metadata selection, source inspection and IDE-style Markdown review. Folder rows still require a separate explicit file selection to inspect content; persistent tags/indexing, remote transport and copying/applying instructions remain future work. The immediate completion order is a repeatable isolated native workflow, safe row-inspection custody, then one qualified external target. A custom executor, scheduler or larger demonstration catalog is not required for that local milestone. ## Engineering checkpoint — October 18, 2026 diff --git a/apps/desktop/native-encrypted-qualification/tauri.conf.json b/apps/desktop/native-encrypted-qualification/tauri.conf.json index a48b8fa..2c95068 100644 --- a/apps/desktop/native-encrypted-qualification/tauri.conf.json +++ b/apps/desktop/native-encrypted-qualification/tauri.conf.json @@ -33,6 +33,8 @@ "allow-begin-workspace-close", "allow-acknowledge-workspace-purge", "allow-select-and-analyze", + "allow-select-and-inspect-sources", + "allow-select-and-list-sources", "allow-list-snapshots", "allow-save-analysis", "allow-open-snapshot", diff --git a/apps/desktop/src/native_encrypted_qualification.rs b/apps/desktop/src/native_encrypted_qualification.rs index c45fdf0..0895ff6 100644 --- a/apps/desktop/src/native_encrypted_qualification.rs +++ b/apps/desktop/src/native_encrypted_qualification.rs @@ -64,6 +64,8 @@ mod macos { "allow-begin-workspace-close", "allow-acknowledge-workspace-purge", "allow-select-and-analyze", + "allow-select-and-inspect-sources", + "allow-select-and-list-sources", "allow-list-snapshots", "allow-save-analysis", "allow-open-snapshot", @@ -229,6 +231,8 @@ mod macos { nonce: String, #[serde(rename = "casePlanSha256")] case_plan_sha256: String, + #[serde(rename = "folderFixture")] + folder_fixture: Identity, directory: Identity, roots: BTreeMap, } @@ -350,7 +354,13 @@ mod macos { } impl Run { fn validate(&self) -> Result<(), ()> { - if !same_directory(&self.directory, &self.manifest.directory) { + if !same_directory(&self.directory, &self.manifest.directory) + || self.manifest.folder_fixture.uid != self.manifest.directory.uid + || !same_directory( + &self.directory.join("folder-fixture"), + &self.manifest.folder_fixture, + ) + { return Err(()); } for (name, id) in &self.manifest.roots { @@ -405,7 +415,7 @@ mod macos { return Err(()); } let manifest: Manifest = read_record(&directory.join("manifest.json"), meta.uid())?; - if manifest.schema != "rangoon.e1c4.run.v2" + if manifest.schema != "rangoon.e1c4.run.v3" || manifest.nonce != args[0] || manifest.case_plan_sha256 != plan_digest() || manifest.roots.len() != plan.roots.len() @@ -1119,6 +1129,32 @@ mod macos { #[cfg(test)] mod header_tests { use super::*; + #[test] + fn folder_qualification_permissions_are_exact_and_required() { + let config: Value = serde_json::from_str(include_str!( + "../native-encrypted-qualification/tauri.conf.json" + )) + .unwrap(); + assert!(valid_context(&config, true)); + for required in [ + "allow-select-and-inspect-sources", + "allow-select-and-list-sources", + ] { + let mut changed = config.clone(); + changed["app"]["security"]["capabilities"][0]["permissions"] + .as_array_mut() + .unwrap() + .retain(|permission| permission != required); + assert!(!valid_context(&changed, true)); + } + let mut broadened = config.clone(); + broadened["app"]["security"]["capabilities"][0]["permissions"] + .as_array_mut() + .unwrap() + .push(json!("allow-send-cloud-model")); + assert!(!valid_context(&broadened, true)); + } + #[test] fn header_callback_accepts_only_finite_classifications() { assert_eq!(header_reply("\"pending\""), Ok(HeaderReply::Pending)); diff --git a/docs/application-architecture.md b/docs/application-architecture.md index 5f971d3..0fac829 100644 --- a/docs/application-architecture.md +++ b/docs/application-architecture.md @@ -4,6 +4,26 @@ Authority: [intent.md](intent.md), October 5 engine architecture and October 7 p Owner: Jeff. Architecture, trust boundaries, schema, integration and release decisions remain with the primary controller. Validation/publication state belongs in [development.md](development.md). +## Enterprise operation and custody boundaries — November 1, 2026 + +Status: accepted planning direction; service, peer, cloud and distributed implementations remain proposed. This reconciles the existing modular core, [remote setup](#remote-setup-and-agent-file-management--october-26-2026), [capacity model](#capacity-model-for-a-5001000-person-organization), [deployment workflow](#deployment-management-as-a-control-plane-workflow) and [adapter strategy](#extension-and-standards-strategy). It does not add a new universal contract, scheduler or mandatory LNSAT/VUSL backend. The [next-phase queue](plan.md#next-phase-packets--november-1-2026) retains local completion first. + +**Shared application boundary.** Original bytes/revisions remain authoritative. Syntax/semantic projections and indexes identify their exact source, importer/profile/configuration version and diagnostics; they do not silently normalize originals or infer authorization. Keep deterministic import/compose/compile and store transactions. Introduce a typed shared use-case seam for a concrete second caller; local Tauri, eventual CLI and authenticated service adapters supply independently verified context and custody. A service never exposes raw Tauri commands, arbitrary paths or database files. A crashed process cannot recreate retained OS custody merely from a path saved in a job. + +**Scope and intent.** Distinguish operator, installation/workload, tenant/workspace/project, native target incarnation, adapter/version, root/file reference, content revision, command, attempt, authorization and outcome. Derive tenancy/actor from verified context, not caller labels, hostname or email. Apply it to database references, blobs, queues, caches, search/facets, cursors, dedupe, key/secret lookup, telemetry/export and administrative tools. Admission pins exact inputs/artifact, expected prior state, frozen target membership/exclusions, adapter/schema, relevant policy/configuration, approval evidence and expiry. Changed intent requires explicit revalidation/supersession. Classification, local review, semantic compatibility and a provider allow decision never become execution authority. + +**Ownership and regions.** Begin any hosted pilot with one bounded tenant/region; keep the same Rust core. A later regional cell is a deployment/shard with bounded tenants/state/quotas, not a second implementation. A qualified consistent assignment directory owns `tenant/target → cell, assignment epoch, transition state`. Routes are hints, not authority. Receivers validate current assignment; moves use compare-and-swap transitions, freeze old admission, establish successor authority and reject stale routes/epochs. Directory outage or a restored old directory cannot create a new owner. Use an existing qualified coordination/storage system rather than a custom consensus algorithm. Global active-active mutation is deferred until its target/consistency/recovery model is proved. + +**Effects and migration.** A lease, outbox, signature or idempotency key alone cannot make an external effect happen once. Target-side fencing/conditional writes and durable duplicate suppression must qualify per operation. Otherwise expose weaker coverage and disable unsupported automatic retry/takeover. Migration needs a target-enforced successor fence, or independently proved old-worker quiescence and effective revocation/expiry of all bounded delegated credential chains, plus reconciliation of already accepted provider jobs. A waiting period alone, unreachable worker, unbounded renewal or expired submitting token does not prove old effects stopped. Preserve unknown outcomes; no silent cross-instance/region failover. The native topology/consensus/authorization guarantees of LNSAT or another engine remain that product's responsibility. + +**Cloud and key separation.** Hosting Rangoon, managing cloud resources and calling model providers are distinct integration profiles. Prefer explicitly configured short-lived workload identities and scoped provider/account/region/resource roles; no ambient credential discovery or general fleet credential. Resolve secret references in the authorized host/service and recheck renewal/delegation/scope. Local OS workspace custody remains independent and usable without cloud KMS. Hosted tenant DEKs/KEKs, immutable key-version references, caches, rotation, retention and recovery follow the [key lifecycle contract](encrypted-workspace.md#enterprise-key-and-credential-lifecycle--november-1-2026). BYOK does not automatically hide authorized processing plaintext from a service. + +**Durability, scale and recovery.** Keep management commands, required outcome/evidence records, content and high-volume telemetry/projections as separate workloads. Use durable command/outbox/attempt state and exact receiver semantics; an ACK states its persistence boundary, not execution success. Scope ordering to tenant/producer/stream/epoch; clock time is not global order. Bound queues, pages, queries, subscriptions, retries, retention and key caches, with per-tenant fairness and reserved control/reconciliation capacity. Telemetry can have explicit gaps; it must not substitute for required effect evidence. Define workload units, tenant/cell count, event-size distribution, concurrency, quotas, RPO/RTO and revocation budgets before claiming capacity. + +Disaster restore pauses dispatch, checks metadata/outbox/evidence/object/key consistency, re-establishes independently current assignment/ownership authority and reconciles target outcomes before reopening. Restoring an archive must not reactivate old grants, approvals, leases or commands. VM clones need distinct enrollment; snapshot rollback needs a recovery protocol and cannot prove its own freshness. Rangoon outages do not weaken target enforcement: already admitted work follows its qualified runtime policy, and new actions requiring fresh authority remain pending/refused. A compromised unlocked endpoint remains outside stored-data encryption's protection. + +**Presentation and validation.** Keep project/target continuity, truthful per-target state, [finished visual components](visual-system.md) and [scoped operator flows](operations-control-plane.md#enterprise-operator-and-visual-state--november-1-2026). Logos/graphs identify and explain; they grant no coverage or authority. Before shared reads test tenant/actor isolation, stale scopes and egress; before effects test split brain, stale workers, altered duplicate payloads, lost replies, concurrent edits, revocation and restore; before scale test producer resets/gaps, full spools, noisy tenants and key/provider throttles. Source fixtures and the reviewed design are not live qualification. + ## Internal operations-first boundary — October 22, 2026 The [accepted internal-first direction](intent.md#internal-operations-first-direction--october-22-2026) prioritizes Hypler's own supervised workloads over speculative integration breadth or a funding narrative. It extends the existing operations/fleet and deployment designs below; it does not replace the local capability workbench or create a second control plane. @@ -207,6 +227,19 @@ Capacity must be specified by operation, not by an undifferentiated "request" co **Proposed qualification workload, not measured capacity or a release claim:** one large tenant with up to 1 million observed actions per day, a 60-second burst at 1,000 actions/second, and a synthetic planning factor of 10 minimized evidence events per action. That implies 10 million events/day and a 60-second burst at 10,000 events/second. At a *hypothetical* 1 KiB persisted event, raw event bodies alone consume about 9.5 GiB/day and 286 GiB per 30 days, before indexes, native evidence, replicas and backups. Payload-size distribution, tenant count, retention and concurrent readers must be measured before sizing a deployment. Sustained 1,000 actions/second would be 86.4 million actions/day and needs a separate scale tier and proof. A desktop selected-file O1 window, capped at 1,024 events and 2 MiB input, is an inspection unit, not a million-event ingest service. +### Qualification workload units — November 1, 2026 + +Both rows below are proposed **one-tenant aggregate workloads in one tested cell**, not per endpoint, per engine instance or all tenants combined. Assume ten minimized 1-KiB event bodies per observed action for arithmetic only. These are not measured capacity or employee-count guarantees; actual event sizes, indexes, evidence, replicas, backups, content and provider/key-service limits must be measured. + +| Synthetic envelope | Actions/day | Events/day and mean | 60-second offered burst | Raw bodies/day / 30 days | +| --- | ---: | --- | ---: | --- | +| First enterprise test | 1,000,000 | 10,000,000 / 115.74 events/s | 10,000 events/s | 9.54 GiB / 286.10 GiB | +| Larger-fleet test | 10,000,000 | 100,000,000 / 1,157.41 events/s | 100,000 events/s | 95.37 GiB / 2.79 TiB | + +The proposed first mix has 1,000 producer streams, 20 interactive sessions, 20 paged queries/s, ten concurrent change records and one new change-record admission/minute. The larger mix has 10,000 streams, 100 sessions, 100 queries/s, 50 concurrent change records and five admissions/minute. Use a bounded 200-metadata-row page for this test profile; this is not a new API limit or permission to execute external effects. State content sizes, key-cache conditions, active tenant count and read/write mix for every result. A separate fairness profile offers one hot tenant plus nine at 10% of the selected baseline, then synchronized bursts; report cell totals, accepted/rejected rates and each tenant's tail latency instead of multiplying a single-tenant result into a capacity claim. + +Partition a tenant's offered workload explicitly if it later spans cells. Benchmark p50/p95/p99 query/admission/readback, durable-ACK and replay lag, CPU/RSS/disk/network, provider/KMS quotas, rotation/renewal and failure recovery. Define authorization freshness, observation lag, revocation bounds, retry/tombstone horizon, retention, RPO/RTO and availability by operation/data class before accepting a deployment. Global active-active ownership and millions of telemetry events are not prerequisites for local authoring. + The hosted path should use admission with authenticated tenant and producer identity; bounded validation and redaction; a durable partitioned event log or equivalent append contract; idempotent, version-pinned projections; and paged query/subscription APIs. Partition by tenant and stable producer/stream identity so causal order has a defined scope; never claim a global total order. Separate immutable native evidence references from minimized searchable fields. Batch writes and projections where safe, but never combine distinct attempts or drop required evidence to improve throughput. Per-tenant quotas and fair scheduling prevent one fleet from exhausting other tenants. Bounded queues, explicit backpressure/retry signals, producer cursor checkpoints and replay make overload observable. On crash, retry or partition, duplicate identity with different bytes is a conflict; missing ranges and retention gaps remain visible. An ingestion acknowledgement means only the stated durability stage, never authority verification or completed execution. The local desktop remains a bounded single-user workbench. It may inspect paged or sampled *views* of a larger hosted history after a qualified connection, but evidence capture itself cannot be silently sampled. Do not route millions of events through one Tauri IPC response, one SQLite transaction or the renderer's graph state. Keep graph layout and animation downstream of bounded projections, with stable selection and a table/timeline fallback. A future service may scale ingest, projection and query workers independently while reusing domain contracts; that extraction requires explicit tenant context, storage and recovery tests rather than a raw HTTP wrapper over desktop commands. diff --git a/docs/continue.md b/docs/continue.md index 59f08ea..dee9e91 100644 --- a/docs/continue.md +++ b/docs/continue.md @@ -1,5 +1,124 @@ # Continue Rangoon application work -## Current: full application source publication — October 29, 2026 + +## November 3 reviewed workbench publication + +Jeff authorizes committing the reviewed workbench snapshot and merging it to public main through a head-bound PR after source checks and fresh aggregate review. The main-relative candidate contains sixty-one paths, including earlier saved-revision handoffs and disposable qualification preparation from `bea3328` plus forty-one reviewed UI/test/doc paths and three validation-extension paths. [Accepted intent](intent.md#november-3-reviewed-workbench-publication) owns exact scope; [publication receipt](development.md#november-3-reviewed-workbench-publication) records validation and remaining limits. Current publication evidence: `/rangoon-ui-main-publication-20261103`; GitHub PR/checks and final receipt own actual publication state. + +Use `/private/tmp/rangoon-ui-c8-worktree-20261103`, branch `codex/ui-inspector-20261103`. Its `public` remote targets `https://github.com/hypler-dev/rangoon.git`; `origin` remains a local recovery source and must not be pushed to. Earlier forty paths were recovered by exact hash; the damaged old temporary checkout and unrelated branches remain preserved. Do not publish its cleanup-related deletions. Continue with isolated native task/input qualification, then one real target's loaded-instruction readback. Native select/Lock pointer, native encrypted workflow and three-OS GUI/package release remain unqualified. No real data/keys, providers, website, LNSAT/VUSL, deployment or executable distribution is opened by this source publication. + + +## UI-C8 Recipe/Graph inspector and edge cases — November 3, 2026 + +The inspector now lists up to sixteen existing outputs with output/piece and unresolved-declaration counts. Choosing an output opens its Recipe fields and focuses its title; navigation performs no edit, assignment, preview, save or authorization. Selected-output context and the inspector list's scroll survive Recipe/Graph navigation, while unapplied authored text remains retained. Source output-selection changes also reveal the selected inspector row using only the list scroll position; page scroll is unchanged. Long titles, graph cards and conflict fields wrap within their panels. Existing diagnostics, conflicts, reasons and save acknowledgement remain visible. A failed action adds concise retained-draft recovery guidance without changing action gates. + +Validation: 30 focused Compose view tests and 668 complete JavaScript tests pass. Final synthetic replay completes 110 layout profiles and 25 interaction/media checks with normal browser exit 0, removed test profile and closed loopback fixture server. Sixty added profiles cover five inert display cases across Recipe/Graph, 320/768/1440 pixels and dark/light: sixteen outputs with long escaped titles, failed preview, stale preview, unresolved declaration and busy state. Real DOM navigation focuses output 16, retains unapplied text while switching outputs/views, and keeps the selected inspector row visible. A read-only fixture controller rejects any domain-method call. Recovery/busy cases keep Save and acknowledgement disabled. These fixtures are presentation tests, not native accepted contracts. + +Overall browser result remains PARTIAL for actual native-select input and Lock-pointer confirmation; native encrypted workflow remains separately unqualified. Lock uses keyboard activation in this replay. Earlier Lock-pointer and browser-exception runs remain retained failed receipts. No normal files/keys/vault, native build/operation, provider calls, dependency fetch, LNSAT/VUSL edits, commit/push/merge/deploy/release. + +[Accepted intent](intent.md#ui-c8-recipegraph-inspector-and-edge-cases--november-3-2026) owns eleven paths. Private exact preimages, logs, incremental patch, postimages and review: `/rangoon-ui-c8-20261103`. Final browser receipt: `/rangoon-ui-render-dQqUPX/receipt.json`. Current checkout: `/private/tmp/rangoon-ui-c8-worktree-20261103`, branch `codex/ui-inspector-20261103`, HEAD `bea3328227c9f2f130a1f9ab38649236c68714ad`. Original temporary checkout lost its Git pointer and 717 tracked paths; a fresh local-only shared clone restored the complete baseline, then copied all forty earlier pending paths after exact hash verification. Old source/deletions and unrelated repositories remain preserved. The clone's origin is local, not a publication destination. Next qualify native input/recovery separately; improve graph scale/navigation only from measured user tasks. + + +## UI-C7 Compose task hierarchy — November 2, 2026 + +Compose now separates Arrange views, History, Layout and Draft controls. A compact static Select inputs → Arrange content → Preview & review → Save locally guide describes the workflow without claiming progress or readiness. Existing Source/Recipe/Graph, Undo/Redo, Reset workspace and Discard draft labels, IDs, pins and predicates remain. Saved-result text requires returned results; a clean unsaved draft is not labeled saved. Repeated read-only/provenance explanation moves into existing inspector selection details; reasons, annotations, diagnostics, preview status and explicit save acknowledgement remain visible. Save controls have their own visible section. + +Actual draft testing found a narrow-layout defect: later desktop grid rules could override the viewport fallback while resize state caught up, producing 280px overflow at 320px. A final narrow viewport rule restores a real one-column layout below 1200px. Revision selectors now fit their panel instead of clipping; grouped tools and selection-details targets retain 44px height and keyboard focus. No overflow hiding, new dependency or animation is added. + +Validation: 29 focused Compose tests and 667 complete JavaScript tests pass. Final synthetic replay completes fourteen Skills plus thirty-six route/gallery/draft profiles (fifty total), twenty-two interaction/media checks, clean browser exit 0, fixture-server closure and profile removal. Actual in-memory drafts cover Source/Recipe/Graph pointer and keyboard switching, focus, six dark/light draft layouts, contained revision selectors, reduced motion, forced colors, refused preview keeping acknowledgement/Save disabled, and Discard pointer Cancel then Confirm. The QA driver handles only the armed exact confirm message/type/page URL; unexpected dialogs are dismissed and fail the run. Earlier overflow and unhandled-confirm failures remain failed receipts. + +Result remains PARTIAL: actual native-select input and Lock-pointer confirmation stay open; synthetic keyboard Lock purge is not native encrypted-workspace proof. No normal files/keys/vault, native app build/operation, providers, LNSAT/VUSL edits, dependency fetch, commit/push/merge/deploy/release. Earlier pending work remains preserved. + +[Accepted intent](intent.md#ui-c7-compose-task-hierarchy--november-2-2026) owns ten paths. Exact preimages, logs, incremental patch, postimages and independent review: `/rangoon-ui-c7-20261102`. Final browser receipt: `/rangoon-ui-render-StS5bl/receipt.json`. Next: extend the same task hierarchy to the recipe/graph inspector and test long titles, many outputs and recovery states; installed native workflow remains a separate gate. + + +## UI-C6 Compose guidance and reliable browser replay — November 2, 2026 + +Compose now displays the selected-input count and the exact missing or excess selection beside Start draft, with an accessible description. Empty, one-input, valid and over-limit selections are covered; original action predicates, exact revision pins, draft locking and native operations remain unchanged. + +The synthetic QA launcher now detects ARM-capable macOS through a fixed, bounded system command and selects the installed default Chrome ARM slice even when Node runs under Rosetta. Explicit browser overrides and other hosts retain direct launch; no browser/dependency is downloaded or updated. The compact-navigation replay waits for the responsive drawer state before clicking, avoiding a resize/event race in the test driver. Production navigation code is unchanged. + +Validation: 31 focused launcher/Compose tests and 665 full JavaScript tests pass. Final synthetic replay completes fourteen Skills profiles plus thirty route/gallery profiles, eighteen interaction/media assertions, no page exceptions/console errors/external page requests, normal browser exit 0, profile removal and fixture-server cleanup. Result remains PARTIAL because actual native-select input and Lock-pointer confirmation remain unqualified. Keyboard Lock purge is synthetic browser evidence only. The first ARM run failed compact-navigation timing and remains a failed receipt; subsequent clean replays do not erase it. + +[Accepted intent](intent.md#ui-c6-architecture-aware-ui-qualification--november-2-2026) owns nine paths. Private preimages, command logs, incremental patch, postimage hashes and review: `/rangoon-ui-c6-20261102`. Final browser capture receipt: `/rangoon-ui-render-aQa9ul/receipt.json`. No normal files/keys/vault, native build/operation, provider calls, dependency fetch, LNSAT/VUSL edits, commit/push/merge/deploy/release. Existing work remains uncommitted and preserved. Next: consolidate Compose's action hierarchy and verify actual select/pointer behavior through a qualified controller, then resume isolated native workflow qualification. + + +## UI-C5 Compile control placement — November 2, 2026 + +The existing format selector, Compile/Open in Skills actions and stale-selection recovery now precede long saved-library/history lists. An escaped selected-revision title or explicit selection prompt keeps context visible. IDs, labels, exact pins, disabled predicates, warnings and native behavior remain unchanged. No automatic compilation, export or navigation is added. + +Source checks pass 13 focused and 660 full JavaScript tests. Eight synthetic dark/light captures at 320/768/1366/1440 completed geometry and passive selection/handoff assertions; Compile ends at 582px on 1366×768 and 564px on 1440×1000. Mobile remains vertically scrollable without horizontal overflow. Browser normal shutdown timed out, so the receipt remains FAIL despite completed captures. The browser reported x64 Chromium under Rosetta on Arm and CVDisplayLink errors; these are diagnostic observations, not a proven cause. Native and complete interaction qualification remain open. No real workspace, keys, native build, providers or publication were touched. + +[Accepted intent](intent.md#ui-c5-compile-control-placement--november-2-2026) owns nine files. Private preimages, logs, exact postimages and independent-review outcome: `/rangoon-compile-layout-20261102`. Earlier icon/logo work and unrelated dirt remain. A follow-up used the installed universal Chrome binary's ARM slice explicitly through `/usr/bin/arch -arm64`. It completed the same eight profiles and normal browser exit 0 with no forced termination; server/profile cleanup completed. The bounded run returns PARTIAL/exit 2 because full application/native workflows were intentionally not run. This is a useful architecture-selection diagnostic, not proof of every prior timeout's cause or complete UI qualification. No browser was installed or modified. + +Next qualify an architecture-aware browser launcher and rerun the complete interaction sequence; preserve current safeguards. + + +## Current: UI-C4 full-color artwork and software marks — November 2, 2026 + +Default icon presentation now uses 57 original filled, layered color objects, with the original monochrome geometry retained for forced colors. Names, four supported sizes, labels and action gates remain. Four unchanged official software marks are packaged locally for agentgateway, Cerbos, Permit and Invariant; the existing Claude/Rangoon/LNSAT/VUSL identities remain. Existing catalog families now have authentic marks while availability and authority stay unchanged. The gallery shows eight named software identities. + +[Intent](intent.md#ui-c4-full-color-artwork-and-software-marks--november-2-2026) owns twenty-seven paths, including the worker's two artwork/test paths and the small QA-result helper/tests. [Receipt](development.md#ui-c4-full-color-artwork-and-software-marks--november-2-2026) records actual validation. Final source checks pass 659 tests; focused color/logo/state/qualification tests pass 28. Fresh visual review passes. Full browser runs captured all 44 profiles and completed sixteen checks, then failed during the repeated Lock dialog input; no full rendered-QA PASS is claimed. An isolated six-profile gallery run also completed visual captures but failed normal browser teardown. Failed receipts remain failed. Native-select input, repeated Lock pointer/keyboard flow, browser cleanup reliability and native encrypted workflow remain unqualified. + +Next: inspect the current color gallery with Jeff, then diagnose the isolated browser/controller Lock sequence before claiming complete interaction acceptance. The QA-result helper prevents any pending gate or failed cleanup becoming PASS. Do not substitute normal workspace/vault or native data to work around automation. Keep all earlier UI work and unrelated dirt; source remains uncommitted. No native build/operation, normal data/keys/vault, provider calls, LNSAT/VUSL edits, dependency installation or publication is opened. + +## Current: UI-I3 semantic icons and visual organization — November 2, 2026 + +The second inspection retains the library/editor/inspector structure and adds a closed 57-symbol catalog, consistent Skills/Compile/Workspace/Lock actions, generic software-category symbols, and a grouped icon/software gallery. Claude/Rangoon/LNSAT/VUSL marks remain unchanged. Two unsupported icon sizes were corrected; a static source-call audit now catches literal name/size mistakes. Disabled primary actions are neutral, desktop navigation scrolls independently, and Lock/theme remain reachable with 44px targets. The observed managed-open label now says “Encrypted workspace is unlocked.” + +[Intent](intent.md#ui-i3-semantic-icons-and-visual-organization--november-2-2026) owns twenty paths; [receipt](development.md#ui-i3-semantic-icons-and-visual-organization--november-2-2026) records evidence. Source checks pass 92 focused and 652 full tests; 57 unique icons pass four supported sizes and literal-call checks. Final synthetic browser coverage completes 44 viewport/theme profiles and 17 recorded checks, with clean teardown and no exceptions, console errors or external page requests. Overall PARTIAL/exit 2 retains the actual native-select input gap. Fresh rendered review passes; source/final-document verdicts are sealed in the local receipt. This UI-only task qualifies no native operation, real-user study, storage backend, SDK or provider support. + +Next: qualify actual dropdown input with working visible control, then refine Compose input prerequisites and Compile action placement/progression. The experience document records proposed Compose mode consolidation and a persistent exact-record context; these are recommendations, not implemented navigation. Complete the fresh disposable encrypted native journey before ordinary data. Preserve previous UI-T2/UI-R1 and unrelated work. No normal data/keys/vault, native operation/build, providers/remote/cloud, LNSAT/VUSL changes, dependency fetch or publication is opened. Source remains uncommitted. + +## Current: UI-T2 task arrangement and interaction audit — November 2, 2026 + +Skills now separates library discovery/creation, revision editing, saved-revision continuation and the provenance/history inspector. Search stays visible; Review/Origin/Clear sit under a retained native disclosure whose summary exposes active facets. Existing recovery explanations sit beside actions, and conflict reload is above fields. The [accepted intent](intent.md#ui-t2-task-arrangement-and-interaction-audit--november-2-2026) owns eleven paths and preserves UI-R1. The [receipt](development.md#ui-t2-task-arrangement-and-interaction-audit--november-2-2026) records source, rendered and unresolved evidence. + +Source checks: 66 focused and 648 full JavaScript tests. Final synthetic browser run completed 14 viewport/theme profiles and 17 interaction/media/controller cases with clean teardown; overall PARTIAL (exit 2), because native macOS select-menu pointer/keyboard input remains unqualified. One facet scenario uses an explicitly programmatic change event and does not close that gate. Source review passes; rendered review retains the native-dropdown P2 gate. Visible-browser control also failed at startup on the configured symlinked writable root; no configuration changed. Actual-user usability, native encrypted save/review/export and current-artifact recovery are not qualified. The previous native development executable predates UI-T2; do not represent it as the latest frontend. + +Next: qualify native dropdown input with a visible controlled browser or fresh disposable native artifact; evaluate task completion with Jeff. Then refine Compose input-count/Start-draft guidance and Compile→Export progression in separately bounded source tasks. Preserve exact pins and native guards. No source Apply/Restore, target-loading proof, live systems, normal data/keys/vault, LNSAT/VUSL edits or publication is opened. Changes remain uncommitted; main remains unchanged by this task. +## Current: UI-R1 rendered refinement and native rebuild — November 1, 2026 + +Skills actions now sit above fields with compact local-task headers, clearer title typography, shorter resizable content and theme-aware surfaces. Existing IDs/guards/drafts/provenance remain. [Intent](intent.md#ui-r1-rendered-workbench-refinement-and-native-rebuild--november-1-2026) owns nine paths; [receipt](development.md#ui-r1-rendered-workbench-refinement-and-native-rebuild--november-1-2026) owns evidence. Native default-encrypted development executable rebuilt offline; it was not launched. Source gates: 64 focused and 646 full JS tests. The installed headless browser now provides isolated synthetic UI control: 14 viewport/theme and 11 interaction/state cases passed, including conflicts, stale reads and Lock purge. Chrome uses a temporary browser profile and mock-keychain flags with unchanged host HOME; this is not an OS filesystem sandbox and receives no normal Rangoon data or credentials. + +Next: review the refined local workbench with Jeff, then qualify real native picker/cancel/Lock, source → skill → compose → Compile/export → restart/recovery using a fresh disposable artifact and reliable native UI control. Browser proof does not close native WebView/OS custody, actual persistence/result readback, physical DPI or Windows/Linux gates. Do not reopen normal files/keys/vault or launch the normal app as a substitute. Preserve the pushed `bea3328` source snapshot; this UI/build slice is uncommitted until separately published. Windows/Proxmox stays deferred; providers/remote/cloud and LNSAT/VUSL remain outside scope. + +## Current: source branch publication — November 1, 2026 + +Jeff authorizes committing and pushing the complete twenty-nine-path pending source delta on `codex/native-workflow-qualification-20261030`. [Intent](intent.md#source-commit-and-branch-push--november-1-2026) and [publication receipt](development.md#source-branch-publication--november-1-2026) own scope/evidence. This widens publication only; no merge/deploy/release or native/provider/data authority is added. Git history and the advertised remote branch ref identify the published commit; private local receipt retains command proof. + +Next remains actual rendered checks and the fresh disposable encrypted native journey once UI control is available. Preserve the original app/website worktrees. Normal files/keys/vault, providers/remote/cloud and LNSAT/VUSL remain closed; Windows/Proxmox stays deferred. + +## Current: NEXT-02b exact saved-result continuation — November 1, 2026 + +Saved Compose outputs now open exact revisions in Skills after validated readback, retaining unrelated drafts and targeting the matching editor heading. Same-skill unsaved edits block opening. Missing/substituted results, failures, repeat/disposed clicks and stale navigation/receipt/Lock replies cannot open a replacement revision. [Intent](intent.md#next-02b-exact-saved-result-continuation--november-1-2026) owns thirteen paths; [receipt](development.md#next-02b-exact-saved-result-continuation--november-1-2026) records evidence. Focused tests: 55 passed; full JavaScript checks: 646 passed. + +Next: restore reliable UI control for the NEXT-02 rendered keyboard/pointer/draft/failure/focus/Lock cases at 320/768/1440 dark/light with reduced motion, then complete NEXT-01's fresh disposable encrypted native journey. Neither rendered/native gate is closed by source tests. Preserve native preparation, direction docs, NEXT-02a and this packet; no normal data/keys/vault, providers/remote/cloud, LNSAT/VUSL changes, dependency fetch or publication/release. Windows/Proxmox remains deferred. + +## Current: NEXT-02a saved-revision Compose handoff — November 1, 2026 + +Skills now has **Add to Compose**, using the existing exact native saved-revision read. It retains other drafts and Compose inputs; open drafts, duplicate/full inputs and busy/unavailable/conflicting/unsaved state block adding with an explanation and a link to existing work. Stale selection/navigation/edit/Lock replies cannot add inputs. Nothing is composed, previewed or saved automatically. [Intent](intent.md#next-02a-saved-revision-compose-handoff--november-1-2026) owns exact files; [receipt](development.md#next-02a-saved-revision-compose-handoff--november-1-2026) owns validation/review. Focused tests: 68 passed; complete JavaScript build checks: 636 passed. Source completion does not qualify native use. + +Next: obtain reliable UI control and qualify keyboard/pointer, cancellation/failure/Lock, existing-draft continuity and 320/768/1440 dark/light views; then finish NEXT-01's disposable encrypted end-to-end native journey. Matching composition-result focus is a separate NEXT-02 subpacket. Preserve the prior native/direction work. No normal data/keys/vault, provider/remote/cloud services, engine changes, publication or release is authorized by this source packet. Windows/Proxmox remains deferred. + +## Current: reconciled direction and next packets — November 1, 2026 + +Jeff accepts documentation/planning reconciliation after the local/remote/enterprise reviews and reiterates finished radials, bars, icons, logos and professional visual states. [Intent](intent.md#direction-reconciliation-and-next-phase-preparation--november-1-2026) defines the exact eleven-document packet; [development](development.md#direction-reconciliation--november-1-2026) records its validators/review and preservation. This does not accept implementation of every future packet, provider access or publication. + +Start with [NEXT-01](plan.md#next-phase-packets--november-1-2026): restore reliable exclusive native UI control, then create a fresh NQ-1 v3 disposable artifact/run and prove picker/cancel/Lock purge plus the encrypted source → skill → compose → Compile/export → restart/recovery journey. NQ-1 source preparation and its dated tests are complete; native/rendered qualification remains open. This session has no native computer-use controller exposed; the earlier symlink-root startup failure remains dated diagnostic evidence. Recheck controller availability before any GUI run. Do not reuse an old artifact, open normal data/keys/vault, or change Codex configuration under this docs task. + +NEXT-02 connects exact saved revisions through Compose/Compile and matching result focus with polished real-data/empty/error states. Then retained row inspection, reversible external-file changes, one installed target-loading proof and persistent bulk organization follow. Freeze each source packet's final files/contracts/validators before implementation. Windows/Proxmox testing remains deferred until the upgraded host is ready; Windows custody/startup/recovery still needs implementation. Core local work and three-OS release gates remain independent of enterprise infrastructure. + +Later peer/service packets use the [enterprise boundaries](application-architecture.md#enterprise-operation-and-custody-boundaries--november-1-2026): authenticated tenant/actor scope, current cell/target ownership, qualified effect-side checks or honest weaker coverage, scoped cloud credential/key lifecycle, paused-restore reconciliation and explicit capacity units. VUSL/LNSAT stay independent. Public SDK waits for two real qualified adapters. No source/assets/schema/dependency/policy/CI, live provider/cloud/remote, normal data/key/vault, foreign-repo or publication operation belongs to this documentation update. Preserve the prior nine-file NQ-1 changes and all unrelated work. + +## Historical: native workflow qualification preparation — October 30, 2026 + +PR [55](https://github.com/hypler-dev/rangoon/pull/55) merged the complete application source onto main at `929873aa18521bebab911b410cf4705542b85b80`; the original application and website worktrees remain preserved. Jeff defers Windows testing until the upgraded Proxmox host is available next week. Windows custody/startup/recovery implementation and Windows/Linux GUI qualification remain open. + +NQ-1 prepares BF-2c testing: both isolated native permission lists include existing folder-metadata and explicit multi-file inspection commands. New disposable manifest v3 binds the fixed synthetic folder identity; the artifact binds its exact directory/file identities, sizes and hashes. The parent verifies those inputs before/after a phase, refusing replacements, links and unexpected entries. Old disposable runs must be recreated. Fixture integrity and clean exit are not picker, Lock-purge or workflow proof. + +[Intent](intent.md#nq-1-disposable-folder-qualification-preparation--october-30-2026), [receipt](development.md#nq-1-disposable-folder-qualification-preparation--october-30-2026), and [manual checklist](reviewer-guide.md#disposable-native-workflow-checklist) own the exact nine-path packet and evidence. Next: restore reliable exclusive UI control, create a fresh isolated artifact/run, prove folder selection/cancel and Lock purge, then complete source → skill → composition → Compile/export → restart/reopen and encrypted recovery. Codex UI startup remains blocked by the configured symlinked writable root; do not launch a vault-backed GUI without its controller or count source tests as native evidence. Then prioritize retained row custody, safe project-file Apply/Restore, one installed target's loaded instructions and persistent bulk organization. Normal data/keys/vault, providers/remote systems, LNSAT/VUSL changes and publication/release remain outside this packet. + +## Historical: full application source publication — October 29, 2026 Jeff authorized all current application work for GitHub main only. The publication candidate reconciles the complete authored app snapshot onto public main `01423598`, preserves PR51/53/54, and includes encrypted startup/recovery, instruction history, native lifecycle seams, Agent files/Markdown review, and Skills → Compile continuity. Original application and website dirt remain outside the publication worktree. The [accepted publication intent](intent.md#full-application-source-publication--october-29-2026) and [receipt](development.md#full-application-source-publication--october-29-2026) supersede the earlier source packets' publication holds for this snapshot only. diff --git a/docs/development.md b/docs/development.md index 4666181..2dcda48 100644 --- a/docs/development.md +++ b/docs/development.md @@ -1,4 +1,245 @@ # Development status + + + + + +## November 3 reviewed workbench publication + +Authority: Jeff says “commit merge.” The exact source-publication packet combines the reviewed pending workbench UI with the earlier `bea3328` prerequisite; public base is `929873aa18521bebab911b410cf4705542b85b80`. Sixty-one main-relative paths include the Skills/Compose/Compile exact-revision handoffs, disposable native folder-test preparation, responsive task grouping, original full-color icons, pinned local software marks, and Recipe/Graph inspector/edge-case testing. The current publication edits only README and the three canonical scope/status records. Exact inventories, preimages, staged patch/tree/commit, validation logs, fresh aggregate review and GitHub checks/merge receipts are retained in `/rangoon-ui-main-publication-20261103`. GitHub supplies public commit, PR and CI evidence; private paths are not public downloadable artifacts. + +Current publication validation includes 670 JavaScript tests, 114 Python qualification source tests, syntax/visual/vision, documentation and focused Rust configuration/formatting checks. Final synthetic UI replay completes 110 viewport/theme profiles and 30 checks, with no observed page exceptions/console errors/external page requests, normal browser exit, profile removal and fixture-server cleanup. The overall result remains PARTIAL for actual native-select and Lock-pointer input. Source output-select testing is programmatic controller-path evidence. Tests use inert fixtures and do not qualify native preview contracts, provider adapters, runtime enforcement or ordinary encrypted-workspace tasks. The publication validators and independent aggregate review record fresh results in the final receipt rather than treating earlier partial UI evidence as complete. + +The prerequisite native changes add exact existing picker permissions only to the isolated qualification configuration and bind a fixed synthetic folder identity in manifest v3. Old disposable runs must be recreated. Folder identity, Python source tests and Rust CI cannot substitute for native picker, Lock/purge, restart or full encrypted recovery proof on the actual artifact. Standard source CI covers the pinned Rust core and desktop build/tests on macOS, Windows and Linux; it distributes no installer and establishes no GUI or custody support claim. + +Security/standards impact: domain and renderer authority remain separated; no normal data, key custody, storage/schema, provider/engine runtime, dependency version or CI-policy change is introduced by the publication. The native test-permission delta is scoped to disposable qualification and validated against exact permissions, manifest identity and replacement/link refusals. Original fixed local icons and hash-pinned vendor images never become untrusted inline SVG or remote runtime requests. ISO/OpenSSF/readiness and native/release limits are unchanged. Producer/integrator: root/OpenAI; fresh independent OpenAI native reviewer examines the exact main-relative candidate, without merge authority. Actual serving model is unexposed. + +Publication gates: verify public repository/base and current branch protection/rules, exact staged paths and README, fresh independent review, named source validators, non-force public branch push, exact PR head/base and every standard CI job, external reviews/threads, then a head-bound ordinary merge. No admin bypass, force push, executable release, deployment, live provider/engine, normal files/keys/vault, website or foreign-repository edit is authorized. Final external receipt records actual status; this entry describes the accepted packet, not a claim that pending publication has completed. + +Aggregate review P2 found missing app-level saved Compose result → Skills replay. The validation-only extension adds an explicit opt-in, memory-only preview/receipt fixture; default synthetic preview/save refusal is unchanged. The actual app replay verifies exact historical revision even after a newer head appears, Skills route/title focus, same-skill dirty-draft and global-busy denial without extra reads, and held replies discarded after navigation or Lock. Eight focused handoff tests include fixture contract validation and default-off behavior. No production application behavior changed to satisfy this finding. The independent review also corrected the candidate count: three additional staged paths add only two main-relative paths because the handoff test file was already in the prerequisite commit. The final candidate is forty-four staged paths and sixty-one main-relative paths. Earlier failed review/fixture expectations and exact initial snapshot remain retained; final head/tree/CI and review evidence must match the resealed candidate. + +Headless browser qualification: retained normal-GPU runs completed assertions but failed browser teardown watchdogs; they remain FAIL. A bounded software-GPU diagnostic completed the same 110 profiles and 30 checks with normal exit 0. The final QA driver therefore uses `--disable-gpu` for deterministic headless software rendering, waits for the actual protection/locked terminal shell, and unloads only its owned page before closing. It retains sandbox, security flags, isolated profile and network restrictions. Synthetic saved-result captures carry an asserted visible noninteractive memory-only badge. This does not qualify hardware GPU rendering, native input, native encrypted tasks or desktop release. The final exact-source replay and independent seal are recorded in the publication receipt. + + +## UI-C8 Recipe/Graph inspector and edge cases — November 3, 2026 + +The inspector now lists up to sixteen existing outputs with output/piece and unresolved-declaration counts. Choosing an output opens its Recipe fields and focuses its title; navigation performs no edit, assignment, preview, save or authorization. Selected-output context and the inspector list's scroll survive Recipe/Graph navigation, while unapplied authored text remains retained. Source output-selection changes also reveal the selected inspector row using only the list scroll position; page scroll is unchanged. Long titles, graph cards and conflict fields wrap within their panels. Existing diagnostics, conflicts, reasons and save acknowledgement remain visible. A failed action adds concise retained-draft recovery guidance without changing action gates. + +Validation: 30 focused Compose view tests and 668 complete JavaScript tests pass. Final synthetic replay completes 110 layout profiles and 25 interaction/media checks with normal browser exit 0, removed test profile and closed loopback fixture server. Sixty added profiles cover five inert display cases across Recipe/Graph, 320/768/1440 pixels and dark/light: sixteen outputs with long escaped titles, failed preview, stale preview, unresolved declaration and busy state. Real DOM navigation focuses output 16, retains unapplied text while switching outputs/views, and keeps the selected inspector row visible. A read-only fixture controller rejects any domain-method call. Recovery/busy cases keep Save and acknowledgement disabled. These fixtures are presentation tests, not native accepted contracts. + +Overall browser result remains PARTIAL for actual native-select input and Lock-pointer confirmation; native encrypted workflow remains separately unqualified. Lock uses keyboard activation in this replay. Earlier Lock-pointer and browser-exception runs remain retained failed receipts. No normal files/keys/vault, native build/operation, provider calls, dependency fetch, LNSAT/VUSL edits, commit/push/merge/deploy/release. + +[Accepted intent](intent.md#ui-c8-recipegraph-inspector-and-edge-cases--november-3-2026) owns eleven paths. Private exact preimages, logs, incremental patch, postimages and review: `/rangoon-ui-c8-20261103`. Final browser receipt: `/rangoon-ui-render-dQqUPX/receipt.json`. Current checkout: `/private/tmp/rangoon-ui-c8-worktree-20261103`, branch `codex/ui-inspector-20261103`, HEAD `bea3328227c9f2f130a1f9ab38649236c68714ad`. Original temporary checkout lost its Git pointer and 717 tracked paths; a fresh local-only shared clone restored the complete baseline, then copied all forty earlier pending paths after exact hash verification. Old source/deletions and unrelated repositories remain preserved. The clone's origin is local, not a publication destination. Next qualify native input/recovery separately; improve graph scale/navigation only from measured user tasks. + +Security and standards impact: display/navigation only; no transformation, storage/schema, credentials, native permission, dependency or provider change. Output selection uses an existing bounded index and changes local view/focus only; no provider decision or UI count becomes authorization. State and native saveability remain authoritative at their existing boundary. The added fixtures are unverified synthetic display states, never passed to native operations. Browser fixture readiness now waits for the host module before replacing its body; exact synthetic exception descriptions remain in private test evidence. ISO/OpenSSF and release claims are unchanged. Producer/integrator: root/OpenAI; fresh independent OpenAI gpt_ui_review covers exact source, tests, actual captures and documentation. Actual serving model is unexposed. + + +## UI-C7 Compose task hierarchy — November 2, 2026 + +Compose now separates Arrange views, History, Layout and Draft controls. A compact static Select inputs → Arrange content → Preview & review → Save locally guide describes the workflow without claiming progress or readiness. Existing Source/Recipe/Graph, Undo/Redo, Reset workspace and Discard draft labels, IDs, pins and predicates remain. Saved-result text requires returned results; a clean unsaved draft is not labeled saved. Repeated read-only/provenance explanation moves into existing inspector selection details; reasons, annotations, diagnostics, preview status and explicit save acknowledgement remain visible. Save controls have their own visible section. + +Actual draft testing found a narrow-layout defect: later desktop grid rules could override the viewport fallback while resize state caught up, producing 280px overflow at 320px. A final narrow viewport rule restores a real one-column layout below 1200px. Revision selectors now fit their panel instead of clipping; grouped tools and selection-details targets retain 44px height and keyboard focus. No overflow hiding, new dependency or animation is added. + +Validation: 29 focused Compose tests and 667 complete JavaScript tests pass. Final synthetic replay completes fourteen Skills plus thirty-six route/gallery/draft profiles (fifty total), twenty-two interaction/media checks, clean browser exit 0, fixture-server closure and profile removal. Actual in-memory drafts cover Source/Recipe/Graph pointer and keyboard switching, focus, six dark/light draft layouts, contained revision selectors, reduced motion, forced colors, refused preview keeping acknowledgement/Save disabled, and Discard pointer Cancel then Confirm. The QA driver handles only the armed exact confirm message/type/page URL; unexpected dialogs are dismissed and fail the run. Earlier overflow and unhandled-confirm failures remain failed receipts. + +Result remains PARTIAL: actual native-select input and Lock-pointer confirmation stay open; synthetic keyboard Lock purge is not native encrypted-workspace proof. No normal files/keys/vault, native app build/operation, providers, LNSAT/VUSL edits, dependency fetch, commit/push/merge/deploy/release. Earlier pending work remains preserved. + +[Accepted intent](intent.md#ui-c7-compose-task-hierarchy--november-2-2026) owns ten paths. Exact preimages, logs, incremental patch, postimages and independent review: `/rangoon-ui-c7-20261102`. Final browser receipt: `/rangoon-ui-render-StS5bl/receipt.json`. Next: extend the same task hierarchy to the recipe/graph inspector and test long titles, many outputs and recovery states; installed native workflow remains a separate gate. + +Security and standards impact: presentation and synthetic validation only. No transformation, persistence/schema, credential, provider, permission or authority change. The static guide has no progress/authorization semantics; actual preview/save gates stay exact. Existing provenance text remains available in the inspector; diagnostics and acknowledgement stay visible. The synthetic dialog handler neither handles native OS consent nor supplies application approval: it is armed for one fixed disposable draft-confirmation message on the exact loopback page. ISO/OpenSSF claims and release gates are unchanged. Root produces/integrates; fresh OpenAI gpt_ui_review provides independent source/rendered review. Actual serving model is unexposed. Source and render evidence do not qualify native platforms or storage. + + +## UI-C6 Compose guidance and reliable browser replay — November 2, 2026 + +Compose now displays the selected-input count and the exact missing or excess selection beside Start draft, with an accessible description. Empty, one-input, valid and over-limit selections are covered; original action predicates, exact revision pins, draft locking and native operations remain unchanged. + +The synthetic QA launcher now detects ARM-capable macOS through a fixed, bounded system command and selects the installed default Chrome ARM slice even when Node runs under Rosetta. Explicit browser overrides and other hosts retain direct launch; no browser/dependency is downloaded or updated. The compact-navigation replay waits for the responsive drawer state before clicking, avoiding a resize/event race in the test driver. Production navigation code is unchanged. + +Validation: 31 focused launcher/Compose tests and 665 full JavaScript tests pass. Final synthetic replay completes fourteen Skills profiles plus thirty route/gallery profiles, eighteen interaction/media assertions, no page exceptions/console errors/external page requests, normal browser exit 0, profile removal and fixture-server cleanup. Result remains PARTIAL because actual native-select input and Lock-pointer confirmation remain unqualified. Keyboard Lock purge is synthetic browser evidence only. The first ARM run failed compact-navigation timing and remains a failed receipt; subsequent clean replays do not erase it. + +[Accepted intent](intent.md#ui-c6-architecture-aware-ui-qualification--november-2-2026) owns nine paths. Private preimages, command logs, incremental patch, postimage hashes and review: `/rangoon-ui-c6-20261102`. Final browser capture receipt: `/rangoon-ui-render-aQa9ul/receipt.json`. No normal files/keys/vault, native build/operation, provider calls, dependency fetch, LNSAT/VUSL edits, commit/push/merge/deploy/release. Existing work remains uncommitted and preserved. Next: consolidate Compose's action hierarchy and verify actual select/pointer behavior through a qualified controller, then resume isolated native workflow qualification. + +Security and standards impact: presentation-only selection guidance and developer-test process selection. No domain/storage/schema/credential/network-policy or runtime authority change. System detection executes only `/usr/sbin/sysctl -n hw.optional.arm64` with a three-second timeout and bounded output; launch uses an argument array, not shell text. Browser security flags, isolated profile and environment allowlist remain unchanged. Missing/unrecognized host detection fails before browser launch. This does not establish ISO/OpenSSF compliance, native support or production readiness. Root is producer/integrator; fresh OpenAI native reviewer evaluates exact incremental source and rendered evidence. Configured reviewer role is gpt_reviewer; actual serving model is unexposed. + + +## UI-C5 Compile control placement — November 2, 2026 + +The existing format selector, Compile/Open in Skills actions and stale-selection recovery now precede long saved-library/history lists. An escaped selected-revision title or explicit selection prompt keeps context visible. IDs, labels, exact pins, disabled predicates, warnings and native behavior remain unchanged. No automatic compilation, export or navigation is added. + +Source checks pass 13 focused and 660 full JavaScript tests. Eight synthetic dark/light captures at 320/768/1366/1440 completed geometry and passive selection/handoff assertions; Compile ends at 582px on 1366×768 and 564px on 1440×1000. Mobile remains vertically scrollable without horizontal overflow. Browser normal shutdown timed out, so the receipt remains FAIL despite completed captures. The browser reported x64 Chromium under Rosetta on Arm and CVDisplayLink errors; these are diagnostic observations, not a proven cause. Native and complete interaction qualification remain open. No real workspace, keys, native build, providers or publication were touched. + +[Accepted intent](intent.md#ui-c5-compile-control-placement--november-2-2026) owns nine files. Private preimages, logs, exact postimages and independent-review outcome: `/rangoon-compile-layout-20261102`. Earlier icon/logo work and unrelated dirt remain. A follow-up used the installed universal Chrome binary's ARM slice explicitly through `/usr/bin/arch -arm64`. It completed the same eight profiles and normal browser exit 0 with no forced termination; server/profile cleanup completed. The bounded run returns PARTIAL/exit 2 because full application/native workflows were intentionally not run. This is a useful architecture-selection diagnostic, not proof of every prior timeout's cause or complete UI qualification. No browser was installed or modified. + +Next qualify an architecture-aware browser launcher and rerun the complete interaction sequence; preserve current safeguards. + + +## UI-C4 full-color artwork and software marks — November 2, 2026 + +Authority: Jeff asks for more beautiful full-color icons and software logos/icons. [Intent](intent.md#ui-c4-full-color-artwork-and-software-marks--november-2-2026) owns twenty-seven paths; the implementation worker owns only the new artwork module and its tests before root integration. Baseline: `codex/native-workflow-qualification-20261030`, HEAD `bea3328227c9f2f130a1f9ab38649236c68714ad`, twenty-one pending authored paths preserved. Private preimages, incremental diff, exact postimages, source/browser logs and review receipt: `/rangoon-fullcolor-icons-20261102`. + +**Delivered presentation:** 57 original layered, filled color objects replace the monochrome-only default. Fixed blue/violet/cyan/jade/gold/ember material parts identify object families; colors do not assert runtime state or authority. Original names, viewBox, sizes 16/20/24/40, decorative accessibility attributes and text labels remain. The old monochrome path is retained and shown in forced colors while the color layer is hidden. Artwork contains only closed local geometry with fixed paint: no external references, IDs, script, arbitrary paths, filters, animation or dependency. Root refined cylinder silhouettes and the agent module after integration. Existing routes, actions, draft state, native commands and security gates are unchanged. + +**Software identity:** unchanged official-site assets are packaged for agentgateway, Cerbos, Permit and Invariant. Exact URLs, source pages, retrieval date, byte lengths, SHA-256, owner attribution and trademark boundaries are in [vendor provenance](../preview/assets/vendors/provenance.json). Existing Claude/Rangoon/LNSAT/VUSL assets remain unchanged. The software gallery presents eight identities with contained proportions, original colors and suitable backing. Existing catalog entries gain only local logo-path metadata: Permit authorization, FastMCP middleware and commercial MCP Gateway retain separate identities/semantics; Invariant local/remote retain separate entries. Availability remains unavailable/unknown and never becomes supported because a logo exists. Public asset retrieval used verified system TLS and no credentials; provider APIs were not called. + +**Source validation:** `npm run build:check` passes syntax/visual/vision checks and 659 JavaScript tests. The focused artwork/vendor/state/catalog/result set passes 28 tests. Independent literal identity pins assert the exact ID→path→SHA/source mapping and emitted image src; swapped local marks cannot pass merely by changing provenance in tandem. New original-art tests cover all 57 names, four sizes, unique geometry, hostile/unknown inputs and fixed local paint. Software tests verify hashes, bounded PNG headers/dimensions and SVG tag/attribute allowlists. Permit retains only its original same-document gradient and clip IDs; references must resolve to the expected local definition kind. New QA-result tests keep failed checks/cleanup as FAIL and ensure a qualified native select cannot hide a pending Lock check. + +**Rendered observations and open gates:** two final full-color source runs captured fourteen Skills plus thirty other route/gallery viewport/theme profiles, forty-four total. Geometry, image loading, color-layer visibility, forced-colors fallback and sixteen preceding interaction/media/controller assertions completed. Both then failed at the repeated Lock dialog input with CDP timeouts; one fresh keyboard-confirmation attempt also stalled while reopening Lock before it could reach keyboard activation. These runs are **FAIL**, not complete UI qualification. The isolated static-gallery run captured six profiles and eight loaded identities but failed normal browser shutdown, with forced cleanup recorded as FAIL. No JavaScript page/console error or external page request was observed before those failures. Clean final app/browser teardown and complete Lock interaction are not claimed. Earlier implementation/fixture failures remain separately retained evidence. + +A fresh rendered reviewer inspected actual normal/forced-color/screenshots and reports PASS with no open visual P1/P2/P3. A suspected missing VUSL mark was withdrawn after rechecking exact artifact bytes and a second capture; no Foundation source/asset change was necessary. Visual review is distinct from the failed browser interaction/cleanup gate. Native WebView/OS/storage, physical DPI, assistive technology and actual-user usability remain separate. The prior native executable predates these frontend changes and was not rebuilt or launched. + +**Security/standards and review:** no renderer authority, credential handling, storage/schema, dependency or network-policy change. Original artwork stays constant geometry; new software assets are fixed local images, never user-supplied inline SVG. Gradient/clip support is limited to vetted same-document references in a hash-pinned packaged brand asset and does not introduce an upload/parser feature. ISO/OpenSSF/readiness claims are unchanged. Design/producer/reviewer roles use OpenAI configurations recorded in the exact local receipt; actual serving IDs are unexposed. Root owns integration and final judgment. No normal data/keys/vault, providers/cloud/remote operation, native build/operation, LNSAT/VUSL edit, install/fetch of dependencies, commit/push/merge/deploy/release. This is a presentation and validation-tooling slice, not technical engine or release qualification. + +## UI-I3 semantic icons and visual organization — November 2, 2026 + +Authority: Jeff requests actual source/rendered inspection, further organization/visual direction and icons for software, skills, editing, compilation, locking and encrypted states. [Intent](intent.md#ui-i3-semantic-icons-and-visual-organization--november-2-2026) owns twenty files. Baseline: `codex/native-workflow-qualification-20261030`, HEAD `bea3328227c9f2f130a1f9ab38649236c68714ad`, eleven pending UI-T2/UI-R1 files retained. Private preimages, incremental diff, command logs, exact postimages and final receipt: `/rangoon-ui-icons-20261102`. + +**Inspection and experience:** actual Skills, Compose, Compile, Workspace, Authority and icon-board renders inform the direction. Keep library/editor/inspector and compact static abstract art. Prioritize Compile's low action placement, Compose's minimum-input explanation and conflict action hierarchy in later bounded tasks. Proposed Compose modes, persistent selected-record/revision context and clear folder-metadata versus saved-copy scope are documented in [experience](product-experience.md#ui-i3-inspected-organization-and-visual-direction--november-2-2026); they are not delivered workflow changes. The [visual contract](visual-system.md#ui-i3-semantic-icon-system--november-2-2026) separates actions, record types, states and software identity. + +**Delivered UI:** Foldline expands from 37 to 57 unique closed SVG symbols, with fixed 16/20/24/40 sizes and non-focusable decorative markup. Skills and Compile actions, local Lock/Unlock/setup and storage-specific backup/export actions keep their exact labels, IDs and predicates while gaining distinct symbols. Original format/runtime/authority warnings remain. Generic category symbols replace unvetted software monograms; exact product names and unavailable labels remain. Packaged Claude, Rangoon, LNSAT and VUSL marks are unchanged, with contained proportions and light backing for dark native marks. The gallery groups symbols and software identities. No new vendor asset, dynamic SVG, framework or dependency is introduced. + +**Actual defects repaired:** Compose's 15px skill and Authority's 34px header requested unsupported sizes, silently returning empty SVG markup; callers now use 16 and 40. The visual validator checks literal source names/sizes in addition to runtime hostile-input checks. Resizing exposed unreachable global controls in the crowded desktop sidebar: navigation now scrolls independently while brand, Lock and theme retain space; the desktop theme target now meets 44px. Disabled primary buttons no longer retain an active orange appearance. “Encrypted workspace is unlocked” replaces unclear managed-protection wording only on the existing observed managed-open path. These are presentation changes, not new enforcement or storage behavior. + +**Validation:** 92 focused affected-view/state tests pass; `npm run build:check` passes syntax/vision/visual checks and 652 JavaScript tests. New semantic tests ensure unknown/browser/Legacy states do not gain an encrypted-state icon or Lock action, setup is not shown as completed encryption, Legacy/readable exports differ from encrypted backups, exact action names and gates survive SVG additions, and software identity remains distinct from availability. Visual checks cover 57 unique glyphs at four sizes, 126 literal-size callers, hostile inputs and nine manifest asset hashes. Final document/spec/whitespace/path checks and independent review are sealed in the local receipt. + +**Rendered evidence:** installed Chrome `156.0.8078.80`, final run completed fourteen Skills viewport/theme/DPR profiles plus thirty profiles across Compose, Compile, Workspace, Authority and the icon gallery: forty-four total. Seventeen interaction/media/controller checks complete, including exact-history handoff, retained drafts, refusals/conflicts, compact navigation and synthetic Lock cancel/purge. Global desktop Lock/theme geometry, icon semantics, no horizontal overflow, packaged mark loading and gallery completeness are checked. No JavaScript exceptions, console errors or external page requests; owned tab/browser/server/profile close normally with browser exit 0 and no forced termination. Final runner returns **PARTIAL, exit 2** because `native_select_pointer_keyboard` remains unqualified on headless macOS. The facet scenario explicitly uses a programmatic change event, not proof of native menu input. + +Earlier runs retained actual failures: theme hit testing, compact route timing, initial global target geometry, and CDP/modal waits. QA now waits a queued task before checking actual pointer hit targets, waits for route/drawer completion, records phase/last control, and keeps its synthetic marker in normal main-area flow. The final successful executed assertions do not turn prior failed runs into evidence or establish a general browser-stability guarantee. Current renders are emulations and synthetic transport, not native WebView/OS/filesystem, physical DPI, real-user usability, actual save/review/export or native recovery qualification. + +**Review/security/publication:** fresh independent OpenAI design, code and rendered reviewers are configured `gpt-5.6-terra`; serving IDs are unexposed. Rendered review passes with no open P1/P2/P3 after mark contrast correction; final code/document outcome belongs to the exact local receipt. Storage/authority predicates, Rust/domain/native code, schema, dependencies and asset bytes remain unchanged. Boolean/disclosure state and previous drafts remain under existing lifecycle controls. QA uses the prior isolated loopback/profile/mock-keychain contract with unchanged HOME, not an OS filesystem sandbox. ISO/OpenSSF claims are unchanged. No normal data/keys/vault, providers/cloud/remote, LNSAT/VUSL edits, native build/operation, dependency fetch, commit/push/merge/deploy/release. This UI-only packet is not technical integration progress. + +## UI-T2 task arrangement and interaction audit — November 2, 2026 + +Authority: Jeff asks for better tool arrangement and actual UI functionality testing. [Intent](intent.md#ui-t2-task-arrangement-and-interaction-audit--november-2-2026) owns eleven paths. Baseline: `codex/native-workflow-qualification-20261030`, HEAD `bea3328227c9f2f130a1f9ab38649236c68714ad`; nine pending UI-R1 paths preserved. Private incremental preimages, patch, logs and receipt: `/rangoon-ui-taskflow-20261102`. + +**Experience:** library owns searching, facets and source-section creation; editor separates Edit revision from Use saved revision; inspector owns origin, history and term help. Exact existing controls and disabled predicates remain. Search stays visible, optional filters use native details with retained open state, active facets remain in the collapsed summary, and no-match text offers Clear/search recovery. Draft/continuation explanations move adjacent to their controls. Conflict reload moves above fields. Tablet provenance explicitly resets inherited grid placement after inspector wrapping. No route replacement, framework, new artwork, fake metric, automatic save or execution is added. + +**Source validation:** focused Skills/model/composition/handoff tests pass 66/66; `npm run build:check` passes syntax/visual/vision checks and 648 tests. New tests cover task-group descriptions, exact control placement, active-facet summaries, explicit disclosure presentation and conflict recovery placement. Source and document checks are bound in the local receipt. The previous native executable is not rebuilt or launched by UI-T2. + +**Rendered evidence:** final installed Chrome `156.0.8078.80` run completed fourteen dark/light logical viewport/DPR profiles and seventeen recorded interaction/media/controller cases. Zero horizontal overflow, 44px action targets, valid inspector widths and desktop actions above the fold; zero JavaScript exceptions, console errors or external page requests. Browser/server/profile teardown completed normally, exit 0 with no forced termination. Runner returns **PARTIAL, exit 2**, with `native_select_pointer_keyboard` pending: macOS headless native dropdown input failed in two prior runs. Facet controller wiring is tested with a clearly labeled programmatic change event; it is not native-select input proof. Pointer/keyboard search, Escape, Clear, hidden-selection preservation, disclosure navigation retention, refused save/review, compact navigation, historical pinning, draft/discard, Compile handoff, failed reads/refresh, conflict/reload, stale reply, reduced motion, forced colors and Lock cancel/purge complete in the final run. Two early dropdown runs and an intermediate CDP timeout/forced teardown remain failed evidence, not successful cases. + +**Measured tradeoff:** at 1366px, editor top moves from 262px to 152px while content starts at 622px versus 603px because action explanations are now adjacent. At 320px, editor top moves from 1140px to 897px and content from 1632px to 1579px. The layout reduces top-level clutter and improves action context; these measurements do not prove faster task completion or finished mobile UX. No real-user study or native encrypted persistence is claimed. + +**Review and next work:** bounded design critique and fresh independent source/rendered review use OpenAI roles configured `gpt-5.6-terra`; actual serving IDs are unexposed. Fresh source review PASS has no remaining actionable P1/P2/P3. Rendered review confirms the hierarchy but retains one P2 qualification gap for native dropdown input. Final verdicts and exact postimages are in the local receipt. The visible-browser CUA entry point also failed before opening with the configured symlinked writable-root error; no configuration was changed. Next product bottlenecks: show Compose's required input count beside Start draft, and make Compile→Export progression clearer without changing guards. Those surfaces are recommendations, not delivered behavior. Qualify actual native menu input and the disposable encrypted workflow before ordinary files. + +**Security/standards:** no native command, authority, permission, storage/schema, dependency, provider or credential change. New disclosure state contains only a boolean and resets on workspace purge. Existing Rust saveability/transactions, exact pins and review-versus-authorization distinctions remain. QA keeps the UI-R1 loopback/profile/mock-keychain contract and unchanged host HOME; it is not an OS filesystem sandbox. Synthetic save/review refuses and never impersonates persistence. ISO/OpenSSF/release claims are unchanged. Normal data/keys/vault, providers/cloud/remote, LNSAT/VUSL, dependency fetch, publication, merge/deploy/release remain untouched. + +## UI-R1 rendered workbench refinement and native rebuild — November 1, 2026 + +Authority: Jeff asks to rebuild and visually refine the UI after the saved-revision source update. [Accepted intent](intent.md#ui-r1-rendered-workbench-refinement-and-native-rebuild--november-1-2026) owns nine paths. Baseline: `codex/native-workflow-qualification-20261030`, HEAD `bea3328227c9f2f130a1f9ab38649236c68714ad`, clean. Private baseline/preimages, screenshots, command logs, artifact identity and final review receipt: `/rangoon-ui-rebuild-20261101`. + +**Experience:** the existing Skills action block moves intact above editable fields. Save/review/discard and Compose/Compile retain IDs, disabled predicates and focus behavior. A compact two-row toolbar keeps every action visible at 1366×768; title fields use readable system typography while content stays monospace. Shared local-task headers and their existing abstract art take less space. Skills panels, field borders, history rows and focus indicators use consistent surfaces; subtle hover border emphasis respects reduced motion. No control, help/error message, provenance or native disclosure is removed. + +**Rendered validation:** `node scripts/qa-ui-render.mjs` uses the installed Chrome with built-in Node/CDP, a disposable profile, loopback synthetic fixture and visible synthetic label. It never starts Tauri or receives normal Rangoon workspace data or provider credentials. It requests a dedicated browser profile and mock-keychain/basic-store flags. Host Chrome may consult OS/HOME metadata; this is not an OS filesystem sandbox. Non-loopback page requests are refused. Chrome **156.0.8078.80** passed **14 viewport/theme cases**: 320×900, 768×1024, 1366×768, 1440×1000, 1920×1080 at DPR 1 and 2, and 3840×2160 at DPR 1, each dark/light. These are emulated browser viewports/DPR, not physical-monitor or native-WebView qualification. All cases had zero horizontal overflow and revision actions at least 44×44 pixels; all five actions were above the fold for desktop cases ≥1240 pixels wide. At 1366×768, the editor begins at y≈262 and all actions end by y≈447; the content field is visible in the initial fold. The three-column center is ≈490 pixels wide. Narrow views retain the stacked fallback and document scrolling. + +**Eleven rendered interaction/state cases passed:** exact historical-revision pointer handoff to Compose; dirty-draft retention across navigation with explicit discard/cancel; keyboard Compile handoff; failed read preserving the editor; failed library refresh retaining stale records; conflict preserving the draft until explicit reload; late Compile reply refusing navigation; reduced motion; forced colors; Escape cancelling Lock confirmation; and synthetic Lock purging the editor. The successful run recorded zero JavaScript exceptions, console errors or non-loopback requests. Synthetic native responses do not qualify real persistence or execution. Saved-result-to-Skills behavior retains its independent source tests; no native save or result workflow was claimed here. + +**Source validation:** 64 focused existing UI/model tests passed; `npm run build:check` passed syntax/visual/vision contracts and all **646 JavaScript tests**. The new QA runner also passes `node --check`. Early browser runs exposed fixture-panel hit-test interference, missing macOS Return-key text synthesis and an assertion expecting a native list error rather than the scoped stale-library message. The QA harness was corrected; final viewport and interaction suites passed. Product guards were not weakened to pass tests. + +**Independent review:** fresh visual review returned **PASS, no actionable P1/P2/P3**, inspecting baseline and final narrow/desktop/theme/conflict/accessibility PNGs. Separate QA-code review identified strict HOME-isolation wording, geometry assertions that could pass an empty/subset action list, premature PASS before cleanup, and a startup cleanup boundary gap. The final runner retains unchanged inherited HOME for host compatibility and narrows its privacy claim to private browser-profile input, mock-keychain flags and no supplied Rangoon data/credentials; it makes no OS filesystem-isolation claim. It requires all five exact action IDs, present editor/content and finite bounded geometry. Setup/listen/spawn failures enter cleanup; no-PID launch rejection is distinguished from a running browser. Request interception drains and the owned tab closes before Browser.close. PASS is written only after normal exit, fixture-server closure and profile removal; timeout/forced cleanup fails the run. + +The final run passed all 14/11 cases with exit code 0, tab/server/profile closed and no forced termination. Negative immediate-exit, invalid-executable and missing-browser cases refused PASS; created profiles/servers were cleaned, and missing-browser preflight created none. Earlier no-HOME runs intermittently failed startup/shutdown and were not counted as success; this is correlation, not a demonstrated root cause. Final normal-exit grace is bounded at ten seconds. Host/browser instability remains a diagnostic concern if it recurs. The installed browser reported 156.0.8078.76 in earlier runs and 156.0.8078.80 in the final run; this task did not install or update Chrome. The version change does not by itself establish the cause of earlier failures. The completion receipt records exact final source and review status. Producer: OpenAI `gpt-6.1-sol`; design/UI-review/QA-review roles are configured OpenAI `gpt-5.6-terra`, high for design and xhigh for review; serving IDs are not exposed. + +**Native rebuild:** pinned Rust **1.99.1**, default `custom-protocol` plus `encrypted-workspace`, `cargo build --manifest-path apps/desktop/Cargo.toml --bin rangoon-desktop --locked --offline`, using the existing cached desktop target, completed in **45.31 s**. It rebuilt the development executable with the refined frontend inputs. SHA-256: `41a5f52d868ebbf0d175f33d17078b5eaee3e778a3ad4dfc7795711398dc6a48`; size: **84,624,680 bytes**. The existing duplicate-custom-test-target manifest warning remains. This is an unoptimized development executable, not a packaged/signed release or a launched native UI test. Exact local path and frontend hashes are in `native-artifact.json`. + +**Security/standards and limits:** no dependency, asset, provider, permission, storage/schema, credential or native command change. QA uses an allowlisted child environment with unchanged host HOME, mock-keychain flags, an owned temporary profile and bounded CDP requests; profile flags do not establish an operating-system filesystem sandbox; only synthetic text/screenshots are retained. No normal data/keys/vault, LNSAT/VUSL, provider/cloud/remote operation or dependency fetch. Browser render proof resolves the earlier browser-observation gap for these cases only. The disposable encrypted native journey, native WebView/OS custody, physical display/DPI behavior and Windows/Linux GUI qualification remain open; no native UI controller is exposed. ISO/OpenSSF and production-readiness claims remain unchanged. Fresh independent UI/code review and final documentation/path checks are recorded in the local completion receipt. No commit/push/merge/deploy/release is part of UI-R1. + +## Source branch publication — November 1, 2026 + +Authority: Jeff requests “commit and push”; [accepted publication intent](intent.md#source-commit-and-branch-push--november-1-2026). Source branch: `codex/native-workflow-qualification-20261030`. Fetched public main and source base both resolve to `929873aa18521bebab911b410cf4705542b85b80`. Root owns aggregate integration, commit and non-force branch push; merge/deployment/release remain closed. Local evidence: `/rangoon-source-push-20261101`. + +**Delivered scope:** NQ-1 synthetic folder inventory/integrity preparation, reconciled local/remote/enterprise drafting records, exact saved-revision Skills → Compose handoff and exact saved-result Compose → Skills readback/focus. No new runtime dependency or engine integration is introduced. Earlier source packets retain their implementation and native-operation limits; this task authorizes their source publication only. + +**Exact authored paths (29):** + +- `README.md` +- `apps/desktop/native-encrypted-qualification/tauri.conf.json` +- `apps/desktop/src/native_encrypted_qualification.rs` +- `docs/application-architecture.md` +- `docs/continue.md` +- `docs/development.md` +- `docs/encrypted-workspace.md` +- `docs/intent.md` +- `docs/operations-control-plane.md` +- `docs/plan.md` +- `docs/product-experience.md` +- `docs/provider-interoperability.md` +- `docs/reviewer-guide.md` +- `docs/visual-system.md` +- `preview/analyze.mjs` +- `preview/composition-model.mjs` +- `preview/composition-skill-handoff.mjs` +- `preview/composition-view.mjs` +- `preview/skill-compile-handoff.mjs` +- `preview/skills-model.mjs` +- `preview/skills-view.mjs` +- `scripts/qualify-native-encrypted.py` +- `tests/composition-model.test.mjs` +- `tests/composition-skill-handoff.test.mjs` +- `tests/composition-view.test.mjs` +- `tests/qualify_native_encrypted_test.py` +- `tests/skill-compile-handoff.test.mjs` +- `tests/skills-model.test.mjs` +- `tests/skills-view.test.mjs` + +**Validation basis:** packet postimages reconcile exactly after accounting for later accepted overlays. The latest JavaScript source evidence is `npm run build:check` with 646 tests plus syntax/visual/vision checks; NEXT-02a and NEXT-02b independently passed 68 and 55 focused tests. Unchanged NQ-1 source retains its dated pinned offline desktop evidence (739 passed, 4 ignored, format/Clippy/build), four qualification-feature tests, custom-target offline build and Python 50 focused/114 aggregate tests. These are reused evidence, not new native GUI runs. Final document/shape/whitespace checks and fresh aggregate read-only review are recorded before publication; terminal commit/remote-ref proof is retained in local evidence and Git history. + +**Security/standards and open gates:** synthetic source/fixtures only; no normal data/keys/vault, provider/remote/cloud operation, LNSAT/VUSL edit, dependency fetch or executable distribution. Native/rendered qualification remains unassessed in this session because no UI controller is exposed. Windows/Proxmox is deferred; source CI is not three-OS GUI or key-custody proof. Existing plaintext export/host-compromise limitations remain. This branch publication claims no ISO/OpenSSF certification, security guarantee or production readiness. + +## NEXT-02b exact saved-result continuation — November 1, 2026 + +Authority: Jeff's “proceed” after NEXT-02a; [accepted intent](intent.md#next-02b-exact-saved-result-continuation--november-1-2026) owns thirteen paths, including a new presentation-only handoff module and its tests. Root owns integration. Baseline: branch `codex/native-workflow-qualification-20261030`, HEAD `929873aa18521bebab911b410cf4705542b85b80`; all twenty-three prior dirty paths preserved. Preimages, task-only patch and local validation/review receipt: `/rangoon-result-continuity-20261101`. + +**Experience:** opening a saved Compose output now reads its exact saved revision before moving to Skills. This keeps the saved result selected when its current head has advanced. Successful matching readback targets the editor heading; a failure stays in Compose with a recovery message. Busy states disable repeated result actions. Same-skill unsaved edits block opening; unrelated drafts remain. Existing routes, layout and explicit save/review/compile/export actions remain. + +**Technical:** buttons carry capability plus revision IDs; the handoff requires membership in the current validated composition receipt and uses the existing `open_capability` command. Skills open gains an optional caller guard and a Boolean completion result, preserving existing default callers. Guard checks before dispatch and retention supplement existing request/workspace generation checks. Receipt invalidation, navigation and Lock cannot retain late content or trigger result navigation. Focus uses a matching selected capability, revision and viewed revision. This is UI orchestration; native Rust remains responsible for saved-reference validation and transactions. + +**Validation:** `node --test tests/skills-model.test.mjs tests/composition-view.test.mjs tests/composition-skill-handoff.test.mjs`: **55 passed**. `npm run build:check`: syntax, visual/vision contracts and **646 JavaScript tests passed**. Coverage includes advanced current head versus exact historical result, draft preservation, invalid/missing/substituted references, native failure, late route/receipt/Lock replies, pre-dispatch reentry, repeated/disposed clicks and exact focus selection. One initial new view assertion failed because its fixture lacked a saved draft; the fixture was corrected and all focused/full checks rerun. `node scripts/validate-review.mjs` passed (640 authored text files, 8 image hashes); intent/plan/visual-spec shapes, six incremental links/anchors, whitespace and exact prior-work/new-path preservation passed. + +**Independent review:** fresh read-only `gpt_reviewer` returned **PASS, no actionable P1/P2/P3**, independently reran all 55 focused tests and verified exact patch membership/reverse integrity. Installed OpenAI role configuration pins `gpt-5.6-terra` at xhigh; its serving identifier is not exposed. Producer: root/Codex, OpenAI `gpt-6.1-sol` per active session configuration. Root owns final integration judgment. No GLM invocation was needed. Source review does not qualify rendered/native operation. + +**Security/standards impact:** no new native permission, persistence/schema, key/credential handling, dependency or network/build privilege. Saved local content crosses only existing native read and renderer lifecycle boundaries. Guard/identity tests contribute secure-development evidence; no ISO/OpenSSF, OS or release qualification is claimed. No normal files/keys/vault, engine/provider/cloud/remote operation, LNSAT/VUSL edit or dependency fetch occurred. + +**Open gates:** no computer-use UI controller is exposed. Actual keyboard/pointer, viewport/theme/reduced-motion rendering and the disposable encrypted native end-to-end journey remain **unassessed**. NEXT-02 source continuity is improved; the full visual/native packet is not complete. Windows/Proxmox remains deferred. No commit/push/merge/deploy or release. + +## NEXT-02a saved-revision Compose handoff — November 1, 2026 + +Authority: Jeff's next-phase “proceed”; [accepted intent](intent.md#next-02a-saved-revision-compose-handoff--november-1-2026) owns the thirteen-path packet. Baseline: branch `codex/native-workflow-qualification-20261030`, HEAD `929873aa18521bebab911b410cf4705542b85b80`; sixteen existing dirty paths preserved. Exact preimages and task delta: `/rangoon-compose-continuity-20261101`. + +**Experience:** Skills adds **Add to Compose** beside Compile. The selected saved revision is read through the existing native command before navigation to Compose. Historical selections stay exact; other skill drafts and selected Compose inputs remain. An open Compose draft, busy operation, duplicate pin or full sixteen-input selection offers a reason and a link to continue existing work. Existing styles, route, heading focus and explicit draft/preview/save steps remain. No graphics or layout rewrite is included. + +**Technical:** reuse saved-revision eligibility and `open_capability`; guard before dispatch and before retaining a reply. Route, selected-skill/revision, edits, conflict, busy state and workspace Lock invalidate stale handoffs. Cancellation releases only the initiating operation's pending state; Lock generation checks prevent content resurrection. The renderer provides navigation hints; Rust still resolves stored references and validates composition preview/commit transactions. No authoritative saveability, provider permission or execution is added. + +**Source validation:** focused `node --test tests/skills-view.test.mjs tests/composition-model.test.mjs tests/composition-view.test.mjs tests/skill-compile-handoff.test.mjs`: **68 passed**. `npm run build:check`: syntax, visual/vision contracts and **636 JavaScript tests passed**. New cases cover exact historical reads, prior inputs, same/unrelated drafts, draft/capacity/duplicate/unavailable/busy gates, malformed/substituted/failed replies, stale route/selection/edit/Lock and reentrant cancellation. `node scripts/validate-review.mjs` passed (638 authored text files, 8 image hashes); intent/plan/visual-spec artifact validation, six incremental links/anchors, whitespace, exact outside-owned dirty-file hashes and untracked preservation passed. A shell summary initially used zsh's reserved `status` variable after tests finished; the test log independently reports all 68 passing. No source failure was hidden by that wrapper error. + +**Independent review:** fresh read-only `gpt_reviewer` returned **PASS, no actionable P1/P2/P3** and independently reran the 68 focused tests. Installed OpenAI role configuration pins `gpt-5.6-terra` at xhigh; the serving model identifier is not exposed. Producer: root/Codex, OpenAI `gpt-6.1-sol` per active session configuration. Root retains integration judgment. Source review does not close the rendered/native gate. No GLM invocation was needed for this bounded packet. + +**Security/standards impact:** no new data category, dependency, native permission, database/schema, filesystem access, credential, network or build privilege. Saved content remains within the existing local workspace and renderer lifecycle; plaintext export and host-compromise limitations are unchanged. Exact identity/Lock tests support existing secure-development evidence; they establish no ISO/OpenSSF certification, maturity or release qualification. + +**Open gates:** actual keyboard/pointer, viewport/theme/reduced-motion and native encrypted workflow checks remain **unassessed**: no UI controller is exposed in this session. Source tests do not prove rendered behavior or native personal-data safety. Matching composition-result focus is a later NEXT-02 subpacket. NEXT-01 native qualification remains first before normal files/keys. No normal data/keys/vault, provider/cloud/remote operation, LNSAT/VUSL change, dependency fetch, commit/push/merge/deploy or release occurred. + +## Direction reconciliation — November 1, 2026 + +Authority: Jeff requests canonical drafting/development updates and preparation of the next phases after the reviewed workflow/enterprise direction. The [accepted intent](intent.md#direction-reconciliation-and-next-phase-preparation--november-1-2026) names exactly eleven documents. Root owns architecture/security/integration; a bounded documentation worker owns product experience and visual-system prose. Baseline: `codex/native-workflow-qualification-20261030`, HEAD `929873aa18521bebab911b410cf4705542b85b80`, with nine pre-existing NQ-1 authored changes preserved. Preimages, exact task delta and validation/preservation receipts live at `/rangoon-doc-direction-20261101`. + +**Experience:** project/target task continuity, original library/work area/inspector hierarchy, radials/bars, local logos/icons and refined abstract artwork remain linked acceptance requirements. The docs define truthful metric partitions, table/graph drill-down, credential references, scoped bulk review and complete real/empty/stale/partial/denied/error/recovery states. Required dark/light/narrow checks remain, with representative desktop/4K logical-scale profiles. These are mechanics and proposed acceptance, not a rendered implementation claim. + +**Technical:** canonical architecture now states source/projection identity, tenant/actor scope across all copies, authoritative cell assignment/epochs, target-qualified fence/CAS/idempotency or explicit weaker coverage, unknown-effect reconciliation, old-worker/credential migration limits, and coordinated recovery. Local versus hosted keys and provider credentials remain separate. Cloud KMS/BYOK/federation, shared tenant services, remote peers, dispatcher and scale remain unimplemented. Existing VUSL ownership, independent authority engines, two-qualified-adapter SDK gate and local release path are preserved. The [ordered packet queue](plan.md#next-phase-packets--november-1-2026) gives owners, candidate source boundaries and validators without accepting those implementations. + +**Security and standards impact:** no new data collection, credential/key operation, runtime authority, dependency, schema, asset or build privilege. The update clarifies proposed identity/storage/evidence/key lifecycle controls under existing ISO/OpenSSF development requirements; it adds no certification, maturity, throughput or platform-support claim and changes no standards pin. Internal strategic reasoning and private review paths are not published as product claims. Native, cloud, provider, normal-data and release gates remain separate. + +**Validation:** document/reference checks pass over 638 authored text files and eight image hashes; all 45 new/changed local links and heading anchors pass. Intent, plan and visual-spec artifact validators and whitespace pass. Exact outside-owned diff and untracked-path preservation pass against task preimages. Initial independent review identified a candidate-scope gap; the plan now lists verified existing paths, explicitly proposed new files and named validators for all eight packets. Fresh independent read-only recheck returns PASS with no actionable P1/P2/P3 findings. It verifies all eleven document postimages, 50 unique existing candidate paths, 18 explicitly absent/proposed paths, clean whitespace and the preserved five outside-owned NQ-1 files. Producer: OpenAI GPT-6.1 Sol; documentation worker: `gpt_docs`, configured OpenAI GPT-5.6 Luna; reviewer: `gpt_reviewer`, configured OpenAI GPT-5.6 Terra (worker/reviewer serving IDs are not exposed). Final metadata/reference/preservation checks close this documentation task; they do not qualify any future source packet. No source/runtime/rendered/load tests are run by this docs-only packet; earlier NQ-1 counts below remain dated evidence, not revalidation. No commit/push/merge/deploy/release or external operation. +## NQ-1 disposable folder qualification preparation — October 30, 2026 + +Authority: Jeff asks to keep working on the next local application phases while postponing Windows/Proxmox testing until the new host is ready. Root owns the exact nine paths named in [intent](intent.md#nq-1-disposable-folder-qualification-preparation--october-30-2026). Baseline is published main `929873aa18521bebab911b410cf4705542b85b80` on isolated branch `codex/native-workflow-qualification-20261030`; the original dirty application and website worktrees are outside this packet. + +**Experience:** the isolated test artifact can now reach the same explicit folder-metadata and multi-file inspection pickers as the existing local workbench. The [manual checklist](reviewer-guide.md#disposable-native-workflow-checklist) separates metadata browsing, explicit content selection, saved revisions and exported files. It requires cancellation, Lock-purge, restart and recovery observations before personal-use qualification. Product layout and normal command behavior are unchanged. + +**Technical:** the exact-match Rust/config permission pair gains only the two existing read-only picker grants. Disposable manifest `rangoon.e1c4.run.v3` adds a fixed `folderFixture` directory identity; native validation rechecks it with all existing case roots. Parent artifact metadata records the fixture's exact no-follow directory/file identities, byte lengths and SHA-256 values. Before and after each phase the runner verifies private permissions, entry sets, retained-handle identity and fixed content, refusing links, hardlinks, nonregular entries, replacements and mutations. The output includes fixture location and a separate `folderFixtureVerified` result; `folderUiVerdict` remains unassessed. A fresh artifact/run is mandatory. The unchanged 46-case plan and product persistence/schema/contracts retain their behavior. + +**Security and standards impact:** only literal synthetic Markdown and ignored test files are created in the nonce-scoped private run. No input file text enters receipts; only fixed names, identities, lengths and hashes do. This prepares reproducible validation evidence under existing ISO/OpenSSF development requirements; it establishes no compliance, encryption qualification or authorization. SHA-256 fixture checks detect changed test inputs and do not authenticate a hostile host. No dependency, product permission, provider, credential or execution boundary changes. Real OS custody and GUI observations remain separate. Normal data/keys/vault, live systems, LNSAT/VUSL edits, dependency fetches and publication/release stay closed. + +**Validation:** pinned Rust 1.99.1 passes four qualification-feature unit tests and builds the actual custom native target offline without launching it. The default desktop checker passes formatting, 739 tests (including one isolated child; four ignored), all-target warnings-denied Clippy and build. JavaScript syntax/vision/visual checks and all 628 tests pass, as do documentation, intent and whitespace checks. Python validation passes 50 focused harness tests and all 114 harness tests, including real parent init/manifest generation and mocked-child runner preflight/postphase/receipt checks. Independent review identified stale validation wording (P2) and missing runner-level coverage (P3); both are corrected, and fresh independent read-only review returns PASS with no actionable P1/P2/P3 findings. The custom qualification target retains non-fatal unused test-helper warnings; default desktop Clippy remains clean. Logs and review evidence are local at `/rangoon-nq1-20261030`. No native GUI was launched. Fresh CUA startup fails on the configured symlinked writable root before any app opens. A passing source/build result must not clear that native qualification gap. + ## Full application source publication — October 29, 2026 ### Windows lint completion during PR 55 diff --git a/docs/encrypted-workspace.md b/docs/encrypted-workspace.md index 4e8b4e4..61bcb50 100644 --- a/docs/encrypted-workspace.md +++ b/docs/encrypted-workspace.md @@ -5,6 +5,20 @@ Authority: the accepted local-first V1 objective and Jeff's October 7 request to Current source checkpoint: E1d-2 below adds native encrypted recovery to the accepted E1c-5c native/renderer path. The latter is now mounted with the existing encrypted feature selected by default and no Legacy fallback in an explicit no-backend build. [The mounting receipt](development.md#e1c-5c-encrypted-default-native-and-renderer-mounting--october-19-2026) owns exact source, tests, independent review and remaining native/platform qualification. Earlier proposed/unmounted descriptions below preserve their design baseline; they do not establish current release or normal-data migration status. +## Enterprise key and credential lifecycle — November 1, 2026 + +Status: planning direction only. Current local workspace/provider-secret custody and dated recovery evidence below retain their exact limits; no hosted tenant KMS, BYOK, federation, escrow, rotation service or distributed anti-rollback implementation is added. [Enterprise architecture](application-architecture.md#enterprise-operation-and-custody-boundaries--november-1-2026) owns deployment/identity context, and [adapter profiles](provider-interoperability.md#enterprise-adapter-and-credential-profiles--november-1-2026) own provider-specific semantics. Cloud custody must never become an implicit fallback key or mandatory unlock dependency for a local workspace. + +Separate local database keys, hosted data-encryption keys (DEKs), wrapping keys (KEKs), workload/device/signing identities, provider secrets and recovery material. A future hosted profile uses vetted encryption with scoped DEKs and an explicitly selected KMS/HSM/secret custodian, preserving ciphertext, wrapped key and immutable provider/key-version/region references and required authenticated context. Nonsecret context can still be sensitive or logged; use appropriately classified opaque IDs, never secrets or instruction content. Ordinary workbench views/plugins receive references rather than keys; an explicitly bounded secret-entry surface retains its own custody. Authorized decrypting processes necessarily handle plaintext, so BYOK/CMEK is not provider-blind processing. A client-only/self-hosted privacy profile has different search/support limitations. + +Rotation does not automatically re-encrypt old objects or retire their keys. Track dependencies across backups, journals, indexes, replicas and in-flight jobs; distinguish rewrap, DEK replacement and content re-encryption. Require a fresh restore rehearsal before retiring a needed version. Destruction requires appropriate separated duties, retention/legal-hold checks, pending/delay state and audit; retained copies, exports, cached DEKs and plaintext already delivered limit crypto-erasure claims. Never regenerate a lost key to conceal failed recovery. + +KMS/vault disable, outage, throttling, unavailable history and wrong context are explicit failure states. DEK/token caches need tenant/scope binding, bounded lifetime, purge/renewal and documented revocation limits; no indefinite extension or plaintext/cross-region fallback. IdP deprovisioning, session revocation, provider permission change and issued-token expiry are distinct. Close new Rangoon admission when known required authority is unavailable; provider-effective revocation can lag and must be verified or shown unknown. Cell/tenant moves must account for old valid credentials, cache access and already accepted effects; see the architecture's ownership transition rather than infer safety from TTL alone. + +Before any enterprise key profile, test wrong tenant/context/key/version, partial rotation, old-backup restore, key loss/disable, cache hot/cold, provider denial/throttle, retention/destruction conflicts and coordinated disaster restore with dispatch paused. Encryption/confidentiality alone does not prove freshness, complete deletion, authorization or protection from a compromised unlocked host. This direction preserves existing crypto dependencies and standards pins; new key/secret providers need separately reviewed source and disposable operational qualification. + +Design references checked November 1, 2026: [NIST SP 800-57 Part 1 Rev. 5](https://csrc.nist.gov/pubs/sp/800/57/pt1/r5/final) for key lifecycle, [AWS IAM guidance](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html) for temporary workload credentials, [RFC 9700](https://www.rfc-editor.org/info/rfc9700/) for audience/credential defenses, [Google Cloud rotation](https://docs.cloud.google.com/kms/docs/key-rotation) for historical-key dependencies and [Azure managed identity guidance](https://learn.microsoft.com/en-us/azure/active-directory/managed-identities-azure-resources/managed-identity-best-practice-recommendations) for permission-cache delays. These references inform proposed provider profiles and do not change the repository's standards pins, supported integrations or compliance status. + ## E1d-2 native SQLCipher recovery copy — October 25, 2026 Status: implemented source and selected disposable macOS native recovery evidence recorded under Jeff's explicit request. The [development receipt](development.md#e1d-2-native-encrypted-recovery--october-25-2026) owns validators and independent-review status. Dependency promotion is resolved by reusing the existing pinned SQLCipher backend. The unpublished age experiment is now standalone historical source outside active builds. No compatibility reader/converter is promised for it. No new cipher, KDF, helper process or runtime crypto dependency is introduced. diff --git a/docs/intent.md b/docs/intent.md index 93d1e75..e6b99b3 100644 --- a/docs/intent.md +++ b/docs/intent.md @@ -4,8 +4,124 @@ Status: accepted Authority: Jeff's dated explicit directions and the source-publication scope below; native operation and release retain their separate gates Owner: Jeff -Accepted by: Jeff; October 29 full application source publication to GitHub main only -Last updated: 2026-10-29 +Accepted by: Jeff; November 1 documentation reconciliation and next-phase preparation; earlier publication authority remains scoped below +Last updated: 2026-11-03 +## November 3 reviewed workbench publication + +Status: accepted source publication and main merge. Authority: Jeff's current “commit merge” instruction supersedes earlier publication holds for the exact reviewed workbench snapshot only. Publish the forty-one reviewed UI/source-test/document paths plus three validation-only paths together with prior branch-only prerequisite `bea3328227c9f2f130a1f9ab38649236c68714ad` onto public `hypler-dev/rangoon` main, initially pinned at `929873aa18521bebab911b410cf4705542b85b80`. The complete main-relative candidate contains sixty-one paths; exact path inventory and preimages are retained in `/rangoon-ui-main-publication-20261103`. Publication-only edits own `README.md` and `docs/{intent,continue,development}.md`; no additional feature implementation is opened. + +Scope: exact saved-revision continuation from Skills/Compose to Compile, bounded draft-preservation and handoff behavior, disposable folder-qualification preparation, task-oriented responsive UI, semantic color icons and packaged vendor marks, Recipe/Graph output navigation and synthetic recovery/scale tests. Preserve native commit/permission/persistence boundaries and all ordinary data/keys/vault, provider and remote-system restrictions. Disposable qualification configuration and manifest-v3 tests do not qualify native tasks. No source cleanup deletions from the damaged old temporary checkout belong to this publication. Website, other application branches, LNSAT and VUSL remain untouched. + +Acceptance: exact staged main-relative diff and current README; fresh independent read-only aggregate review; source, documentation, toolchain-configuration and focused Python qualification validators; non-force public branch push; PR with exact head/base, three-OS source CI, review/thread/protection checks and head-bound normal merge. Any failure remains open and must not be bypassed with admin or force. Installed native GUI, real files/keys, browser native-select/Lock-pointer input, native encrypted workflow and package release retain their separate gates. User authorization covers this source push/main merge, not deploy or release. External GitHub PR/CI and final publication receipt record actual commit/merge state. + +Aggregate review finding P2 requires one validation-only extension before publication: `scripts/ui-composition-handoff-fixture.mjs`, `scripts/qa-skills-interaction.mjs`, `tests/composition-skill-handoff.test.mjs` and the already-owned browser driver. Add opt-in synthetic saved-result envelopes and actual app replay for exact pin/route/focus, dirty/busy denial and late navigation/Lock replies. No production source behavior changes are opened; default synthetic preview/save refusal stays unchanged. Headless QA uses software GPU rendering and unloads its owned page before shutdown; browser security flags, network policy, profile isolation and product rendering remain unchanged. Hardware/native UI qualification is separate. Fixture success is memory-only and explicitly not native persistence or qualification. Reseal and independently review the updated candidate before publication. + +## UI-C8 Recipe/Graph inspector and edge cases — November 3, 2026 + +Status: accepted bounded UI continuation. Authority: Jeff requests Recipe/Graph inspector refinement and long-title, many-output and recovery-state testing. Root owns `preview/{composition-view.mjs,composition.css}`, `tests/composition-view.test.mjs`, `scripts/{qa-ui-render,ui-composition-fixtures}.mjs`, `README.md`, and `docs/{intent,continue,development,product-experience,visual-system}.md`. Preserve forty existing pending paths. Refine inspector with bounded output navigation, exact selected-output context, output/piece/unresolved-declaration counts and clear retained-draft recovery copy. Output navigation changes only view/focus/selection; it performs no domain mutation, preview, save, assignment or provider operation. Preserve existing action IDs, predicates, draft/form cache, exact pins and disclosures. Keep diagnostics, conflicts and acknowledgement visible. Navigation across outputs must retain unapplied fields. Avoid clipping long titles, fields and graph cards; maintain focus and 44px targets in both themes. + +Acceptance: focused source/view regressions including sixteen outputs and escaped long titles, unchanged save gates under failed/stale/busy/unresolved fixtures, actual responsive Recipe/Graph renders and navigation/form-retention checks with inert fixtures plus existing full synthetic interaction replay, full source/doc/intent/whitespace validation and fresh independent read-only source/rendered review. Inert display fixtures never establish native acceptance or executable contracts. No normal data/keys/vault, native build/operation, providers, dependency fetch, LNSAT/VUSL edits, publication or release. Root restored source testing into a fresh local-only clone at the prior HEAD after old temporary files lost Git metadata and 717 tracked paths; all forty pending postimages were hash-verified before copying. Preserve old checkout and other repositories; do not publish cleanup-related deletions. + +## UI-C7 Compose task hierarchy — November 2, 2026 + +Status: accepted bounded UI continuation. Authority: Jeff accepts the next UI priorities. Root owns `preview/{composition-view.mjs,composition.css}`, `tests/composition-view.test.mjs`, `scripts/qa-ui-render.mjs`, `README.md`, and `docs/{intent,continue,development,product-experience,visual-system}.md`. Preserve all pending work. Group existing editor views, edit history, layout and discard controls; add a compact static Select → Arrange → Preview → Save guide without fake progress/completion. Keep existing button names, IDs, predicates, pins, keyboard actions and native workflows. Show saved-result text only when returned results exist. Move only repeated explanatory copy into existing inspector selection details; keep diagnostics, reasons, annotations, preview status and explicit acknowledgement visible. Tighten spacing while preserving 44px controls, wrapping, focus, reduced motion and forced colors. Add no framework or dependency. + +Acceptance: focused Compose state/view tests, complete source build, synthetic responsive dark/light renders at 320/768/1440 including an actual local draft, view switching and preview-refusal checks, document/intent/whitespace validation, preservation hashes and fresh independent read-only source/rendered review. No normal files/keys/vault, native build/operation, provider calls, LNSAT/VUSL edits, dependency fetch, publication or release. This UI-only slice does not qualify storage, engine integration or native tasks. Rollback uses exact private preimages without reverting previous UI work. + +## UI-C6 architecture-aware UI qualification — November 2, 2026 + +Status: accepted bounded continuation. Authority: Jeff asks to continue UI improvements and fixes. Root owns `scripts/{qa-ui-render,ui-qa-launch}.mjs`, `preview/composition-view.mjs`, `tests/{ui-qa-launch,composition-view}.test.mjs`, `README.md`, and `docs/{intent,continue,development}.md`. Preserve existing pending work. Prefer the installed default Chrome ARM slice on an ARM-capable macOS host, including an x64 Node process under Rosetta; retain direct launch on other hosts and explicit browser overrides. Detect host capability using a bounded, fixed system command, never a shell. Record launch selection and fail honestly on detection or launch errors; do not install, update or change browser security flags/profile/environment. Add deterministic selection tests and replay the existing synthetic UI sequence. Add concise Compose selection-count guidance beside Start draft, linked with aria-describedby, covering empty/partial/valid/over-limit selections without changing existing action gates, pins, labels or operations. Keep locked-draft messaging unchanged. Review observed UX defects before further product changes. + +Acceptance: focused launcher tests, full source build, document/whitespace validators, actual responsive synthetic interaction replay and fresh independent read-only review. Preserve pending input/native gates and failed receipts. No normal data/keys/vault, native app operation/build, providers, LNSAT/VUSL edits, dependency fetch, publication or release. This task improves validation tooling and does not establish native or production readiness. + +## UI-C5 Compile control placement — November 2, 2026 + +Status: accepted bounded UI continuation. Authority: Jeff says to keep going after the full-color work. Root owns `preview/{compilation-view.mjs,workbench-shell.css}`, `tests/compilation-view.test.mjs`, `README.md`, and `docs/{intent,continue,development,product-experience,visual-system}.md`. Preserve all prior work. Move the existing format/action block above the long saved-library/history lists within the selection panel, show an escaped selected-revision title or a clear selection prompt, and keep stale-selection recovery beside actions. Preserve IDs, labels, exact pins, disabled predicates, warnings, native behavior and color artwork. No automatic compile/export/navigation. + +Acceptance: focused view tests and full source build checks; bounded synthetic dark/light Compile renders at 320/768/1440 if browser control permits; fresh independent source/rendered review. Failed browser control remains an open gate, never a PASS. No normal data/keys/vault, native build/operation, providers, dependency fetch, LNSAT/VUSL changes, publication or release. + +## UI-C4 full-color artwork and software marks — November 2, 2026 + +Status: accepted bounded UI continuation. Authority: Jeff requests more beautiful full-color icons and software logos/icons. Root owns `preview/{icons,icon-gallery,vendor-marks,authority-catalog}.mjs`, `preview/icon-gallery.html`, `preview/{visual-system,workbench-shell}.css`, `preview/assets/vendors/{provenance.json,agentgateway-mark.svg,cerbos-mark.png,permit-mark.svg,invariant-mark.png}`, `scripts/{validate-visuals,qa-ui-render,ui-qa-result}.mjs`, `tests/{vendor-marks,ui-icon-semantics,authority-catalog,ui-qa-result}.test.mjs`, `README.md` and `docs/{intent,continue,development,product-experience,visual-system}.md`. The bounded implementation worker owns only new `preview/color-icon-artwork.mjs` and `tests/color-icon-artwork.test.mjs`; root integrates and validates. Preserve all twenty-one pending paths and unrelated work. + +Replace monochrome-only presentation with original filled, layered color object artwork across the closed 57-icon catalog. Preserve names, four allowed sizes, action labels, routes, disabled predicates and state/authority meanings. Use a bounded local constant geometry catalog, no runtime untrusted SVG, arbitrary paths, framework or dependency. Retain original monochrome geometry as a forced-colors fallback. Color identifies object family and never becomes an approval, enforcement or connection indicator. Do not use a generic colored square behind an unchanged outline as the full-color treatment. + +Acquire only bounded public identity assets from official product sites for agentgateway, Cerbos, Permit and Invariant. This task explicitly permits these asset reads and local packaging, superseding UI-I3's no-new-vendor-asset limit for this scope only. Record exact source URLs, dates, hashes, formats and trademark boundaries. Keep original bytes; validate inert PNG/SVG content and allow only vetted local paths. Permit's internal gradient/clip references may be retained only as closed same-document IDs, never external URLs or scripts; do not widen the app's runtime image/network policy. Apply marks to existing catalog entries without changing compatibility, availability, consent, authorization or execution semantics. Preserve existing Rangoon/Claude/LNSAT/VUSL marks. + +Acceptance: original artwork/input-boundary tests; pinned software-asset hash/format/content checks; relevant existing view/state tests and complete `npm run build:check`; actual dark/light renders at 320/768/1440 and four icon sizes, in-app/gallery/engine-card imagery, software loading, keyboard, reduced motion and forced-colors fallback; fresh independent read-only code/rendered review; document/intent/whitespace and exact path/preimage preservation. Retain the known native-select and native workflow qualification gaps. The observed headless Lock-pointer dispatch gap also remains open; keyboard confirmation may test purge mechanics without claiming pointer qualification. No credentials, normal data/keys/vault, provider calls or installation, native build/operation, LNSAT/VUSL edits, dependency fetch, publication, merge/deploy/release. + +## UI-I3 semantic icons and visual organization — November 2, 2026 + +Status: accepted bounded UI continuation. Authority: Jeff requests another actual inspection, organizational/visual direction, and icons for software, skills, editing, compilation, locking and encrypted states. Root owns `preview/{icons,icon-gallery,skills-view,composition-view,compilation-view,workspace-lock-view,workspace-view,authority-view}.mjs`, `preview/icon-gallery.html`, `preview/workbench-shell.css`, `scripts/{validate-visuals,qa-ui-render}.mjs`, `tests/skills-view.test.mjs`, new `tests/ui-icon-semantics.test.mjs`, `README.md` and `docs/{intent,continue,development,product-experience,visual-system}.md`. Preserve all eleven pending UI-T2/UI-R1 paths. This slice is UI-only; it does not close native workflow or integration gaps. + +Reuse the closed local Foldline SVG catalog and packaged software marks. Add distinct semantic action, data and state glyphs; retain text labels and existing routes/IDs/disabled predicates. Fix unsupported icon sizes instead of widening arbitrary SVG input. Symbols remain decorative, fixed and noninteractive. Keep desktop Lock/theme controls reachable while the route navigation scrolls independently. Storage/lock symbols follow existing validated presentation state and never imply broad safety, authentication or approval. Differentiate encrypted storage from readable exports. Keep official Claude/LNSAT/VUSL/Rangoon marks unmodified; missing brand marks use clearly generic category symbols plus exact software names, never invented logos or support claims. No new remote asset, dynamic SVG, dependency or animation framework. + +Acceptance: scope-appropriate view/security-state tests and source-wide literal icon-name/size checks; `npm run build:check`; rendered 320/768/1440 dark/light on affected core routes, action-label/icon geometry, forced colors/reduced motion and synthetic Lock; inspect gallery and software identities; fresh independent read-only source/rendered review; document/intent/whitespace and preimage preservation. Keep prior native-select qualification gap and synthetic fixture limits explicit. No normal data/keys/vault, native execution/build, providers/cloud/remote, dependency fetch, LNSAT/VUSL edits, publication, merge/deploy/release. + +## UI-T2 task arrangement and interaction audit — November 2, 2026 + +Status: accepted bounded UI continuation. Authority: Jeff asks to improve tool arrangement and test functionality to judge usability. Root owns `preview/{skills-view.mjs,workbench-shell.css,analyze.mjs}`, `tests/skills-view.test.mjs`, `scripts/qa-ui-render.mjs`, `README.md`, and `docs/{intent,continue,development,product-experience,visual-system}.md`. Preserve the nine pending UI-R1 paths and all existing domain/native behavior. The current request defines this bounded task; no new product architecture or contract is introduced. + +Arrange Skills around finding/creating, editing, and using a saved revision. Keep search directly visible; group optional facets under a native disclosure with retained open state, visible active-filter summary and exact counts. Put creation in the library and term help with the inspector. Distinguish edit controls from Compose/Compile continuation, and place existing disabled-action/recovery explanations beside their controls. Preserve all IDs, exact-revision guards, drafts, confirmation, escaping, warnings and authority boundaries. No action occurs merely from opening a panel or navigating. + +Acceptance: relevant Skills/controller/handoff tests, complete `npm run build:check`, actual synthetic pointer/keyboard tests for filters, disclosure retention, draft preservation, failed saves/reviews, continuation, compact navigation, history, conflicts and Lock; 320/768/1440 dark/light plus laptop/desktop emulations, no horizontal overflow and 44px controls; fresh independent design and rendered/code review; document and whitespace/path checks. Record usability hypotheses separately from observed mechanics. Synthetic fixture refusal does not qualify successful native save/review/export or real-user usability. Normal workspace/vault, providers, remote/cloud, LNSAT/VUSL edits, dependencies, native runtime changes, publication, merge/deploy/release remain closed. Any later native rebuild/qualification must bind the new frontend identity. + +## UI-R1 rendered workbench refinement and native rebuild — November 1, 2026 + +Status: accepted bounded UI/build task. Authority: Jeff asks to rebuild the desktop UI and refine its presentation after the source handoff updates. Root owns exactly `preview/workbench-shell.css`, `preview/skills-view.mjs`, new `scripts/qa-ui-render.mjs`, `README.md`, and `docs/{intent,continue,development,product-experience,visual-system}.md`. A bounded read-only UI design review informs implementation; fresh independent UI/code review validates the final delta. Preserve all existing routes, IDs, action gates, drafts, provenance, security disclosures and native contracts. + +Bring Skills revision actions above editable fields, reduce unused editor/header space, improve shared typography/control/surface hierarchy, and retain readable content plus at least 44px touch controls. Preserve the library/editor/inspector baseline, restrained local abstract artwork, dark/light, keyboard, reduced-motion and forced-colors behavior. No new motion framework, dependency, external asset or fake activity/metric. Changes cover the local workbench, not a completed product-wide redesign. + +Render the real frontend/controllers against existing explicitly synthetic loopback fixtures using installed headless Chrome and a disposable profile. The QA runner uses built-in Node/CDP only, loopback servers, blocked non-loopback page traffic, a private browser-profile directory and mock-keychain flags, and no supplied native workspace data or credentials. Chrome retains unchanged host HOME for compatibility and may consult OS metadata. Require the exact expected action set and confirmed browser/server/profile teardown before PASS. Profile flags do not establish an OS filesystem sandbox. Record screenshots, logical dimensions/DPR, overflow, action geometry, console failures and pointer/keyboard continuity; test 320/768/1440 dark/light plus laptop/desktop/4K emulated profiles. Distinguish synthetic browser coverage from native WebView, OS custody and real filesystem behavior. + +Acceptance: focused existing UI/model tests and `npm run build:check`; rendered viewport/theme and relevant draft/handoff/conflict/failure/Lock/reduced-motion/forced-colors cases; document/intent/whitespace checks; fresh independent review. Rebuild the default encrypted native development executable with pinned Rust 1.99.1 and cached locked/offline dependencies after final UI changes. Record binary/artifact identity without launching normal workspace/vault or claiming installed/native workflow qualification. Native test-window operation, normal files/keys/vault, providers/remote/cloud, LNSAT/VUSL, dependency fetch, merge/deploy/release and publication remain outside this task. + +## Source commit and branch push — November 1, 2026 + +Status: accepted publication task. Authority: Jeff explicitly requests “commit and push” after NEXT-02b. Root owns the exact twenty-nine pending authored paths listed in the publication receipt, including README/current records, NQ-1 native test-harness preparation, reconciled direction docs and NEXT-02a/NEXT-02b source/tests. This supersedes those packets’ publication holds for this aggregate delta only. Original application/website worktrees remain untouched. + +Commit the reviewed source snapshot on `codex/native-workflow-qualification-20261030` and push that branch to `hypler-dev/rangoon` without force. Main/base is `929873aa18521bebab911b410cf4705542b85b80`; fetched main matches the source base. README must substantively describe the final source scope and remaining qualification gaps. No merge, desktop package/release, website deployment, live provider/remote/cloud operation, normal user data/keys/vault, LNSAT/VUSL edit or dependency fetch is authorized. Native/rendered and deferred Windows gates remain unchanged. + +Acceptance: exact packet postimage reconciliation; latest matching source-test evidence; document/intent/whitespace/path checks; a fresh independent read-only review of the aggregate publication diff; exact staged path/tree verification before commit; push and remote advertised-ref readback. Reuse unchanged pinned Rust/native and latest JavaScript evidence where postimages match, distinguishing source qualification from GUI operation. [Publication receipt](development.md#source-branch-publication--november-1-2026) owns scope, validation and remaining gates; local evidence retains terminal commit/push identity. + +## NEXT-02b exact saved-result continuation — November 1, 2026 + +Status: accepted bounded source continuation. Authority: Jeff says “proceed” after NEXT-02a source completion. Root owns exactly `preview/{analyze,composition-view,skills-model}.mjs`, new `preview/composition-skill-handoff.mjs`, `tests/{composition-view,skills-model}.test.mjs`, new `tests/composition-skill-handoff.test.mjs`, `README.md` and `docs/{intent,plan,continue,development,product-experience}.md`. Preserve all prior native, direction and NEXT-02a work. Reuse the intent-driven-delivery workflow and existing local native read; no new contract or engine behavior. + +A saved composition result carries capability plus exact revision identity into Skills. Validate membership in the current saved receipt, then validate native readback before navigation and matching editor focus. Missing/malformed/substituted results or read failures keep the user in Compose with a bounded explanation. Same-skill unsaved edits block continuation; unrelated drafts remain. Recheck result identity, route, dirty state and workspace generation before retaining replies. Busy/pending/disposed/Lock and repeated click paths cannot replace a selection, navigate or retain late content. Navigation never saves, reviews, exports or executes. Existing routes, shell and styles remain. + +Acceptance: focused Skills model, composition view and new handoff tests (exact current/history pins, unrelated/same-skill drafts, failed/substituted/malformed results, receipt invalidation, route/Lock/reentrant cancellation, repeated/disposed clicks and exact focus targeting); full `npm run build:check`; document/intent/whitespace and prior-work preservation; fresh independent read-only review. Actual keyboard/pointer, reduced-motion and 320/768/1440 dark/light rendering plus native encrypted workflow remain required and unassessed while no UI controller is exposed. No native command/permission, storage/schema, provider/engine or dependency change; no normal files/keys/vault, network/cloud/remote operation, LNSAT/VUSL edit, publication or release. + +## NEXT-02a saved-revision Compose handoff — November 1, 2026 + +Status: accepted bounded source task. Authority: Jeff says “proceed” after the next-phase documentation. Root owns exactly `preview/{analyze,skills-view,composition-model,skill-compile-handoff}.mjs`, `tests/{skills-view,composition-model,skill-compile-handoff}.test.mjs`, `README.md`, and `docs/{intent,plan,continue,development,product-experience}.md`. Preserve all prior native qualification and direction-documentation changes. + +Add a Skills action that opens the selected saved revision in the existing Compose (merge) workbench through `open_capability`. Reuse saved-revision eligibility. Historical selections remain exact; unsaved same-skill edits block handoff. Retain other drafts and pinned inputs. An open Compose draft, duplicate pin, pending operation, unavailable bridge or full input list blocks adding without resetting work. Navigate only after a validated exact native read; selection, navigation and Lock changes invalidate late results before destination mutation. No latest-revision fallback, automatic draft creation, preview, save, review, export or execution. + +This subpacket does not include matching composition-result focus, new graphics, native commands, storage/schema, provider/engine changes or external-file actions. Acceptance: focused handoff/model/view tests covering exact current/history pins, draft preservation, unavailable/full/duplicate states, failures and stale/Lock/reentrant responses; full `npm run build:check`; documentation/intent/whitespace and outside-scope preservation; fresh independent read-only review. Actual keyboard/pointer and 320/768/1440 dark/light rendered checks remain required and explicitly unassessed if the UI controller is unavailable. Source completion does not qualify native use or normal user data. No normal files/keys/vault, provider/remote/cloud calls, dependency fetch, LNSAT/VUSL edits, publication or release. + +## Direction reconciliation and next-phase preparation — November 1, 2026 + +Status: accepted documentation and planning task. Authority: Jeff requests updating drafting/development documents after the reviewed local/remote/enterprise direction, and explicitly requires the original radials, bars, icons, logos and finished professional visual character. This accepts canonical documentation reconciliation and preparation of bounded packets, not implementation of every proposed service, source packet or cloud operation. + +Root owns exactly `README.md` and `docs/{intent,plan,continue,development,application-architecture,product-experience,visual-system,provider-interoperability,encrypted-workspace,operations-control-plane}.md`. The documentation worker owns only `product-experience.md` and `visual-system.md`; root owns architecture, security, integration and remaining records. Preserve the existing nine-file NQ-1 change set, including its source/test/configuration bytes and reviewer guide; retain historical receipts. Add mechanics and accurate gates without publishing private strategic reasoning or creating competing canonical contracts. + +Accepted planning direction: preserve the local-first Rust core, native custody/transactions, original bytes and immutable revisions. Improve project/target task continuity and complete visual states. Syntax/semantic projections and indexes remain versioned derived data. Future UI/CLI/service adapters reuse typed application use cases; authenticated peer/actor scope and target-side checks remain separate from translation, classification, local review and provider decisions. Enterprise planning includes tenant isolation, authoritative target/cell assignment, qualified effect ownership, scoped credential/key lifecycles, recovery and explicit workload envelopes. VUSL and LNSAT remain independent; Rangoon does not define a replacement VUSL contract or another engine's cluster semantics. + +[Architecture](application-architecture.md#enterprise-operation-and-custody-boundaries--november-1-2026), [experience](product-experience.md), [visual system](visual-system.md), [key custody](encrypted-workspace.md#enterprise-key-and-credential-lifecycle--november-1-2026) and [next packets](plan.md#next-phase-packets--november-1-2026) own their respective mechanics. Packet status remains proposed until its exact scope/ownership/validators and applicable native/external authority are accepted. The existing personal-use and three-OS release path remains; enterprise scope is not a prerequisite for useful local delivery. Windows/Proxmox testing is deferred until the upgraded lab host is ready, with Windows custody/startup/recovery implementation still required. + +Acceptance: document/reference/anchor checks, intent/spec/plan artifact validation, exact outside-scope/preimage preservation, whitespace and fresh independent read-only review. Source/runtime/rendered/load tests are not rerun or claimed by this docs-only packet. No source, schema, dependency, asset, CI/AGENTS policy or standards-pin change; no normal data/keys/vault, cloud/provider/remote operation, LNSAT/VUSL edit, commit/push/merge/deploy or release. The [development receipt](development.md#direction-reconciliation--november-1-2026) owns actual validation and unresolved gates. + +## NQ-1 disposable folder qualification preparation — October 30, 2026 + +Authority: Jeff asks to continue the next local application phases after deferring Windows testing until the upgraded Proxmox host is ready. This bounded task prepares the already accepted BF-2c native picker/Lock rehearsal. It does not accept normal personal data or expand provider, engine or release scope. + +Root owns exactly `scripts/qualify-native-encrypted.py`, `tests/qualify_native_encrypted_test.py`, `apps/desktop/src/native_encrypted_qualification.rs`, `apps/desktop/native-encrypted-qualification/tauri.conf.json`, `README.md`, and `docs/{intent,continue,development,reviewer-guide}.md`. Add the existing folder-metadata and explicit multi-file inspection grants to both isolated permission lists. Create a fixed synthetic folder in each new nonce run; bind its directory identity in a new disposable manifest version and its exact file/directory inventory in the artifact record. Refuse changed contents, replaced entries, links or unexpected children before/after a phase. Old disposable runs must be recreated; this is not a product storage or compatibility change. + +Reuse the current native commands and case plan. Keep metadata browsing separate from file inspection and save. Record fixture integrity separately from manual UI observations; a valid fixture or clean process exit never proves folder selection, Lock purge or the complete workflow. Native GUI proof requires a fresh artifact and exclusive, working UI control. Current Codex UI startup is blocked by the configured symlinked writable root; do not change Codex configuration or start a vault-backed GUI without a reliable controller. + +Acceptance: focused Python harness tests including fixture mutation/replacement/link/unexpected-child negatives, pinned Rust formatting and native qualification-target compilation/tests, existing desktop source checks as affected, document/intent/whitespace checks, and fresh independent read-only review. Retain the existing timeout, event/output bounds, isolated credentials and exact cleanup. Windows/Proxmox work remains deferred; normal data/keys/vault, real providers/remote systems, LNSAT/VUSL changes, dependency fetches and publication/release remain outside this task. The development ledger owns actual results and the reviewer guide owns the manual workflow checklist. + ## Full application source publication — October 29, 2026 Status: accepted. Authority: Jeff requested “push and deploy,” clarified “Update GitHub main only,” then expanded the scope to “we should push all of it.” This accepts publication of the complete authored Rangoon application snapshot, not only CW-1. It supersedes earlier packet-level publication holds for this snapshot; their implementation, native-operation and release limits remain historical and current evidence where applicable. diff --git a/docs/operations-control-plane.md b/docs/operations-control-plane.md index e9de96b..2d4b053 100644 --- a/docs/operations-control-plane.md +++ b/docs/operations-control-plane.md @@ -4,6 +4,18 @@ Authority: Jeff's accepted October 7 continuation in [intent.md](intent.md). Can Status: accepted product direction and proposed implementation contract. This document adds no runtime approvals, grants, policy evaluator, telemetry ingestion, live subscriptions, execution adapter or authority engine. Current `rangoon-engine` remains unavailable. The W3 editor authors inert definitions and checkpoints; its saved `validated` intent is structural inspection, not an execution approval. +## Enterprise operator and visual state — November 1, 2026 + +Planning refinement, not mounted service behavior. Reuse the [enterprise ownership contract](application-architecture.md#enterprise-operation-and-custody-boundaries--november-1-2026), [product experience](product-experience.md), [visual system](visual-system.md) and existing lifecycle/coverage records below. The original command-center character remains: compact metric strip, radials/bars, system logos/icons, table/work area and inspector. Finish success and loading/empty/stale/partial/denied/error/unknown/recovery views together; data provenance and functional tests remain necessary. + +Keep organization/workspace context concise; expose project/environment/region/target at the action. Existing local routes do not pretend to have a mounted fleet. A draft retains its original scope/revision when context changes; pending action eligibility and late results are fenced, while unrelated work is preserved. Systems tables, topology, charts, approvals and exports share the same authorized scope and selected target. Simple/Advanced changes density, never permission. Autocomplete, aggregates and support views must not leak protected names/counts. + +Bulk review freezes exact target IDs/incarnations, membership/exclusions, expected prior state, artifact, adapter/policy versions, evidence freshness and expiry. Filters or autoscaling do not silently add targets after approval. Show requester, distinct approver/delegation duties and remaining stages without making approval equivalent to target authorization. Compare desired/installed/effective revisions independently; a receipt/ACK or green connection is not effective configuration. Promotion requires qualified fresh readback and a denominator; partial/unknown targets stay visible. Rollback is a new explicit operation with its own failure/authorization limits. + +Metric cards carry label, exact units/counts, scope, source/watermark and state. Radial segments form declared disjoint buckets; unknown is not a green remainder. Bars show outcomes, latency/window/sample treatment, queue pressure or actual/reserved/estimated/unknown cost with a numeric/table alternative. Drill-down opens the same filtered table/inspector. Credentials/keys show reference, owner, allowed operation, expiry, verification and rotation/recovery state, never ordinary secret values. Packaged LNSAT/VUSL/provider logos identify modules without granting support or authority. No fake progress, compliance percentage or animated traffic is introduced by this direction. + +Before service/fleet claims, qualify actor/tenant/scope changes, target-set drift, revoked/expired delegates, old-cell callbacks, stale/wrong-profile observations, unreachable hosts, queue pressure and uncertain effects. Emergency requests require incident/target/time/scope binding and the applicable provider controls; they are not bypass switches. Source/static charts and synthetic events do not prove those native/remote outcomes. + ## Product outcome An operator can answer who requested an action, what exact action and resources were covered, which rules and versions applied, who could approve, who approved or denied, which authority issued a bounded authorization, where enforcement occurred and what outcome evidence exists. Each answer retains its source, time and verification state. Missing evidence and unknown effects remain visible. These are essential free-product safety and inspection surfaces; enterprise hosting adds organizational administration and scale rather than permission bypasses. diff --git a/docs/plan.md b/docs/plan.md index def8625..dad655b 100644 --- a/docs/plan.md +++ b/docs/plan.md @@ -4,9 +4,54 @@ Status: proposed Authority: [intent.md](intent.md), including accepted provider-independent, internal operations-first and personal-completion continuations Owner: Jeff -Last updated: 2026-10-25 +Last updated: 2026-11-01 +## Next-phase packets — November 1, 2026 + +Authority: [accepted documentation/planning direction](intent.md#direction-reconciliation-and-next-phase-preparation--november-1-2026). The table is the current preparation queue and supersedes earlier statements of the immediate next task; it preserves their historical scope and completed evidence. These are proposed implementation/qualification packets, not blanket source, native or external-operation acceptance. Freeze each final file list, interfaces, preimages, rollback and named validators before implementation. Reuse existing application, parser, store, history, coverage and SDK records rather than duplicate them. + +| Order / packet | Outcome and initial ownership | Acceptance before advancing | +| --- | --- | --- | +| NEXT-01 — native local journey | Root owns validation of the existing isolated target: `scripts/qualify-native-encrypted.py`, its Python tests, `apps/desktop/src/native_encrypted_qualification.rs` and isolated Tauri configuration. NQ-1 preparation is implemented; this packet supplies actual artifact-bound picker/Lock and source → skill → compose → compile/export → restart/recovery evidence. | Restore reliable exclusive UI control first; create a fresh v3 run, select only synthetic fixtures, prove cancel/late-result purge and recovery into a fresh encrypted workspace. Use the [manual checklist](reviewer-guide.md#disposable-native-workflow-checklist). Source tests/fixture integrity do not count as native proof. Defects need a separately bounded correction; normal data remains closed. | +| NEXT-02 — connected, finished local task | Root owns exact revision/source context and integration; one UI writer may own the accepted subset of `preview/{analyze,skills-view,composition-model,composition-view}.mjs` and their existing tests. Carry a saved skill into Compose as precisely as Compile; focus the matching saved result only after successful native read; preserve drafts, context and failures. | Tests: `tests/{skills-model,skills-view,composition-model,composition-view,compilation-model,compilation-view}.test.mjs`; full `npm run build:check`; actual keyboard/pointer/draft/conflict/Lock/late-result views in dark/light. Retain existing routes and native commands. Refine real local metrics/controls and complete empty/error/recovery states; enterprise charts need real sources before live claims. | +| NEXT-03 — retained folder-row inspection | Root owns file/IPC/lifecycle design; candidate modules are `crates/rangoon-host/src/source_inventory.rs`, native `source_collection`/`workspace_source_access`, registration/capability files and Agent files model/view tests. Freeze exact files and opaque reference contract before source. | Explicit content-inspection admission separate from metadata; no renderer path reopening. Root/file replacement, symlink/reparse, stale session, expiry, Lock/drain/cancel and bounded paging tests; pinned host/desktop checks and fresh disposable native proof. Unsupported OS/path profiles remain explicit. | +| NEXT-04 — reversible project-file changes | Root owns AR-3/AR-4 native selected-target custody, encrypted original capture, retained preview, explicit Apply/Restore, readback and durable reconciliation. Reuse [instruction change history](target-loader-qualification.md#instruction-change-archive-and-restore--october-25-2026) and existing store history/recovery. | Exact target/precondition, absent versus empty, concurrent edits, archive/key mismatch, crashes before/after possible effect and fresh-process recovery. Unknown effect cannot be blindly retried. Workspace-record history alone is not project-file undo. Freeze exact native/store/UI files in the source packet. | +| NEXT-05 — one target-loading proof | Root owns one artifact/version-pinned target adapter and disposable task. Reuse compilation/export/inspection and [target qualification](target-loader-qualification.md). | Demonstrate actual loaded/effective instructions, overrides/includes and loss report. Keep byte identity, loaded context, behavioral adherence and enforcement distinct. Installing/running a target, provider/model requests and credentials require their own explicit accepted test scope. | +| NEXT-06 — practical bulk organization | Root owns encrypted project/root catalog and versioned parser/projection/index contracts; bounded workers may own UI/fixtures after acceptance. Keep original bytes authoritative, current parser behavior compatible, indexes rebuildable and native revision lineage exact. | Incremental invalidation by source plus importer/profile/config version; rename/delete/case/Unicode/stale-finding handling; scoped search/tags and complete migration/backup/restore. Benchmark at least 1,000 metadata rows with exact limits. Evaluate a parser replacement only against compatibility/corpus/performance evidence; do not raise archive caps alone. | +| NEXT-07 — one authenticated read-only peer | Root owns RM-2 transport, enrollment, device plus actor identity, host-selected roots, grants and credential custody; one reviewed built-in adapter first. The lab/OS backend must be ready and qualified for its scope. | Two disposable installations, independently verified identities, metadata versus content consent, opaque host references, expiry/revocation/drain, reconnect/freshness/gaps, hostile reports, path profiles and bounded resource/egress tests. Offline RM-1 labels are not live grants. Remote writes remain closed. | +| NEXT-08 — single-region enterprise control | Root owns tenant/application context, current target/cell assignment, durable command/outbox/attempt semantics, effect-side support classes, key/credential lifecycle and operator scope. Prepare separate source packets for one tenant/service, one identity/KMS profile and one qualified effect adapter. | Prove tenant isolation across storage/cache/index/queue/keys; target fence/CAS or explicit weaker coverage; old-worker/credential quiescence; unknown-effect reconciliation; scoped renewal, key rotation/old-backup restore, DR with paused dispatch and overload fairness. Regional cells follow measured load/residency; global active-active effects remain deferred. Public SDK/registry requires two real independently qualified adapters. | + +**NEXT-02a status — November 1:** exact saved-revision Skills → Compose source handoff implemented and source-tested; [receipt](development.md#next-02a-saved-revision-compose-handoff--november-1-2026). Preserves existing drafts/inputs and rejects stale replies before retention. Rendered/native qualification remains open; matching composition-result focus and broader visual refinement remain later subpackets. The umbrella NEXT-02 is not complete. + +**NEXT-02b status — November 1:** saved composition outputs now carry exact revision identity into Skills through native readback, with matching editor-focus selection, draft preservation and stale-result guards. [Receipt](development.md#next-02b-exact-saved-result-continuation--november-1-2026). Source tests pass; actual rendered and encrypted native qualification remain open. NEXT-02 is not fully qualified. + +### Candidate files and named validators + +These paths are a preparation manifest, not a permitted write list. Existing paths were checked during this docs task; **new candidate** paths do not exist and their placement/names remain subject to the accepted source subpacket. Any required workspace/manifests, registration, schema, capability or dependency changes must be named in that final packet. Later umbrella rows must split into small independently reviewed slices. Test commands for new files/packages are proposed and are not runnable until those accepted files exist. Set the pinned toolchain and `CARGO_NET_OFFLINE=true` for Rust commands. + +**NEXT-01** — Existing candidates: `scripts/qualify-native-encrypted.py`, `tests/qualify_native_encrypted_test.py`, `apps/desktop/src/native_encrypted_qualification.rs`, `apps/desktop/native-encrypted-qualification/tauri.conf.json`. **New candidates:** None currently proposed.. Named validation: `python3 -m unittest tests/qualify_native_encrypted_test.py`; pinned offline custom native target build plus the named disposable phases; actual GUI checklist, not only source assertions. + +**NEXT-02** — Existing candidates: `preview/analyze.mjs`, `preview/skills-view.mjs`, `preview/composition-model.mjs`, `preview/composition-view.mjs`, `preview/skill-compile-handoff.mjs`, `tests/skills-view.test.mjs`, `tests/composition-model.test.mjs`, `tests/composition-view.test.mjs`, `tests/skill-compile-handoff.test.mjs`. **New candidates:** None currently proposed.. Named validation: `node --test tests/skills-view.test.mjs tests/composition-model.test.mjs tests/composition-view.test.mjs tests/skill-compile-handoff.test.mjs`; `npm run build:check`; named rendered context/draft/focus/failure/Lock/viewport cases. + +**NEXT-03** — Existing candidates: `crates/rangoon-host/src/source_inventory.rs`, `crates/rangoon-host/src/lib.rs`, `apps/desktop/src/source_collection.rs`, `apps/desktop/src/workspace_source_access.rs`, `apps/desktop/src/workspace_source_access_tests.rs`, `apps/desktop/src/main.rs`, `apps/desktop/build.rs`, `apps/desktop/capabilities/source-analysis.json`, `preview/agent-files-model.mjs`, `preview/agent-files-view.mjs`, `tests/agent-files-model.test.mjs`, `tests/agent-files-view.test.mjs`. **New candidates:** None currently proposed.. Named validation: `cargo test -p rangoon-host --locked --offline`; `node --test tests/agent-files-model.test.mjs tests/agent-files-view.test.mjs`; pinned desktop checks and fresh native row/Lock/cancel/replacement rehearsal. Command/permission names freeze only with the source packet. + +**NEXT-04** — Existing candidates: `crates/rangoon-store/src/instruction_history.rs`, `crates/rangoon-store/src/instruction_history_tests.rs`, `crates/rangoon-store/src/instruction_history_backup.rs`, `apps/desktop/src/workspace_source_access.rs`, `apps/desktop/src/main.rs`, `apps/desktop/build.rs`, `apps/desktop/capabilities/source-analysis.json`. **New candidates:** `apps/desktop/src/instruction_changes.rs`, `apps/desktop/src/instruction_changes_tests.rs`, `preview/instruction-change-model.mjs`, `preview/instruction-change-view.mjs`, `tests/instruction-change.test.mjs`. Named validation: `cargo test -p rangoon-store --locked --offline`; proposed `node --test tests/instruction-change.test.mjs`; pinned desktop checks plus target replacement/conflict/crash/unknown-effect and fresh encrypted restore/readback phases. Split read-only target preparation from effect mounting; do not open every candidate file at once. + +**NEXT-05** — Existing candidates: `crates/rangoon-compile/src/bundle.rs`, `crates/rangoon-host/src/instructions.rs`, `apps/desktop/src/compilation_tests.rs`, `preview/compilation-model.mjs`, `tests/compilation-model.test.mjs`, `tests/compilation-view.test.mjs`, `docs/target-loader-qualification.md`. **New candidates:** `scripts/qualify-target-loader.py`, `tests/qualify_target_loader_test.py`. Named validation: `cargo test -p rangoon-compile -p rangoon-host --locked --offline`; `node --test tests/compilation-model.test.mjs tests/compilation-view.test.mjs`; proposed `python3 -m unittest tests/qualify_target_loader_test.py`; separately accepted installed-target/version loading and denial/readback cases. + +**NEXT-06** — Existing candidates: `crates/rangoon-domain/src/lib.rs`, `crates/rangoon-import/src/lib.rs`, `crates/rangoon-store/src/lib.rs`, `crates/rangoon-host/src/source_inventory.rs`, `preview/agent-files-model.mjs`, `preview/agent-files-view.mjs`, `tests/markdown-review.test.mjs`, `tests/agent-files-model.test.mjs`, `tests/agent-files-view.test.mjs`. **New candidates:** `crates/rangoon-store/src/project_catalog.rs`, `crates/rangoon-store/src/project_catalog_tests.rs`. Named validation: `cargo test -p rangoon-domain -p rangoon-import -p rangoon-host -p rangoon-store --locked --offline`; `node --test tests/markdown-review.test.mjs tests/agent-files-model.test.mjs tests/agent-files-view.test.mjs`; encrypted migration/recovery and >=1,000-row benchmark with stated limits. New parser dependency/backends require separate review. + +**NEXT-07** — Existing candidates: `preview/remote-inventory-model.mjs`, `tests/remote-inventory-model.test.mjs`, `tests/fixtures/remote-inventory.v1.json`, `crates/rangoon-host/src/source_inventory.rs`, `apps/desktop/src/workspace_source_access.rs`. **New candidates:** `crates/rangoon-peer/Cargo.toml`, `crates/rangoon-peer/src/lib.rs`, `crates/rangoon-peer/tests/read_only.rs`. Named validation: `node --test tests/remote-inventory-model.test.mjs`; proposed `cargo test -p rangoon-peer --locked --offline` after reviewed workspace registration; synthetic TLS/identity/grant/egress negatives before separately accepted two-installation lab tests. No credential/transport choice is implied by placeholder paths. + +**NEXT-08** — Existing candidates: `docs/application-architecture.md`, `docs/provider-interoperability.md`, `docs/encrypted-workspace.md`, `docs/operations-control-plane.md`, `crates/rangoon-ops/src/lib.rs`, `crates/rangoon-integrations/src/lib.rs`, `crates/rangoon-store/src/lib.rs`, `apps/desktop/src/workspace_source_access.rs`, `tests/operations-model.test.mjs`, `tests/operations-parity.test.mjs`. **New candidates:** `crates/rangoon-application/Cargo.toml`, `crates/rangoon-application/src/lib.rs`, `crates/rangoon-management/Cargo.toml`, `crates/rangoon-management/src/lib.rs`, `crates/rangoon-management/tests/tenant_ownership.rs`, `crates/rangoon-management/tests/key_lifecycle.rs`. Named validation: Proposed `cargo test -p rangoon-application -p rangoon-management --locked --offline` after accepted manifests; wrong-tenant/old-owner/outbox/replay/key-history/restore/throttle conformance plus real-backend durability and selected cloud-profile qualification. Reuse/extract existing `rangoon-ops`, integration, store and native use-case contracts rather than redefine them in the proposed package names. Run existing `cargo test -p rangoon-ops -p rangoon-integrations --locked --offline` and `node --test tests/operations-model.test.mjs tests/operations-parity.test.mjs` for affected compatibility. Freeze one use case, storage/key profile and exact subpacket first; new package names are placeholders, not an accepted architecture/service/DB/IdP/KMS implementation. + +NEXT-01 gates personal-data use and native qualification claims. Independently accepted source/UI-only preparation may proceed while controller access is blocked; it does not bypass that gate or authorize normal-data/external operation. + +**Validator rails.** Set `CARGO_NET_OFFLINE=true` and pin Rust 1.99.1 through `node scripts/check-source-rust.mjs --toolchain-bin ` or its `--desktop` variant with locked/offline dependencies. Run packet-specific named tests first; broaden only for affected contracts. Document/reference/intent/whitespace checks and fresh independent review apply to each meaningful packet. UI packets retain 320/768/1440 dark/light checks and record representative desktop/actual 4K scale profiles, keyboard, reduced motion and forced colors. Each packet has linked technical and experience outcomes; a passing source test, logo, chart or rendered sample is not runtime/authority/release proof. + +**Scope and release.** Continue local work independently of optional engines/cloud services. Windows/Proxmox testing is deferred until the upgraded host is ready; current Windows custody/startup/recovery needs implementation before testing can establish support. Linux GUI and three-OS packaging remain separate gates. No enterprise scheduler, shared database, marketplace or global control plane is required for the personal local milestone. Publication remains separately scoped and must update README substantively. The [development ledger](development.md#direction-reconciliation--november-1-2026) owns current results; dates below retain historical evidence. + ## Current native recovery packet — October 25, 2026 The [E1d-2 packet](encrypted-workspace.md#e1d-2-native-sqlcipher-recovery-copy--october-25-2026) is implemented: the existing SQLCipher backend creates and verifies a canonical encrypted recovery image using a separate native-selected key file. The age experiment is preserved as standalone historical source, excluded from active builds; the active pre-experiment 167-package lock graph is unchanged. diff --git a/docs/product-experience.md b/docs/product-experience.md index ff4a3ad..a41cb29 100644 --- a/docs/product-experience.md +++ b/docs/product-experience.md @@ -1,5 +1,78 @@ # Product experience: make the visual promise useful + + +## UI-C8 output-focused inspector — November 3, 2026 + +The shared Recipe/Graph inspector presents bounded output navigation, counts and the existing working-selection context. Choosing a record opens the corresponding Recipe fields with title focus; it does not modify content or assign ranges. Output-list scroll and unapplied authored text survive navigation. Long names remain readable through wrapping. Failed actions retain the draft and point to the existing message; preview diagnostics and explicit save acknowledgement stay visible. + +[Intent](intent.md#ui-c8-recipegraph-inspector-and-edge-cases--november-3-2026) and [development receipt](development.md#ui-c8-recipegraph-inspector-and-edge-cases--november-3-2026) own exact scope and validation. + + +## UI-C7 task-oriented Compose controls — November 2, 2026 + +Keep one compact static workflow guide above the editing surface. Separate view switching, edit history, workspace layout and destructive draft actions into named groups. Keep review and Save together below the work area, with exact preview content, diagnostics and acknowledgement visible. Technical explanations belong in existing inspector details; selected inputs, reasons, annotations and error recovery remain in context. Narrow drafts stack panels and fit revision selectors without clipped controls. + +[Intent](intent.md#ui-c7-compose-task-hierarchy--november-2-2026) and [development receipt](development.md#ui-c7-compose-task-hierarchy--november-2-2026) own exact scope and evidence. This is UI-only; native task qualification remains separate. + + +## UI-C5 reachable Compile setup — November 2, 2026 + +Keep output format and explicit actions near the selected-revision summary, before long skill/history lists. Preserve exact historical selection, disabled gates, readable-export warnings and the existing three-panel layout. Stale selection recovery belongs beside actions. Desktop Compile should remain visible in the initial viewport; narrow layouts may scroll vertically. This presentation order changes no native behavior. [Actual evidence and open gates](development.md#ui-c5-compile-control-placement--november-2-2026). + +## UI-C4 full-color object and software identity — November 2, 2026 + +Jeff requests richer full-color icons. Daily work now uses filled layered objects with stable family colors, preserving labels, exact action meaning and neutral unavailable states. Software identity remains separate from operation symbols: original local vendor marks identify named products, while capabilities and connection states come from existing application data. All current catalog families have vetted local marks; no new adapter becomes supported by this presentation change. + +The gallery presents the complete icon catalog and eight software identities. Forced colors switches to the original monochrome shapes. No framework, decorative motion, live-traffic animation or new operation is added. [Visual mechanics](visual-system.md#ui-c4-filled-color-artwork-and-authentic-software-marks--november-2-2026) and [actual validation limits](development.md#ui-c4-full-color-artwork-and-software-marks--november-2-2026) govern this refinement. Existing organizational recommendations remain next work; source/visual completion does not close browser Lock or native qualification. + +## UI-I3 inspected organization and visual direction — November 2, 2026 + +The second pass inspected actual synthetic Skills, historical Compose, Compile, conflict, responsive and accessibility screenshots plus current renderers and local assets. The existing library/editor/inspector structure is worth retaining. The strongest remaining organizational issues are Compile's primary action below the initial viewport, Compose's weak minimum-input guidance, and competing conflict messages. These are prioritized follow-up recommendations, not completed workflow changes. Keep critical plaintext/export and recovery warnings visible at the relevant decision; an advanced fold must not hide a consequential warning. + +Use one coherent vocabulary for four visual roles: record types (source, skill, workflow, revision), actions (edit, save, compose, compile, export), operational states (locked, readable, encrypted, unknown, warning), and software identities. Action icons remain beside labels; a software mark never substitutes for an action or an availability label. Software without a vetted local mark uses a generic category glyph beside its exact name. LNSAT/VUSL remain independent; Claude identifies a text format only, and AGENTS.md keeps a generic document symbol. + +Delivered UI-I3 work adds semantic icons and grouped icon/software review, fixes two silently absent glyphs caused by unsupported sizes, aligns existing actions, and neutralizes disabled primary buttons. It changes no operation predicate, persistence, connection, export or authority behavior. The [receipt](development.md#ui-i3-semantic-icons-and-visual-organization--november-2-2026) owns actual tests and open qualification gates. + +Next arrangement changes should be small and testable: put Compile's current-revision/profile/action summary together; show Compose's required/pinned count beside Start draft; make conflict recovery one clearly identified action zone while retaining detailed error context; add a compact persistent selected-record/revision context before expanding system administration. Graphs should use the same flat entity symbols and exact labeled connections as lists; 3D remains an optional inspection view, not the only editor. Do not replace useful whitespace with fake activity, invented charts or decorative system nodes. + +Recommended next information-architecture experiment: expose Decompose/Merge/Split as modes under one Compose entry while preserving the existing routes, per-operation drafts and exact input rules. This is proposed navigation, not delivered consolidation. Keep selected-folder metadata clearly separate from saved workspace copies; searching a folder must not imply content inspection or permission to reopen paths. A persistent selected record/revision context should identify what will be acted on, with output format kept distinct from an actually connected target. Daily tools and Systems/Advanced remain separate without hiding unresolved errors or unavailable-operation reasons. + + +## Current direction and acceptance — November 1, 2026 + +This is the current product-experience direction for the next planning phases. It preserves the existing library/work-area/right-inspector workbench, route IDs, grouped navigation, dark/light themes and abstract glossy Rangoon art. Marketing mascot art remains secondary. The proposed contexts are Workspace, Library, Systems and Activity; they are information-architecture proposals, not an implemented replacement shell. The canonical custody boundary is [enterprise operation and custody boundaries](application-architecture.md#enterprise-operation-and-custody-boundaries--november-1-2026), and packet sequencing is in [next-phase packets](plan.md#next-phase-packets--november-1-2026). + +Task continuity is project- and target-oriented. Every handoff carries the exact source, revision and target. Older-scope drafts remain available; navigation never silently retargets, auto-saves, runs or changes a selected target. Proposed target preparation stays distinct from effective-configuration readback. Any future enterprise operation scopes action at organization, workspace, project, environment, region and target levels. Immutable target sets, policy pins and artifact pins are recorded before approval; each target reports its own outcome and freshness. Credential references are shown only as references. Simple and advanced density change presentation, never authority. + +The next phase may make real local work easier to find and recover, but it must not invent fleet progress, packet animation, compliance/readiness claims or provider support. State coverage includes loading, empty, stale, partial, denied, error, unknown and recovery. Each state says what remains usable and the next safe action. Shared typography and tokens govern these states; real-state transitions stay subtle, with reduced-motion, forced-colors, keyboard, touch and text alternatives preserved. + +Acceptance for this direction is documentation and planning acceptance only. It does not accept source implementation, a replacement IA, rendered UI quality or native/runtime qualification. Root records reconciliation in [direction reconciliation](development.md#direction-reconciliation--november-1-2026). Future implementation must preserve existing route and control semantics, prove each target/state with source and rendered evidence, and keep unsupported or unqualified behavior visibly unavailable. + +## UI-T2 task grouping and usability evidence — November 2, 2026 + +Keep daily work in four places: library finds/creates, editor changes a revision, Use saved revision continues to Compose/Compile, and inspector explains origin/history. Search is always visible; Review/Origin/Clear use a keyboard-accessible native disclosure whose closed summary names active facets. Retain deliberate open/closed state through rerenders/navigation and reset it on workspace purge. Filtering never closes or replaces the selected editor. No-match and failure states keep existing work and offer recovery. Conflict reload belongs before editable content. Term help remains available with the inspector. + +Place each disabled/recovery explanation beside its action. Preserve action IDs, exact historical pinning, save/review gates, local-review scope and explicit confirmation. Grouping does not grant authority or run the next operation. Narrow layouts scroll; desktop preserves library/editor/inspector. Completed browser assertions are mechanics evidence, not a user study: the final run is PARTIAL because native-select input remains open. [Receipt](development.md#ui-t2-task-arrangement-and-interaction-audit--november-2-2026) records measurements and known tradeoffs. Next assess Compose input prerequisites and Compile→Export hierarchy, then test complete task success with real native persistence and disposable data. + +## UI-R1 compact daily editing — November 1, 2026 + +Skills revision actions sit directly below the selected revision header, before Title and Content. Keep the complete existing action block, IDs, gating and descriptions. Group the five actions into two readable rows on desktop and wrap them on narrow layouts with at least 44-pixel targets. Saved, dirty, historical, pending and conflict states keep their existing meaning. The textarea scales from 180 to 280 pixels and remains vertically resizable; title text uses the shared system font, content remains monospace. + +Local-task headers reserve less space for existing abstract art. Compress closed source/help disclosures without hiding their text or error/recovery states. Retain library/editor/provenance hierarchy, theme-aware borders, clear keyboard focus and restrained hover emphasis. At 1366×768 the actions and beginning of content must be visible without scrolling; narrow views may scroll vertically, never horizontally. Browser fixtures stay visibly synthetic. Rendered evidence now covers the named local cases; native encrypted and OS qualification remain separate. [Receipt](development.md#ui-r1-rendered-workbench-refinement-and-native-rebuild--november-1-2026). + +## NEXT-02b inspect the exact saved output — November 1, 2026 + +A saved composition output opens its exact saved revision in Skills after successful native readback. The editor heading receives focus only when the selected capability and viewed revision match. A newer saved head never silently replaces the composition result. Missing or changed results, failed reads and unavailable/busy states retain the current workbench and explain the next step. Same-skill unsaved edits must be saved or discarded first; other drafts remain available. + +Result controls carry both identities, disable during opening and stop after disposal. Navigation, receipt invalidation and Lock reject stale completion. This continuation does not save, review, compile, export or execute. Source tests cover identity/focus decisions and lifecycle handling; rendered keyboard/pointer, theme/viewport/reduced-motion and native encrypted qualification remain open. [Development receipt](development.md#next-02b-exact-saved-result-continuation--november-1-2026) owns evidence. + +## NEXT-02a saved skill into Compose — November 1, 2026 + +**Add to Compose** carries the exact selected saved revision from Skills into the existing Compose workbench, after an existing native read validates the returned identity. Historical revisions remain pinned. The user chooses another input and starts a draft explicitly; navigation creates no composition, preview, save, review, export or execution. + +Keep skill edits and other work intact. Same-skill unsaved edits, conflict, unavailable/busy state, an existing Compose draft, duplicate pin and full input selection disable adding with an explanation. **Open Compose** remains available to continue retained work. Navigation, selection/edit changes and Lock discard late handoff replies. Failed reads keep the user in Skills and retain previous Compose work. Existing theme, button and heading-focus patterns apply. Source tests are complete; actual rendered keyboard/pointer/layout/Lock behavior remains unassessed until UI control is available. [Development receipt](development.md#next-02a-saved-revision-compose-handoff--november-1-2026) records evidence and remaining work. + ## CW-1 saved-revision continuation — October 29, 2026 Skills gains **Open in Compile** beside its saved-revision actions. It opens that exact saved revision, including a selected historical revision, in the existing Compile workbench and focuses the selected revision/profile area after loading. Choose the format and compile explicitly there; nothing is compiled, exported or executed by navigation. diff --git a/docs/provider-interoperability.md b/docs/provider-interoperability.md index 4f36fdd..4197536 100644 --- a/docs/provider-interoperability.md +++ b/docs/provider-interoperability.md @@ -4,6 +4,16 @@ October 18 source checkpoint: D2a OpenShell mapping and D3a LNSAT evidence decod Authority: [intent.md](intent.md), October 7 provider-independent continuation. Owner: Jeff; the controller owns architecture, privacy, integration and release judgment. Status: accepted product direction; I1 source contract frozen after fresh independent pre-code review; offline source and independent conformance fixtures qualified; native wiring and all real adapters remain unimplemented. Validation and publication evidence belongs only in [development.md](development.md). +## Enterprise adapter and credential profiles — November 1, 2026 + +Planning refinement: [enterprise architecture](application-architecture.md#enterprise-operation-and-custody-boundaries--november-1-2026) owns shared trust/operation semantics; this guide owns adapter-specific coverage. Current offline decoders, synthetic read-client evidence and fixed-origin advisory model path do not establish generic cloud administration, live peer access, workload federation or KMS support. + +Declare hosting, cloud resource management, model inference, peer file access and authority/evidence integration as separate profiles. Pin provider/product/adapter/schema/version, tested OS/path profile, allowed operations, resource/account/region, credential source by reference, expiry/renewal and data/egress/retention policy. Human SSO, workload/device authentication, application permission and provider authorization are separate facts. Resolve credentials only in the approved native/service boundary; forbid ambient SDK environment/profile discovery and unapproved fallback credentials, providers or regions. Renewal rechecks current actor/delegation and scope. Never forward an unrelated audience token or expose a credential to imported content, ordinary workbench state, telemetry or unconfined plugin code. + +Effect support is per operation: identify conditional-state/fence support, duplicate identity/payload binding and retention horizon, cancellation limits, target-native readback, revocation propagation and unknown-outcome reconciliation. A provider that cannot enforce a claimed guarantee receives an explicit weaker/unsupported coverage state; connection or a successful preparation does not fill the gap. An old worker's valid token or accepted provider job can outlive a routing/lease change. Engine instances retain independent IDs/stores and require their own qualified topology before failover. VUSL maps semantics/provenance without authorizing effects, and its specification/core remain upstream-owned. + +Use reviewed built-in adapters first. Public SDK/registry follows two real independently qualified adapters exercising its contracts; fixture-only connector models do not establish live support. A signed manifest/logo describes identity, not safety or privilege. Pin update artifacts/channels, keep active jobs on compatible versions, and require real OS/resource/filesystem/network confinement before untrusted executable plugins. Tests must include wrong tenant/issuer/audience/account, stale grants, changed payload/identity, provider/key outage, resource reuse, redirect/egress misuse, cache/renewal and partial/unknown outcomes. The [next packets](plan.md#next-phase-packets--november-1-2026) do not authorize installation, credentials or provider contact. + ## Reconciliation and release boundary Rangoon and LNSAT are separate products. Rangoon owns capability authoring, immutable source provenance, decomposition, composition, revisions, instruction compilation, export and inspection. These local workflows must start and remain usable without LNSAT or any other external provider installed, configured or running. A bundled inert diagnostic crate is not an installed external engine. An absent integration affects only its own optional operation; it cannot prevent local startup, reading, editing, recovery or export. diff --git a/docs/reviewer-guide.md b/docs/reviewer-guide.md index 0f03883..ece3df3 100644 --- a/docs/reviewer-guide.md +++ b/docs/reviewer-guide.md @@ -13,7 +13,7 @@ Current review focus: the [October 29 audit](system-audit.md#october-29-whole-ap | --- | --- | --- | | Design and usability, about 20 minutes | Run `npm start`; open `http://127.0.0.1:4377`. Compare the sample screens with the real `analyze.html` workbench. Try navigation, dark/light, narrow width, workflow editing and the Operations empty state. | Clarity, hierarchy, terminology, recoverability and visual fidelity. Sample counts and playground behavior are synthetic. Browser mode cannot save native records or inspect a selected local operations file. | | Source and architecture | Read the [current audit](system-audit.md#october-29-whole-application-viability-and-drift-audit), [architecture](application-architecture.md), [feature matrix](../README.md#product-and-feature-status), [OpenShell boundary](provider-interoperability.md#openshell-runtime-boundary-and-adapter-sequence) and [development evidence](development.md). Run `npm run build:check` and the relevant Rust package tests if desired. | Contract and implementation critique. Passing source tests do not establish installed desktop support, enforcement, certification or model accuracy. | -| Guided native task on disposable data | Use an explicitly prepared isolated qualification artifact and synthetic fixture, with its own manifest, app-data location and test-key custody. Select, save, derive, revise, review, open the saved revision in Compile, export and reopen after restart; retain the exact stopping point. Do not substitute an ordinary personal-profile launch. | A task observation for that exact artifact and machine. Default source uses Managed encryption and recovery has dated macOS evidence, but the current folder-picker harness still needs its permission/fixture correction. No private projects, normal keys, provider credentials or production data. | +| Guided native task on disposable data | Use an explicitly prepared isolated qualification artifact and synthetic fixture, with its own manifest, app-data location and test-key custody. Select, save, derive, revise, review, open the saved revision in Compile, export and reopen after restart; retain the exact stopping point. Do not substitute an ordinary personal-profile launch. | A task observation for that exact artifact and machine. Default source uses Managed encryption and recovery has dated macOS evidence, and the folder-picker harness now has source-level permission/fixture preparation; a fresh artifact and actual GUI observations are still required. No private projects, normal keys, provider credentials or production data. | No LNSAT, OpenShell, model account or provider credential is needed for core content work. Do not install an authority engine or configure a live gateway @@ -22,6 +22,21 @@ report and displays **unverified observations**; it is not a live event feed, approval inbox or execution controller. Provider comparisons describe candidate abilities and unavailable states, not connected support. +## Disposable native workflow checklist + +The October 30 NQ-1 changes prepare the existing macOS qualification runner; they do not record a native task pass. Use exclusive, reliable UI control and a new run from the exact reviewed source. Windows testing is deferred until the Proxmox test host is available; Windows encrypted custody still requires implementation. + +1. Build with pinned Rust 1.99.1 and offline dependencies using the existing `scripts/qualify-native-encrypted.py init` entry. Keep the resulting source/executable/manifest hashes and OS/architecture. Its `folderFixture` output names the only folder for this rehearsal. Manifest v3 rejects old runs; never edit an older manifest to reuse it. +2. Start the `authoring` phase with `run NONCE authoring`. Complete isolated Managed setup using the disposable app's own custody. Record each confirmation and expected cancellation; normal user workspaces and keys remain outside this test. +3. Open Agent files and cancel Choose folder first. Verify the current selection/results remain intact. Choose the exact printed `folder-fixture`: expect only `AGENTS.md` and `skills/review/SKILL.md`. Hidden `.git/ignored.md` and `notes.txt` must not appear. Check relative names, sizes, observed timestamps and complete-list status. Metadata selection must not expose content or create saved source records. +4. Select/filter a row, then Lock. Verify folder rows, selected metadata, timestamps and private filter/inspector state are cleared. Unlock must not revive previous metadata. Also test Lock while a picker/result is pending; late completion must not restore rows. Capture actual UI/accessible-tree evidence alongside native lifecycle observations. +5. Use the separate explicit file picker to inspect a synthetic Markdown file, then Import & Analyze's explicit selection to save a source. Derive a skill, revise it, inspect historical/current revisions and review the chosen revision. Open that exact saved revision in Compile; unsaved changes must request save/discard without losing another draft. +6. Complete a composition from saved references, inspect its source coverage and resulting revision, then compile/export. Verify selected format and exported bytes through the existing explicit inspection flow. Export produces readable files; do not use private instructions. An export receipt proves output creation, not that an external runtime loaded or obeyed it. +7. Lock, end `authoring` cleanly, then restart the app using the existing `relaunch` phase. Reopen the saved records and confirm their content, revision pins and lineage. Exercise encrypted backup/restore on a separate fresh disposable destination through the existing recovery procedure and retain its artifact-bound evidence. Workspace recovery is separate from undoing changes to external project files. +8. End each phase cleanly, retain its parent receipt and exact UI stopping point, then perform the existing isolated slot cleanup. `phaseExitVerified` and `folderFixtureVerified` describe process/input checks only. Keep the picker/Lock/full-journey verdict unassessed until each observation above is recorded. Never turn a missing observation, cancelled test or interrupted controller into a pass. + +The runner accepts fixed controls only; it does not automate these UI actions. Timeout remains 20 minutes per phase, with existing event/output bounds. The fixed folder is outside all workspace case roots and is never an instruction execution target. CUA currently fails before launch because of the configured symlinked writable root; resolve controller access before starting a vault-backed native rehearsal. + ## Feedback that changes the build For each observation, include route, platform/browser, task, expected result, diff --git a/docs/visual-system.md b/docs/visual-system.md index b7d722b..31153f8 100644 --- a/docs/visual-system.md +++ b/docs/visual-system.md @@ -4,7 +4,73 @@ Status: accepted Intent: [intent.md](intent.md), visual quality continuation Owner: Jeff; primary controller owns visual direction and integration -Last updated: 2026-10-18 +Last updated: 2026-11-02 + + + +## UI-C8 inspector scale and recovery — November 3, 2026 + +Keep output navigation within a 260px scrollable region, with 44px labeled targets, wrapped names, visible focus and a selected border that survives forced colors. Preserve the selected row and scroll when rerendering. Counts describe local recipe records and unresolved declarations, never approval or semantic safety. Recovery guidance is concise and adjacent to preview status. Use inert sixteen-output and recovery fixtures for responsive checks; do not turn fixture acceptance into a native support claim. + +[Intent](intent.md#ui-c8-recipegraph-inspector-and-edge-cases--november-3-2026) and [development receipt](development.md#ui-c8-recipegraph-inspector-and-edge-cases--november-3-2026) own exact scope and validation. + + +## UI-C7 Compose toolbar and responsive draft layout — November 2, 2026 + +Use compact 11px tool-group labels, fixed local semantic icons and labeled 44px buttons. Grouped tools wrap instead of horizontal scrolling. The static workflow guide becomes a two-column list on narrow screens and never displays fake completion. Preserve visible focus, forced-color borders, reduced motion and separate saved versus unsaved messaging. Below the 1200px workspace gate, CSS must stack draft panels even before asynchronous layout state updates. Native selects stay within their containing panel. + +[Intent](intent.md#ui-c7-compose-task-hierarchy--november-2-2026) and [development receipt](development.md#ui-c7-compose-task-hierarchy--november-2-2026) own exact scope and evidence. This is UI-only; native task qualification remains separate. + + +## UI-C5 reachable Compile setup — November 2, 2026 + +Keep output format and explicit actions near the selected-revision summary, before long skill/history lists. Preserve exact historical selection, disabled gates, readable-export warnings and the existing three-panel layout. Stale selection recovery belongs beside actions. Desktop Compile should remain visible in the initial viewport; narrow layouts may scroll vertically. This presentation order changes no native behavior. [Actual evidence and open gates](development.md#ui-c5-compile-control-placement--november-2-2026). + +## UI-C4 filled color artwork and authentic software marks — November 2, 2026 + +Full-color presentation supersedes UI-I3's monochrome default. Each of 57 closed names now renders an original layered object with fixed blue/violet/cyan/jade/gold/ember parts and light/cutout details. Documents, modules, tools, storage and connections retain recognizable silhouettes at 16/20/24/40 pixels. The treatment uses meaningful object parts rather than a uniform colored tile behind an unchanged line. Geometry stays in the 24-unit viewBox and uses no ID, URL, filter, script or animation. No icon becomes an independent control or replaces its visible action label. + +The renderer includes a color group and the original monochrome path. Normal themes show the color group; forced colors hides it and restores the currentColor outline. Color identifies object family, not a successful check, approval, enforcement, connection, encryption guarantee or live activity. Locked/unlocked geometry and adjacent validated state remain distinct from a material's color. Disabled controls keep their actual disabled semantics and existing control styling. Reduced motion introduces no new animation. + +Package authentic marks for agentgateway, Cerbos, Permit and Invariant alongside existing Claude, Rangoon, LNSAT and VUSL. Preserve exact asset bytes, ratio and original color. Gallery software cards use a balanced four/two/one-column layout; white backing may separate native marks from a dark surface without recoloring them. All sources, hashes and trademark attribution remain in the [vendor manifest](../preview/assets/vendors/provenance.json). Permit internal gradient/clip references stay inside the original fixed local SVG image; original Rangoon geometry has no references. Do not accept arbitrary SVG or remote image URLs at runtime. A brand mark does not establish adapter coverage or endorsement. + +Fresh visual review of actual normal and forced-color renders passes. Complete browser interaction qualification remains open because of the repeated Lock-input and teardown failures documented in the [receipt](development.md#ui-c4-full-color-artwork-and-software-marks--november-2-2026). Rendered artwork review is not native execution, security or release qualification. + +## UI-I3 semantic icon system — November 2, 2026 + +The closed Foldline catalog now contains 57 unique path-based symbols, including distinct edit, compile, export, lock, unlock, encrypted-storage, readable-file, database, history, restore, copy, filter, folder, terminal, model, agent, API, cloud, network and warning shapes. Existing skill/source/composition symbols remain. Fix callers that request an unsupported size rather than accepting arbitrary sizes: Compose's skill now requests 16 instead of 15; Authority's header requests 40 instead of 34. Static literal-name/size checks supplement the unchanged runtime allowlist; they do not parse arbitrary JavaScript or become a security boundary. + +Use 16px action/kicker glyphs, 20px record/panel glyphs, 24px category symbols and 40px empty/recovery symbols. Navigation retains its existing 18px CSS slot. Keep the 24-unit viewBox, 1.75-unit stroke, rounded joins/caps and currentColor; no decorative SVG receives focus or replaces a text name. Preserve 44px interactive targets. Additions have no script, references, external image, animation or user-supplied path. Warm orange denotes active choice or an available primary action; disabled primary actions use neutral surfaces with their actual disabled attribute unchanged. Forced colors uses system text/borders, not a colored glow. + +Packaged software marks remain unchanged and identifiable: Rangoon application, Claude text format, LNSAT authority engine and VUSL semantic layer. The gallery separates those marks from generic operation/category icons. It labels identity as distinct from connection, compatibility and authority. Missing vetted marks use generic gateway/policy/guardrail symbols beside product names; do not invent vendor logos or download assets at runtime. All mark provenance and trademark boundaries remain in the existing asset manifests. No new binary/vector vendor asset is introduced by this packet. + +The lock symbol means a local lock action or reported locked state. Encrypted-storage symbols follow the existing managed-storage presentation path; fresh setup, unknown, browser and Legacy states must not display a successful encrypted state. Unlock symbols label the explicit unlock action, not proof that content is already open. Readable export and Legacy backup use a different document symbol. Labels and warnings remain authoritative presentation context; icons do not attest host integrity, confidentiality after unlock, export encryption, authentication, approval or enforcement. + +Keep abstract glossy Rangoon art subdued and static in task headers; professional flat symbols carry the working hierarchy. Avoid mascot art, constant border animation, motion suggesting live traffic, glowing green security marks and oversized controls. Preserve existing reduced-motion behavior. Review [the local icon gallery](../preview/icon-gallery.html) in both themes, then the real core-route renders. Synthetic review labels must not obscure controls; browser mechanics remain separate from native and actual-user usability qualification. + +## UI-T2 tool arrangement — November 2, 2026 + +Retain shared tokens and the three-panel workbench. Skills action groups use small descriptive headings, three edit controls, then two saved-revision continuations with local explanations. On narrow screens, edit buttons wrap and continuations stack; all button and disclosure targets remain at least 44px. Source creation belongs in the library; help joins the inspector. Active review/origin labels remain visible when filters are closed. The wrapped inspector explicitly resets inherited tablet grid-column placement to avoid implicit empty tracks. No decorative animation, external asset, framework or synthetic progress is added. + +The final synthetic browser suite records fourteen theme/viewport profiles and seventeen interaction/media/controller cases, with no overflow and valid inspector width. Its overall PARTIAL result retains actual native-select input as an open qualification gate. The content field starts 19px lower on desktop because explanations moved beside actions; the editor panel itself starts 110px higher. These are measured layout outcomes, not a universal UX improvement claim. Native, physical-display, screen-reader and real-user task evidence remain separate. [Receipt](development.md#ui-t2-task-arrangement-and-interaction-audit--november-2-2026). + +## UI-R1 implemented local refinement — November 1, 2026 + +The Skills editor uses an action row above fields, system type for titles, monospace content, a 180–280 pixel responsive/resizable textarea and consistent hairline panel/field borders. Its primary actions remain at least 44×44 pixels and visible above the fold at tested desktop widths. Compact shared local-task headers use existing restrained abstract artwork and unchanged semantic content. Hover border emphasis is 120 ms only when hover is available and reduced motion is not requested. Forced-colors restores system borders, Canvas and Highlight; no animated border loop is added. + +The library/editor/inspector structure and existing responsive fallback remain. Browser QA covers 320/768/1366/1440/1920/3840 logical widths, dark/light, and explicitly recorded DPR 1/2 profiles. These are headless Chrome emulations, not physical display or native-WebView observations. The runner records overflow, action geometry, browser identity, exceptions and console errors while synthetic data remains visibly labeled. [Development receipt](development.md#ui-r1-rendered-workbench-refinement-and-native-rebuild--november-1-2026) owns actual results. Broader operational surfaces, actual saved-result native flows and three-OS qualification are not marked complete by this refinement. + +## Current visual direction and acceptance — November 1, 2026 + +Retain the finished original command-center feel: radials, bars, icons, logos, restrained glossy abstract art, library/work area/right inspector, grouped navigation and dark/light themes. Visual refinement must strengthen this professional surface, not replace it with a marketing mascot or a generic dashboard. Existing route IDs and controls remain stable. The proposed Workspace, Library, Systems and Activity contexts are planning vocabulary only. + +Charts are evidence views, never decoration that implies capability. Metric cards state scope, numerator, denominator, source and watermark. Radial segments are disjoint. Desired, installed and effective are independent fields, not additive slices; use explicit effective, installed-only, pending, failed and unknown buckets where applicable. Composition coverage uses exact native-derived units. The renderer never becomes save authority. + +Bars show outcomes, latency, queue pressure and cost with explicit definitions: latency includes sample window, sample count and failure treatment; queues show age, depth/capacity and delayed/rejected counts; costs distinguish actual, reserved, estimated and unknown values with currency and period. Every bar supports table or inspector drilldown to the underlying scope and freshness. No invented progress, packet animation, fake compliance/readiness or unlabeled synthetic activity. + +Use packaged marks only: `preview/assets/authority/lnsat-mark.webp`, `preview/assets/foundations/vusl-logo.png` and the compact SVG catalog in `preview/icons.mjs`. Logos identify assets and provenance; they never imply support, permission, approval or runtime integration. Do not add external untrusted SVG/HTML or runtime asset fetches. Finish loading, empty, stale, partial, denied, error, unknown and recovery states with shared typography/tokens, subtle real-state transitions, reduced-motion, forced-colors, keyboard/touch access and text alternatives. + +Required viewport matrix remains 320, 768 and 1440 in dark and light. Add 1366×768 and 1920×1080 profiles, plus actual 4K profiles when available. Record logical viewport and scale/DPR for each 4K observation; do not confuse physical pixels with CSS layout. This update accepts design requirements only. Future implementation requires source/rendered evidence plus separate native/runtime qualification. The [enterprise custody boundary](application-architecture.md#enterprise-operation-and-custody-boundaries--november-1-2026), [next-phase packets](plan.md#next-phase-packets--november-1-2026) and [direction reconciliation](development.md#direction-reconciliation--november-1-2026) own cross-document sequencing and receipts. ## UI-V2 mature workbench art and hierarchy diff --git a/preview/analyze.mjs b/preview/analyze.mjs index 4f63199..bfd74c3 100644 --- a/preview/analyze.mjs +++ b/preview/analyze.mjs @@ -1,3 +1,4 @@ +import { compositionResultIssue, openCompositionResultInSkills, compositionResultFocus } from './composition-skill-handoff.mjs'; import { bindMarkdownFind } from './markdown-find.mjs'; import { renderImportMarkdownLines, captureMarkdownReview, restoreMarkdownReview, jumpToMarkdownLine } from './markdown-review.mjs'; import { createAgentFilesController } from './agent-files-model.mjs'; @@ -22,7 +23,7 @@ import { createModelAssistanceController } from './model-assistance-model.mjs'; import { bindModelAssistanceView } from './model-assistance-view.mjs'; import { createCloudCredentialController } from './cloud-credential-model.mjs'; import { icon } from './icons.mjs'; -import { openSkillInCompilation, skillCompileSelection } from './skill-compile-handoff.mjs'; +import { openSkillInCompilation, skillCompileSelection, openSkillInComposition, skillCompositionIssue } from './skill-compile-handoff.mjs'; import { createStartupSplash } from './launch.mjs'; import { bindWorkbenchNavigation, renderWorkbenchNavigation } from './workbench-navigation.mjs'; import { createWorkspaceLockController, workspaceSaveDisclosure } from './workspace-lock-model.mjs'; @@ -133,6 +134,7 @@ let openEngineDetails = new Set(); let skillsActionFocus = null; let skillsOriginalOpen = false; let skillsSavedOpen = false; +let skillsLibraryFiltersOpen = false; let skillsDiscardConfirmation = null; let skillsRenderedCapability = null; const skillsDisclosureStates = new Map(); @@ -149,6 +151,11 @@ let compilationActionFocus = null; let compilationHandoffRevision = null; let skillsCompileHandoff = { pending: false, error: null }; let skillsCompileEpoch = 0; +let skillsComposeHandoff = { pending: false, error: null }; +let skillsComposeEpoch = 0; +let compositionSkillHandoff = { pending: false, error: null }; +let compositionSkillEpoch = 0; +let skillsHandoffSelection = null; const text = value => escapeText(value); const formatBytes = value => new Intl.NumberFormat().format(value ?? 0); @@ -198,7 +205,23 @@ function renderComposition() { app.innerHTML = `
${renderRail()}
`; compositionViewRoute = route; compositionView = bindCompositionView(document.querySelector('#composition-root'), composition, { - onOpenSkill: id => { if (sourceBlocked()) return; location.hash = '#skills'; void skillsController.open(id); }, + getResultHandoff: () => compositionSkillHandoff, + onOpenSkill: async (capabilityId, revisionId) => { + const originRoute = route, navigation = navigationEpoch; + if (sourceBlocked() || nativeOperations || compositionSkillHandoff.pending || compositionControllers.get(originRoute) !== composition || location.hash !== `#${originRoute}`) return false; + const issue = compositionResultIssue({ composition, skills: skillsController, capabilityId, revisionId }); + if (issue) { compositionSkillHandoff = { pending: false, error: issue }; renderComposition(); return false; } + const request = ++compositionSkillEpoch; + const isCurrent = () => !sourceBlocked() && request === compositionSkillEpoch && navigation === navigationEpoch && route === originRoute && location.hash === `#${originRoute}`; + compositionSkillHandoff = { pending: true, error: null }; renderComposition(); + const opened = await openCompositionResultInSkills({ composition, skills: skillsController, capabilityId, revisionId, isCurrent }).catch(() => false); + if (!isCurrent()) return false; + compositionSkillHandoff = { pending: false, error: opened ? null : 'Could not open this saved revision. Your composition and other drafts are retained. Try again or open Skills.' }; + if (!opened) { renderComposition(); return false; } + skillsHandoffSelection = { capabilityId, revisionId }; + location.hash = '#skills'; + return true; + }, }); } else compositionView.render(); routeEntry = false; @@ -538,6 +561,8 @@ function renderSkills() { const selection = typeof active?.selectionStart === 'number' ? [active.selectionStart, active.selectionEnd] : null; const editorScroll = document.querySelector('#skills-content-input')?.scrollTop ?? 0; const libraryScroll = document.querySelector('.skills-library__list')?.scrollTop ?? 0; + const filters = document.querySelector('.skills-filter-options'); + if (filters) skillsLibraryFiltersOpen = filters.open; const original = document.querySelector('.skills-original'); if (original) skillsOriginalOpen = original.open; const saved = document.querySelector('.skills-saved'); @@ -555,7 +580,7 @@ function renderSkills() { const disclosures = skillsDisclosureStates.get(skillsRenderedCapability); skillsOriginalOpen = disclosures?.original ?? false; skillsSavedOpen = disclosures?.saved ?? false; - app.innerHTML = `
${renderRail()}
${renderSkillsView(state, { discardConfirmation: skillsDiscardConfirmation, compileHandoff: skillsCompileHandoff })}
`; + app.innerHTML = `
${renderRail()}
${renderSkillsView(state, { libraryFiltersOpen: skillsLibraryFiltersOpen, discardConfirmation: skillsDiscardConfirmation, compileHandoff: skillsCompileHandoff, composeHandoff: { ...skillsComposeHandoff, composition: compositionControllers.get('merge')?.getState() } })}
`; routeEntry = false; announcer.textContent = state.message; if (skillsSourceDisclosures.has(skillsRenderedSource)) document.querySelector('.skills-source-create').open = skillsSourceDisclosures.get(skillsRenderedSource); @@ -568,7 +593,9 @@ function renderSkills() { if (library) library.scrollTop = libraryScroll; if (routeFocusPending === 'skills') { if (skillsCreateFocusPending) document.querySelector('.skills-source-create')?.setAttribute('open', ''); - document.querySelector(skillsCreateFocusPending ? '#skills-create-title' : '#skills-title')?.focus({ preventScroll: true }); + const resultFocus = compositionResultFocus(state, skillsHandoffSelection); + document.querySelector(resultFocus || (skillsCreateFocusPending ? '#skills-create-title' : '#skills-title'))?.focus({ preventScroll: true }); + skillsHandoffSelection = null; skillsCreateFocusPending = false; routeFocusPending = null; } else { @@ -716,7 +743,7 @@ for (const operation of compositionRoutes) { } return bridge(command, args); } : undefined, - onChange: () => { if (sourceBlocked()) return; if (route === operation) renderComposition(); }, + onChange: () => { if (sourceBlocked()) return; if (route === operation) renderComposition(); else if (route === 'skills' && operation === 'merge') renderSkills(); }, onCommitted: async () => { if (sourceBlocked()) return; invalidateCompositions('Composition saved. Preview other retained drafts against the current workspace before saving.', operation); @@ -964,7 +991,7 @@ app.addEventListener('click', event => { return; } if (event.target.closest('#skills-open-compile')) { - if (route !== 'skills' || location.hash !== '#skills' || nativeOperations || skillsCompileHandoff.pending || !skillCompileSelection(skillsController.getState())) return; + if (route !== 'skills' || location.hash !== '#skills' || nativeOperations || skillsCompileHandoff.pending || skillsComposeHandoff.pending || !skillCompileSelection(skillsController.getState())) return; const request = ++skillsCompileEpoch; const navigation = navigationEpoch; const isCurrent = () => !sourceBlocked() && request === skillsCompileEpoch && navigation === navigationEpoch && route === 'skills' && location.hash === '#skills'; @@ -977,6 +1004,20 @@ app.addEventListener('click', event => { location.hash = '#compile'; }); } + if (event.target.closest('#skills-open-compose')) { + const composition = compositionControllers.get('merge'); + if (route !== 'skills' || location.hash !== '#skills' || nativeOperations || skillsCompileHandoff.pending || skillsComposeHandoff.pending || skillCompositionIssue(skillsController.getState(), composition?.getState())) return; + const request = ++skillsComposeEpoch; + const navigation = navigationEpoch; + const isCurrent = () => !sourceBlocked() && request === skillsComposeEpoch && navigation === navigationEpoch && route === 'skills' && location.hash === '#skills'; + skillsComposeHandoff = { pending: true, error: null }; renderSkills(); + return openSkillInComposition({ skills: skillsController, composition, isCurrent }).catch(() => false).then(opened => { + if (!isCurrent()) return; + skillsComposeHandoff = { pending: false, error: opened ? null : 'Could not add this saved revision. Existing Compose work is retained. Check the selection and try again.' }; + if (!opened) { skillsActionFocus = '#skills-open-compose'; renderSkills(); return; } + location.hash = '#merge'; + }); + } if (event.target.closest('#skills-save')) { skillsActionFocus = '#skills-save'; return skillsController.save(); } if (event.target.closest('#skills-review')) { skillsActionFocus = '#skills-review'; return skillsController.review(); } if (event.target.closest('#skills-reload-list')) return skillsController.list(); @@ -1002,7 +1043,9 @@ app.addEventListener('click', event => { // Capture disclosure changes before navigation replaces the Skills DOM. app.addEventListener('toggle', event => { if (sourceBlocked() || !event.target.isConnected || !event.target.closest('.skills-page')) return; - if (event.target.matches('.skills-source-create') && skillsRenderedSource) { + if (event.target.matches('.skills-filter-options')) { + skillsLibraryFiltersOpen = event.target.open; + } else if (event.target.matches('.skills-source-create') && skillsRenderedSource) { skillsSourceDisclosures.set(skillsRenderedSource, event.target.open); } else if (skillsRenderedCapability && event.target.matches('.skills-advanced, .skills-original, .skills-saved')) { skillsDisclosureStates.set(skillsRenderedCapability, { @@ -1050,7 +1093,7 @@ app.addEventListener('input', event => { skillsController.updateDraft(event.target.matches('#skills-title-input') ? { title: event.target.value } : { content: event.target.value }); skillsDiscardConfirmation = null; document.querySelector('.skills-discard-confirmation')?.remove(); - syncSkillsEditorChrome(document, skillsController.getState(), { compileHandoff: skillsCompileHandoff }); + syncSkillsEditorChrome(document, skillsController.getState(), { compileHandoff: skillsCompileHandoff, composeHandoff: { ...skillsComposeHandoff, composition: compositionControllers.get('merge')?.getState() } }); }); app.addEventListener('change', event => { @@ -1080,6 +1123,11 @@ window.addEventListener('hashchange', () => { navigationEpoch += 1; skillsCompileEpoch += 1; skillsCompileHandoff = { pending: false, error: null }; + skillsComposeEpoch += 1; + skillsComposeHandoff = { pending: false, error: null }; + compositionSkillEpoch += 1; + compositionSkillHandoff = { pending: false, error: null }; + if (routeFromHash() !== 'skills') skillsHandoffSelection = null; if (routeFromHash() !== 'compile') compilationHandoffRevision = null; if (sourceBlocked()) return; retainSourceScroll(); @@ -1170,7 +1218,12 @@ function openWorkspaceLockDialog() { function purgeWorkspaceRenderer() { skillsCompileEpoch += 1; skillsCompileHandoff = { pending: false, error: null }; + skillsComposeEpoch += 1; + skillsComposeHandoff = { pending: false, error: null }; + compositionSkillEpoch += 1; + compositionSkillHandoff = { pending: false, error: null }; compilationHandoffRevision = null; + skillsHandoffSelection = null; let healthy = true; const attempt = callback => { try { if (callback() === false) healthy = false; } catch { healthy = false; } }; attempt(() => markdownFindBinding?.dispose()); @@ -1189,7 +1242,7 @@ function purgeWorkspaceRenderer() { skillsDisclosureStates.clear(); skillsSourceDisclosures.clear(); skillsRenderedSource = null; - skillsOriginalOpen = skillsSavedOpen = skillsCreateFocusPending = engineCheckFocusPending = workflowVisited = routeEntry = false; + skillsOriginalOpen = skillsSavedOpen = skillsLibraryFiltersOpen = skillsCreateFocusPending = engineCheckFocusPending = workflowVisited = routeEntry = false; route = ''; attempt(() => openEngineDetails.clear()); attempt(() => workbenchNavigation?.dispose()); diff --git a/preview/assets/vendors/agentgateway-mark.svg b/preview/assets/vendors/agentgateway-mark.svg new file mode 100644 index 0000000..b2bb781 --- /dev/null +++ b/preview/assets/vendors/agentgateway-mark.svg @@ -0,0 +1,12 @@ + + + + + + + + + + + + diff --git a/preview/assets/vendors/cerbos-mark.png b/preview/assets/vendors/cerbos-mark.png new file mode 100644 index 0000000..bd03246 Binary files /dev/null and b/preview/assets/vendors/cerbos-mark.png differ diff --git a/preview/assets/vendors/invariant-mark.png b/preview/assets/vendors/invariant-mark.png new file mode 100644 index 0000000..d64e6d9 Binary files /dev/null and b/preview/assets/vendors/invariant-mark.png differ diff --git a/preview/assets/vendors/permit-mark.svg b/preview/assets/vendors/permit-mark.svg new file mode 100644 index 0000000..f52867b --- /dev/null +++ b/preview/assets/vendors/permit-mark.svg @@ -0,0 +1,25 @@ + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/preview/assets/vendors/provenance.json b/preview/assets/vendors/provenance.json index 835e9e0..4205dbc 100644 --- a/preview/assets/vendors/provenance.json +++ b/preview/assets/vendors/provenance.json @@ -12,6 +12,66 @@ "owner": "Anthropic", "usage": "CLAUDE.md text-format identification only. No runtime compatibility or endorsement.", "license": "Third-party trademark asset; not covered by Rangoon Apache-2.0 source license." + }, + { + "id": "agentgateway", + "path": "preview/assets/vendors/agentgateway-mark.svg", + "sha256": "b7ba567137787b0c41afe5d43a942680dc7fb2db475cd5ec2db2cdaaec9eee9e", + "bytes": 2636, + "source": "https://agentgateway.dev/agw-mark-color.svg", + "sourcePage": "https://agentgateway.dev/", + "retrieved": "2026-11-02", + "owner": "agentgateway project", + "usage": "Named software identification in the existing catalog and icon gallery only. Not connection, runtime compatibility, endorsement or authorization evidence.", + "license": "Third-party trademark identity; brand rights remain with the named owner and are not granted by Rangoon Apache-2.0 source licensing.", + "unchanged": true, + "format": "svg" + }, + { + "id": "cerbos", + "path": "preview/assets/vendors/cerbos-mark.png", + "sha256": "06669c72f70245cc347d5a657bb270c7cbaf038044d78d2e0de11a679a2caed0", + "bytes": 6856, + "source": "https://www.cerbos.dev/apple-touch-icon.png", + "sourcePage": "https://www.cerbos.dev/", + "retrieved": "2026-11-02", + "owner": "Cerbos", + "usage": "Named software identification in the existing catalog and icon gallery only. Not connection, runtime compatibility, endorsement or authorization evidence.", + "license": "Third-party trademark identity; brand rights remain with the named owner and are not granted by Rangoon Apache-2.0 source licensing.", + "unchanged": true, + "format": "png", + "width": 180, + "height": 180 + }, + { + "id": "permit", + "path": "preview/assets/vendors/permit-mark.svg", + "sha256": "a39c45a1e144f2409cda7c1eb723ec83696387385663ef4dab6c417399ce1d0d", + "bytes": 6029, + "source": "https://www.permit.io/images/svgs/permit-logo.svg", + "sourcePage": "https://www.permit.io/", + "retrieved": "2026-11-02", + "owner": "Permit Inc.", + "usage": "Named software identification in the existing catalog and icon gallery only. Not connection, runtime compatibility, endorsement or authorization evidence.", + "license": "Third-party trademark identity; brand rights remain with the named owner and are not granted by Rangoon Apache-2.0 source licensing.", + "unchanged": true, + "format": "svg" + }, + { + "id": "invariant", + "path": "preview/assets/vendors/invariant-mark.png", + "sha256": "9852d767913fa7f9936230effb025602424a469a467cf4929e38b72cd6fb5143", + "bytes": 33290, + "source": "https://invariantlabs.ai/theme/icon/apple-touch-icon.png", + "sourcePage": "https://invariantlabs.ai/", + "retrieved": "2026-11-02", + "owner": "Invariant Labs AG", + "usage": "Named software identification in the existing catalog and icon gallery only. Not connection, runtime compatibility, endorsement or authorization evidence.", + "license": "Third-party trademark identity; brand rights remain with the named owner and are not granted by Rangoon Apache-2.0 source licensing.", + "unchanged": true, + "format": "png", + "width": 180, + "height": 181 } ], "unavailable": [ diff --git a/preview/authority-catalog.mjs b/preview/authority-catalog.mjs index 249d19c..06e9c37 100644 --- a/preview/authority-catalog.mjs +++ b/preview/authority-catalog.mjs @@ -46,7 +46,7 @@ const freeze = value => { export const AUTHORITY_CATALOG = freeze([ entry({ - id: 'agentgateway', productTarget: 'agentgateway standalone', family: 'agentgateway', category: 'gateway', badge: 'Gateway', logoPath: null, + id: 'agentgateway', productTarget: 'agentgateway standalone', family: 'agentgateway', category: 'gateway', badge: 'Gateway', logoPath: 'assets/vendors/agentgateway-mark.svg', summary: 'Research reference for a standalone gateway configuration and mediated access-log inspection.', abilities: [{ label: 'Configuration preview', operation: 'configuration_preview' }, { label: 'MCP authorization mapping', operation: 'authorization_evaluation' }, { label: 'Mediated access-log evidence', operation: 'evidence_read' }], limitations: 'Gateway authorization applies only to traffic it mediates. Kubernetes is a separate future target; no Rangoon profile or connection exists.', @@ -54,7 +54,7 @@ export const AUTHORITY_CATALOG = freeze([ areas: [{ id: 'decompose', relationship: 'Local transformation needs no authority engine.' }, { id: 'merge', relationship: 'Local transformation needs no authority engine.' }, { id: 'split', relationship: 'Local transformation needs no authority engine.' }, { id: 'workflows', relationship: 'Design reference for mediated workflow traffic.' }, { id: 'compile', relationship: 'Design reference for configuration preview output.' }], }), entry({ - id: 'cerbos', productTarget: 'Cerbos PDP', family: 'cerbos', category: 'authorization', badge: 'Authorization', logoPath: null, + id: 'cerbos', productTarget: 'Cerbos PDP', family: 'cerbos', category: 'authorization', badge: 'Authorization', logoPath: 'assets/vendors/cerbos-mark.png', summary: 'Research reference for policy configuration and explicit authorization-decision inspection.', abilities: [{ label: 'Policy configuration preview', operation: 'configuration_preview' }, { label: 'Resource decision inspection', operation: 'authorization_evaluation' }], limitations: 'CheckResources evaluates requested resource/actions. Enforcement remains with the caller; a decision is not an approval, grant consumption, or execution receipt.', @@ -62,7 +62,7 @@ export const AUTHORITY_CATALOG = freeze([ areas: [{ id: 'skills', relationship: 'Local review is separate from a provider decision.' }, { id: 'workflows', relationship: 'Design reference for explicit decision boundaries.' }, { id: 'engine', relationship: 'Contrast with the separate LNSAT diagnostic.' }], }), entry({ - id: 'permit', productTarget: 'Permit authorization', family: 'permit', category: 'authorization', badge: 'Authorization', logoPath: null, + id: 'permit', productTarget: 'Permit authorization', family: 'permit', category: 'authorization', badge: 'Authorization', logoPath: 'assets/vendors/permit-mark.svg', summary: 'Research reference for identity, resource, tenant, and policy decision evidence.', abilities: [{ label: 'Configuration preview', operation: 'configuration_preview' }, { label: 'Decision evidence inspection', operation: 'authorization_evaluation' }], limitations: 'Permit identity, resource, tenant, and policy semantics remain provider-specific. Account, PDP, credential, and retention qualification are open; decisions are not Rangoon approvals.', @@ -70,7 +70,7 @@ export const AUTHORITY_CATALOG = freeze([ areas: [{ id: 'skills', relationship: 'Local review is separate from a provider decision.' }, { id: 'workflows', relationship: 'Design reference for resource-aware policy decisions.' }, { id: 'workspace', relationship: 'Design reference only; no saved assignment exists.' }], }), entry({ - id: 'permit-fastmcp', productTarget: 'Permit FastMCP middleware', family: 'permit', category: 'authorization', badge: 'Middleware', logoPath: null, + id: 'permit-fastmcp', productTarget: 'Permit FastMCP middleware', family: 'permit', category: 'authorization', badge: 'Middleware', logoPath: 'assets/vendors/permit-mark.svg', summary: 'Research reference for server-side permission mapping in an owned FastMCP server.', abilities: [{ label: 'Permission-mapping preview', operation: 'configuration_preview' }, { label: 'Compatible evaluation evidence', operation: 'authorization_evaluation' }], limitations: 'This middleware runs inside an owned FastMCP server with its own request and identity mapping. It is not the commercial Permit MCP Gateway.', @@ -78,7 +78,7 @@ export const AUTHORITY_CATALOG = freeze([ areas: [{ id: 'workflows', relationship: 'Design reference for owned-server middleware placement.' }, { id: 'model-assistance', relationship: 'Design reference only; no model route is bound.' }], }), entry({ - id: 'permit-mcp-gateway', productTarget: 'Permit MCP Gateway', family: 'permit', category: 'gateway', badge: 'Gateway', logoPath: null, + id: 'permit-mcp-gateway', productTarget: 'Permit MCP Gateway', family: 'permit', category: 'gateway', badge: 'Gateway', logoPath: 'assets/vendors/permit-mark.svg', summary: 'Research reference for commercial gateway configuration and decision/audit evidence.', abilities: [{ label: 'Gateway configuration preview', operation: 'configuration_preview' }, { label: 'Decision and audit evidence', operation: 'evidence_read' }], limitations: 'This is a separate commercial product with separate connection, authentication, entitlement, and retention treatment. Middleware availability does not confer gateway access.', @@ -86,7 +86,7 @@ export const AUTHORITY_CATALOG = freeze([ areas: [{ id: 'workflows', relationship: 'Design reference for mediated gateway placement.' }, { id: 'compile', relationship: 'Design reference for an inert configuration preview.' }], }), entry({ - id: 'invariant-local', productTarget: 'Invariant local', family: 'invariant', category: 'guardrail', badge: 'Local guardrail', logoPath: null, + id: 'invariant-local', productTarget: 'Invariant local', family: 'invariant', category: 'guardrail', badge: 'Local guardrail', logoPath: 'assets/vendors/invariant-mark.png', summary: 'Research reference for a pinned local policy preview and locally produced violation reports.', abilities: [{ label: 'Policy configuration preview', operation: 'configuration_preview' }, { label: 'Violation report inspection', operation: 'guardrail_evaluation' }], limitations: 'A future adapter must pin LocalPolicy, detectors, and dependencies. Imported policy is not trusted code; local execution, isolation, and detector egress remain unqualified. No violations is not authorization.', @@ -94,7 +94,7 @@ export const AUTHORITY_CATALOG = freeze([ areas: [{ id: 'analysis', relationship: 'Design reference for local content inspection.' }, { id: 'model-assistance', relationship: 'Design reference for separate guardrail reporting.' }], }), entry({ - id: 'invariant-remote', productTarget: 'Invariant remote', family: 'invariant', category: 'guardrail', badge: 'Remote guardrail', logoPath: null, + id: 'invariant-remote', productTarget: 'Invariant remote', family: 'invariant', category: 'guardrail', badge: 'Remote guardrail', logoPath: 'assets/vendors/invariant-mark.png', summary: 'Research reference for explicitly consented policy and trace evaluation result inspection.', abilities: [{ label: 'Consented remote policy evaluation', operation: 'guardrail_evaluation' }, { label: 'Result evidence inspection', operation: 'evidence_read' }], limitations: 'Remote treatment has distinct payload, endpoint, credential, and retention handling. There is no automatic local-to-remote fallback; remote compatibility remains unqualified.', diff --git a/preview/authority-view.mjs b/preview/authority-view.mjs index 7b7b051..0ca8e62 100644 --- a/preview/authority-view.mjs +++ b/preview/authority-view.mjs @@ -22,11 +22,12 @@ const presentedEntries = entries => { const recommended = entries.find(item => item.id === 'lnsat'); return recommended ? [recommended, ...entries.filter(item => item !== recommended)] : [...entries]; }; +const categorySymbol = item => icon(({ gateway: 'connector', authorization: 'gate', guardrail: 'check', 'action-authority': 'gate' })[item.category] ?? 'connector', { size: 24 }); const recommendation = item => item.id === 'lnsat' ? 'Recommended' : ''; const card = (item, state) => { const comparison = getAuthorityComparison(item.id); const readiness = getAuthorityReadiness(item.id); - return `
${item.logoPath ? `` : ``}

${escape(item.category)}

${escape(item.productTarget)}

${recommendation(item)}

${escape(comparison?.purpose ?? item.summary)}

Unavailable · ${readiness?.availableCount ?? 0} / ${readiness?.operationCount ?? 5} available

${escape(item.badge)}
`; + return `
${item.logoPath ? `` : ``}

${escape(item.category)}

${escape(item.productTarget)}

${recommendation(item)}

${escape(comparison?.purpose ?? item.summary)}

Unavailable · ${readiness?.availableCount ?? 0} / ${readiness?.operationCount ?? 5} available

${escape(item.badge)}
`; }; const unavailable = item => `

Adapter details

Adapter
Unavailable
Reason
${escape(item.reason)}
Observed version
Unknown
Compatibility
Unknown
Connection
Unknown
Runtime
Unknown
Rangoon authority
None
Network attempted
No
`; const statusKey = (label, entries) => `

${escape(label)}

    ${entries.map(entry => `
  • ${escape(entry.label)}${escape(entry.explanation)}
  • `).join('')}
`; @@ -44,7 +45,7 @@ const inspector = state => { if (!readiness) return ''; const origin = state.originArea && areaById.get(state.originArea); const chain = `${origin ? `${origin.label} → ` : ''}${item.id} → unavailable adapter`; - return ``; + return ``; }; const authorityResults = state => `${state.entries.length} of 8 modules${state.inspector === 'filtered-empty' ? '; selected module hidden by filters' : ''}.`; @@ -61,7 +62,7 @@ const authorityComparison = () => `

LOCAL REFERENCE / NO PROVIDER CONNECTION

Authority engines

Compare optional authority and safety modules.

Adapters Unavailable

${renderFoundationContext()}

${authorityResults(state)}

${renderAuthorityLibrary(state)}${inspector(state)}
Plan module roles
${renderAuthorityPlanner()}
Compare module references${authorityComparison()}
`; + return `

LOCAL REFERENCE / NO PROVIDER CONNECTION

Authority engines

Compare optional authority and safety modules.

Adapters Unavailable

${renderFoundationContext()}

${authorityResults(state)}

${renderAuthorityLibrary(state)}${inspector(state)}
Plan module roles
${renderAuthorityPlanner()}
Compare module references${authorityComparison()}
`; } export function bindAuthorityView({ container, controller, navigate = hash => { location.hash = hash; } }) { diff --git a/preview/color-icon-artwork.mjs b/preview/color-icon-artwork.mjs new file mode 100644 index 0000000..f126ebf --- /dev/null +++ b/preview/color-icon-artwork.mjs @@ -0,0 +1,79 @@ +const colors = Object.freeze({ + blue: '#5C8DFF', + violet: '#7A5AF8', + cyan: '#28BBD2', + jade: '#32B486', + gold: '#F2B84B', + ember: '#F17C3A', + highlight: '#EAF3FF', + cutout: '#24344A', +}); + +const art = Object.freeze({ + command: ``, + import: ``, + decompose: ``, + merge: ``, + skill: ``, + workflow: ``, + check: ``, + branch: ``, + connector: ``, + evidence: ``, + roadmap: ``, + source: ``, + bundle: ``, + gate: ``, + outcome: ``, + search: ``, + density: ``, + focus: ``, + theme: ``, + chevron: ``, + unavailable: ``, + unknown: ``, + research: ``, + approval: ``, + arrow: ``, + plus: ``, + save: ``, + clear: ``, + more: ``, + zoomin: ``, + zoomout: ``, + panleft: ``, + panright: ``, + reset: ``, + undo: ``, + redo: ``, + edit: ``, + compile: ``, + export: ``, + lock: ``, + unlock: ``, + encrypted: ``, + plaintext: ``, + database: ``, + history: ``, + restore: ``, + copy: ``, + filter: ``, + folder: ``, + terminal: ``, + model: ``, + agent: ``, + api: ``, + cloud: ``, + network: ``, + warning: ``, + viewcube: ``, +}); + +export const COLOR_ICON_NAMES = Object.freeze(Object.keys(art)); +const supportedSizes = new Set([16, 20, 24, 40]); + +/** Return static, full-color inner SVG geometry from the closed local catalog. */ +export function colorIconArtwork(name, { size = 20 } = {}) { + if (typeof name !== 'string' || !Object.hasOwn(art, name) || !supportedSizes.has(size)) return ''; + return art[name]; +} diff --git a/preview/compilation-view.mjs b/preview/compilation-view.mjs index d5cc2fa..7d5f06b 100644 --- a/preview/compilation-view.mjs +++ b/preview/compilation-view.mjs @@ -100,13 +100,13 @@ function revisions(state, busy) { } function profiles(state, busy) { - return `
Output format
`; + return `
Output format
`; } function selectionPanel(state, busy, skillsBusy) { const hasSelection = Boolean(selectedCapabilityId(state) && selectedRevision(state)); const canGenerate = Boolean(state.bridgeAvailable && hasSelection && state.profile && !state.needsRefresh && !busyState(state, busy)); - return ``; + return ``; } function tabButton(tab, label, selected, disabledTab) { @@ -170,7 +170,7 @@ function portableAction(state, busy) { const blocker = exportBlocker(state, busy); const receipt = bundle.status === 'exported' ? bundle.receipt : null; const status = fileActionNotice('export', state); - return `

PORTABLE ACTION

Plaintext bundle

Export writes a selected plaintext .rangoon-instructions file. It does not install or run instructions.

${renderTechnicalDetails('compile-export-identity-details', `
Expected candidate
${text(value?.candidate?.candidateId ?? 'Compile first')}
`)}${blocker ? `

${text(blocker)}

` : ''}${status ? `

${text(status)}

` : ''}${receipt ? `

EXPORT RECEIPT

Write completed

Completion covers this write and file sync only. It does not establish future integrity, directory durability, or authentication.

${renderTechnicalDetails('compile-export-receipt-details', `
Bundle ID
${text(receipt.bundleId ?? 'Unavailable')}
Candidate ID
${text(receipt.candidateId ?? 'Unavailable')}
SHA-256
${text(receipt.sha256 ?? 'Unavailable')}
Bytes
${number(receipt.byteLength)}
Authority
${text(receipt.authority ?? 'none')}
`)}
` : ''}
`; + return `

PORTABLE ACTION

${icon('plaintext', { size: 20 })}Plaintext bundle

Export writes a selected plaintext .rangoon-instructions file. It does not install or run instructions.

${renderTechnicalDetails('compile-export-identity-details', `
Expected candidate
${text(value?.candidate?.candidateId ?? 'Compile first')}
`)}${blocker ? `

${text(blocker)}

` : ''}${status ? `

${text(status)}

` : ''}${receipt ? `

EXPORT RECEIPT

Write completed

Completion covers this write and file sync only. It does not establish future integrity, directory durability, or authentication.

${renderTechnicalDetails('compile-export-receipt-details', `
Bundle ID
${text(receipt.bundleId ?? 'Unavailable')}
Candidate ID
${text(receipt.candidateId ?? 'Unavailable')}
SHA-256
${text(receipt.sha256 ?? 'Unavailable')}
Bytes
${number(receipt.byteLength)}
Authority
${text(receipt.authority ?? 'none')}
`)}
` : ''}
`; } function evidenceRail(state, busy) { diff --git a/preview/composition-model.mjs b/preview/composition-model.mjs index cffcecd..f39885c 100644 --- a/preview/composition-model.mjs +++ b/preview/composition-model.mjs @@ -252,14 +252,17 @@ export function createCompositionController({ operation, invoke, onChange = () = set({ pending: null, inputs: [input], message: 'Saved source selected. Start a draft to edit its proposed partition.' }); return true; }, - async addRevision(capabilityId, revisionId = null) { - if (!mutationAllowed() || operation === 'decompose' || state.draft || !validId(capabilityId, 'capability:') || (revisionId !== null && !validId(revisionId, 'revision:'))) return false; + async addRevision(capabilityId, revisionId = null, { isCurrent = () => true } = {}) { + if (!isCurrent() || !mutationAllowed() || operation === 'decompose' || state.draft || !validId(capabilityId, 'capability:') || (revisionId !== null && !validId(revisionId, 'revision:'))) return false; const max = operation === 'merge' ? 16 : 1; if (state.inputs.length >= max) return false; + const prior = { pending: state.pending, error: state.error, message: state.message }; const request = ++epoch; const identity = workspaceIdentity; set({ pending: 'revision', error: null, message: 'Opening saved skill revision…' }); - if (identity !== workspaceIdentity) return false; + if (identity !== workspaceIdentity || request !== epoch) return false; + if (!isCurrent()) { set(prior); return false; } const result = await call('open_capability', { capabilityId, revisionId }); if (identity !== workspaceIdentity || request !== epoch) return false; + if (!isCurrent()) { set(prior); return false; } const input = result?.outcome === 'opened' ? revisionInput(result.capability) : null; if (!input || input.reference.capabilityId !== capabilityId || (revisionId ? input.reference.revisionId !== revisionId : input.reference.revisionId !== input.latestRevisionId) || state.inputs.some(item => item.reference.kind === 'revision' && item.reference.capabilityId === input.reference.capabilityId && item.reference.revisionId === input.reference.revisionId)) { fail(result); return false; } set({ pending: null, inputs: [...state.inputs, input], message: 'Saved skill revision selected.' }); diff --git a/preview/composition-skill-handoff.mjs b/preview/composition-skill-handoff.mjs new file mode 100644 index 0000000..b16d6fb --- /dev/null +++ b/preview/composition-skill-handoff.mjs @@ -0,0 +1,31 @@ +// Presentation/navigation only. Native reads resolve the saved reference. +const exactId = (value, prefix) => typeof value === 'string' && new RegExp(`^${prefix}:[a-f0-9]{64}$`).test(value); + +export function compositionResultSelection(state, capabilityId, revisionId) { + if (!state?.bridgeAvailable || state.pending || !exactId(capabilityId, 'capability') || !exactId(revisionId, 'revision')) return null; + const result = state.results?.find(item => item.id === capabilityId && item.revision?.id === revisionId); + return result ? { capabilityId, revisionId } : null; +} + +export function compositionResultIssue({ composition, skills, capabilityId, revisionId }) { + if (!compositionResultSelection(composition.getState(), capabilityId, revisionId)) return 'This saved result is no longer available. Open the current composition results.'; + const state = skills.getState(); + if (!state.bridgeAvailable) return 'Open Rangoon desktop to inspect this saved skill.'; + if (state.pending) return 'Wait for the current skill operation to finish.'; + if (skills.hasUnsavedDraft(capabilityId)) return 'Save or discard this skill’s unsaved edits in Skills before opening the saved result.'; + return null; +} + +export async function openCompositionResultInSkills({ composition, skills, capabilityId, revisionId, isCurrent }) { + if (!isCurrent() || compositionResultIssue({ composition, skills, capabilityId, revisionId })) return false; + // Skills is pending during its read; only the origin and retained-draft guards apply here. + const current = () => isCurrent() && Boolean(compositionResultSelection(composition.getState(), capabilityId, revisionId)) && !skills.hasUnsavedDraft(capabilityId); + const opened = await skills.open(capabilityId, revisionId, { isCurrent: current }); + return Boolean(opened && current()); +} + +export function compositionResultFocus(state, selection) { + if (!selection || state?.pending) return null; + return state?.selected?.id === selection.capabilityId && state.selected.revision?.id === selection.revisionId && state.viewedRevisionId === selection.revisionId + ? '#skills-editor-title' : '#skills-title'; +} diff --git a/preview/composition-view.mjs b/preview/composition-view.mjs index 2f35c48..fab5b41 100644 --- a/preview/composition-view.mjs +++ b/preview/composition-view.mjs @@ -1,3 +1,4 @@ +import { compositionResultSelection } from './composition-skill-handoff.mjs'; import { escapeText } from './analysis-model.mjs'; import { icon } from './icons.mjs'; import { byteRangeText, textareaSelectionRange } from './composition-model.mjs'; @@ -112,7 +113,7 @@ function inputPicker(state, ui = {}) { const revisions = history.length ? history : [{ id: item.latestRevisionId, title: item.title, current: true }]; const matchedItem = matchesFilter(filter, item.title, item.id, item.latestRevisionId); const shownRevisions = matchedItem ? revisions : revisions.filter(revision => matchesFilter(filter, revision.title, revision.id)); - return shownRevisions.length ? `
${icon('skill', { size: 15 })}${text(item.title)} ${text(short(item.latestRevisionId))}
${shownRevisions.map(revision => ``).join('')}
` : ''; + return shownRevisions.length ? `
${icon('skill', { size: 16 })}${text(item.title)} ${text(short(item.latestRevisionId))}
${shownRevisions.map(revision => ``).join('')}
` : ''; }).join(''); const empty = state.status === 'unavailable' ? 'Open this route in Rangoon desktop app. Browser preview cannot invent saved records.' : state.status === 'loading' ? 'Loading saved workspace records…' : state.status === 'failed' ? 'Saved records unavailable. Existing draft stays in memory.' : 'No saved records available yet.'; const sourceMode = state.operation === 'decompose'; @@ -128,8 +129,14 @@ function selectedInputs(state) { const locked = Boolean(state.draft); const countText = locked ? `${values.length} saved input${values.length === 1 ? '' : 's'} in this recipe` : state.operation === 'decompose' ? 'Choose one saved source.' : state.operation === 'merge' ? 'Choose 2–16 pinned revisions.' : 'Choose one pinned revision.'; const validInputCount = state.operation === 'merge' ? values.length >= 2 && values.length <= 16 : values.length === 1; - const action = locked ? '

Inputs locked after draft start. Discard draft to change them.

' : ``; - return `

PINNED INPUTS

${text(countText)}

${action}
${values.length ? `
    ${values.map((item, index) => `
  1. ${text(inputTitle(item))}${inputKind(item) === 'revision' && item.latestRevisionId && item.reference?.revisionId !== item.latestRevisionId ? 'Historical · ' : ''}${text(short(inputIdentity(item)))} · ${Number(item.content ? bytes(item.content) : item.byteLength ?? 0).toLocaleString()} bytes${inputKind(item) === 'revision' && item.history?.length ? `` : ''}
    ${locked ? '' : `
    `}
  2. `).join('')}
` : `

${text(countText)} Exact selected revisions remain pinned; no latest revision is substituted silently.

`}
`; + const count = values.length; + const noun = state.operation === 'decompose' ? 'source' : 'revision'; + const requirement = state.operation === 'merge' + ? count < 2 ? `Add ${2 - count} more saved revision${2 - count === 1 ? '' : 's'} to begin.` : count > 16 ? `Remove ${count - 16} revision${count - 16 === 1 ? '' : 's'}; maximum 16.` : 'Selection complete. Start a draft to arrange content.' + : count === 0 ? `Choose one saved ${noun} to begin.` : count > 1 ? `Keep one saved ${noun}; remove ${count - 1}.` : 'Selection complete. Start a draft to arrange content.'; + const selectionHelp = locked ? '' : `

${count} ${noun}${count === 1 ? '' : 's'} selected. ${requirement}

`; + const action = locked ? '

Inputs locked after draft start. Discard draft to change them.

' : ``; + return `

PINNED INPUTS

${text(countText)}

${action}
${selectionHelp}${values.length ? `
    ${values.map((item, index) => `
  1. ${text(inputTitle(item))}${inputKind(item) === 'revision' && item.latestRevisionId && item.reference?.revisionId !== item.latestRevisionId ? 'Historical · ' : ''}${text(short(inputIdentity(item)))} · ${Number(item.content ? bytes(item.content) : item.byteLength ?? 0).toLocaleString()} bytes${inputKind(item) === 'revision' && item.history?.length ? `` : ''}
    ${locked ? '' : `
    `}
  2. `).join('')}
` : `

${text(countText)} Exact selected revisions remain pinned; no latest revision is substituted silently.

`}
`; } // Presentation-only byte-boundary scan: never copies/decodes the full selected @@ -166,9 +173,17 @@ function placementHint(state, range) { return placed ? 'Existing placements of this range will be reassigned. Duplicate keeps both.' : 'Place source-backed text in this output; the original file stays unchanged.'; } +function inspectorOutputs(state, ui = {}) { + const outputs = state.draft?.outputs ?? []; + const active = selectionContext(state, ui).outputIndex; + const pieces = outputs.reduce((count, output) => count + (output.pieces?.length ?? 0), 0); + const unresolved = (state.draft?.conflicts ?? []).filter(item => !String(item.resolution ?? '').trim()).length; + return `

Outputs

${outputs.length} output${outputs.length === 1 ? '' : 's'} · ${pieces} piece${pieces === 1 ? '' : 's'} · ${unresolved} unresolved declaration${unresolved === 1 ? '' : 's'}

Choose an output to edit its recipe. Original files stay unchanged.

${outputs.map((output, index) => ``).join('') || '

No outputs in this draft.

'}
`; +} + function workingSelection(state, ui = {}) { const context = selectionContext(state, ui); - return `

WORKING SELECTION

${text(context.source ? inputTitle(context.source) : 'Choose source text')}

${context.range ? `${context.range.endByte - context.range.startByte} bytes selected · original read-only` : 'Select a section or highlight exact source text.'}

${text(context.excerpt)}
Destination${text(state.draft?.outputs?.[context.outputIndex]?.title || 'Untitled output')}${text(targetLabel(state.targets?.[context.outputIndex], state.targetDetails?.[context.outputIndex]))}
Selection details

${text(context.range ? `${inputIdentity(context.source)} · ${rangeLabel(context.range)}` : 'No source range selected.')}

Recipe edits leave original files unchanged.

`; + return `

WORKING SELECTION

${text(context.source ? inputTitle(context.source) : 'Choose source text')}

${context.range ? `${context.range.endByte - context.range.startByte} bytes selected · original read-only` : 'Select a section or highlight exact source text.'}

${text(context.excerpt)}
Destination${text(state.draft?.outputs?.[context.outputIndex]?.title || 'Untitled output')}${text(targetLabel(state.targets?.[context.outputIndex], state.targetDetails?.[context.outputIndex]))}
Selection details

${text(context.range ? `${inputIdentity(context.source)} · ${rangeLabel(context.range)}` : 'No source range selected.')}

Original input remains read-only. Reasons and annotations remain visible with every preview.

Recipe edits leave original files unchanged.

`; } function rangeActions(state, ui = {}) { @@ -239,7 +254,7 @@ function annotationList(state) { return `

COVERAGE RECORDS

Exceptions and conflicts

${annotations.map(([kind, title]) => `

${title}

${(draft?.[kind] ?? []).map((value, index) => `
${text(rangeLabel(value.range))}
`).join('') || '

None.

'}
`).join('')}

Manual conflicts

Declarations document local context. A resolution is not proof of semantic safety.

${(draft?.conflicts ?? []).map((value, index) => `
${text(value.title)}${(value.ranges ?? []).map(rangeLabel).join(' · ')}
`).join('') || '

No declared conflicts.

'}

Select at least two source ranges with “Add range to conflict” in inspector.

`; } -function previewPanel(state) { +function previewPanel(state, resultHandoff = {}) { const envelope = state.preview; const preview = envelope?.preview ?? envelope; const core = preview?.core ?? preview; @@ -249,7 +264,7 @@ function previewPanel(state) { const saveable = Boolean(preview?.saveable); const stale = Boolean(state.previewStale); const saved = Array.isArray(state.results) && state.results.length > 0; - return `

NATIVE PREVIEW

${saved ? 'Composition saved' : stale ? 'Preview stale' : previewReady ? saveable ? 'Preview ready' : 'Preview blocked' : 'Preview required'}

${saved ? 'Saved local composition. Open returned skills below.' : stale ? 'Recipe changed or preview failed. Inspect a new native preview before saving.' : previewReady ? 'Host returned this exact preview; it is not an approval or execution authority.' : 'Native host computes output content, coverage and saveability.'}

${diagnostics.length ? `
    ${diagnostics.map(item => `
  • ${text(item.message ?? item.code ?? 'Blocked by local validation.')}
  • `).join('')}
` : ''}${outputs.length ? `
${outputs.map((output, index) => `
Output ${Number(output.outputIndex ?? index) + 1}: ${text(output.title ?? state.draft?.outputs?.[index]?.title ?? 'Untitled')} · ${Number(output.byteLength ?? bytes(output.content ?? '')).toLocaleString()} bytes · ${text(preview?.appliedOutputs?.[index]?.kind === 'append' ? 'update existing' : 'create new')}
${text(output.content ?? '')}
`).join('')}
` : ''}${saved ? `

Actual saved skills

${state.results.map(item => ``).join('')}
` : ``}
`; + return `

NATIVE PREVIEW

${saved ? 'Composition saved' : stale ? 'Preview stale' : previewReady ? saveable ? 'Preview ready' : 'Preview blocked' : 'Preview required'}

${saved ? 'Saved local composition. Open returned skills below.' : stale ? 'Recipe changed or preview failed. Inspect a new native preview before saving.' : previewReady ? 'Host returned this exact preview; it is not an approval or execution authority.' : 'Native host computes output content, coverage and saveability.'}

${state.error && !saved ? '

Draft kept. Check the message above before retrying.

' : ''}${diagnostics.length ? `
    ${diagnostics.map(item => `
  • ${text(item.message ?? item.code ?? 'Blocked by local validation.')}
  • `).join('')}
` : ''}${outputs.length ? `
${outputs.map((output, index) => `
Output ${Number(output.outputIndex ?? index) + 1}: ${text(output.title ?? state.draft?.outputs?.[index]?.title ?? 'Untitled')} · ${Number(output.byteLength ?? bytes(output.content ?? '')).toLocaleString()} bytes · ${text(preview?.appliedOutputs?.[index]?.kind === 'append' ? 'update existing' : 'create new')}
${text(output.content ?? '')}
`).join('')}
` : ''}${saved ? `

Actual saved skills

${state.results.map(item => ``).join('')}

${text(resultHandoff.pending ? 'Opening saved revision…' : resultHandoff.error || 'Open a saved revision to inspect it in Skills.')}

` : `

Save locally

`}
`; } function coveragePanel(state) { @@ -257,16 +272,37 @@ function coveragePanel(state) { return `

COVERAGE

Source coverage

${coverage.length ? `
    ${coverage.map(item => `
  1. ${text(item.disposition ?? 'unknown')}${text(rangeLabel(item.range))}${item.duplicationAcknowledged ? ' · acknowledged duplicate' : ''}
  2. `).join('')}
` : '

Prepare a native preview to inspect copied, duplicated, replaced, excluded and unassigned byte spans.

'}
`; } +function compositionToolbar(state) { + const resultLabel = state.dirty ? 'Unsaved draft' : state.results?.length ? 'Saved local result' : 'Draft unchanged'; + return `
+ +
History
+ + +
+
Layout
+
${resultLabel}
+
`; +} + +function compositionGuide() { + return `
  1. ${icon('source', { size: 16 })}Select inputs
  2. ${icon('edit', { size: 16 })}Arrange content
  3. ${icon('check', { size: 16 })}Preview & review
  4. ${icon('save', { size: 16 })}Save locally
`; +} + export function renderCompositionView(state, graphUi = {}) { const operation = state.operation ?? 'decompose'; const phase = state.draft ? 'recipe' : 'inputs'; const layout = graphUi.workspaceLayout ?? { desktop: false, left: 240, right: 320, leftCollapsed: false, rightCollapsed: false }; const dock = (side, label, body, needsRestore = false) => `
${needsRestore && layout[`${side}Collapsed`] ? '' : ''}${body.replace('