zelari-code 2.17.0 → 2.18.0

package/dist/cli/commands/inspectSession.js

@@ -0,0 +1,86 @@
+/**
+ * inspectSession.ts — `zelari-code inspect <session-id> [--json]` (v0.10).
+ *
+ * FIRST consumer of the NDJSON `harness_state` event: reads the ADR-0023
+ * read-model for one spine session (`<sessionsDir>/<id>/events.jsonl`) and
+ * prints a human-readable report — header (session id + turnsTotal), one
+ * line per turn (verification verdict + completion contract with blocker
+ * count), and a "support lens" section (context projections, memory
+ * events, compactions). `--json` prints the raw state instead.
+ *
+ * Advisory-only: reads the session spine, writes nothing, emits no events,
+ * never influences mission/run exit codes. The sessions dir resolves exactly
+ * like the harness_state emitter (workspaceRoot + ZELARI_SESSIONS_DIR,
+ * ADR-0016) so the read matches what the headless hosts wrote. The
+ * reader/derivation are REUSED from harnessState.ts — no re-parsing here.
+ */
+import path from 'node:path';
+import { existsSync } from 'node:fs';
+import { resolveSessionsDir } from '@zelari/core/session';
+import { readHarnessState } from '../harnessState.js';
+/**
+ * Pure renderer — HarnessState → report text. No I/O, no clock, no color,
+ * so it is testable without spawning the CLI (same discipline as the
+ * read-model it renders).
+ */
+export function renderInspectReport(state) {
+    const lines = [
+        `session ${state.session.sessionId}  status=${state.session.status}  turns=${state.execution.turnsTotal}`,
+    ];
+    const contractByTurn = new Map(state.execution.contracts.map((c) => [c.turn, c]));
+    for (const turn of state.turns) {
+        const contract = contractByTurn.get(turn.index);
+        const verification = turn.verification
+            ? `${turn.verification.verdict}${turn.verification.strict ? '' : ' (non-strict)'}`
+            : 'unknown'; // ADR-0023: no verification evidence ⇒ unknown ≠ pass.
+        const blockers = contract?.blockers ?? [];
+        const completion = contract?.complete
+            ? 'complete'
+            : blockers.length > 0
+                ? `incomplete — ${blockers.length} blockers: ${blockers.join(', ')}`
+                : 'incomplete';
+        lines.push(`  turn ${turn.index}  [${turn.outcome}]  verification: ${verification}  contract: ${completion}`);
+    }
+    lines.push('');
+    lines.push('support lens:');
+    const projections = state.support.contextProjections;
+    const last = projections[projections.length - 1];
+    lines.push(`  context projections: ${projections.length}` +
+        (last ? `  (last: ${last.contextChars} chars → ${last.returnedCount} items)` : ''));
+    lines.push(`  memory events: ${state.support.memoryEvents}`);
+    const saved = state.support.tokensSavedByCompaction;
+    lines.push(`  compactions: ${state.support.compactions}${saved !== undefined ? ` (${saved} tokens saved)` : ''}`);
+    return lines.join('\n');
+}
+/** Run the session-inspect command. Prints to stdout/stderr; returns the exit code. */
+export async function runInspectSession(opts) {
+    const sessionsDir = resolveSessionsDir({ workspaceRoot: opts.cwd ?? process.cwd() });
+    const sessionDir = path.join(sessionsDir, opts.sessionId);
+    const eventsPath = path.join(sessionDir, 'events.jsonl');
+    // readHarnessState is tolerant by contract (missing log ⇒ empty pending
+    // state), so "session not found" is checked HERE, before the read.
+    if (!existsSync(sessionDir)) {
+        // eslint-disable-next-line no-console
+        console.error(`zelari-code inspect: no session directory at ${sessionDir}`);
+        return 1;
+    }
+    if (!existsSync(eventsPath)) {
+        // eslint-disable-next-line no-console
+        console.error(`zelari-code inspect: session directory has no events.jsonl at ${eventsPath}`);
+        return 1;
+    }
+    let state;
+    try {
+        state = await readHarnessState(sessionDir);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        // eslint-disable-next-line no-console
+        console.error(`zelari-code inspect: cannot read session at ${sessionDir}: ${msg}`);
+        return 1;
+    }
+    // eslint-disable-next-line no-console
+    console.log(opts.json ? JSON.stringify(state, null, 2) : renderInspectReport(state));
+    return 0;
+}
+//# sourceMappingURL=inspectSession.js.map

package/dist/cli/commands/inspectSession.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspectSession.js","sourceRoot":"","sources":["../../../src/cli/commands/inspectSession.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAqB,MAAM,oBAAoB,CAAC;AAEzE;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAmB;IACrD,MAAM,KAAK,GAAa;QACtB,WAAW,KAAK,CAAC,OAAO,CAAC,SAAS,YAAY,KAAK,CAAC,OAAO,CAAC,MAAM,WAAW,KAAK,CAAC,SAAS,CAAC,UAAU,EAAE;KAC1G,CAAC;IACF,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAClF,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAC/B,MAAM,QAAQ,GAAG,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAChD,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY;YACpC,CAAC,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,eAAe,EAAE;YAClF,CAAC,CAAC,SAAS,CAAC,CAAC,uDAAuD;QACtE,MAAM,QAAQ,GAAG,QAAQ,EAAE,QAAQ,IAAI,EAAE,CAAC;QAC1C,MAAM,UAAU,GAAG,QAAQ,EAAE,QAAQ;YACnC,CAAC,CAAC,UAAU;YACZ,CAAC,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC;gBACnB,CAAC,CAAC,gBAAgB,QAAQ,CAAC,MAAM,cAAc,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;gBACpE,CAAC,CAAC,YAAY,CAAC;QACnB,KAAK,CAAC,IAAI,CACR,UAAU,IAAI,CAAC,KAAK,MAAM,IAAI,CAAC,OAAO,oBAAoB,YAAY,eAAe,UAAU,EAAE,CAClG,CAAC;IACJ,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAC5B,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,kBAAkB,CAAC;IACrD,MAAM,IAAI,GAAG,WAAW,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACjD,KAAK,CAAC,IAAI,CACR,0BAA0B,WAAW,CAAC,MAAM,EAAE;QAC5C,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,IAAI,CAAC,YAAY,YAAY,IAAI,CAAC,aAAa,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CACrF,CAAC;IACF,KAAK,CAAC,IAAI,CAAC,oBAAoB,KAAK,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IAC7D,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,uBAAuB,CAAC;IACpD,KAAK,CAAC,IAAI,CACR,kBAAkB,KAAK,CAAC,OAAO,CAAC,WAAW,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,KAAK,gBAAgB,CAAC,CAAC,CAAC,EAAE,EAAE,CACtG,CAAC;IACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAWD,uFAAuF;AACvF,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAA2B;IACjE,MAAM,WAAW,GAAG,kBAAkB,CAAC,EAAE,aAAa,EAAE,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACrF,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IAC1D,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;IACzD,wEAAwE;IACxE,mEAAmE;IACnE,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,sCAAsC;QACtC,OAAO,CAAC,KAAK,CAAC,gDAAgD,UAAU,EAAE,CAAC,CAAC;QAC5E,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,sCAAsC;QACtC,OAAO,CAAC,KAAK,CAAC,iEAAiE,UAAU,EAAE,CAAC,CAAC;QAC7F,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,KAAmB,CAAC;IACxB,IAAI,CAAC;QACH,KAAK,GAAG,MAAM,gBAAgB,CAAC,UAAU,CAAC,CAAC;IAC7C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7D,sCAAsC;QACtC,OAAO,CAAC,KAAK,CAAC,+CAA+C,UAAU,KAAK,GAAG,EAAE,CAAC,CAAC;QACnF,OAAO,CAAC,CAAC;IACX,CAAC;IACD,sCAAsC;IACtC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC,CAAC;IACrF,OAAO,CAAC,CAAC;AACX,CAAC"}