zelari-code 2.16.4 → 2.17.0

package/dist/cli/memory/fileBackend.js

@@ -118,13 +118,17 @@ export function isMemoryEnabled(env = process.env) {
 /**
  * Resolve and initialise the memory backend for a project. Returns a no-op
  * backend (never throws) when disabled or when initialisation fails, so callers
- * can always `await memory.search(...)` without guarding.
+ * can always `await memory.search(...)` without guarding. `onEvent` (optional)
+ * receives V2 memory telemetry — hosts pass a spine sink (`memorySinkFor`) or
+ * `spineMemoryEventNote` to project it onto the session spine (W2).
  */
-export async function getMemoryBackend(projectRoot, env = process.env) {
+export async function getMemoryBackend(projectRoot, env = process.env, onEvent) {
     if (!isMemoryEnabled(env))
         return new NoopMemoryBackend();
     if (isMemoryV2Enabled(env)) {
-        const service = await getMemoryService(projectRoot, env);
+        const service = await getMemoryService(projectRoot, env, {
+            ...(onEvent ? { onEvent } : {}),
+        });
         if (service instanceof NoopMemoryService)
             return new NoopMemoryBackend();
         return new LegacyMemoryBackendAdapter(service);

package/dist/cli/memory/fileBackend.js.map

@@ -1 +1 @@
-{"version":3,"file":"fileBackend.js","sourceRoot":"","sources":["../../../src/cli/memory/fileBackend.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"fileBackend.js","sourceRoot":"","sources":["../../../src/cli/memory/fileBackend.ts"],"names":[],"mappings":"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"}

package/dist/cli/memory/spineTelemetry.js

@@ -0,0 +1,49 @@
+/**
+ * Write one memory telemetry event as a spine `note`. Per-turn context
+ * projection (`memory_recall_end` with reason `context-built`) gets the
+ * dedicated `context.projection` subject; every other event lands under
+ * `memory_event` with its type. Never throws — a degraded/disabled spine
+ * must not break the run over telemetry.
+ */
+export function spineMemoryEventNote(handle, event) {
+    try {
+        if (event.type === 'memory_recall_end' && event.reason === 'context-built') {
+            handle.note('context.projection', {
+                subject: 'context.projection',
+                ...(event.contextChars !== undefined ? { contextChars: event.contextChars } : {}),
+                ...(event.returnedCount !== undefined ? { returnedCount: event.returnedCount } : {}),
+                ...(event.durationMs !== undefined ? { durationMs: event.durationMs } : {}),
+                ...(event.backend !== undefined ? { backend: event.backend } : {}),
+            });
+            return;
+        }
+        handle.note(`memory_${event.type}`, {
+            subject: 'memory_event',
+            type: event.type,
+            ...(event.durationMs !== undefined ? { durationMs: event.durationMs } : {}),
+            ...(event.candidateCount !== undefined ? { candidateCount: event.candidateCount } : {}),
+            ...(event.returnedCount !== undefined ? { returnedCount: event.returnedCount } : {}),
+            ...(event.backend !== undefined ? { backend: event.backend } : {}),
+            ...(event.reason !== undefined ? { reason: event.reason } : {}),
+            ...(event.memoryId !== undefined ? { memoryId: event.memoryId } : {}),
+        });
+    }
+    catch {
+        // Degraded spine must NEVER break the run over telemetry.
+    }
+}
+/**
+ * Late-binding seam for hosts where the memory service is constructed BEFORE
+ * the spine opens (headless single-turn / council): events are dropped while
+ * `holder.current` is unset and flow once the spine handle is assigned.
+ * TUI hosts pass a getter-backed holder (`{ get current() { return … } }`) —
+ * a getter on `current` satisfies this shape.
+ */
+export function memorySinkFor(holder) {
+    return (event) => {
+        const handle = holder.current;
+        if (handle)
+            spineMemoryEventNote(handle, event);
+    };
+}
+//# sourceMappingURL=spineTelemetry.js.map

package/dist/cli/memory/spineTelemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spineTelemetry.js","sourceRoot":"","sources":["../../../src/cli/memory/spineTelemetry.ts"],"names":[],"mappings":"AAeA;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAuB,EAAE,KAAkB;IAC9E,IAAI,CAAC;QACH,IAAI,KAAK,CAAC,IAAI,KAAK,mBAAmB,IAAI,KAAK,CAAC,MAAM,KAAK,eAAe,EAAE,CAAC;YAC3E,MAAM,CAAC,IAAI,CAAC,oBAAoB,EAAE;gBAChC,OAAO,EAAE,oBAAoB;gBAC7B,GAAG,CAAC,KAAK,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACjF,GAAG,CAAC,KAAK,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACpF,GAAG,CAAC,KAAK,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC3E,GAAG,CAAC,KAAK,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACnE,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,UAAU,KAAK,CAAC,IAAI,EAAE,EAAE;YAClC,OAAO,EAAE,cAAc;YACvB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,GAAG,CAAC,KAAK,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3E,GAAG,CAAC,KAAK,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,KAAK,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACvF,GAAG,CAAC,KAAK,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACpF,GAAG,CAAC,KAAK,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAClE,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/D,GAAG,CAAC,KAAK,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACtE,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,0DAA0D;IAC5D,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,MAAqC;IACjE,OAAO,CAAC,KAAK,EAAE,EAAE;QACf,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC;QAC9B,IAAI,MAAM;YAAE,oBAAoB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAClD,CAAC,CAAC;AACJ,CAAC"}

package/dist/cli/runHeadless.js

@@ -3,6 +3,8 @@ import { buildCouncilTaskWithHistory, } from './hooks/conversationContext.js';
 import { createBuiltinToolRegistry } from './toolRegistry.js';
 import { chooseOrchestration } from './orchestration/policy.js';
 import { collectOrchestrationFacts, spineOrchestrationNote } from './orchestration/facts.js';
+// W2: memory telemetry projected onto the session spine as state-only notes.
+import { memorySinkFor, spineMemoryEventNote } from './memory/spineTelemetry.js';
 import { COUNCIL_TIER_SIZES } from './councilConfig.js';
 import { emitEvent, resolveHeadlessCwd, resolveHeadlessKey, resolveHeadlessProvider, } from './headless.js';
 import { createLocalCliProvider } from './provider/localCli/claudeProvider.js';
@@ -16,19 +18,21 @@ import { writeSessionTodos } from './sessionTodos.js';
 import { promises as fs } from 'node:fs';
 import path from 'node:path';
 import { randomUUID } from 'node:crypto';
-import { evaluateStrictBuildGate, strictGateEventPayload, strictGateExitCode } from './kraken/verificationBridge.js';
+import { evaluateStrictBuildGate, strictEnvOverlay, strictGateEventPayload, strictGateExitCode } from './kraken/verificationBridge.js';
 import { setActiveProofPersistenceSurface, } from './kraken/completionProofPersist.js';
 import { buildModelContext } from './budget/modelContextBuilder.js';
 import { recordCompactionMetrics } from './metrics.js';
 import { openHeadlessSpine, resolveHeadlessProfileId, seedHeadlessModelHistory, sessionStartedEvent, } from './headlessSpine.js';
+import { emitHarnessStateEvent } from './headless/harnessStateEmit.js';
 import { checkStrictPolicyLoad, recordPolicyLoadBlockedOnSpine, reportPolicyLoadBlocked, } from './headless/policyGate.js';
 import { activePolicyLoadMode, setActivePolicyLoadSurface, } from './safety/policyLoadMode.js';
 import { planModeFromOpts, registerHeadlessMcp, runOneTurn, writeProofSafe } from './headless/runOneTurn.js';
 export async function runHeadless(opts) {
     resetTaskSpawnCount();
-    if (opts.strictDone) {
-        process.env.ZELARI_STRICT_DONE = '1';
-    }
+    // H10-fix1: strictDone/missionStrict NEVER touch process.env (not even
+    // once-per-process) — each gate site builds a per-invocation overlay via
+    // strictEnvOverlay(opts), so `--no-strict-done` (false→'0') is honored
+    // and a concurrent sidecar can never race on the real env.
     // === Global crash handlers (headless-only) ===
     // Without these, an uncaught exception during a tool call (e.g. write_file
     // failing deep in the harness) kills the process silently: no agent_end,
@@ -121,7 +125,13 @@ export async function runHeadless(opts) {
             model,
         });
     }
-    return dispatchHeadlessTurn(opts, provider, model, providerStream);
+    return dispatchHeadlessTurn(opts, provider, model, providerStream, {
+        // H10-fix3: the gate already ran above on the SAME input (no chdir in
+        // between) — the one-shot marker keeps dispatchHeadlessTurn from
+        // re-running it (duplicate `[policy]` stderr warning + double policy
+        // load). Per-invocation flag only; never process-global.
+        policyGateDone: true,
+    });
 }
 /** Strict policy-load + phase/proof surfaces. Returns the block exit code, or undefined. */
 async function applyHeadlessPolicyGate(opts) {
@@ -134,6 +144,9 @@ async function applyHeadlessPolicyGate(opts) {
         reportPolicyLoadBlocked(policyLoad.block, opts.output);
         await recordPolicyLoadBlockedOnSpine(policyLoad.block, {
             mode: opts.mode,
+            // H10-fix2: the spine must land in the RESOLVED workspace, not the
+            // process cwd — a sidecar hosts N workspaces without `chdir`.
+            workspace: cwd,
             ...(opts.profile ? { profile: opts.profile } : {}),
             ...(opts.resumeSessionId ? { resumeSessionId: opts.resumeSessionId } : {}),
         });
@@ -147,9 +160,13 @@ async function applyHeadlessPolicyGate(opts) {
 /**
  * Per-turn dispatch shared by `--headless` (one-shot process) and
  * `--serve-harness` (long-lived sidecar). Does NOT install process-fatal
- * handlers or mutate `ZELARI_STRICT_DONE` — those belong to the one-shot
- * CLI wrapper. Honors `opts.cwd` so N sidecar sessions can sit on
- * different folders without `chdir`.
+ * handlers or touch `ZELARI_STRICT_DONE` — the strict knobs ride
+ * HeadlessOptions into a per-invocation env overlay (strictEnvOverlay)
+ * consumed at each gate site (runOneTurn / runHeadlessZelari). Honors
+ * `opts.cwd` so N sidecar sessions can sit on
+ * different folders without `chdir`. `oneShot.policyGateDone` is set by
+ * the one-shot wrapper ONLY (its gate already ran); the sidecar never
+ * passes it, so the gate keeps running every turn here.
  */
 const KRAKEN_TURN_ENV = [
     ['krakenExploreModel', 'ZELARI_KRAKEN_EXPLORE_MODEL'],
@@ -166,7 +183,11 @@ function applyKrakenTurnEnv(opts) {
         }
     }
 }
-export async function dispatchHeadlessTurn(opts, provider, model, providerStream) {
+export async function dispatchHeadlessTurn(opts, provider, model, providerStream, oneShot, 
+// t37: serve hosts pass the kernel-owned workspace LspManager here so
+// every dispatch path (kraken single / council / zelari) registers the
+// LSP tools against THAT server instead of the shared per-root manager.
+extras) {
     const cwd = resolveHeadlessCwd(opts);
     if (typeof opts.mode === 'string') {
         const parsed = parseMode(opts.mode);
@@ -176,6 +197,10 @@ export async function dispatchHeadlessTurn(opts, provider, model, providerStream
         opts = { ...opts, cwd };
     }
     applyKrakenTurnEnv(opts);
+    // Each parent user turn gets a fresh tentacle budget (GUIDA: default 6).
+    // Desktop sidecar never enters runHeadless(), so without this the counter
+    // lives for the whole Node process — 6 tentacles total, then spawn cap.
+    resetTaskSpawnCount();
     if (opts.todos && opts.todos.length > 0) {
         writeSessionTodos(opts.todos, { merge: false });
     }
@@ -196,9 +221,17 @@ export async function dispatchHeadlessTurn(opts, provider, model, providerStream
     catch {
         /* non-fatal */
     }
-    const policyBlock = await applyHeadlessPolicyGate(opts);
-    if (policyBlock !== undefined)
-        return policyBlock;
+    // H10-fix3: the sidecar (serve/harnessServer) needs this gate EVERY turn —
+    // it also re-pins setPhase/setActivePolicyLoadSurface/setActiveProof-
+    // PersistenceSurface per turn. The one-shot wrapper passes
+    // `policyGateDone` because runHeadless() already ran the identical gate
+    // moments ago; re-running it would emit the same `[policy]` warning twice
+    // and reload the policy set for nothing.
+    if (!oneShot?.policyGateDone) {
+        const policyBlock = await applyHeadlessPolicyGate(opts);
+        if (policyBlock !== undefined)
+            return policyBlock;
+    }
     // P1.1 (t12) -> t23 (P1.E): `--mode auto` resolves ONCE here, before any
     // dispatch check. Pure classifier (./orchestration/policy.js); the only
     // I/O is the CHEAP FACTS collection (bounded repo walk + active-contract
@@ -257,12 +290,12 @@ export async function dispatchHeadlessTurn(opts, provider, model, providerStream
             process.stderr.write(`[zelari-code --headless] ${line}\n`);
     }
     if (mode === 'zelari') {
-        return runHeadlessZelari(opts, provider, model, providerStream);
+        return runHeadlessZelari(opts, provider, model, providerStream, extras);
     }
     if (mode === 'council' || opts.useCouncil) {
-        return runHeadlessCouncil(opts, provider, model, providerStream);
+        return runHeadlessCouncil(opts, provider, model, providerStream, extras);
     }
-    return runOneTurn(opts, provider, model, providerStream);
+    return runOneTurn(opts, provider, model, providerStream, extras);
 }
 /**
  * `--kraken-graph <goal>`: plan (F4) + execute (F3) a Kraken task graph,
@@ -287,9 +320,23 @@ async function runHeadlessKrakenGraph(opts, provider, model) {
     const { createKrakenSubAgentContextFactory } = await import('./toolRegistry.js');
     const cwd = resolveHeadlessCwd(opts);
     const sessionId = crypto.randomUUID();
+    // W1: kraken-graph was the only headless dispatch path with no ADR-0016
+    // session spine — hosts had no event log to resume or replay. Mirror the
+    // council/zelari hosts: same open shape, same degrade-and-stop discipline.
+    const spine = await openHeadlessSpine({ sessionId, mode: 'kraken', workspace: cwd });
+    // E1.4: advertise the spine session id so hosts (Desktop) resume the same
+    // event log next turn. Gated to json output — plain stdout must stay
+    // byte-for-byte identical to the pre-spine behavior.
+    if (opts.output === 'json')
+        emitEvent(sessionStartedEvent(spine));
+    spine.userMessage(prompt);
     const { getMemoryService, isMemoryAutoWriteEnabled, isMemoryV2Enabled } = await import('./memory/serviceFactory.js');
     const graphMemory = isMemoryV2Enabled()
-        ? await getMemoryService(cwd, process.env)
+        ? await getMemoryService(cwd, process.env, {
+            // W2: the spine is already open here — memory events are noted
+            // directly (context.projection / memory_event state-only payloads).
+            onEvent: (event) => spineMemoryEventNote(spine, event),
+        })
         : undefined;
     const log = (message) => {
         if (opts.output === 'json') {
@@ -310,6 +357,9 @@ async function runHeadlessKrakenGraph(opts, provider, model) {
         abort.abort();
     };
     process.once('SIGINT', onSigint);
+    // W1: every return below records its code first so the finally can close
+    // the spine with the matching status (completed / error / cancelled).
+    let exitCode = 0;
     try {
         // ---- Pre-flight: run a pre-built plan from disk, skipping the planner.
         let preflightGraph;
@@ -322,7 +372,8 @@ async function runHeadlessKrakenGraph(opts, provider, model) {
             }
             catch (e) {
                 log(`plan file not found: ${planPath} (${e.message})`);
-                return 1;
+                exitCode = 1;
+                return exitCode;
             }
             let planJson;
             try {
@@ -330,11 +381,13 @@ async function runHeadlessKrakenGraph(opts, provider, model) {
             }
             catch (e) {
                 log(`plan file is malformed JSON: ${e.message}`);
-                return 1;
+                exitCode = 1;
+                return exitCode;
             }
             if (!planJson || !Array.isArray(planJson.nodes)) {
                 log(`plan file is malformed: missing "nodes" array`);
-                return 1;
+                exitCode = 1;
+                return exitCode;
             }
             const { createGraph, validateGraph } = await import('@zelari/core');
             const validated = createGraph(planJson.graphId ?? opts.runPlan, planJson.nodes);
@@ -373,7 +426,8 @@ async function runHeadlessKrakenGraph(opts, provider, model) {
                 emitEvent({ type: 'log', message: `plan_only_id=${planId}` });
                 emitEvent({ type: 'log', message: `plan_only_path=${planPath}` });
             }
-            return 0;
+            exitCode = 0;
+            return exitCode;
         }
         const audit = new AuditLogger();
         const executor = new KrakenGraphExecutor({
@@ -438,7 +492,8 @@ async function runHeadlessKrakenGraph(opts, provider, model) {
         else {
             process.stdout.write(`${finalAscii}\n`);
         }
-        return summary.converged ? 0 : 3;
+        exitCode = summary.converged ? 0 : 3;
+        return exitCode;
     }
     catch (err) {
         const message = err instanceof Error ? err.message : String(err);
@@ -448,18 +503,39 @@ async function runHeadlessKrakenGraph(opts, provider, model) {
         else {
             process.stderr.write(`[zelari-code --headless] kraken graph failed: ${message}\n`);
         }
-        return 2;
+        exitCode = 2;
+        return exitCode;
     }
     finally {
         process.off('SIGINT', onSigint);
         await graphMemory?.close().catch(() => undefined);
+        // W1: the spine closes on EVERY exit (completed / error / cancelled) and
+        // must never change the exit code.
+        try {
+            const closeReason = abort.signal.aborted
+                ? 'cancelled'
+                : exitCode === 0
+                    ? 'completed'
+                    : 'error';
+            await spine.close(closeReason);
+        }
+        catch { /* spine never fails the run */ }
+        // HarnessState inc.3: final read-model event for JSON hosts (best-effort).
+        await emitHarnessStateEvent({ spine, workspaceRoot: cwd, output: opts.output, emitEvent });
     }
 }
-async function buildCouncilToolRegistry(planMode, opts, memoryService, memoryAutoWrite = false) {
+async function buildCouncilToolRegistry(planMode, opts, memoryService, memoryAutoWrite = false, 
+// t37: the council/zelari parent registry honors the same TurnExtras as
+// the single-agent path. TODO(t37): the deeper council mission-slice
+// per-agent registries (~runAgentMissionSlice below) still resolve via
+// the shared per-root map — same anti-thrash behavior (one manager per
+// root, no cross-workspace kills), just not the kernel-owned instance.
+extras) {
     const cwd = opts ? resolveHeadlessCwd(opts) : process.cwd();
     const { registry: toolRegistry } = createBuiltinToolRegistry({
         root: cwd,
         planMode,
+        ...(extras?.lspProvider ? { lspProvider: extras.lspProvider } : {}),
         permissionPolicy: {
             read: 'allow',
             write: 'allow',
@@ -487,13 +563,18 @@ async function buildCouncilToolRegistry(planMode, opts, memoryService, memoryAut
     }
     return { toolRegistry, workspaceCtx: realCtx };
 }
-async function runHeadlessCouncil(opts, provider, model, providerStream) {
+async function runHeadlessCouncil(opts, provider, model, providerStream, extras) {
     const { dispatchCouncil } = await import('./councilDispatcher.js');
     const sessionId = crypto.randomUUID();
     const cwd = resolveHeadlessCwd(opts);
     const memoryFactory = await import('./memory/serviceFactory.js');
+    // W2: memory events project onto the session spine (late-binding holder —
+    // the spine opens below; events before assignment are dropped, advisory).
+    const spineHolder = {};
     const nativeMemory = memoryFactory.isMemoryV2Enabled()
-        ? await memoryFactory.getMemoryService(cwd, process.env)
+        ? await memoryFactory.getMemoryService(cwd, process.env, {
+            onEvent: memorySinkFor(spineHolder),
+        })
         : undefined;
     const memoryAutoWrite = memoryFactory.isMemoryAutoWriteEnabled();
     const spine = await openHeadlessSpine({
@@ -502,6 +583,8 @@ async function runHeadlessCouncil(opts, provider, model, providerStream) {
         profile: opts.profile,
         workspace: cwd,
     });
+    // W2: bind the memory telemetry sink to the now-open spine.
+    spineHolder.current = spine;
     // Exit-1/E1.2: the session spine is the model-context source of truth.
     // Legacy `--history` is imported one-shot into a fresh log; prior turns
     // are then derived from events. The 1.x rolling history no longer feeds
@@ -528,7 +611,7 @@ async function runHeadlessCouncil(opts, provider, model, providerStream) {
         process.stderr.write('[zelari-code --headless] council build soft-gate: forced design-phase ' +
             '(set ZELARI_COUNCIL_CAN_BUILD=1 to allow Lucifero implement)\n');
     }
-    const { toolRegistry } = await buildCouncilToolRegistry(planModeFromOpts(opts) || softGated, opts, nativeMemory, memoryAutoWrite);
+    const { toolRegistry } = await buildCouncilToolRegistry(planModeFromOpts(opts) || softGated, opts, nativeMemory, memoryAutoWrite, extras);
     const { FeedbackStore } = await import('./councilFeedback.js');
     const feedbackStore = new FeedbackStore();
     // Multi-turn: Desktop passes --history, but council used to ignore it →
@@ -678,6 +761,8 @@ async function runHeadlessCouncil(opts, provider, model, providerStream) {
         await spine.close(exitCode === 0 ? 'completed' : 'error');
     }
     catch { /* spine never fails the run */ }
+    // HarnessState inc.3: final read-model event for JSON hosts (best-effort).
+    await emitHarnessStateEvent({ spine, workspaceRoot: cwd, output: opts.output, emitEvent });
     if (opts.exportSessionPath) {
         try {
             const json = await spine.exportJson();
@@ -723,7 +808,7 @@ async function runHeadlessCouncil(opts, provider, model, providerStream) {
 /**
  * Zelari mission loop (headless). Streams progress as `log` events + council BrainEvents.
  */
-async function runHeadlessZelari(opts, provider, model, providerStream) {
+async function runHeadlessZelari(opts, provider, model, providerStream, extras) {
     const projectRoot = resolveHeadlessCwd(opts);
     const sessionId = opts.resumeSessionId ?? crypto.randomUUID();
     const spine = await openHeadlessSpine({
@@ -752,9 +837,11 @@ async function runHeadlessZelari(opts, provider, model, providerStream) {
         userMessage: opts.task,
         hasPlan: hasWorkspacePlan(projectRoot),
     });
-    const memory = await getMemoryBackend(projectRoot);
+    // W2: the mission spine is already open here — mission memory events are
+    // noted directly (context.projection / memory_event state-only payloads).
+    const memory = await getMemoryBackend(projectRoot, process.env, (event) => spineMemoryEventNote(spine, event));
     const nativeMissionMemory = memory.service;
-    const { toolRegistry, workspaceCtx } = await buildCouncilToolRegistry(planModeFromOpts(opts), opts, nativeMissionMemory, Boolean(nativeMissionMemory) && process.env.ZELARI_MEMORY_AUTO_WRITE !== '0');
+    const { toolRegistry, workspaceCtx } = await buildCouncilToolRegistry(planModeFromOpts(opts), opts, nativeMissionMemory, Boolean(nativeMissionMemory) && process.env.ZELARI_MEMORY_AUTO_WRITE !== '0', extras);
     const feedbackStore = new FeedbackStore();
     const chairmanBudget = envNumber(process.env.ZELARI_MODE_MAX_TOOLS_LUCIFER, {
         default: 30,
@@ -1079,12 +1166,15 @@ async function runHeadlessZelari(opts, provider, model, providerStream) {
             exitCode = exitCode || 3;
         else if (state.status === 'success') {
             // ADR-0025: missions close under the strict evidence gate by default
-            // (opt-out: ZELARI_MISSION_STRICT=0). A blocked gate never exits 0 —
+            // (opt-out: ZELARI_MISSION_STRICT=0, or the per-run --no-mission-strict /
+            // --no-strict-done overlay). A blocked gate never exits 0 —
             // the mission "success" becomes the strict exit code and the spine
             // records mission-strict-blocked instead of mission-success.
             const missionGate = await evaluateStrictBuildGate('build', {
                 emit: (input) => spine.appendEvent(input),
                 surface: 'mission',
+                // H10-fix1: per-invocation env overlay — never process.env.
+                env: strictEnvOverlay(opts),
                 cwd: projectRoot,
             });
             const missionVerificationPayload = strictGateEventPayload(missionGate);
@@ -1126,6 +1216,8 @@ async function runHeadlessZelari(opts, provider, model, providerStream) {
                 await spine.close(exitCode === 2 ? 'error' : 'stopped');
         }
         catch { /* spine never fails the run */ }
+        // HarnessState inc.3: final read-model event for JSON hosts (best-effort).
+        await emitHarnessStateEvent({ spine, workspaceRoot: projectRoot, output: opts.output, emitEvent });
         if (opts.exportSessionPath) {
             try {
                 const json = await spine.exportJson();