@timurproko/a1 0.2.7-dev.792 → 0.2.7-dev.794

package/dist/native/darwin-arm64/manifest.json

@@ -1,15 +1,17 @@
 {
-  "schema": "a1-process-guardian-artifact-v1",
-  "protocolVersion": 1,
+  "schema": "a1-process-guardian-artifact-v2",
+  "kind": "node-addon",
+  "nodeApi": 9,
+  "protocolVersion": 2,
   "crateVersion": "0.1.0-dev",
   "platform": "darwin",
   "architecture": "arm64",
   "capability": "supported",
-  "builtAt": "2026-10-17T13:02:46.502Z",
+  "builtAt": "2026-10-18T08:41:09.288Z",
   "artifact": {
-    "filename": "process-guardian",
-    "sha256": "47e9052599983a6bb0078ce6203ba18d71bec0b7b94e6a49019d11d46c3fbeca",
-    "size": 410368
+    "filename": "process-guardian.node",
+    "sha256": "a87eaaffcd986b624c8b044b756446cc1bdaf4334a1775b97820542fe34f9fb7",
+    "size": 456080
   },
   "provenance": {
     "language": "Rust",

package/dist/native/darwin-arm64/terminal-host-THIRD-PARTY-NOTICES.txt

@@ -1,6 +1,6 @@
 Third-party notices for the A1 terminal host
 
-The terminal-host executable and its session-writer lock include the following components.
+The terminal-host Node-API addon includes the following components.
 
 ==============================================================================
 anyhow 1.0.104

package/dist/native/darwin-arm64/terminal-host.manifest.json

@@ -1,5 +1,7 @@
 {
-  "schema": "a1-terminal-host-artifact-v1",
+  "schema": "a1-terminal-host-artifact-v2",
+  "kind": "node-addon",
+  "nodeApi": 9,
   "protocolVersion": 1,
   "generation": 1,
   "crateVersion": "0.1.0-dev",
@@ -7,21 +9,21 @@
   "architecture": "arm64",
   "target": "aarch64-apple-darwin",
   "capability": "supported",
-  "builtAt": "2026-10-17T13:07:42.805Z",
+  "builtAt": "2026-10-18T08:43:27.368Z",
   "artifact": {
-    "filename": "terminal-host",
-    "sha256": "da3e4930eb0249992da208ac2ab8f38f882388e810a7bcc0c48152f03b245129",
-    "size": 5337024
+    "filename": "terminal-host.node",
+    "sha256": "af7b9fee2efa8478c728465031e73fb316b6b7012d11de0364130b0acd1b6e62",
+    "size": 5173904
   },
-  "sessionLock": {
-    "filename": "a1_session_lock.node",
-    "sha256": "44682ec58d0de84a447535fa579fa847ffbc332a446cc60fd02e52b73716a03e",
-    "size": 577680
+  "entry": {
+    "filename": "dist/foundation/resident-tabs/host-entry.js",
+    "sha256": "4b1f702cc9980ffa531cf3e9963b884eaa35120d04d5c195ea3308f501d8d557",
+    "size": 1315
   },
   "notices": {
     "filename": "terminal-host-THIRD-PARTY-NOTICES.txt",
-    "sha256": "fca50b98ad080b268a21267295bc8367ffdb0652b9f6a1cb26a81e35f8e58d05",
-    "size": 540069
+    "sha256": "5f18fd5d1863f7282c9c3e249b9a25df1b454d26cc737b92b3360ca877e50120",
+    "size": 540046
   },
   "provenance": {
     "language": "Rust",
@@ -34,8 +36,7 @@
     "zigVersion": "0.15.2",
     "rustVersion": "rustc 1.99.1 (58cf8f9c3 2026-10-13)",
     "features": {
-      "executable": [],
-      "sessionLock": [
+      "addon": [
         "node-addon"
       ]
     },

package/dist/native/darwin-x64/manifest.json

@@ -1,21 +1,23 @@
 {
-  "schema": "a1-process-guardian-artifact-v1",
-  "protocolVersion": 1,
+  "schema": "a1-process-guardian-artifact-v2",
+  "kind": "node-addon",
+  "nodeApi": 9,
+  "protocolVersion": 2,
   "crateVersion": "0.1.0-dev",
   "platform": "darwin",
   "architecture": "x64",
   "capability": "supported",
-  "builtAt": "2026-10-17T13:02:52.732Z",
+  "builtAt": "2026-10-18T08:41:16.359Z",
   "artifact": {
-    "filename": "process-guardian",
-    "sha256": "80ac279b688fe2642c43a40669ff35afc478fc5a8bda7f6cc2ac88a98431a4ce",
-    "size": 394768
+    "filename": "process-guardian.node",
+    "sha256": "783a65f0de287a1c02cd5429dbe97bc8633f4cc8a7b92e3e961180b9bdcff814",
+    "size": 444248
   },
   "provenance": {
     "language": "Rust",
     "cargoLock": "native/process-guardian/Cargo.lock",
     "sourceRoot": "native/process-guardian",
     "signatureStatus": "ci-attestation-required",
-    "identityCheck": "executed"
+    "identityCheck": "mach-o-header"
   }
 }

package/dist/native/darwin-x64/terminal-host-THIRD-PARTY-NOTICES.txt

@@ -1,6 +1,6 @@
 Third-party notices for the A1 terminal host
 
-The terminal-host executable and its session-writer lock include the following components.
+The terminal-host Node-API addon includes the following components.
 
 ==============================================================================
 anyhow 1.0.104

package/dist/native/darwin-x64/terminal-host.manifest.json

@@ -1,5 +1,7 @@
 {
-  "schema": "a1-terminal-host-artifact-v1",
+  "schema": "a1-terminal-host-artifact-v2",
+  "kind": "node-addon",
+  "nodeApi": 9,
   "protocolVersion": 1,
   "generation": 1,
   "crateVersion": "0.1.0-dev",
@@ -7,21 +9,21 @@
   "architecture": "x64",
   "target": "x86_64-apple-darwin",
   "capability": "supported",
-  "builtAt": "2026-10-17T13:11:38.751Z",
+  "builtAt": "2026-10-18T08:45:43.907Z",
   "artifact": {
-    "filename": "terminal-host",
-    "sha256": "d1b524a5bd2da42a36e40f9b2e7c27b1d0143ecff88982fea9a20ac0367472e8",
-    "size": 5815872
+    "filename": "terminal-host.node",
+    "sha256": "1a5465ea12ecfe76d5f0c8fd5c11dee99597b4206a7e9ece01b37fc5c477c211",
+    "size": 5656912
   },
-  "sessionLock": {
-    "filename": "a1_session_lock.node",
-    "sha256": "d1418e81a3c8f48139b90aff322d2d860eab3e033cb8d25ff7760cc9e3331555",
-    "size": 516344
+  "entry": {
+    "filename": "dist/foundation/resident-tabs/host-entry.js",
+    "sha256": "4b1f702cc9980ffa531cf3e9963b884eaa35120d04d5c195ea3308f501d8d557",
+    "size": 1315
   },
   "notices": {
     "filename": "terminal-host-THIRD-PARTY-NOTICES.txt",
-    "sha256": "4b96f6f99efd3091fad24422c9cfade9b40a96c6b4b9c97b38ec1de05c290991",
-    "size": 552243
+    "sha256": "ebddf265d324c1393ba2f52b5fa411709ae2179bfe1aa7bb5bd84f0adc4ccef0",
+    "size": 552220
   },
   "provenance": {
     "language": "Rust",
@@ -34,12 +36,11 @@
     "zigVersion": "0.15.2",
     "rustVersion": "rustc 1.99.1 (58cf8f9c3 2026-10-13)",
     "features": {
-      "executable": [],
-      "sessionLock": [
+      "addon": [
         "node-addon"
       ]
     },
     "signatureStatus": "ci-attestation-required",
-    "identityCheck": "executed"
+    "identityCheck": "mach-o-header"
   }
 }

package/dist/native/linux-x64/manifest.json

@@ -1,15 +1,17 @@
 {
-  "schema": "a1-process-guardian-artifact-v1",
-  "protocolVersion": 1,
+  "schema": "a1-process-guardian-artifact-v2",
+  "kind": "node-addon",
+  "nodeApi": 9,
+  "protocolVersion": 2,
   "crateVersion": "0.1.0-dev",
   "platform": "linux",
   "architecture": "x64",
   "capability": "supported",
-  "builtAt": "2026-10-17T13:02:43.567Z",
+  "builtAt": "2026-10-18T08:40:48.343Z",
   "artifact": {
-    "filename": "process-guardian",
-    "sha256": "94a96fa9d5178a1949d05c6d6cc9504f3030cd49a096cd9db20dd29860ea5884",
-    "size": 411760
+    "filename": "process-guardian.node",
+    "sha256": "118e5954e3864672bd8482ab7edf419cb27dcdf2533720316979b7f5cc5a53a5",
+    "size": 491520
   },
   "provenance": {
     "language": "Rust",

package/dist/native/linux-x64/terminal-host-THIRD-PARTY-NOTICES.txt

@@ -1,6 +1,6 @@
 Third-party notices for the A1 terminal host
 
-The terminal-host executable and its session-writer lock include the following components.
+The terminal-host Node-API addon includes the following components.
 
 ==============================================================================
 anyhow 1.0.104

package/dist/native/linux-x64/terminal-host.manifest.json

@@ -1,5 +1,7 @@
 {
-  "schema": "a1-terminal-host-artifact-v1",
+  "schema": "a1-terminal-host-artifact-v2",
+  "kind": "node-addon",
+  "nodeApi": 9,
   "protocolVersion": 1,
   "generation": 1,
   "crateVersion": "0.1.0-dev",
@@ -7,21 +9,21 @@
   "architecture": "x64",
   "target": "x86_64-unknown-linux-gnu",
   "capability": "supported",
-  "builtAt": "2026-10-17T13:05:45.852Z",
+  "builtAt": "2026-10-18T08:43:45.076Z",
   "artifact": {
-    "filename": "terminal-host",
-    "sha256": "9be29443a6ea4ce4718a93539adf9fb38dd6fdc0beb110485cd01a1fc93e5918",
-    "size": 6435192
+    "filename": "terminal-host.node",
+    "sha256": "843b10ab29eddf859a74a97875ba646a90917d9ec78445474895bb64f6e0772a",
+    "size": 6353496
   },
-  "sessionLock": {
-    "filename": "a1_session_lock.node",
-    "sha256": "bae1affd0d1ce906258afbc97f762796630c73ab314846d10b6a5bd0fe63f54f",
-    "size": 740560
+  "entry": {
+    "filename": "dist/foundation/resident-tabs/host-entry.js",
+    "sha256": "4b1f702cc9980ffa531cf3e9963b884eaa35120d04d5c195ea3308f501d8d557",
+    "size": 1315
   },
   "notices": {
     "filename": "terminal-host-THIRD-PARTY-NOTICES.txt",
-    "sha256": "526eb656e7fb47474bcfb07cf922a95a4920d6c4130478902e3c8ea5bb805e04",
-    "size": 577577
+    "sha256": "c3c1874dfdc10608f46e7576486b7eb6f43eb85460ce7b81db02e6db32af1cc2",
+    "size": 577554
   },
   "provenance": {
     "language": "Rust",
@@ -34,8 +36,7 @@
     "zigVersion": "0.15.2",
     "rustVersion": "rustc 1.99.1 (58cf8f9c3 2026-10-13)",
     "features": {
-      "executable": [],
-      "sessionLock": [
+      "addon": [
         "node-addon"
       ]
     },

package/dist/native/win32-x64/manifest.json

@@ -1,15 +1,17 @@
 {
-  "schema": "a1-process-guardian-artifact-v1",
-  "protocolVersion": 1,
+  "schema": "a1-process-guardian-artifact-v2",
+  "kind": "node-addon",
+  "nodeApi": 9,
+  "protocolVersion": 2,
   "crateVersion": "0.1.0-dev",
   "platform": "win32",
   "architecture": "x64",
   "capability": "supported",
-  "builtAt": "2026-10-17T13:03:20.189Z",
+  "builtAt": "2026-10-18T08:41:31.607Z",
   "artifact": {
-    "filename": "process-guardian.exe",
-    "sha256": "231de38cbd11f08c493027290c523c589d8ffbfa61d9a8e6b55c2300ed50dbad",
-    "size": 288256
+    "filename": "process-guardian.node",
+    "sha256": "6299956800f1ab62f2e5bb4a1e4d61dbd45ce70a7711cbb9aca8f23033bdbbaf",
+    "size": 402432
   },
   "provenance": {
     "language": "Rust",

package/dist/native/win32-x64/terminal-host-THIRD-PARTY-NOTICES.txt

@@ -1,6 +1,6 @@
 Third-party notices for the A1 terminal host
 
-The terminal-host executable and its session-writer lock include the following components.
+The terminal-host Node-API addon includes the following components.
 
 ==============================================================================
 anyhow 1.0.104

package/dist/native/win32-x64/terminal-host.manifest.json

@@ -1,5 +1,7 @@
 {
-  "schema": "a1-terminal-host-artifact-v1",
+  "schema": "a1-terminal-host-artifact-v2",
+  "kind": "node-addon",
+  "nodeApi": 9,
   "protocolVersion": 1,
   "generation": 1,
   "crateVersion": "0.1.0-dev",
@@ -7,21 +9,21 @@
   "architecture": "x64",
   "target": "x86_64-pc-windows-msvc",
   "capability": "supported",
-  "builtAt": "2026-10-17T13:09:09.866Z",
+  "builtAt": "2026-10-18T08:44:54.428Z",
   "artifact": {
-    "filename": "terminal-host.exe",
-    "sha256": "0b6770b00388985dc7e65e6f8fffc93eec60f85621462e388c8b25d30a0bf3c8",
-    "size": 5740544
+    "filename": "terminal-host.node",
+    "sha256": "de82227898a90a6ec6bda0c8b503148388d3769ef4ab7f1176e56c8472b76232",
+    "size": 5617664
   },
-  "sessionLock": {
-    "filename": "a1_session_lock.node",
-    "sha256": "a4f2407b6166aa5e12b07548c286acf2e9a744a1f58fef2bfcab2cddbad1dca1",
-    "size": 1996288
+  "entry": {
+    "filename": "dist/foundation/resident-tabs/host-entry.js",
+    "sha256": "4b1f702cc9980ffa531cf3e9963b884eaa35120d04d5c195ea3308f501d8d557",
+    "size": 1315
   },
   "notices": {
     "filename": "terminal-host-THIRD-PARTY-NOTICES.txt",
-    "sha256": "9e80136b62106ac672162dacbd0d6eb2a94b3318e597e40dfcf70c4920c34b00",
-    "size": 555140
+    "sha256": "127b8634dc7f47d9b8c250ff281e028daeac7729290da4f41cf1a1eeafdb76ca",
+    "size": 555117
   },
   "provenance": {
     "language": "Rust",
@@ -34,8 +36,7 @@
     "zigVersion": "0.15.2",
     "rustVersion": "rustc 1.99.1 (58cf8f9c3 2026-10-13)",
     "features": {
-      "executable": [],
-      "sessionLock": [
+      "addon": [
         "node-addon"
       ]
     },

package/dist/product-identity.d.ts

@@ -5,7 +5,7 @@ declare const ENDPOINT_KEYS: readonly ["windowsPipeStem", "unixSocketFilename",
 declare const MANIFEST_KEYS: readonly ["releaseFilename", "packageFilename"];
 declare const PROTOCOL_KEYS: readonly ["namespace", "controlEnvelope", "supervisorSchema", "nativeHostSchema", "structuredAgentSchema", "controlStoreSchema", "promptHistorySchema", "releaseCohortSchema", "updateJournalSchema"];
 declare const EVIDENCE_KEYS: readonly ["nativeSpikeSchema", "terminalProvenanceSchema", "terminalProofSchema", "stableReleaseSchema", "previewReleaseSchema", "releaseCertificationSchema", "previewPlatformVerdictSchema", "piSourceLedgerSchema", "piComponentParitySchema", "piEventFrameParitySchema", "startupTraceSchema", "dependencyLayerSchema", "dependencyLayerCertificationSchema", "runtimePayloadSchema"];
-declare const ARTIFACT_KEYS: readonly ["cliEntry", "supervisorEntry", "guardianEntry", "uiEntry", "nativeExecutable", "nativeCrate", "processGuardianExecutable", "releaseTarballStem", "diagnosticStem"];
+declare const ARTIFACT_KEYS: readonly ["cliEntry", "supervisorEntry", "guardianEntry", "uiEntry", "terminalHostAddon", "terminalHostEntry", "nativeCrate", "processGuardianAddon", "releaseTarballStem", "diagnosticStem"];
 type StringRecord<Keys extends readonly string[]> = {
     readonly [Key in Keys[number]]: string;
 };

package/dist/product-identity.js

@@ -9,7 +9,7 @@ const ENDPOINT_KEYS = ["windowsPipeStem", "unixSocketFilename", "metadataFilenam
 const MANIFEST_KEYS = ["releaseFilename", "packageFilename"];
 const PROTOCOL_KEYS = ["namespace", "controlEnvelope", "supervisorSchema", "nativeHostSchema", "structuredAgentSchema", "controlStoreSchema", "promptHistorySchema", "releaseCohortSchema", "updateJournalSchema"];
 const EVIDENCE_KEYS = ["nativeSpikeSchema", "terminalProvenanceSchema", "terminalProofSchema", "stableReleaseSchema", "previewReleaseSchema", "releaseCertificationSchema", "previewPlatformVerdictSchema", "piSourceLedgerSchema", "piComponentParitySchema", "piEventFrameParitySchema", "startupTraceSchema", "dependencyLayerSchema", "dependencyLayerCertificationSchema", "runtimePayloadSchema"];
-const ARTIFACT_KEYS = ["cliEntry", "supervisorEntry", "guardianEntry", "uiEntry", "nativeExecutable", "nativeCrate", "processGuardianExecutable", "releaseTarballStem", "diagnosticStem"];
+const ARTIFACT_KEYS = ["cliEntry", "supervisorEntry", "guardianEntry", "uiEntry", "terminalHostAddon", "terminalHostEntry", "nativeCrate", "processGuardianAddon", "releaseTarballStem", "diagnosticStem"];
 const ROOT_KEYS = ["schema", "displayName", "commandName", "packageName", "filesystem", "environment", "state", "endpoint", "manifest", "protocol", "evidence", "artifacts"];
 export function validateProductIdentity(value) {
     const root = exactObject(value, ROOT_KEYS, "product identity");

package/dist/product-identity.json

@@ -87,9 +87,10 @@
         "supervisorEntry": "bin/supervisor.js",
         "guardianEntry": "bin/guardian.js",
         "uiEntry": "bin/ui.js",
-        "nativeExecutable": "terminal-host",
+        "terminalHostAddon": "terminal-host",
+        "terminalHostEntry": "host-entry",
         "nativeCrate": "terminal-host",
-        "processGuardianExecutable": "process-guardian",
+        "processGuardianAddon": "process-guardian",
         "releaseTarballStem": "timurproko-a1",
         "diagnosticStem": "a1"
     }

package/dist/runtime-payload-inventory.json

@@ -8,6 +8,7 @@
     "bin/ui.js",
     "bin/update-recovery.js",
     "bin/warmup.js",
+    "dist/foundation/launch-guardian/exit-watcher.js",
     "dist/foundation/startup/startup-descriptor.js",
     "dist/integrations/pi/startup-public.js"
   ],

package/dist/ui/settings/declarations.d.ts

@@ -176,18 +176,6 @@ export declare const OWNED_SETTING_DECLARATIONS: Readonly<{
         defaultValue: 8;
         allowedValues: readonly [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16];
     }>;
-    readonly tabsMax: Readonly<{
-        id: "tabsMax";
-        label: "Maximum tabs";
-        section: Readonly<{
-            id: "tabs";
-            title: "Tabs";
-        }>;
-        description: "Maximum resident A1 tabs kept in the shared strip.";
-        application: "live";
-        defaultValue: 10;
-        allowedValues: readonly number[];
-    }>;
     readonly tabsAutoName: Readonly<{
         id: "tabsAutoName";
         label: "Auto name";

package/dist/ui/settings/declarations.js

@@ -10,7 +10,6 @@ const APPEARANCE_SECTION = Object.freeze({ id: "appearance", title: "Appearance"
 const SCROLL_SECTION = Object.freeze({ id: "scroll", title: "Scroll" });
 const AGENT_SECTION = Object.freeze({ id: "agent", title: "Agent" });
 const TABS_SECTION = Object.freeze({ id: "tabs", title: "Tabs" });
-const TABS_MAX_CHOICES = Object.freeze(Array.from({ length: 50 }, (_, index) => index + 1));
 /**
  * Every A1 setting, keyed by its id. The table is the one declaration: ids, defaults, and allowed
  * values are read from it, and `OwnedSettingValueOf` derives each getter's type from it.
@@ -137,15 +136,6 @@ export const OWNED_SETTING_DECLARATIONS = Object.freeze({
         defaultValue: 8,
         allowedValues: Object.freeze([1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16]),
     }),
-    tabsMax: Object.freeze({
-        id: "tabsMax",
-        label: "Maximum tabs",
-        section: TABS_SECTION,
-        description: "Maximum resident A1 tabs kept in the shared strip.",
-        application: "live",
-        defaultValue: 10,
-        allowedValues: TABS_MAX_CHOICES,
-    }),
     tabsAutoName: Object.freeze({
         id: "tabsAutoName",
         label: "Auto name",

package/docs/architecture/boundaries.md

@@ -7,23 +7,24 @@ Every interactive command uses this profile-neutral lifecycle path:
 ```text
 mutable a1 entry
   -> verified immutable release
-  -> Node launch guardian and authenticated launch-instance registration
-  -> native process guardian and per-instance containment
-  -> profile-aware owned-UI runtime selection
+  -> Node launch guardian loading the verified process-guardian addon
+  -> addon-held per-instance containment and profile-aware runtime selection
   -> owned Pi-backed composition, with A1 surfaces enabled only for bare a1
 ```
 
 Launch-instance ownership is plural. The supervisor tracks any number of independently authenticated `a1` and `a1 pi` instances and never uses one product-wide foreground mutex. Closing one instance closes only its verified process tree. Persisted rows alone do not prove liveness, and uncertainty never authorizes terminating an unrelated process.
 
-Neither guardian reads ordinary terminal input, parses or relays runtime output, renders cells, infers frames, synthesizes terminal responses, or emits display control. Both profiles use the same owned rendering and input pipeline. Bare `a1` exposes A1-owned surfaces; `a1 pi` withholds those surfaces and uses Pi's ordinary profile root. The private guardian boundary carries only bounded identity, readiness, stop, and outcome data.
+The launch guardian and process-guardian addon do not read ordinary terminal input, parse or relay runtime output, render cells, infer frames, or synthesize terminal responses. Their only terminal output is the bounded reset and sanitized armed exit notice after runtime failure. Both profiles use the same owned rendering and input pipeline. Bare `a1` exposes A1-owned surfaces; `a1 pi` withholds those surfaces and uses Pi's ordinary profile root. The containment boundary carries only bounded identity, readiness, stop, and outcome data.
+
+A detached Node exit watcher sits outside the launch guardian's containment. It waits for the guardian, performs bounded Unix process-group cleanup, and may deliver the same claimed exit notice. A kill aimed at every Node runtime also kills this watcher; the accepted loss of the notice and Unix fallback cleanup in that case is documented in [`process-guardian-provenance.md`](process-guardian-provenance.md), and A1 starts no native executable to close that gap.
 
 The owned Pi-backed surface is not an arbitrary-CLI terminal multiplexer. A feature that requires resident arbitrary CLI sessions, internal tabs, terminal-state reconnection, or A1-authoritative scrollback must introduce and certify the separate composed-terminal authority rather than reactivating the retired transparent attachment path.
 
 ## Current module responsibilities
 
 - `lifecycle`: dependency-free launch-instance, process identity, state transition, outcome, and control-command contracts.
-- `process-containment`: artifact verification, OS-verifiable process inspection, containment adapters, and bounded graceful/forced cleanup; it owns no terminal content.
-- `launch-guardian`: one profile-neutral instance coordinator above runtime selection.
+- `process-containment`: process-guardian addon loading and artifact verification, OS-verifiable process inspection, in-process containment adapters, and bounded graceful/forced cleanup; it owns no terminal content.
+- `launch-guardian`: one profile-neutral Node instance coordinator above runtime selection, plus the fixed Node exit-watcher entry used only for owner-death cleanup and the armed notice.
 - `protocol`: additive control handshake, bounded line framing, authenticated launch-instance commands, typed stop intent, snapshots, and command results.
 - `launch`: resolves the effective profile home and the history-specific data root. Composition uses its public path resolver to select `~/.a1/data` for history unless `A1_DATA_DIR` is explicit; global control/release/runtime/cache paths stay unchanged.
 - `prompt-history`: narrowly typed user-input retention in separate profile-owned databases under `~/.a1/data/history` (or `<A1_DATA_DIR>/history`), with bounded worker queues and no supervisor/control-store payloads. It receives a resolved root rather than importing launch-feature internals; it never probes, imports, or deletes the former platform-default history. The editor's owned history state machine remains inside the Pi component boundary; the session UI only coordinates snapshots and classified submissions.
@@ -32,14 +33,14 @@ The owned Pi-backed surface is not an arbitrary-CLI terminal multiplexer. A feat
 - `supervisor`: endpoint identity, plural cohort ownership, per-instance reconciliation, and aggregate release shutdown coordination. It owns no terminal surface.
 - `pi-engine-adapter`, `pi-component-adapter`, and `pi-tui-runtime-adapter`: isolate pinned Pi engine and presentation knowledge behind neutral contracts; product features do not import them directly. Inside the engine adapter, one process-level engine host owns what is process-wide (the HTTP dispatcher, the theme singletons, the one-time changelog and package-update announcements, the startup trace) and is the only place sessions are created, so every session id is unique per process.
 - `session-shell` (`src/app/session-shell`): the application layer that composes the feature owners, the UI foundations, and the three Pi adapters into the interactive session; only composition imports it. Its render root assembles semantic document and dock rows, while its focused viewport controller owns follow state, pointer routing, selection, and interaction timers. Owned-app route lifecycle belongs to the neutral `ui-apps` owner and is only hosted by the session shell.
-- release/update/bootstrap: package-derived immutable release identity, process-guardian integrity, cohort selection, durable update transactions, rollback, and dependency-light command entry. After an unsuccessful bare-A1 child exit, the bootstrap restores owned terminal modes; neither guardian emits terminal controls.
+- release/update/bootstrap: package-derived immutable release identity, native-addon integrity, cohort selection, durable update transactions, rollback, and dependency-light command entry. Before certified fast-path reuse it checks every recorded product file is present; a missing or altered file is replaced only from the matching installed package when its size and digest reproduce the approved release, followed by full verification. Dependency layers keep their separate verification and repair policy. After an unsuccessful bare-A1 child exit, the launch owner or its Node watcher restores owned terminal modes and emits only the armed bounded notice.
 - `terminal-cleanup`: bounded, idempotent emergency restoration and fatal-exit diagnostics for an explicitly owned terminal. It does not inspect commands, relay terminal input/output, or emulate terminal state. The owned UI installs its fatal boundary before terminal activation; packaged bootstrap and checkout launch provide the surviving-owner fallback. Fatal records retain at most ten 16 KiB records with trusted classifications and code locations, never prompts, attachments, raw input, credentials, or arbitrary exception messages.
 
 ## Dependency direction
 
 Terminal boundaries are application-agnostic. They may not select behavior from executable names, arguments, CLI-specific environment variables, or visible text. Production code may not import private Pi distribution APIs or use a Pi-specific terminal workaround.
 
-The JavaScript product path has no PTY or terminal-emulator dependency. Reintroducing `node-pty`, xterm state, custom input encoders, mode/query trackers, cadence-derived frame inference, or renderer/projection code requires an approved capability change and cannot become a second terminal authority. The Rust process guardian is a lifecycle-only native boundary and is independent from the held composed terminal host.
+The JavaScript product path has no PTY or terminal-emulator dependency. Reintroducing `node-pty`, xterm state, custom input encoders, mode/query trackers, cadence-derived frame inference, or renderer/projection code requires an approved capability change and cannot become a second terminal authority. The Rust process guardian is a lifecycle-only Node-API addon loaded by the launch guardian and is independent from the terminal-host Node-API addon. No A1-built executable is part of the production process surface.
 
 `scripts/governance/check-architecture.mjs` enforces the structural parts of these boundaries. Cross-cutting rationale belongs here; implementation history belongs in Git and archived OpenSpec changes.
 
@@ -61,7 +62,7 @@ Default future agents and composed hosts are children of the originating bare-`a
 
 The structured-agent runtime uses a versioned adapter hello and feature negotiation before readiness. Runtime state must use typed events, commands, snapshots, cancellation, and recovery evidence. It must not infer structured semantics from terminal text, terminal timing, or visual content and must not own pseudoterminals or renderer state.
 
-The terminal-host protocol boundary may carry only bounded typed control and semantic lifecycle messages. Pseudoterminal bytes, per-event child input, rendered cells, cell grids, framebuffers, and screen buffers are forbidden across it. Console host executables and packaging live outside the current JavaScript production owners and remain unavailable until the isolated in-terminal proof passes; replacing them with a lightweight custom parser/renderer is forbidden. A desktop-native window and GPU application shell are postponed and are not required for the terminal-hosted product.
+The JavaScript-to-native terminal-host boundary carries only the fixed role arguments, host command, return code, session-lock calls, and typed semantic bridge data. `host-entry.js` does not touch Node's stdin/stdout streams; pseudoterminal bytes, per-event child input, rendered cells, cell grids, framebuffers, and screen buffers remain inside the addon's native roles and their bounded native IPC. The verified addon and fixed entry are the packaged production host; no console host executable exists. Replacing libghostty-vt with a lightweight custom parser/renderer is forbidden. A desktop-native window and GPU application shell are postponed and are not required for the terminal-hosted product.
 
 Resource queues, retained state, evidence, logs, and diagnostics follow `docs/architecture/resource-and-data-policy.md`. Terminal content and authentication material are never control-store records. Unknown data is potentially sensitive by default and must be rejected or redacted before persistence.
 

package/docs/architecture/process-guardian-provenance.md

@@ -1,29 +1,35 @@
 # Process guardian provenance
 
-A1 launch-instance containment uses a standalone native executable named `process-guardian`. The approved implementation is a separate Rust crate at `native/process-guardian`; it is not a Node-API addon and does not reuse or resume the held composed terminal-host implementation.
+A1 launch-instance containment uses the Node-API 9 addon `process-guardian.node`. The approved implementation is the separate Rust crate at `native/process-guardian`; it produces no product executable. The foreground Node launch guardian loads the addon and holds the containment boundary in-process.
 
 ## Boundary
 
-The executable owns platform process containment and launches one immutable `a1-ui` runtime with inherited terminal handles. It does not create a PTY, read ordinary terminal input, capture or parse runtime output, render, or relay terminal bytes. Its private parent/child coordination is restricted to bounded lifecycle and identity data.
+The addon owns platform process containment and launches one immutable A1 UI runtime with inherited terminal handles. It also provides native process-start inspection, terminal-mode capture and restoration, exit-notice delivery, and the bounded process-wait and process-group operations used by the exit watcher. It does not create a PTY, read ordinary terminal input, capture or parse runtime output, render, or relay terminal bytes.
 
-On Windows it uses `windows-sys 0.61.2` to create a Job Object, enables `JOB_OBJECT_LIMIT_KILL_ON_JOB_CLOSE`, assigns the runtime before resuming it, denies silent breakaway by never enabling breakaway limits, monitors the verified Node parent process, and terminates remaining job members after root or parent exit.
+On Windows it uses `windows-sys 0.61.2` to create a Job Object, enables `JOB_OBJECT_LIMIT_KILL_ON_JOB_CLOSE`, and creates the runtime directly in that job through `PROC_THREAD_ATTRIBUTE_JOB_LIST`. The runtime is a job member from its first instruction; the former suspended-create, assign, and resume sequence is gone. Ordinary jobs do not enable breakaway, and closing the addon-held job handle terminates remaining members.
 
-On Linux and macOS it creates a dedicated POSIX process group before exec, transfers foreground-terminal ownership only when a terminal is present, monitors the verified parent, applies bounded TERM/KILL cleanup to that group, and restores the prior foreground group. Linux derives process start identity from procfs. macOS derives it from the native `proc_pidinfo(PROC_PIDTBSDINFO)` start timestamp; PID liveness alone is never treated as identity.
+On Linux and macOS it uses `posix_spawn` to create a dedicated process group, transfers foreground-terminal ownership only when a terminal is present, applies bounded TERM/KILL cleanup to that group, and restores the prior foreground group. Linux derives process start identity from procfs. macOS derives it from `proc_pidinfo(PROC_PIDTBSDINFO)`; PID liveness alone is never treated as identity.
+
+## Exit watcher
+
+After the contained runtime starts, the launch guardian starts `dist/foundation/launch-guardian/exit-watcher.js` in another Node runtime outside the guardian's containment. The watcher waits for the guardian, performs bounded Unix process-group cleanup when needed, and claims and delivers the armed exit notice with the captured terminal modes. On Windows the addon creates that Node process outside both the runtime job and the guardian's inherited job; on Unix it remains in the terminal session so terminal hang-up reaches it naturally. The guardian itself delivers the notice on ordinary completion, and claim-by-rename ensures only one owner can print it.
+
+There is one accepted gap: a machine-wide kill aimed at every Node process, such as `taskkill /IM node.exe` or `pkill node`, kills the watcher together with the guardian and runtime. No exit notice is then printed and, on Unix, non-Node descendants left in the runtime process group are not signalled by the watcher. A1 does not work around that case by starting an A1-built executable. Terminal closure, `Ctrl+Break`, guardian failure, runtime termination, and a kill aimed only at the guardian remain covered.
 
 ## Artifact contract
 
-Release builds place the exact executable at:
+Release builds place the addon at:
 
 ```text
-dist/native/win32-x64/process-guardian.exe
-dist/native/linux-x64/process-guardian
-dist/native/darwin-x64/process-guardian
-dist/native/darwin-arm64/process-guardian
+dist/native/win32-x64/process-guardian.node
+dist/native/linux-x64/process-guardian.node
+dist/native/darwin-x64/process-guardian.node
+dist/native/darwin-arm64/process-guardian.node
 ```
 
-The publication `guardians` job builds them on `windows-2025`, `ubuntu-24.04`, and `macos-15` (arm64); the macOS arm64 job also cross-compiles the x64 guardian with `--target x86_64-apple-darwin`, and its manifest records whether the identity was observed by execution or only from the Mach-O header.
+The publication `guardians` job builds them on `windows-2025`, `ubuntu-24.04`, and `macos-15` arm64; the macOS arm64 job also cross-compiles x64 with `--target x86_64-apple-darwin`. A native build is identified by loading the addon into Node and reading `version()`. When the producing runner cannot load the cross-compiled x64 addon, its manifest records only the observed Mach-O architecture.
 
-Each supported artifact must be named in the release integrity manifest with target triple, crate version, guardian protocol version, SHA-256, byte size, build provenance, and signature/attestation status. The build marks a platform supported only after its native containment integration runs on that platform. A missing, altered, incompatible, unsupported, or wrong-platform artifact is a concise containment launch error; A1 never silently falls back to PID-only cleanup.
+Each `a1-process-guardian-artifact-v2` manifest records `kind: "node-addon"`, Node-API 9, target platform and architecture, crate and protocol versions, SHA-256, byte size, build provenance, and signature/attestation status. A supported artifact is verified before loading. A missing, altered, incompatible, unsupported, or wrong-platform artifact is a concise containment launch error; A1 never silently falls back to PID-only cleanup. If a certified immutable release file disappears or changes, bootstrap restores it only from a matching installed package whose source bytes reproduce the certified size and digest, then verifies the complete release again.
 
 ## Licensing