@timurproko/a1 0.2.6-dev.734 → 0.2.6

package/dist/ui/components/value-menu.js

@@ -1,13 +1,14 @@
 import { overlaySpan } from "./spans.js";
 import { displayWidth, padToWidth } from "./text.js";
-/** Where the menu is placed: below its anchor where there is room, else above. */
+/**
+ * Where the menu is placed: over its anchor, so the value in effect sits on the very
+ * row it was read from, shifted only as far as the body edges require.
+ */
 export function valueMenuFrame(state, anchor, layout) {
     const bodyTop = layout.bodyTop ?? 0;
     const bodyBottom = bodyTop + layout.bodyHeight;
-    const below = anchor.screenRow + 1;
-    const top = below + state.choices.length <= bodyBottom
-        ? below
-        : Math.max(bodyTop, anchor.screenRow - state.choices.length);
+    const currentIndex = Math.max(0, state.current === null ? 0 : state.choices.indexOf(state.current));
+    const top = Math.max(bodyTop, Math.min(anchor.screenRow - currentIndex, bodyBottom - state.choices.length));
     const previewWidth = Math.max(0, ...(state.previews ?? []).map(displayWidth));
     const previewColumns = previewWidth === 0 ? 0 : previewWidth + 1;
     const width = Math.max(...state.choices.map(choice => displayWidth(choice) + previewColumns + 4), 6);

package/docs/architecture/boundaries.md

@@ -53,7 +53,7 @@ The engine host removes A1's own obstacles to several Pi sessions in one process
 
 ## Planned multi-agent boundaries
 
-The multi-agent workspace feature, its dependency-free contracts, the structured-agent runtime, and the Node side of the terminal-host protocol were removed from `develop` while the multi-agent plan is on hold; their last state is preserved on the `archive/multi-agent-workspace` branch. A future implementation starts from the current codebase rather than from that copy. The boundary rules below remain the design intent for that work.
+The multi-agent workspace feature, its dependency-free contracts, the structured-agent runtime, and the Node side of the terminal-host protocol were removed from `develop`; their last state is commit `243eb7a7` in `develop` history. That structured-workspace plan was retired on 2026-10-10 in favor of `add-persistent-multi-agent-tabs`, where every tab runs the complete A1 UI under the native terminal host. A future implementation starts from the current codebase rather than from that copy. The boundary rules below remain the design intent for that work.
 
 The workspace feature may depend on workspace contracts and the structured/terminal-host foundations. Those foundations may depend only on dependency-free workspace contracts, never on product features, launch profiles, or each other unless an approved capability adds the dependency. Launch profiles do not import, initialize, launch, or connect to composed terminal-host infrastructure.
 

package/docs/architecture/evidence/terminal-host-spike/manual-one-pane-terminal-host.md

@@ -0,0 +1,70 @@
+# Manual one-pane terminal-host result
+
+## First manual artifact
+
+- Artifact: `native/terminal-host/target/debug/addone-terminal-host.exe`
+- SHA-256: `8d81db199687a9b8f195b4e40cb4b235de3ea00ffeb9cf55f9c64b1b3582cbba`
+- Size: 2,214,912 bytes
+- User-controlled run: one fullscreen `cmd.exe` pane inside Windows Terminal
+
+The user reported that typing commands, cursor movement, colors, Windows Terminal resize, and fast output worked correctly.
+
+The first artifact had one finding: `Ctrl+Shift+Q` did not exit.
+
+## Corrective artifact
+
+- Corrective artifact SHA-256: `1025a0823114477b7ab311ef55098647fc337b98a9194cf389fc124a047360bf`
+- Size: 2,227,712 bytes
+- Correction: accept `Ctrl+Q` or `Ctrl+Shift+Q`, including uppercase key delivery.
+- Correction: resolve Windows command shims through generic PATH/PATHEXT lookup; `pi` resolves to `C:\Users\tprokopiev\AppData\Roaming\npm\pi.cmd`.
+- Automated non-interactive result after correction: build, version/provenance, terminal model, PTY start, process exit, and cleanup passed.
+
+## Follow-up artifact
+
+- Artifact SHA-256: `b083af60eb8c4ca90438e4022c4e6d10b1410dda5554f554a8b814ba2cdee291`
+- Size: 2,238,464 bytes
+- Removed the host-owned quit shortcut so `Ctrl+Q` no longer intercepts input.
+- Added generic calling-shell ancestry detection; this Git Bash environment resolves to `C:\Program Files\Git\usr\bin\bash.exe --login -i`.
+- Disabled mouse capture by default so the outer terminal can provide native selection.
+- Added `Shift+PageUp`/`Shift+PageDown` and `Shift+Up`/`Shift+Down` host scrollback.
+- Non-interactive terminal model and PTY cleanup probes pass.
+
+## Theme-preservation artifact
+
+- Artifact SHA-256: `9989373d1ee28ac42bf7a6b1be02d68b92c23b71f14336db493a93d76df48198`
+- Size: 2,238,464 bytes
+- The frame composer now emits the outer terminal's default foreground/background for unstyled cells instead of forcing black.
+- The automated probe asserts the default-background sequence and passes.
+
+## Palette-preservation artifact
+
+- Artifact SHA-256: `203219f0ee79f3086467dccb5479b5749b09f8bac79623f84682545d374ba2f4`
+- Size: 2,238,976 bytes
+- Palette-indexed child colors are emitted as palette indexes (`38;5;n` / `48;5;n`) instead of being converted through Ghostty's default RGB palette.
+- The automated probe asserts default-background and palette-passthrough sequences and passes.
+
+## Scrollback artifact
+
+- Artifact SHA-256: `6280786d713abe37eb979e309d27b7ed1eb1f1e1e76e485b0bc5f9c357391ca6`
+- Size: 2,246,656 bytes
+- Mouse capture is enabled so wheel events reach the host; wheel and Shift+navigation scroll the retained terminal viewport.
+- Viewport changes mark the frame dirty before composition.
+- The non-interactive probe verifies retained scrollback, viewport movement, and repainted earlier content.
+- Use the outer terminal's modifier-based selection, usually Shift+drag in Windows Terminal, while pointer capture is active.
+
+## Selection and exit artifact
+
+- Artifact SHA-256: `fc6d9d1ecbaae4718b850a42b5e6868758d1f4c8c8e1a7645237115d1f1d883c`
+- Size: 2,266,624 bytes
+- Plain left-drag selects terminal content with one uniform white background and black foreground; release emits an OSC 52 clipboard write.
+- Double-click selects a word; triple-click selects a line.
+- Ctrl+C clears an active host selection before reaching the child; without selection, interrupt keys remain child-owned.
+- Mouse wheel scrolls the retained viewport. Home, End, PageUp, PageDown, and arrow keys remain child-owned; no host keyboard scroll binding is active.
+- PTY output-channel closure exits the host when the child session ends.
+- Non-interactive probes pass for terminal rendering, scrollback, selection, and PTY cleanup.
+
+Manual retest should verify plain drag selection, double/triple click, mouse wheel, and Ctrl+C selection clearing. No terminal was launched or driven by automation on the active workstation.
+
+## User acceptance
+
+The user manually confirmed that the vanilla-Pi terminal-host proof launches and works after the interaction corrections. The accepted one-pane pipeline includes theme/palette preservation, retained scrollback, mouse wheel scrolling, plain drag selection, word/line click selection, selection clearing with Ctrl+C, and child-owned interrupt behavior. Task 5.1 is accepted; the next gate is the 2×2 multi-pane proof.

package/docs/architecture/evidence/terminal-host-spike/manual-two-by-two-basic-terminal-host.md

@@ -0,0 +1,32 @@
+# Manual 2×2 terminal-host basic result
+
+## Exact artifact
+
+- Recorded at: `2026-08-14T16:13:20.217Z`
+- Source commit: `aeb7421ff5cc82bc5da04cfb0d356e8f8041b6cb`
+- Artifact: `native/terminal-host/target/debug/addone-terminal-host.exe`
+- SHA-256: `896e1b5d2e2730dfd8e591fe3bd565a2aa283fb3ec6f64e8345745c6afcf024d`
+- Size: 2,367,488 bytes
+- Invocation: user-controlled `npm run proof:terminal-host`
+- Surface: one existing outer terminal, one fixed tab, four independently PTY-backed Pi sessions
+
+## User-reported result
+
+The user manually confirmed all of the following against the exact artifact:
+
+- all four panes launched Pi;
+- the four-pane presentation worked without observed flicker;
+- pane focus and input routing worked;
+- changing or clicking the focused pane preserved content in every pane after the repaint correction.
+
+The user accepted this basic multi-pane proof result.
+
+## Explicit product disposition
+
+The fixed 2×2 grid and dashed pane outlines are disposable proof scaffolding, not an accepted production layout or UI design. This result proves the native multi-pane pipeline only. It does not approve carrying the fixed geometry, border treatment, or proof interaction model into the product.
+
+Production tabs and panes are expected later to use authoritative arbitrary layouts selected through the AddOne UI. The proof implementation may be removed or replaced after the exact-artifact 2×2 gate is finished; it must not become the default production workspace by inertia.
+
+## Gate scope
+
+This record does not complete the formal tasks 5.3–5.6 acceptance gate. High-rate output, broader terminal modes and interactions, resize/terminal-size measurements, resource observations, abnormal exits, isolated-worker requirements, and the final stop/go decision remain separately required. No automated physical terminal control was performed on the active workstation.

package/docs/architecture/evidence/terminal-host-spike/milestone-baseline.json

@@ -0,0 +1,115 @@
+{
+  "schema": "addone-multi-agent-milestone-baseline-v1",
+  "recordedAt": "2026-08-13T17:49:35.803Z",
+  "branch": "milestone/multi-agent-workspace",
+  "source": {
+    "commit": "8f4a45b907c8ccfca9b6fad52bd12c2bfe7b1172",
+    "tree": "f702a5cc6fba92a430d00634504039f0d8f4a304",
+    "developCommitAtBranchCreation": "8f4a45b907c8ccfca9b6fad52bd12c2bfe7b1172",
+    "originDevelopAtBranchCreation": "a526a63062b2f93db821c631548da885e20dc41d",
+    "tagAtCommit": null,
+    "cleanAtBranchCreation": true
+  },
+  "runtime": {
+    "platform": "win32",
+    "architecture": "x64",
+    "osRelease": "10.0.26200",
+    "node": "v24.16.0",
+    "npm": "11.13.0"
+  },
+  "package": {
+    "name": "@timurproko/addone",
+    "version": "0.1.5-dev.10",
+    "packageManager": "npm@11.13.0",
+    "nodeRange": ">=22.19.0 <25",
+    "lockfileVersion": 3,
+    "packageJsonSha256": "fb5966d03c9efb8d7aa726cc0582f34227aa525bf28baaa492c0a8af7fa0b617",
+    "packageLockSha256": "626b54ca5b5619c71a2dc7d667d49e4746bdea268be6fafa0635011f97824b80",
+    "localTarball": {
+      "filename": "timurproko-addone-0.1.5-dev.10.tgz",
+      "integrity": "sha512-7gLuq3Ec8uU76jXNWiBYUYMdK9O8roRROjs36xOnhJ+M9jboSRLdSBc0zQQXNqmsD6xa9b/87o/UqymmkbsFlg==",
+      "shasum": "370482e37ba171f7bd52f57eb6969c6c5940c2f4",
+      "sha256": "1046f005802bd1372ae232d5301d038511f7c9f072d1e0cb1a4ea1965b5f112f",
+      "size": 80121,
+      "unpackedSize": 370136,
+      "fileCount": 167,
+      "note": "Locally packed milestone source; it intentionally differs from the already-published dev.10 bytes because later documentation and update wording commits are present."
+    },
+    "registry": {
+      "latest": "0.1.4",
+      "next": "0.1.5-dev.10",
+      "nextIntegrity": "sha512-XjwhIsCbZjJbAwFQjWLnSsSS6Lb21Uls1MhkQUXOAiJh5Fg7IfQI4Ol4gMUGuzxSzOf38Cor+F+zB8nHLh79Dg==",
+      "nextShasum": "4af9a7697ad79209214889a8c56f3bb19228fb65"
+    }
+  },
+  "launchProfiles": {
+    "terminalCapability": "transparent",
+    "addone": {
+      "invocation": "a1",
+      "configurationRoot": "~/.a1/agent",
+      "projectTrust": "pi-default"
+    },
+    "pi": {
+      "invocation": "a1 pi",
+      "configurationRoot": "~/.pi/agent",
+      "environmentRule": "PI_CODING_AGENT_DIR removed",
+      "projectTrust": "pi-default"
+    },
+    "evidenceHashes": {
+      "documentationSha256": "0fcc0a7823dcdad2f00d6e2c82ba117d14b7cb2a2fcebfbb2615eafd94413003",
+      "contractsSha256": "bc63eeacdc65b89b0b4d84c2e25a4fb8f937d1864ab4275119a4a0aec707a38c",
+      "pathsSha256": "5a263fa07d3ccfd21a71721b43a99844d46f7cc15ed8f36caa556c1cc0cbbdfa",
+      "preparationSha256": "b5eb00f3c6ebbfda0dd9e8e793b6553b00720a4d24f24d5bcacf1d0f7183687d",
+      "isolationTestSha256": "9c72d63d2a4bcc143d73afbbe921821c3d813e10a4b0297288dff93bcb77d07e"
+    }
+  },
+  "gates": [
+    {
+      "command": "npm ci",
+      "passed": true,
+      "detail": "68 packages installed; 0 vulnerabilities"
+    },
+    {
+      "command": "npm run build",
+      "passed": true
+    },
+    {
+      "command": "npm run check",
+      "passed": true,
+      "detail": "typecheck, architecture, deprecated-dependency policy, 31 Vitest files/155 tests, and 1 release file/3 tests"
+    },
+    {
+      "command": "npm audit --audit-level=high --json",
+      "passed": true,
+      "detail": "0 vulnerabilities"
+    },
+    {
+      "command": "openspec validate --specs --strict --no-interactive",
+      "passed": true,
+      "detail": "7 main specifications"
+    },
+    {
+      "command": "openspec validate evolve-bare-a1-into-multi-agent-workspace --strict --no-interactive",
+      "passed": true
+    },
+    {
+      "command": "npm pack --ignore-scripts --json",
+      "passed": true,
+      "detail": "exact local tarball metadata and SHA-256 recorded"
+    }
+  ],
+  "releaseVerdict": {
+    "schema": "addone-development-preview-platform-verdict-v2",
+    "passed": true,
+    "certificationStatus": "uncertified-development-preview",
+    "terminalCapability": "transparent",
+    "physicalHostCertification": "deferred",
+    "crossPlatformCertification": "deferred",
+    "stableReleaseEligible": false
+  },
+  "desktopAutomation": "not-run",
+  "terminalApplicationsLaunched": false,
+  "physicalCertification": "deferred",
+  "stableReleaseEligible": false,
+  "passed": true
+}

package/docs/architecture/evidence/terminal-host-spike/owned-ui-foundation-prerequisite.json

@@ -0,0 +1,48 @@
+{
+  "schema": "addone-multi-agent-owned-ui-prerequisite-v1",
+  "milestone": "evolve-bare-a1-into-multi-agent-workspace",
+  "prerequisiteChange": "build-owned-pi-ui-foundation",
+  "recordedAt": "2026-08-17T12:31:58Z",
+  "result": "satisfied",
+  "acceptedBaselineCommit": "084d0fb7e4004bc4b83a0b28c8aaea736b558d44",
+  "hardenedFoundationCommit": "efb244472fa4e6499300533a3f535fe60ab7f948",
+  "publishedSourceCommit": "d407ed017a6f9216a9a0c62d85d7cd44803d4d2c",
+  "publication": {
+    "package": "@timurproko/addone@0.1.5-dev.11",
+    "tag": "next",
+    "workflowRun": "https://github.com/timurproko/addone/actions/runs/32030101549",
+    "integrity": "sha512-05GQdg7ZfvcEpI6wAvebyx/06JPnV5AUtSbptx7P3mzT28iU4yurP87uKIKsvpNwPzjMsr8k5RfiAeEyq/GfpQ==",
+    "latestPreserved": "0.1.4"
+  },
+  "acceptance": {
+    "sourcePortCoverage": "109 records and 29 behaviors; zero pending or stale entries",
+    "modalCoverage": "47 nodes, 111 transitions, and 36 settings instances",
+    "terminalParity": "54 checkpoints with zero differences",
+    "extensionBoundary": "validated public ExtensionUIContext translated through AddOne-owned contracts",
+    "zeroDebtGate": "passed",
+    "manualBaseAcceptance": "passed",
+    "prohibitedRuntimeOrPackagePatches": 0
+  },
+  "compositionBoundary": {
+    "ownedContractsComposableForStructuredTabs": true,
+    "terminalHostInitializationRequired": false,
+    "ptyCreationRequired": false,
+    "interactiveModeMutationRequired": false,
+    "deepPiImportsRequired": false
+  },
+  "milestoneAuthorization": {
+    "task5_4OwnedUiPrerequisite": "complete",
+    "structuredTabsMayBeginAtTask5_5": true,
+    "structuredTabsStartedByThisRecord": false,
+    "section6MayBegin": false,
+    "section6Blocker": "Section 6 additionally requires terminal-host proof acceptance; this record satisfies only the owned-UI prerequisite.",
+    "composedTerminalWorkAuthorized": false
+  },
+  "evidence": [
+    "evidence/owned-pi-ui-foundation/automated-evidence-7.35-zero-debt-final-gates.json",
+    "evidence/owned-pi-ui-foundation/zero-debt-architecture-audit.md",
+    "evidence/owned-pi-ui-foundation/manual-acceptance-pi-0.84.2-base-084d0fb.json",
+    "evidence/owned-pi-ui-foundation/owned-ui-shell-composability.json",
+    "evidence/owned-pi-ui-foundation/automated-evidence-8.5-next-publication.json"
+  ]
+}

package/docs/architecture/evidence/terminal-host-spike/terminal-host-provenance.json

@@ -0,0 +1,125 @@
+{
+  "schema": "a1-terminal-host-provenance-v1",
+  "recordedAt": "2026-08-20T09:25:48.307Z",
+  "change": "evolve-bare-a1-into-multi-agent-workspace",
+  "hostMode": "console-inside-existing-terminal",
+  "desktopApplicationRequired": false,
+  "sources": [
+    {
+      "name": "libghostty-vt",
+      "repository": "https://github.com/ghostty-org/ghostty",
+      "commit": "c5a21edfcbc2d5b46540ad91b7980aca31f5f1f3",
+      "committedAt": "2026-07-14T20:12:12-07:00",
+      "role": "terminal parsing, retained state, and input semantics",
+      "license": "MIT",
+      "licenseNotice": "Copyright (c) 2024 Mitchell Hashimoto, Ghostty contributors",
+      "licenseSha256": "3129de97bc7769d683e52ce02cb4eaecd2b0aab144b09d6325a1b135bdc87cc0",
+      "cleanSourceTree": true,
+      "licenseVerification": "verified-local-license-file"
+    },
+    {
+      "name": "portable-pty",
+      "version": "0.9.0",
+      "role": "ConPTY and Unix PTY/process ownership",
+      "license": "MIT",
+      "licenseNotice": "Copyright (c) 2018 Wez Furlong",
+      "licenseSha256": "c06f48b2acbbb4bb88345225c6d85264773528fe9fc99241cd255a7e32be632e",
+      "cleanSourceTree": true,
+      "licenseVerification": "verified-local-license-file"
+    },
+    {
+      "name": "crossterm",
+      "version": "0.29.0",
+      "registryChecksum": "d8b9f2e4c67f833b660cdb0a3523065869fb35570177239812ed4c905aeff87b",
+      "role": "outer-terminal raw mode and host input events",
+      "license": "MIT",
+      "cleanSourceTree": true,
+      "licenseVerification": "declared-license-recorded; license notice must be vendored before packaging"
+    }
+  ],
+  "rendererPolicy": {
+    "initial": "A1-owned buffered frame composer",
+    "ratatui": "optional evaluation candidate, not selected by default"
+  },
+  "excludedStacks": [
+    "Ghostty desktop application",
+    "Winghostty Win32 runtime",
+    "OpenGL/WGL",
+    "Metal",
+    "GTK",
+    "AppKit",
+    "Herdr",
+    "Node terminal parser",
+    "Node terminal renderer"
+  ],
+  "patchPolicy": {
+    "default": "retain upstream behavior without local patches",
+    "requiredPatchFields": [
+      "source revision",
+      "target revision",
+      "reason",
+      "tests",
+      "upstream synchronization decision",
+      "license impact"
+    ],
+    "behavioralTerminalPatchesRequireSeparateReview": true
+  },
+  "buildPrerequisites": {
+    "operatingSystems": [
+      "windows-10",
+      "windows-11"
+    ],
+    "architectures": [
+      "x64",
+      "arm64"
+    ],
+    "language": "Rust",
+    "zig": ">=0.15.2 <0.16",
+    "cToolchain": "Visual Studio 2022 Build Tools/MSVC on Windows",
+    "terminal": "user-owned terminal emulator",
+    "isolatedPhysicalWorkerRequired": true,
+    "guiSdkRequired": false,
+    "openGlRequired": false,
+    "win32WindowRuntimeRequired": false,
+    "localProbe": {
+      "rustAvailable": true,
+      "rustVersion": "1.97.1",
+      "zigAvailable": true,
+      "zigVersion": "0.15.2",
+      "requiredZigAvailable": true,
+      "nativeBuildAttempted": true,
+      "reason": "Rust 1.97.1 and Zig 0.15.2 are available; the clean console-host build and non-interactive probe pass."
+    }
+  },
+  "artifactManifestRequirements": [
+    "artifactPath",
+    "sha256",
+    "sizeBytes",
+    "signatureStatus",
+    "buildTimestamp",
+    "a1Commit",
+    "a1ProtocolVersion",
+    "libghosttyVtCommit",
+    "ptyComponentVersion",
+    "hostInputComponentVersion",
+    "rendererComponentIdentity",
+    "retainedComponents",
+    "adaptedComponents",
+    "compilerVersions",
+    "targetTriple",
+    "licenseHashes",
+    "buildCommand",
+    "dependencyCacheProvenance",
+    "cleanSourceTree",
+    "evidenceSchema",
+    "physicalVerdictReference"
+  ],
+  "checks": {
+    "license": "passed",
+    "provenance": "passed",
+    "sourceTreeHygiene": "passed",
+    "binaryBuild": "passed",
+    "physicalAutomation": "not-run"
+  },
+  "passed": true
+}

package/docs/architecture/evidence/terminal-host-spike/terminal-host-task-5-1.json

@@ -0,0 +1,56 @@
+{
+  "schema": "a1-terminal-host-task-5-1-v1",
+  "recordedAt": "2026-08-20T09:25:48.307Z",
+  "change": "evolve-bare-a1-into-multi-agent-workspace",
+  "task": "5.1",
+  "hostMode": "console-inside-existing-terminal",
+  "desktopWindowCreated": false,
+  "fullscreenRun": "not-run-user-controlled-only",
+  "toolchain": {
+    "rust": "1.97.1",
+    "cargo": "1.97.1",
+    "zig": "0.15.2",
+    "platform": "win32",
+    "architecture": "x64"
+  },
+  "artifact": {
+    "path": "native/terminal-host/target/debug/a1-terminal-host.exe",
+    "profile": "debug",
+    "sha256": "d1437d46d469a8823565a0428b57a1888bb327c2ce26d3cb51c0fb6fc88e4165",
+    "sizeBytes": 2394624
+  },
+  "source": {
+    "cargoTomlSha256": "8c6510f8d758189f24f91c1f044e93902a376e3c1a5bb71ca747603f03f0cc72",
+    "cargoLockSha256": "ec023df443170affda1ce69ddaa9489785fed1347d97bcb44a793607e61a20a2",
+    "buildScriptSha256": "54befce9dd9b1fbfadb388d8c4d1c97e1d6473660a075b7acc6baaddf54301c7",
+    "mainSha256": "6180f21f4dcfc0e1a8a4808a4312957eaff7bc7342660b3d449e8ea7ee164eed",
+    "ghosttyBindingSha256": "31747a4c5a4214059cea1d2ccab0b6245e74e05d5da3188271be4b331acb9231",
+    "libghosttyVtCommit": "c5a21edfcbc2d5b46540ad91b7980aca31f5f1f3",
+    "libghosttyVtLicenseSha256": "3129de97bc7769d683e52ce02cb4eaecd2b0aab144b09d6325a1b135bdc87cc0",
+    "portablePtyVersion": "0.9.0",
+    "crosstermVersion": "0.29.0"
+  },
+  "commands": [
+    {
+      "command": "cargo clean && npm run test:terminal-host",
+      "result": "passed"
+    },
+    {
+      "command": "a1-terminal-host.exe --version",
+      "result": "passed"
+    },
+    {
+      "command": "a1-terminal-host.exe --probe",
+      "result": "passed",
+      "detail": "created a retained terminal model, composed a frame, started cmd.exe through a PTY, waited for exit, and cleaned up without entering alternate-screen mode"
+    }
+  ],
+  "limitations": [
+    "No fullscreen interactive run was launched by the agent.",
+    "No user input or physical rendering acceptance is claimed.",
+    "One-pane manual terminal validation remains user-controlled.",
+    "Isolated-worker physical automation remains deferred."
+  ],
+  "passed": true,
+  "sourceCommit": "b26383ed6605b222d6b853eb232c6b94e0fdb7ff"
+}

package/docs/architecture/evidence/terminal-host-spike/terminal-host-task-5-3.json

@@ -0,0 +1,174 @@
+{
+  "schema": "a1-terminal-host-task-5-3-v1",
+  "recordedAt": "2026-08-20T09:25:48.307Z",
+  "change": "evolve-bare-a1-into-multi-agent-workspace",
+  "task": "5.3",
+  "sourceCommit": "b26383ed6605b222d6b853eb232c6b94e0fdb7ff",
+  "artifact": {
+    "path": "native/terminal-host/target/debug/a1-terminal-host.exe",
+    "profile": "debug",
+    "sha256": "d1437d46d469a8823565a0428b57a1888bb327c2ce26d3cb51c0fb6fc88e4165",
+    "sizeBytes": 2394624
+  },
+  "toolchain": {
+    "rust": "1.97.1",
+    "cargo": "1.97.1",
+    "zig": "0.15.2",
+    "platform": "win32",
+    "architecture": "x64"
+  },
+  "authority": {
+    "owner": "native-terminal-host",
+    "nodeRelay": false,
+    "rawPayloadExported": false,
+    "outerPresentationBufferedInNativeHost": true,
+    "controlPlanePayloads": "typed identity, topology, capability, lifecycle, recovery, and bounded diagnostics only"
+  },
+  "identityObservation": {
+    "schema": "a1-terminal-host-hot-path-v1",
+    "paneCount": 4,
+    "streamIdentities": [
+      1,
+      8,
+      15,
+      22
+    ],
+    "inputIdentities": [
+      2,
+      9,
+      16,
+      23
+    ],
+    "terminalModelIdentities": [
+      3,
+      10,
+      17,
+      24
+    ],
+    "renderDamageIdentities": [
+      4,
+      11,
+      18,
+      25
+    ],
+    "keyEncoderIdentities": [
+      5,
+      12,
+      19,
+      26
+    ],
+    "mouseEncoderIdentities": [
+      6,
+      13,
+      20,
+      27
+    ],
+    "selectionIdentities": [
+      7,
+      14,
+      21,
+      28
+    ],
+    "allIdentitySetsUnique": true,
+    "presentationWrites": 2,
+    "presentationBytes": 4618,
+    "panes": [
+      {
+        "paneId": "pane-1",
+        "sessionId": "session-1",
+        "ptyOutputChunks": 8,
+        "ptyOutputBytes": 272,
+        "terminalModelWrites": 8,
+        "terminalModelBytes": 272,
+        "inputWrites": 2,
+        "inputBytes": 23,
+        "renderPasses": 2,
+        "renderedBytes": 642
+      },
+      {
+        "paneId": "pane-2",
+        "sessionId": "session-2",
+        "ptyOutputChunks": 8,
+        "ptyOutputBytes": 272,
+        "terminalModelWrites": 8,
+        "terminalModelBytes": 272,
+        "inputWrites": 2,
+        "inputBytes": 23,
+        "renderPasses": 2,
+        "renderedBytes": 668
+      },
+      {
+        "paneId": "pane-3",
+        "sessionId": "session-3",
+        "ptyOutputChunks": 9,
+        "ptyOutputBytes": 272,
+        "terminalModelWrites": 9,
+        "terminalModelBytes": 272,
+        "inputWrites": 2,
+        "inputBytes": 23,
+        "renderPasses": 2,
+        "renderedBytes": 698
+      },
+      {
+        "paneId": "pane-4",
+        "sessionId": "session-4",
+        "ptyOutputChunks": 8,
+        "ptyOutputBytes": 272,
+        "terminalModelWrites": 8,
+        "terminalModelBytes": 272,
+        "inputWrites": 2,
+        "inputBytes": 23,
+        "renderPasses": 2,
+        "renderedBytes": 726
+      }
+    ]
+  },
+  "nativePrimitiveProbe": {
+    "keyEncoding": true,
+    "textImeEncoding": true,
+    "mouseEncoding": true,
+    "paneRelativeMouse": true,
+    "selection": true,
+    "clipboardOsc52Encoding": true,
+    "keyAndMouseModesRefreshedFromRetainedTerminal": true,
+    "nodeRelay": false
+  },
+  "staticBoundaryChecks": {
+    "nodeProtocolHotPathPayloadsAbsent": true,
+    "nativeImplementationDependenciesAbsentFromNodeManifest": true,
+    "probeRunnerUsesInheritedStdio": true,
+    "explicitTransparentModesRemainIndependent": true
+  },
+  "commands": [
+    {
+      "command": "npm run test:terminal-host",
+      "result": "passed"
+    },
+    {
+      "command": "npm run check:architecture",
+      "result": "passed"
+    },
+    {
+      "command": "npx vitest run test/repository-governance/native-host-boundary.test.ts test/repository-governance/terminal-architecture-policy.test.ts",
+      "result": "38 tests passed"
+    },
+    {
+      "command": "npm test",
+      "result": "285 tests passed"
+    },
+    {
+      "command": "npm run typecheck",
+      "result": "passed"
+    },
+    {
+      "command": "openspec validate evolve-bare-a1-into-multi-agent-workspace --strict",
+      "result": "passed"
+    }
+  ],
+  "limitations": [
+    "No physical terminal automation was run on the active workstation.",
+    "The text/IME gate validates the native composed-Unicode input path; operating-system IME behavior remains a task 5.4/5.5 physical workload where supported.",
+    "High-rate workloads, resource and latency measurements, abnormal exits, and exact-artifact physical acceptance remain tasks 5.4 and 5.5."
+  ],
+  "passed": true
+}