zelari-code 2.0.0-alpha.5 → 2.0.0

package/dist/cli/missionContinuation.test.js

@@ -0,0 +1,117 @@
+/**
+ * F4 integration — the mission loop records advisory continuation without
+ * obeying it: advice on every implementation slice, deterministic stop rules
+ * untouched, spine round-trip of mission.progress state events.
+ */
+import { describe, expect, it, vi } from 'vitest';
+import { runZelariMission, } from './zelariMission.js';
+import { SessionStore, readSessionLog, buildProjection, } from '@zelari/core/session';
+import { deriveMissionState } from '@zelari/core/mission';
+import * as path from 'node:path';
+import * as os from 'node:os';
+import { promises as fs } from 'node:fs';
+const brief = {
+    goal: 'vertical slice',
+    deliverableThisMission: 'one module',
+    phases: [{ mode: 'implementation', focus: 'impl' }],
+    sliceMvp: { id: 'slice-1', summary: 'mvp', acceptance: [] },
+};
+function fakeMemory() {
+    return {
+        init: vi.fn(async () => { }),
+        add: vi.fn(async () => { }),
+        search: vi.fn(async () => []),
+    };
+}
+function deps(overrides = {}) {
+    return {
+        projectRoot: os.tmpdir(),
+        memory: fakeMemory(),
+        runSlice: vi.fn(async () => ({ completionOk: true, ran: true, writeCount: 2 })),
+        emit: vi.fn(),
+        env: { ZELARI_CHECKPOINT: '0', ZELARI_MISSION_MAX_ITER: '3' },
+        ...overrides,
+    };
+}
+describe('runZelariMission — advisory continuation (F4)', () => {
+    it('records advice on each implementation slice but never obeys it for done-by-score', async () => {
+        const onMissionProgress = vi.fn();
+        // Slice 1: claims completion but wrote 0 files → NOT done.
+        // Slice 2: real green → done. The loop must follow its own deterministic
+        // rules; the advice is only recorded.
+        const results = [
+            { completionOk: true, ran: true, writeCount: 0 },
+            { completionOk: true, ran: true, writeCount: 3 },
+        ];
+        let i = 0;
+        const d = deps({
+            runSlice: vi.fn(async () => results[i++]),
+            onMissionProgress,
+        });
+        const state = await runZelariMission('do it', brief, d);
+        expect(state.status).toBe('success');
+        expect(state.iteration).toBeGreaterThanOrEqual(2);
+        expect(onMissionProgress).toHaveBeenCalled();
+        const first = onMissionProgress.mock.calls[0][0];
+        expect(first.doneByScore).toBe(false);
+        expect(first.goalRewrite).toBe(false);
+        expect(['continue', 'wind-down', 'hold-for-user']).toContain(first.recommendation);
+    });
+    it('emits a wind-down advice only when the deterministic gate is green', async () => {
+        const seen = [];
+        const d = deps({
+            runSlice: vi.fn(async () => ({ completionOk: true, ran: true, writeCount: 1 })),
+            onMissionProgress: (advice) => seen.push(advice.recommendation),
+        });
+        const state = await runZelariMission('go', brief, d);
+        expect(state.status).toBe('success');
+        expect(seen[seen.length - 1]).toBe('wind-down');
+    });
+    it('budget-exhausted run holds for the user instead of claiming done', async () => {
+        const onMissionProgress = vi.fn();
+        const d = deps({
+            runSlice: vi.fn(async () => ({ completionOk: false, ran: true, writeCount: 1 })),
+            onMissionProgress,
+        });
+        const state = await runZelariMission('go', brief, d);
+        expect(state.status).toBe('stopped');
+        const last = onMissionProgress.mock.calls.at(-1)[0];
+        expect(['hold-for-user', 'continue']).toContain(last.recommendation);
+    });
+});
+describe('mission.progress spine round-trip', () => {
+    it('advice events replay as state (lastAdvice) and never join the model surface', async () => {
+        const tmp = await fs.mkdtemp(path.join(os.tmpdir(), 'f4-'));
+        const store = new SessionStore(tmp);
+        const { sessionId, writer } = await store.create({ profile: 'mission/v1' });
+        await writer.append({
+            kind: 'mission.phase',
+            actor: { type: 'system' },
+            data: { phase: 'build' },
+        });
+        await writer.append({
+            kind: 'mission.progress',
+            actor: { type: 'system' },
+            data: {
+                recommendation: 'continue',
+                rationale: 'required criteria incomplete → no early-stop',
+                blockers: ['1/1 required criteria not passing'],
+                iteration: 2,
+            },
+        });
+        await writer.close();
+        const report = await readSessionLog(path.join(tmp, sessionId, 'events.jsonl'));
+        const events = report.events;
+        const projection = buildProjection(events, report.issues);
+        expect(projection.missionAdvice).toHaveLength(1);
+        expect(projection.missionAdvice[0].recommendation).toBe('continue');
+        const state = deriveMissionState(projection);
+        expect(state.phase).toBe('build');
+        expect(state.lastAdvice?.rationale).toContain('no early-stop');
+        const { isModelSurfaceEvent } = await import('@zelari/core/session');
+        const adviceEvent = events.find((e) => e.kind === 'mission.progress');
+        expect(adviceEvent).toBeDefined();
+        expect(isModelSurfaceEvent(adviceEvent)).toBe(false);
+    });
+});
+//# sourceMappingURL=missionContinuation.test.js.map

package/dist/cli/missionContinuation.test.js.map

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

package/dist/cli/profileMatrix.test.js

@@ -0,0 +1,130 @@
+/**
+ * profileMatrix — F7 (Exit-3.2, doc §10) profile × phase smoke matrix.
+ *
+ * Cells (§10 minimum): minimal+plan/build, kraken+plan/build, council+plan,
+ * mission+build. For each cell the smoke walks the three real wiring legs:
+ *
+ *   1. profile loader   — mode/--profile resolves to the expected versioned
+ *      profile (ADR-0022); explicit ids win over mode defaults
+ *   2. session metadata — the spine `session.started` header records profile +
+ *      toolManifestHash of the declared profile, so same-task/same-profile
+ *      runs stay comparable
+ *   3. capability gate  — the REAL registry built for that phase: plan strips
+ *      every PLAN_BLOCKED_TOOLS mutator while keeping the plan-domain tools
+ *      (task_create/update/list + explore-only `task`); build registers the
+ *      full mutator set; declared profile tools are a subset of the build
+ *      registry (declarative 2.0 manifest ⊆ real 1.x registry)
+ *
+ * Wiring invariants that live inside runHeadless (mission slices never run in
+ * plan; kraken/council registries derive planMode from the phase) are locked
+ * as source assertions — same pattern as legacyContextIsolation.test.ts.
+ */
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { promises as fs } from 'node:fs';
+import { readFileSync } from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import { fileURLToPath } from 'node:url';
+import { readSessionLog } from '@zelari/core/session';
+import { MINIMAL_V1, KRAKEN_V1, MISSION_V1, toolManifestHash } from '@zelari/core/runtime';
+import { openHeadlessSpine, resolveHeadlessProfileId } from './headlessSpine.js';
+import { createBuiltinToolRegistry } from './toolRegistry.js';
+import { PLAN_BLOCKED_TOOLS } from './phase.js';
+const REPO_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..', '..');
+function readCli(rel) {
+    return readFileSync(path.join(REPO_ROOT, 'src', 'cli', rel), 'utf8');
+}
+const MATRIX = [
+    { mode: 'kraken', profile: 'minimal/v1', explicitProfile: 'minimal/v1', phase: 'plan', declaredTools: MINIMAL_V1.tools },
+    { mode: 'kraken', profile: 'minimal/v1', explicitProfile: 'minimal/v1', phase: 'build', declaredTools: MINIMAL_V1.tools },
+    { mode: 'kraken', profile: 'kraken/v1', phase: 'plan', declaredTools: KRAKEN_V1.tools },
+    { mode: 'kraken', profile: 'kraken/v1', phase: 'build', declaredTools: KRAKEN_V1.tools },
+    { mode: 'council', profile: 'council/v1', phase: 'plan', declaredTools: [...MINIMAL_V1.tools, 'write_file'] },
+    // §10 + mission contract: mission runs BUILD only (slices implement on disk).
+    { mode: 'zelari', profile: 'mission/v1', phase: 'build', declaredTools: MISSION_V1.tools },
+];
+let tmp;
+beforeEach(async () => {
+    tmp = await fs.mkdtemp(path.join(os.tmpdir(), 'zelari-profile-matrix-'));
+});
+afterEach(async () => {
+    await fs.rm(tmp, { recursive: true, force: true });
+});
+describe('F7 profile × phase smoke matrix (Exit-3.2)', () => {
+    it.each(MATRIX)('cell $mode/$phase → $profile: loader, session metadata and phase capability gate', async (cell) => {
+        // Leg 1 — profile loader: explicit id wins, otherwise the mode default.
+        expect(resolveHeadlessProfileId(cell.mode, cell.explicitProfile)).toBe(cell.profile);
+        // Leg 2 — session metadata on the spine header.
+        const sessionId = `mx-${cell.mode}-${cell.phase}`;
+        const handle = await openHeadlessSpine({ sessionId, mode: cell.mode, profile: cell.explicitProfile, baseDir: tmp, quiet: true });
+        expect(handle.profileId).toBe(cell.profile);
+        const report = await readSessionLog(path.join(tmp, sessionId, 'events.jsonl'));
+        expect(report.ok).toBe(true);
+        const started = report.events.find((e) => e.kind === 'session.started');
+        expect(started).toBeDefined();
+        const startedData = (started?.data ?? {});
+        expect(startedData.profile).toBe(cell.profile);
+        // The manifest hash is the DECLARED profile tool set (ADR-0022) — the
+        // comparability contract, distinct from the phase-gated live registry.
+        expect(startedData.toolManifestHash).toBe(toolManifestHash(cell.declaredTools));
+        // Leg 3 — real registry for the phase (no tool is invoked: zero side effects).
+        const { registry } = createBuiltinToolRegistry({
+            root: tmp,
+            sessionId,
+            planMode: cell.phase === 'plan',
+            lifecycleHooks: null,
+            lspProvider: null,
+        });
+        const names = new Set(registry.list());
+        // Observe builtins exist in BOTH phases.
+        for (const observe of ['read_file', 'grep_content', 'list_files']) {
+            expect(names.has(observe), `${observe} must exist in ${cell.phase}`).toBe(true);
+        }
+        if (cell.phase === 'plan') {
+            // No mutating builtin survives plan (no unauthorized side effects).
+            for (const blocked of PLAN_BLOCKED_TOOLS) {
+                expect(names.has(blocked), `${blocked} must be stripped in plan`).toBe(false);
+            }
+            // Plan-domain tools stay: durable plan tasks + explore-only delegation.
+            for (const planTool of ['task_create', 'task_update', 'task_list', 'task']) {
+                expect(names.has(planTool), `${planTool} must exist in plan`).toBe(true);
+            }
+        }
+        else {
+            // Build: the full mutator set is available.
+            for (const mutator of ['write_file', 'edit_file', 'apply_diff', 'bash', 'task']) {
+                expect(names.has(mutator), `${mutator} must exist in build`).toBe(true);
+            }
+            // Declared 2.0 profile tools are a subset of the real build registry.
+            for (const declared of cell.declaredTools) {
+                expect(names.has(declared), `declared tool ${declared} missing from build registry`).toBe(true);
+            }
+        }
+    }, 30_000);
+});
+describe('F7 wiring invariants (source-level, legacyContextIsolation pattern)', () => {
+    it('kraken and council registries derive planMode from the resolved phase', () => {
+        const src = readCli('runHeadless.ts');
+        // Kraken parent registry (headless hot path).
+        expect(src).toContain('planMode: planModeFromOpts(opts),');
+        // Council pipelines: explicit phase (design leg) and soft-gated variant.
+        expect(src).toContain('planModeFromOpts(opts) || softGated,');
+        expect(src).toContain('planModeFromOpts(opts),');
+        // planModeFromOpts is the single phase→planMode derivation.
+        expect(src).toContain("return (opts.phase ?? 'build') === 'plan';");
+    });
+    it('mission implementation slices are hard-wired to BUILD (never planMode)', () => {
+        const src = readCli('runHeadless.ts');
+        const lines = src.split(/\r?\n/);
+        const idx = lines.findIndex((l) => l.includes('const { registry: agentRegistry } = createBuiltinToolRegistry({'));
+        expect(idx).toBeGreaterThan(-1);
+        const window = lines.slice(idx, idx + 12).join('\n');
+        expect(window).toContain('planMode: false');
+        expect(window).not.toContain('planMode: true');
+    });
+    it('PLAN_BLOCKED_TOOLS stays exactly the mutating builtins', () => {
+        // If a new mutator lands without a plan gate, this reminds the author.
+        expect([...PLAN_BLOCKED_TOOLS].sort()).toEqual(['apply_diff', 'bash', 'edit_file', 'write_file']);
+    });
+});
+//# sourceMappingURL=profileMatrix.test.js.map

package/dist/cli/profileMatrix.test.js.map

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

package/dist/cli/runHeadless.js

@@ -37,8 +37,8 @@ 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 } from './kraken/verificationBridge.js';
-import { openHeadlessSpine, resolveHeadlessProfileId, seedHeadlessModelHistory, } from './headlessSpine.js';
+import { evaluateStrictBuildGate, strictGateEventPayload, strictGateExitCode } from './kraken/verificationBridge.js';
+import { openHeadlessSpine, resolveHeadlessProfileId, seedHeadlessModelHistory, sessionStartedEvent, } from './headlessSpine.js';
 export async function runHeadless(opts) {
     resetTaskSpawnCount();
     // Desktop multi-turn todo persistence: each message spawns a fresh process,
@@ -332,6 +332,8 @@ async function runHeadlessKrakenGraph(opts, provider, model) {
             emitEvent({ type: 'message_delta', delta: finalAscii });
             emitEvent({ type: 'message_end' });
             emitEvent({ type: 'agent_end', reason: summary.converged ? 'completed' : 'error' });
+            // COMPAT MIRROR (ADR-0024): the session spine is the canonical context;
+            // history_snapshot is one-shot legacy-host replay only (F13 cleanup, doc §8).
             emitEvent({
                 type: 'history_snapshot',
                 messages: [
@@ -417,6 +419,9 @@ async function runHeadlessSingle(opts, provider, model, providerStream) {
     // are then derived from events. The 1.x rolling history no longer feeds
     // the harness messages directly (degraded spine falls back to it).
     const seededHistory = await seedHeadlessModelHistory(spine, opts.history);
+    // E1.4: advertise the spine session id so hosts (Desktop) resume the
+    // same event log next turn instead of replaying 1.x history JSON.
+    emitEvent(sessionStartedEvent(spine));
     if (opts.task)
         spine.userMessage(opts.task);
     // Fase 3 (ADR-0020): fresh per-run candidate registry (each headless run
@@ -785,7 +790,10 @@ async function runHeadlessSingle(opts, provider, model, providerStream) {
             emittedWrites: pass.emittedWrites + retry.emittedWrites,
         };
     }
-    // Fase 8 (ADR-0020): completion gate — a BUILD turn that used selection
+    // E2.2: when strict mode is on and the gate stays blocked after the repair
+    // pass, the run closes non-success (dedicated exit code + session status).
+    let strictExit = 0;
+    // Fase 8 (ADR-0020): completion gate — a BUILD turn that used selection  // Fase 8 (ADR-0020): completion gate — a BUILD turn that used selection
     // cannot cleanly finish while required checks are unresolved (fail OR
     // unknown — a degraded observation is never proof). One automatic
     // repair pass (budget = 1, structural), reusing the same recovery
@@ -795,7 +803,7 @@ async function runHeadlessSingle(opts, provider, model, providerStream) {
         opts.mode === 'kraken' &&
         isKrakenSelectionEnabled() &&
         !planModeFromOpts(opts)) {
-        const strictGate = evaluateStrictBuildGate('build');
+        const strictGate = await evaluateStrictBuildGate('build', { emit: (input) => spine.appendEvent(input) });
         const gate = strictGate.gate;
         const verificationPayload = strictGateEventPayload(strictGate);
         spine.verificationRun(verificationPayload);
@@ -829,7 +837,7 @@ async function runHeadlessSingle(opts, provider, model, providerStream) {
                 successfulWrites: pass.successfulWrites + repair.successfulWrites,
                 emittedWrites: pass.emittedWrites + repair.emittedWrites,
             };
-            const after = evaluateStrictBuildGate('build');
+            const after = await evaluateStrictBuildGate('build', { emit: (input) => spine.appendEvent(input) });
             const afterPayload = strictGateEventPayload(after);
             spine.verificationRun(afterPayload);
             if (opts.output === 'json') {
@@ -837,6 +845,15 @@ async function runHeadlessSingle(opts, provider, model, providerStream) {
             }
             if (!after.blocked)
                 markRepairSucceeded();
+            else {
+                strictExit = strictGateExitCode(after);
+                const gateMsg = `[headless] Kraken BUILD: strict completion gate still blocked after repair pass — ` +
+                    `closing non-success (exit ${strictExit}): ${after.summary}`;
+                if (opts.output === 'json')
+                    emitEvent({ type: 'log', message: gateMsg });
+                else
+                    process.stderr.write(`[zelari-code --headless] ${gateMsg}\n`);
+            }
         }
     }
     progressRuntime.finish(pass.finalReason);
@@ -851,6 +868,7 @@ async function runHeadlessSingle(opts, provider, model, providerStream) {
     }
     process.stdout.write('');
     // v1.10.0: emit a history_snapshot so the desktop can replay this turn.
+    // COMPAT MIRROR (ADR-0024): session spine is canonical — see emit sites below.
     // Include the user turn + final assistant text (user/assistant only).
     if (pass.finalReason !== 'error' && opts.output === 'json') {
         try {
@@ -888,6 +906,8 @@ async function runHeadlessSingle(opts, provider, model, providerStream) {
                     : []),
             ];
             if (snapshot.length > 0) {
+                // COMPAT MIRROR (ADR-0024): the session spine is the canonical context;
+                // history_snapshot is one-shot legacy-host replay only (F13 cleanup, doc §8).
                 emitEvent({ type: 'history_snapshot', messages: snapshot });
             }
         }
@@ -896,7 +916,8 @@ async function runHeadlessSingle(opts, provider, model, providerStream) {
         }
     }
     try {
-        await spine.close(pass.finalReason === 'error' ? 'error' : 'completed');
+        const closeStatus = pass.finalReason === 'error' ? 'error' : strictExit !== 0 ? 'stopped' : 'completed';
+        await spine.close(closeStatus);
     }
     catch { /* spine never fails the run */ }
     if (opts.exportSessionPath) {
@@ -915,6 +936,9 @@ async function runHeadlessSingle(opts, provider, model, providerStream) {
     }
     if (pass.finalReason === 'error')
         return 3;
+    // E2.2: strict done gate — a blocked verdict overrides a clean pass exit.
+    if (strictExit !== 0)
+        return strictExit;
     return pass.exitCode;
 }
 async function buildCouncilToolRegistry(planMode, opts) {
@@ -959,6 +983,9 @@ async function runHeadlessCouncil(opts, provider, model, providerStream) {
     // are then derived from events. The 1.x rolling history no longer feeds
     // the harness messages directly (degraded spine falls back to it).
     const seededHistory = await seedHeadlessModelHistory(spine, opts.history);
+    // E1.4: advertise the spine session id so hosts (Desktop) resume the
+    // same event log next turn instead of replaying 1.x history JSON.
+    emitEvent(sessionStartedEvent(spine));
     if (opts.task)
         spine.userMessage(opts.task);
     // Experiment: free-form council+build soft-gated to design-phase unless
@@ -1078,6 +1105,8 @@ async function runHeadlessCouncil(opts, provider, model, providerStream) {
                     ? [{ role: 'assistant', content: lastAssistantText }]
                     : []),
             ];
+            // COMPAT MIRROR (ADR-0024): the session spine is the canonical context;
+            // history_snapshot is one-shot legacy-host replay only (F13 cleanup, doc §8).
             emitEvent({ type: 'history_snapshot', messages: snapshot });
         }
         catch {
@@ -1121,6 +1150,9 @@ async function runHeadlessZelari(opts, provider, model, providerStream) {
     // are then derived from events. The 1.x rolling history no longer feeds
     // the harness messages directly (degraded spine falls back to it).
     const seededHistory = await seedHeadlessModelHistory(spine, opts.history);
+    // E1.4: advertise the spine session id so hosts (Desktop) resume the
+    // same event log next turn instead of replaying 1.x history JSON.
+    emitEvent(sessionStartedEvent(spine));
     if (opts.task)
         spine.userMessage(opts.task);
     spine.missionPhase('design', 'mission-start');
@@ -1184,6 +1216,13 @@ async function runHeadlessZelari(opts, provider, model, providerStream) {
             emit,
             buildViaAgent,
             onMissionPhase: (phase, note) => spine.missionPhase(phase, note),
+            onMissionProgress: (advice, iteration) => spine.missionProgress({
+                recommendation: advice.recommendation,
+                rationale: advice.rationale,
+                blockers: advice.blockers,
+                ...(advice.trend ? { trend: advice.trend } : {}),
+                iteration,
+            }),
             runSlice: async ({ userMessage: slicePrompt, runMode, ragContext, implementerRetry, }) => {
                 const effectiveRunMode = planModeFromOpts(opts) ? 'design-phase' : runMode;
                 // design-phase always council; implementation uses agent when policy ON
@@ -1397,8 +1436,27 @@ async function runHeadlessZelari(opts, provider, model, providerStream) {
         if (state.status === 'error')
             exitCode = exitCode || 3;
         else if (state.status === 'success') {
-            exitCode = 0;
-            spine.missionPhase('done', 'mission-success');
+            // ADR-0025: missions close under the strict evidence gate by default
+            // (opt-out: ZELARI_MISSION_STRICT=0). 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',
+            });
+            const missionVerificationPayload = strictGateEventPayload(missionGate);
+            spine.verificationRun(missionVerificationPayload);
+            if (opts.output === 'json') {
+                emitEvent({ type: 'verification_run', ...missionVerificationPayload });
+            }
+            if (missionGate.blocked) {
+                exitCode = strictGateExitCode(missionGate);
+                spine.missionPhase('verification', 'mission-strict-blocked');
+            }
+            else {
+                exitCode = 0;
+                spine.missionPhase('done', 'mission-success');
+            }
         }
         else if (state.status === 'stalled' || state.status === 'stopped') {
             exitCode = exitCode || 0;
@@ -1439,6 +1497,8 @@ async function runHeadlessZelari(opts, provider, model, providerStream) {
     }
     if (opts.output === 'json') {
         try {
+            // COMPAT MIRROR (ADR-0024): the session spine is the canonical context;
+            // history_snapshot is one-shot legacy-host replay only (F13 cleanup, doc §8).
             emitEvent({
                 type: 'history_snapshot',
                 messages: [