zelari-code 1.48.0 → 1.49.0

package/dist/cli/kraken/completionGate.test.js

@@ -0,0 +1,172 @@
+/**
+ * Fase 8 (ADR-0020) — completion gate unit tests.
+ *
+ * classify: pure matching semantics (mirrors verifyReport).
+ * evaluate: registry-driven gating (build-only, selection-only).
+ * prompt: repair directive shape.
+ */
+import { describe, expect, it } from 'vitest';
+import { buildKrakenRepairPrompt, classifyKrakenChecks, evaluateKrakenCompletionGate, } from './completionGate.js';
+import { resetKrakenCandidates, setKrakenCheckResults, setKrakenSelection, } from './candidateRegistry.js';
+const CHECKS = [
+    'session survives concurrent refresh',
+    'rotated cookie rejects the old token',
+];
+function result(check, status) {
+    return { check, status };
+}
+function selectWithChecks(checks) {
+    resetKrakenCandidates();
+    setKrakenSelection({
+        status: 'selected',
+        winnerIndex: 1,
+        rationale: 'stronger evidence',
+        requiredChecks: checks,
+        degraded: false,
+        verifier: null,
+        judgedBy: 'llm',
+    });
+}
+describe('classifyKrakenChecks', () => {
+    it('null results → every check unknown (no report ≠ pass)', () => {
+        const out = classifyKrakenChecks(CHECKS, null);
+        expect(out.unknown).toEqual(CHECKS);
+        expect(out.passed).toEqual([]);
+        expect(out.failed).toEqual([]);
+    });
+    it('groups pass/fail/unknown by exact normalized match', () => {
+        const out = classifyKrakenChecks(CHECKS, [
+            result('Session survives concurrent  refresh', 'pass'),
+            result('rotated cookie rejects the old token', 'fail'),
+        ]);
+        expect(out.passed).toEqual([CHECKS[0]]);
+        expect(out.failed).toEqual([CHECKS[1]]);
+        expect(out.unknown).toEqual([]);
+    });
+    it('matches a lightly reworded criterion by containment', () => {
+        const out = classifyKrakenChecks(['race condition on concurrent session refresh'], [result('concurrent session refresh', 'pass')]);
+        expect(out.passed).toEqual(['race condition on concurrent session refresh']);
+    });
+    it('later duplicate results win (self-correction)', () => {
+        const out = classifyKrakenChecks(CHECKS, [
+            result(CHECKS[0], 'fail'),
+            result(CHECKS[0], 'pass'),
+        ]);
+        expect(out.passed).toEqual([CHECKS[0]]);
+        expect(out.failed).toEqual([]);
+    });
+    it('a check with no matching block is unknown, never pass', () => {
+        const out = classifyKrakenChecks(CHECKS, [result('totally unrelated check', 'pass')]);
+        expect(out.unknown).toEqual(CHECKS);
+    });
+});
+describe('evaluateKrakenCompletionGate', () => {
+    it('open when no selection ran this turn', () => {
+        resetKrakenCandidates();
+        const gate = evaluateKrakenCompletionGate('build');
+        expect(gate.blocked).toBe(false);
+        expect(gate.selectionUsed).toBe(false);
+    });
+    it('open for needs_more_evidence — checks stay advisory', () => {
+        resetKrakenCandidates();
+        setKrakenSelection({
+            status: 'needs_more_evidence',
+            winnerIndex: null,
+            rationale: 'tie',
+            requiredChecks: ['advisory check'],
+            degraded: false,
+            verifier: null,
+            judgedBy: 'llm',
+        });
+        expect(evaluateKrakenCompletionGate('build').blocked).toBe(false);
+    });
+    it('blocked when verification never ran (all unknown)', () => {
+        selectWithChecks(CHECKS);
+        const gate = evaluateKrakenCompletionGate('build');
+        expect(gate.blocked).toBe(true);
+        expect(gate.selectionUsed).toBe(true);
+        expect(gate.total).toBe(2);
+        expect(gate.passed).toBe(0);
+        expect(gate.unknownChecks).toEqual(CHECKS);
+    });
+    it('blocked while any check fails (pass does not offset fail)', () => {
+        selectWithChecks(CHECKS);
+        setKrakenCheckResults([
+            result(CHECKS[0], 'pass'),
+            result(CHECKS[1], 'fail'),
+        ]);
+        const gate = evaluateKrakenCompletionGate('build');
+        expect(gate.blocked).toBe(true);
+        expect(gate.failedChecks).toEqual([CHECKS[1]]);
+    });
+    it('blocked while any check is unknown (unknown ≠ pass)', () => {
+        selectWithChecks(CHECKS);
+        setKrakenCheckResults([
+            result(CHECKS[0], 'pass'),
+            result(CHECKS[1], 'unknown'),
+        ]);
+        expect(evaluateKrakenCompletionGate('build').blocked).toBe(true);
+    });
+    it('open only when every check passes', () => {
+        selectWithChecks(CHECKS);
+        setKrakenCheckResults(CHECKS.map((c) => result(c, 'pass')));
+        const gate = evaluateKrakenCompletionGate('build');
+        expect(gate.blocked).toBe(false);
+        expect(gate.passed).toBe(2);
+    });
+    it('never blocks a PLAN turn even with unresolved checks', () => {
+        selectWithChecks(CHECKS);
+        // no results at all → would block in build
+        expect(evaluateKrakenCompletionGate('build').blocked).toBe(true);
+        expect(evaluateKrakenCompletionGate('plan').blocked).toBe(false);
+    });
+    it('reset clears the gate state', () => {
+        selectWithChecks(CHECKS);
+        resetKrakenCandidates();
+        expect(evaluateKrakenCompletionGate('build').selectionUsed).toBe(false);
+    });
+});
+describe('buildKrakenRepairPrompt', () => {
+    it('lists failed and unknown checks with the pass counter', () => {
+        const prompt = buildKrakenRepairPrompt({
+            blocked: true,
+            selectionUsed: true,
+            total: 3,
+            passed: 1,
+            failedChecks: ['race on refresh'],
+            unknownChecks: ['cookie rotation'],
+        });
+        expect(prompt).toContain('passed 1/3');
+        expect(prompt).toContain('FAILED checks');
+        expect(prompt).toContain('- race on refresh');
+        expect(prompt).toContain('UNKNOWN checks');
+        expect(prompt).toContain('- cookie rotation');
+    });
+    it('forbids re-running kraken_select and demands a verify tentacle', () => {
+        const prompt = buildKrakenRepairPrompt({
+            blocked: true,
+            selectionUsed: true,
+            total: 1,
+            passed: 0,
+            failedChecks: ['x'],
+            unknownChecks: [],
+        });
+        expect(prompt).toContain('do NOT call kraken_select again');
+        expect(prompt).toContain('`task verify`');
+        expect(prompt).toContain('<verify-report>');
+        expect(prompt).toContain('status: pass');
+    });
+    it('omits empty sections', () => {
+        const prompt = buildKrakenRepairPrompt({
+            blocked: true,
+            selectionUsed: true,
+            total: 2,
+            passed: 0,
+            failedChecks: [],
+            unknownChecks: ['a', 'b'],
+        });
+        expect(prompt).not.toContain('FAILED checks');
+        expect(prompt).toContain('UNKNOWN checks');
+    });
+});
+//# sourceMappingURL=completionGate.test.js.map

package/dist/cli/kraken/completionGate.test.js.map

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

package/dist/cli/kraken/metrics.js

@@ -0,0 +1,96 @@
+/**
+ * Kraken Verified Selection — per-turn metrics (Fase 10, ADR-0020 §58).
+ *
+ * Captures the cost/effectiveness telemetry of a Kraken turn that used the
+ * selection flow, so alpha adoption can be measured against the key question:
+ * "do SIMPLE tasks pay a measurable price?" (They must not — with
+ * ZELARI_KRAKEN_SELECTION unset the registry stays empty, collect returns
+ * null and nothing is emitted.)
+ *
+ * Design mirrors candidateRegistry: in-memory, per-process, reset every
+ * parent turn. Transient counters (tokens, latency, repair flags) are
+ * recorded at call sites; everything derivable (selectionUsed,
+ * candidateCount, needsMoreEvidence, verification pass/fail/unknown) is
+ * derived at collect time from the candidate registry + completion gate —
+ * one source of truth, no double bookkeeping.
+ *
+ * Token numbers are REAL provider-reported usage (UsageBreakdown on
+ * message_end / usage deltas), never approximated. Absent usage stays
+ * undefined/0 — we do not fabricate data.
+ */
+import { getKrakenCheckResults, getKrakenSelection, krakenCandidates, krakenRequiredChecks, } from './candidateRegistry.js';
+import { classifyKrakenChecks } from './completionGate.js';
+function store() {
+    const g = globalThis;
+    g.__zelariKrakenTurnMetrics ??= {
+        candidateTokens: 0,
+        selectionRecorded: false,
+        selectionFallback: false,
+        repairTriggered: false,
+        repairSucceeded: false,
+    };
+    return g.__zelariKrakenTurnMetrics;
+}
+/** Reset per parent turn (call beside resetKrakenCandidates). */
+export function resetKrakenTurnMetrics() {
+    const g = globalThis;
+    g.__zelariKrakenTurnMetrics = undefined;
+}
+/** Record provider-reported tokens consumed by one candidate tentacle. */
+export function recordCandidateTokens(totalTokens) {
+    if (!Number.isFinite(totalTokens) || totalTokens <= 0)
+        return;
+    store().candidateTokens += Math.round(totalTokens);
+}
+/** Record the judging-call outcome (called once per kraken_select). */
+export function recordSelectionOutcome(outcome) {
+    const s = store();
+    s.selectionRecorded = true;
+    s.selectionLatencyMs = Math.max(0, Math.round(outcome.latencyMs));
+    if (typeof outcome.tokens === 'number' && Number.isFinite(outcome.tokens) && outcome.tokens > 0) {
+        s.selectionTokens = Math.round(outcome.tokens);
+    }
+    s.selectionFallback = outcome.degraded;
+    s.selectionFallbackReason = outcome.fallbackReason;
+}
+/** The completion gate forced a repair pass (budget = 1, Fase 8). */
+export function markRepairTriggered() {
+    store().repairTriggered = true;
+}
+/** The repair pass ended with every blocking check resolved. */
+export function markRepairSucceeded() {
+    if (store().repairTriggered)
+        store().repairSucceeded = true;
+}
+/**
+ * Collect the turn snapshot. Returns null when the turn had NO selection
+ * activity (flag off, or a plain turn) — callers emit nothing, so simple
+ * tasks pay exactly zero telemetry overhead (§58).
+ */
+export function collectKrakenTurnMetrics() {
+    const s = store();
+    const verdict = getKrakenSelection();
+    const candidates = krakenCandidates();
+    if (!verdict && candidates.length === 0 && !s.selectionRecorded && !s.repairTriggered) {
+        return null;
+    }
+    const classification = classifyKrakenChecks(krakenRequiredChecks(), getKrakenCheckResults());
+    return {
+        selectionUsed: verdict !== null,
+        candidateCount: candidates.length,
+        candidateTokens: s.candidateTokens,
+        ...(s.selectionTokens !== undefined ? { selectionTokens: s.selectionTokens } : {}),
+        ...(s.selectionLatencyMs !== undefined ? { selectionLatencyMs: s.selectionLatencyMs } : {}),
+        selectionFallback: s.selectionFallback,
+        ...(s.selectionFallbackReason !== undefined
+            ? { selectionFallbackReason: s.selectionFallbackReason }
+            : {}),
+        needsMoreEvidence: verdict?.status === 'needs_more_evidence',
+        verificationPass: classification.passed.length,
+        verificationFail: classification.failed.length,
+        verificationUnknown: classification.unknown.length,
+        repairTriggered: s.repairTriggered,
+        repairSucceeded: s.repairSucceeded,
+    };
+}
+//# sourceMappingURL=metrics.js.map

package/dist/cli/kraken/metrics.js.map

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

package/dist/cli/kraken/metrics.test.js

@@ -0,0 +1,145 @@
+import { afterEach, describe, expect, it } from 'vitest';
+import { collectKrakenTurnMetrics, markRepairSucceeded, markRepairTriggered, recordCandidateTokens, recordSelectionOutcome, resetKrakenTurnMetrics, } from './metrics.js';
+import { registerCandidate, resetKrakenCandidates, setKrakenCheckResults, setKrakenSelection, } from './candidateRegistry.js';
+function verdict(partial) {
+    return {
+        status: 'selected',
+        winnerIndex: 1,
+        rationale: 'test',
+        requiredChecks: [],
+        degraded: false,
+        verifier: null,
+        judgedBy: 'deterministic',
+        ...partial,
+    };
+}
+function check(check, status) {
+    return { check, status };
+}
+afterEach(() => {
+    resetKrakenCandidates();
+    resetKrakenTurnMetrics();
+});
+describe('collectKrakenTurnMetrics — null when no selection activity', () => {
+    it('returns null on a plain turn (flag off ⇒ zero telemetry)', () => {
+        resetKrakenCandidates();
+        resetKrakenTurnMetrics();
+        expect(collectKrakenTurnMetrics()).toBeNull();
+    });
+    it('returns null when only unrelated counters were touched', () => {
+        recordCandidateTokens(0); // ignored by the guard
+        expect(collectKrakenTurnMetrics()).toBeNull();
+    });
+});
+describe('candidate counters', () => {
+    it('counts registered candidates (ok and malformed both cost)', () => {
+        registerCandidate({
+            status: 'ok',
+            description: 'h1',
+            report: {
+                hypothesis: 'h1',
+                evidence: [{ claim: 'observed', basis: 'src/x.ts:10', degraded: false }],
+                risks: [],
+                hasDegradedEvidence: false,
+            },
+            raw: '',
+        });
+        registerCandidate({ status: 'malformed', description: 'h2', error: 'bad', raw: '' });
+        const m = collectKrakenTurnMetrics();
+        expect(m?.candidateCount).toBe(2);
+        expect(m?.selectionUsed).toBe(false); // no kraken_select yet
+    });
+    it('sums provider-reported candidate tokens, ignoring junk', () => {
+        registerCandidate({
+            status: 'ok',
+            description: 'h1',
+            report: {
+                hypothesis: 'h1',
+                evidence: [],
+                risks: [],
+                hasDegradedEvidence: false,
+            },
+            raw: '',
+        });
+        recordCandidateTokens(1200);
+        recordCandidateTokens(800.4); // rounded
+        recordCandidateTokens(-5); // ignored
+        recordCandidateTokens(Number.NaN); // ignored
+        const m = collectKrakenTurnMetrics();
+        expect(m?.candidateTokens).toBe(2000);
+    });
+});
+describe('selection counters', () => {
+    it('records latency/tokens/fallback from the judging call', () => {
+        recordSelectionOutcome({ latencyMs: 1500, tokens: 900, degraded: false });
+        const m = collectKrakenTurnMetrics();
+        expect(m?.selectionLatencyMs).toBe(1500);
+        expect(m?.selectionTokens).toBe(900);
+        expect(m?.selectionFallback).toBe(false);
+    });
+    it('keeps tokens undefined when the provider reports none', () => {
+        recordSelectionOutcome({ latencyMs: 200, degraded: true, fallbackReason: 'verifier call failed' });
+        const m = collectKrakenTurnMetrics();
+        expect(m?.selectionTokens).toBeUndefined();
+        expect(m?.selectionFallback).toBe(true);
+        expect(m?.selectionFallbackReason).toBe('verifier call failed');
+    });
+    it('flags needs_more_evidence from the persisted verdict', () => {
+        setKrakenSelection(verdict({ status: 'needs_more_evidence', winnerIndex: null }));
+        const m = collectKrakenTurnMetrics();
+        expect(m?.selectionUsed).toBe(true);
+        expect(m?.needsMoreEvidence).toBe(true);
+    });
+});
+describe('verification counters', () => {
+    it('classifies pass/fail/unknown from registry state', () => {
+        setKrakenSelection(verdict({ requiredChecks: ['tests pass', 'build clean', 'lint clean'] }));
+        setKrakenCheckResults([
+            check('tests pass', 'pass'),
+            check('build clean', 'fail'),
+            // 'lint clean' unreported ⇒ unknown
+        ]);
+        const m = collectKrakenTurnMetrics();
+        expect(m?.verificationPass).toBe(1);
+        expect(m?.verificationFail).toBe(1);
+        expect(m?.verificationUnknown).toBe(1);
+    });
+    it('reports zero verification counters before any verify tentacle', () => {
+        setKrakenSelection(verdict({ requiredChecks: ['tests pass'] }));
+        const m = collectKrakenTurnMetrics();
+        expect(m?.verificationPass).toBe(0);
+        expect(m?.verificationUnknown).toBe(1);
+    });
+});
+describe('repair flags', () => {
+    it('tracks triggered and success independently', () => {
+        markRepairTriggered();
+        let m = collectKrakenTurnMetrics();
+        expect(m?.repairTriggered).toBe(true);
+        expect(m?.repairSucceeded).toBe(false);
+        markRepairSucceeded();
+        m = collectKrakenTurnMetrics();
+        expect(m?.repairSucceeded).toBe(true);
+    });
+    it('success without trigger is ignored (defensive)', () => {
+        setKrakenSelection(verdict({})); // activity so the snapshot is non-null
+        markRepairSucceeded();
+        const m = collectKrakenTurnMetrics();
+        expect(m?.repairTriggered).toBe(false);
+        expect(m?.repairSucceeded).toBe(false);
+    });
+});
+describe('reset', () => {
+    it('clears transient counters but derives fresh from the registry', () => {
+        recordSelectionOutcome({ latencyMs: 100, tokens: 50, degraded: false });
+        markRepairTriggered();
+        resetKrakenTurnMetrics();
+        expect(collectKrakenTurnMetrics()).toBeNull(); // registry also empty here
+        setKrakenSelection(verdict({}));
+        const m = collectKrakenTurnMetrics();
+        expect(m?.repairTriggered).toBe(false);
+        expect(m?.candidateTokens).toBe(0);
+        expect(m?.selectionLatencyMs).toBeUndefined();
+    });
+});
+//# sourceMappingURL=metrics.test.js.map

package/dist/cli/kraken/metrics.test.js.map

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

package/dist/cli/kraken/selectionPlaybook.js

@@ -0,0 +1,23 @@
+import { KRAKEN_SELECTION_PLAYBOOK_MODULE } from '@zelari/core/skills';
+import { isKrakenSelectionEnabled } from './candidateRegistry.js';
+/**
+ * Adaptive Verified-Selection playbook (plan §53).
+ *
+ * Returns the selection playbook module for the Kraken parent prompt when
+ * BOTH the call site wants it (standard Kraken paths only — never Zelari
+ * mission slices) and the alpha feature flag `ZELARI_KRAKEN_SELECTION=1`
+ * is enabled. Flag off ⇒ the parent prompt stays byte-identical to
+ * today's (regression guard §65).
+ *
+ * The playbook teaches WHEN to explore candidates (simple → direct,
+ * ambiguous → 2, high uncertainty → 3) and the discipline around
+ * kraken_select; the candidate-side instructions (report format,
+ * diversity, integrity) live in the task tool's candidate
+ * systemPromptOverride (Fase 3).
+ */
+export function krakenSelectionPlaybook(include) {
+    if (!include || !isKrakenSelectionEnabled())
+        return [];
+    return [KRAKEN_SELECTION_PLAYBOOK_MODULE];
+}
+//# sourceMappingURL=selectionPlaybook.js.map

package/dist/cli/kraken/selectionPlaybook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectionPlaybook.js","sourceRoot":"","sources":["../../../src/cli/kraken/selectionPlaybook.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gCAAgC,EAAE,MAAM,qBAAqB,CAAC;AAEvE,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAElE;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAAgB;IACtD,IAAI,CAAC,OAAO,IAAI,CAAC,wBAAwB,EAAE;QAAE,OAAO,EAAE,CAAC;IACvD,OAAO,CAAC,gCAAgC,CAAC,CAAC;AAC5C,CAAC"}

package/dist/cli/kraken/selectionPlaybook.test.js

@@ -0,0 +1,55 @@
+import { describe, it, expect, afterEach } from 'vitest';
+import { krakenSelectionPlaybook } from './selectionPlaybook.js';
+import { KRAKEN_LEAD_PLAYBOOK_MODULE } from '@zelari/core/skills';
+const FLAG = 'ZELARI_KRAKEN_SELECTION';
+describe('krakenSelectionPlaybook (Fase 5 — adaptive playbook)', () => {
+    const prev = process.env[FLAG];
+    afterEach(() => {
+        if (prev === undefined)
+            delete process.env[FLAG];
+        else
+            process.env[FLAG] = prev;
+    });
+    it('flag off ⇒ no module (prompt byte-identical, regression guard)', () => {
+        delete process.env[FLAG];
+        expect(krakenSelectionPlaybook(true)).toEqual([]);
+    });
+    it('non-kraken call site ⇒ no module even with flag on', () => {
+        process.env[FLAG] = '1';
+        expect(krakenSelectionPlaybook(false)).toEqual([]);
+    });
+    it('flag on + kraken path ⇒ exactly one module', () => {
+        process.env[FLAG] = '1';
+        const mods = krakenSelectionPlaybook(true);
+        expect(mods).toHaveLength(1);
+        expect(mods[0].title).toMatch(/Verified Selection/i);
+    });
+    it('carries the adaptive thresholds (simple→direct, ambiguous→2, uncertainty→3)', () => {
+        process.env[FLAG] = '1';
+        const c = krakenSelectionPlaybook(true)[0].content;
+        expect(c).toMatch(/DIRECT/i);
+        expect(c).toMatch(/2 candidates/);
+        expect(c).toMatch(/up to 3 candidates/);
+    });
+    it('carries the orchestration contract (purpose=candidate, kraken_select, single path)', () => {
+        process.env[FLAG] = '1';
+        const c = krakenSelectionPlaybook(true)[0].content;
+        expect(c).toContain('purpose="candidate"');
+        expect(c).toContain('kraken_select');
+        expect(c).toContain('needs_more_evidence');
+        expect(c).toMatch(/Never blend/i);
+    });
+    it('carries check routing (PLAN → plan section, BUILD → verify Acceptance) + integrity', () => {
+        process.env[FLAG] = '1';
+        const c = krakenSelectionPlaybook(true)[0].content;
+        expect(c).toMatch(/verification section/i);
+        expect(c).toMatch(/Acceptance/i);
+        expect(c).toMatch(/proof of absence/i);
+    });
+    it('sorts after the lead playbook (priority ordering preserved)', () => {
+        process.env[FLAG] = '1';
+        const [m] = krakenSelectionPlaybook(true);
+        expect(m.priority).toBeGreaterThan(KRAKEN_LEAD_PLAYBOOK_MODULE.priority);
+    });
+});
+//# sourceMappingURL=selectionPlaybook.test.js.map

package/dist/cli/kraken/selectionPlaybook.test.js.map

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