zelari-code 2.50.1 → 2.51.0

package/dist/cli/acp/server.js

@@ -0,0 +1,229 @@
+/**
+ * acp/server — the stdio JSON-RPC 2.0 loop behind `zelari-code acp`.
+ *
+ * Responsibilities (and nothing else): decode frames, route methods, keep the
+ * loop NON-BLOCKING while a turn runs, translate failures into JSON-RPC
+ * errors, shut down cleanly on EOF. The agent runtime itself lives behind the
+ * injected `AcpTurnDispatcher` (turnAdapter.ts) — this module has no opinion
+ * about how a turn is executed, which keeps its tests model-free.
+ *
+ * Fail-soft invariants (P2), each covered by a test:
+ *   - malformed frame  -> reported to `log` (stderr), loop continues;
+ *   - unknown method   -> -32601, loop continues;
+ *   - bad params       -> -32602, loop continues;
+ *   - internal throw   -> -32603, loop continues (process stays alive);
+ *   - stdin EOF/error  -> in-flight prompts settle as 'cancelled', reader
+ *                         detaches, `onShutdown` fires once (exit 0 upstream).
+ *
+ * Protocol subset + explicit non-goals: see the header of protocol.ts.
+ */
+import { randomUUID } from 'node:crypto';
+import { attachFrameReader, createFrameWriter } from './framing.js';
+import { AcpError, JSON_RPC_ERRORS, parseJsonRpcMessage, readInitializeParams, readPromptParams, readSessionIdParams, readSessionNewParams, sessionUpdateNotification, } from './protocol.js';
+/** Agent capabilities advertised on `initialize` (no reverse requests). */
+export const ACP_AGENT_CAPABILITIES = {
+    loadSession: false,
+    promptCapabilities: { image: false, audio: false, embeddedContext: false },
+};
+function resultResponse(id, result) {
+    return { jsonrpc: '2.0', id, result };
+}
+function errorResponse(id, code, message) {
+    return { jsonrpc: '2.0', id, error: { code, message } };
+}
+function errorCodeOf(err) {
+    return err instanceof AcpError ? err.code : JSON_RPC_ERRORS.INTERNAL_ERROR;
+}
+function errorMessageOf(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+/** Start the ACP transport on the given (or process) stdio pair. */
+export function startAcpServer(deps) {
+    const input = deps.input ?? process.stdin;
+    const log = deps.log ?? ((line) => process.stderr.write(`${line}\n`));
+    const sessions = new Map();
+    let closed = false;
+    // The frame writer binds sink.write NOW (framing.ts): a turn's stdout
+    // capture (turnAdapter.ts) can never swallow a JSON-RPC frame.
+    const writer = createFrameWriter(deps.output ?? process.stdout, (message) => log(`[zelari-code acp] stdout write failed: ${message}`));
+    const shutdownWaiters = [];
+    const reader = attachFrameReader(input, {
+        onMessage: (raw) => {
+            void handleMessage(raw);
+        },
+        onEof: () => shutdown(),
+        onMalformedFrame: (detail) => log(`[zelari-code acp] frame dropped (fail-soft): ${detail}`),
+    });
+    function shutdown() {
+        if (closed)
+            return;
+        closed = true;
+        for (const session of sessions.values())
+            cancelPrompt(session);
+        reader.detach();
+        for (const waiter of shutdownWaiters.splice(0))
+            waiter();
+        try {
+            deps.onShutdown?.();
+        }
+        catch {
+            /* shutdown is best-effort */
+        }
+    }
+    function cancelPrompt(session) {
+        const inflight = session.inflight;
+        if (!inflight)
+            return;
+        inflight.cancelled = true;
+        try {
+            inflight.abort.abort();
+        }
+        catch {
+            /* ignore */
+        }
+        inflight.settle({ stopReason: 'cancelled' });
+    }
+    async function handleMessage(raw) {
+        const parsed = parseJsonRpcMessage(raw);
+        if (parsed.kind === 'invalid') {
+            writer.write(errorResponse(parsed.id, JSON_RPC_ERRORS.INVALID_REQUEST, parsed.reason));
+            return;
+        }
+        if (parsed.kind === 'notification') {
+            handleNotification(parsed.notification.method, parsed.notification.params);
+            return;
+        }
+        const { id, method, params } = parsed.request;
+        let outcome;
+        try {
+            outcome = handleRequest(method, params);
+        }
+        catch (err) {
+            writer.write(errorResponse(id, errorCodeOf(err), errorMessageOf(err)));
+            return;
+        }
+        if (outcome.kind === 'result') {
+            writer.write(resultResponse(id, outcome.value));
+            return;
+        }
+        // Pending (a turn is running): the loop keeps reading stdin while the
+        // response is written when the dispatcher settles.
+        outcome.promise.then((value) => writer.write(resultResponse(id, value)), (err) => writer.write(errorResponse(id, errorCodeOf(err), errorMessageOf(err))));
+    }
+    /** Inbound notifications are never answered (JSON-RPC 2.0). */
+    function handleNotification(method, params) {
+        try {
+            if (method === 'initialized')
+                return; // handshake tail: nothing to do
+            if (method === 'session/cancel') {
+                const { sessionId } = readSessionIdParams(params, 'session/cancel');
+                const session = sessions.get(sessionId);
+                if (!session) {
+                    log(`[zelari-code acp] session/cancel for unknown session '${sessionId}'`);
+                    return;
+                }
+                cancelPrompt(session);
+                return;
+            }
+            if (method === '$/cancelRequest')
+                return; // acknowledged, no-op
+            log(`[zelari-code acp] ignoring unknown notification '${method}'`);
+        }
+        catch (err) {
+            log(`[zelari-code acp] notification '${method}' rejected: ${errorMessageOf(err)}`);
+        }
+    }
+    function handleRequest(method, params) {
+        switch (method) {
+            case 'initialize': {
+                const { protocolVersion } = readInitializeParams(params);
+                return {
+                    kind: 'result',
+                    value: {
+                        protocolVersion,
+                        agentCapabilities: ACP_AGENT_CAPABILITIES,
+                        authMethods: [],
+                    },
+                };
+            }
+            case 'session/new': {
+                const { cwd } = readSessionNewParams(params, deps.fallbackCwd);
+                const sessionId = randomUUID();
+                sessions.set(sessionId, { id: sessionId, cwd });
+                return { kind: 'result', value: { sessionId } };
+            }
+            case 'session/prompt': {
+                const { sessionId, text } = readPromptParams(params);
+                const session = sessions.get(sessionId);
+                if (!session) {
+                    throw new AcpError(JSON_RPC_ERRORS.INVALID_PARAMS, `unknown session '${sessionId}'`);
+                }
+                if (session.inflight) {
+                    throw new AcpError(JSON_RPC_ERRORS.INVALID_PARAMS, `session '${sessionId}' already has a prompt in flight`);
+                }
+                return { kind: 'pending', promise: startPrompt(session, text) };
+            }
+            case 'session/cancel': {
+                const { sessionId } = readSessionIdParams(params, 'session/cancel');
+                const session = sessions.get(sessionId);
+                if (!session) {
+                    throw new AcpError(JSON_RPC_ERRORS.INVALID_PARAMS, `unknown session '${sessionId}'`);
+                }
+                cancelPrompt(session);
+                return { kind: 'result', value: null };
+            }
+            default:
+                throw new AcpError(JSON_RPC_ERRORS.METHOD_NOT_FOUND, `method not found: ${method}`);
+        }
+    }
+    function startPrompt(session, text) {
+        const record = {
+            cancelled: false,
+            settled: false,
+            abort: new AbortController(),
+            settle: () => { },
+        };
+        const promise = new Promise((resolve) => {
+            record.settle = (result) => {
+                if (record.settled)
+                    return;
+                record.settled = true;
+                resolve(result);
+            };
+        });
+        session.inflight = record;
+        const onUpdate = (update) => {
+            // A cancelled turn stops streaming: the client was already told so.
+            if (record.cancelled)
+                return;
+            writer.write(sessionUpdateNotification(session.id, update));
+        };
+        void deps
+            .dispatcher({
+            sessionId: session.id,
+            cwd: session.cwd,
+            prompt: text,
+            onUpdate,
+            signal: record.abort.signal,
+        })
+            .then((result) => record.settle({ stopReason: record.cancelled ? 'cancelled' : result.stopReason }), (err) => {
+            log(`[zelari-code acp] turn failed: ${errorMessageOf(err)}`);
+            record.settle({ stopReason: record.cancelled ? 'cancelled' : 'refusal' });
+        })
+            .finally(() => {
+            if (session.inflight === record)
+                session.inflight = undefined;
+        });
+        return promise;
+    }
+    return {
+        sessionIds: () => [...sessions.keys()],
+        close: () => shutdown(),
+        whenClosed: () => closed
+            ? Promise.resolve()
+            : new Promise((resolve) => {
+                shutdownWaiters.push(resolve);
+            }),
+    };
+}
+//# sourceMappingURL=server.js.map

package/dist/cli/acp/server.js.map

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

package/dist/cli/acp/turnAdapter.js

@@ -0,0 +1,144 @@
+import { drainLines, mapCapturedLine, } from './eventMap.js';
+import { agentMessageChunk } from './protocol.js';
+/** Swap `process.stdout.write` for the duration of a turn. Returns restore. */
+export function captureStdout(onChunk) {
+    const original = process.stdout.write;
+    const patched = ((chunk, ...rest) => {
+        try {
+            const text = typeof chunk === 'string'
+                ? chunk
+                : Buffer.isBuffer(chunk)
+                    ? chunk.toString('utf8')
+                    : String(chunk);
+            onChunk(text);
+        }
+        catch {
+            /* a capture bug must never kill the turn */
+        }
+        // Callers (e.g. content builders) may pass a completion callback; honour it
+        // so nothing can hang waiting on a write that "succeeded".
+        const last = rest[rest.length - 1];
+        if (typeof last === 'function') {
+            try {
+                last();
+            }
+            catch {
+                /* ignore */
+            }
+        }
+        return true;
+    });
+    process.stdout.write = patched;
+    return () => {
+        process.stdout.write = original;
+    };
+}
+/**
+ * Serialize turn execution: the stdout capture is process-global, so exactly
+ * one turn may be in flight. Later prompts queue behind earlier ones.
+ */
+function createSingleFlight() {
+    let chain = Promise.resolve();
+    return (fn) => {
+        const run = chain.then(fn, fn);
+        chain = run.then(() => undefined, () => undefined);
+        return run;
+    };
+}
+/** Real dispatcher: lazy provider resolution + stdout capture, serialized. */
+export function createHeadlessTurnDispatcher(deps = {}) {
+    const enqueue = createSingleFlight();
+    const mode = deps.mode ?? 'kraken';
+    let streamPromise = null;
+    const ensureStream = () => {
+        if (!streamPromise) {
+            streamPromise = (async () => {
+                if (deps.resolveStream)
+                    return deps.resolveStream();
+                // Dynamic imports keep the TUI/provider graph out of the module load
+                // path until a turn actually needs it (same discipline as runHeadless).
+                const { resolveHeadlessKey, resolveHeadlessProvider } = await import('../headless.js');
+                const { provider, model } = resolveHeadlessProvider({
+                    ...(deps.provider ? { provider: deps.provider } : {}),
+                    ...(deps.model ? { model: deps.model } : {}),
+                });
+                const key = await resolveHeadlessKey(provider);
+                if ('error' in key)
+                    throw new Error(key.error);
+                const { buildProviderStream } = await import('../provider/resolveStream.js');
+                const stream = buildProviderStream({
+                    providerId: provider,
+                    apiKey: key.apiKey,
+                    baseUrl: key.baseUrl,
+                    model,
+                });
+                return { provider, model, stream };
+            })();
+            streamPromise.catch(() => {
+                streamPromise = null; // allow a retry once the key materializes
+            });
+        }
+        return streamPromise;
+    };
+    const runTurn = deps.dispatch ?? defaultDispatch;
+    return (request) => enqueue(async () => {
+        if (request.signal.aborted)
+            return { stopReason: 'cancelled', exitCode: 0 };
+        const { provider, model, stream } = await ensureStream();
+        const opts = {
+            task: request.prompt,
+            output: 'json',
+            mode,
+            phase: 'build',
+            useCouncil: mode === 'council',
+            cwd: request.cwd,
+        };
+        const buffer = { text: '' };
+        const emit = (line) => {
+            for (const update of mapCapturedLine(line))
+                request.onUpdate(update);
+        };
+        const restore = captureStdout((chunk) => {
+            buffer.text += chunk;
+            drainLines(buffer, false, emit);
+        });
+        const priorHostMarker = process.env['ZELARI_SERVE_HARNESS'];
+        process.env['ZELARI_SERVE_HARNESS'] = '1';
+        let exitCode = 2;
+        try {
+            exitCode = await runTurn(opts, provider, model, stream);
+        }
+        catch (err) {
+            request.onUpdate(agentMessageChunk(`\n[zelari-code acp] turn failed: ${err instanceof Error ? err.message : String(err)}\n`));
+            exitCode = 2;
+        }
+        finally {
+            if (priorHostMarker === undefined)
+                delete process.env['ZELARI_SERVE_HARNESS'];
+            else
+                process.env['ZELARI_SERVE_HARNESS'] = priorHostMarker;
+            restore();
+            drainLines(buffer, true, emit);
+        }
+        return {
+            stopReason: request.signal.aborted ? 'cancelled' : stopReasonForExit(exitCode),
+            exitCode,
+        };
+    });
+}
+/**
+ * Headless exit codes (headless.ts header): 0 completed, 1 user error,
+ * 2 runtime error, 3 agent errored, 5/6 strict evidence gates. ACP only has
+ * `end_turn | max_tokens | refusal | cancelled`; every non-zero outcome is
+ * reported as `refusal` (the turn did not deliver) — the exit code travels
+ * with AcpTurnResult for hosts that log it.
+ */
+function stopReasonForExit(exitCode) {
+    return exitCode === 0 ? 'end_turn' : 'refusal';
+}
+/** Default turn runner — the real headless dispatch (imported lazily). */
+async function defaultDispatch(opts, provider, model, stream) {
+    const { dispatchHeadlessTurn } = await import('../runHeadless.js');
+    return dispatchHeadlessTurn(opts, provider, model, stream);
+}
+//# sourceMappingURL=turnAdapter.js.map

package/dist/cli/acp/turnAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"turnAdapter.js","sourceRoot":"","sources":["../../../src/cli/acp/turnAdapter.ts"],"names":[],"mappings":"AA8BA,OAAO,EACL,UAAU,EACV,eAAe,GAEhB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,iBAAiB,EAAuC,MAAM,eAAe,CAAC;AA0CvF,+EAA+E;AAC/E,MAAM,UAAU,aAAa,CAAC,OAAgC;IAC5D,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;IACtC,MAAM,OAAO,GAAG,CAAC,CAAC,KAAc,EAAE,GAAG,IAAe,EAAW,EAAE;QAC/D,IAAI,CAAC;YACH,MAAM,IAAI,GACR,OAAO,KAAK,KAAK,QAAQ;gBACvB,CAAC,CAAC,KAAK;gBACP,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;oBACtB,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;oBACxB,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACtB,OAAO,CAAC,IAAI,CAAC,CAAC;QAChB,CAAC;QAAC,MAAM,CAAC;YACP,4CAA4C;QAC9C,CAAC;QACD,4EAA4E;QAC5E,2DAA2D;QAC3D,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACnC,IAAI,OAAO,IAAI,KAAK,UAAU,EAAE,CAAC;YAC/B,IAAI,CAAC;gBACF,IAAmB,EAAE,CAAC;YACzB,CAAC;YAAC,MAAM,CAAC;gBACP,YAAY;YACd,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,CAA2C,CAAC;IAC7C,OAAO,CAAC,MAAM,CAAC,KAAK,GAAG,OAAO,CAAC;IAC/B,OAAO,GAAG,EAAE;QACV,OAAO,CAAC,MAAM,CAAC,KAAK,GAAG,QAAQ,CAAC;IAClC,CAAC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,kBAAkB;IACzB,IAAI,KAAK,GAAqB,OAAO,CAAC,OAAO,EAAE,CAAC;IAChD,OAAO,CAAI,EAAoB,EAAc,EAAE;QAC7C,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QAC/B,KAAK,GAAG,GAAG,CAAC,IAAI,CACd,GAAG,EAAE,CAAC,SAAS,EACf,GAAG,EAAE,CAAC,SAAS,CAChB,CAAC;QACF,OAAO,GAAG,CAAC;IACb,CAAC,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,4BAA4B,CAAC,OAAyB,EAAE;IACtE,MAAM,OAAO,GAAG,kBAAkB,EAAE,CAAC;IACrC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,QAAQ,CAAC;IACnC,IAAI,aAAa,GAA6C,IAAI,CAAC;IAEnE,MAAM,YAAY,GAAG,GAAsC,EAAE;QAC3D,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,aAAa,GAAG,CAAC,KAAK,IAAI,EAAE;gBAC1B,IAAI,IAAI,CAAC,aAAa;oBAAE,OAAO,IAAI,CAAC,aAAa,EAAE,CAAC;gBACpD,qEAAqE;gBACrE,wEAAwE;gBACxE,MAAM,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC;gBACvF,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,uBAAuB,CAAC;oBAClD,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACrD,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBAC1B,CAAC,CAAC;gBACtB,MAAM,GAAG,GAAG,MAAM,kBAAkB,CAAC,QAAQ,CAAC,CAAC;gBAC/C,IAAI,OAAO,IAAI,GAAG;oBAAE,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;gBAC/C,MAAM,EAAE,mBAAmB,EAAE,GAAG,MAAM,MAAM,CAAC,8BAA8B,CAAC,CAAC;gBAC7E,MAAM,MAAM,GAAG,mBAAmB,CAAC;oBACjC,UAAU,EAAE,QAAiD;oBAC7D,MAAM,EAAE,GAAG,CAAC,MAAM;oBAClB,OAAO,EAAE,GAAG,CAAC,OAAO;oBACpB,KAAK;iBACN,CAAC,CAAC;gBACH,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;YACrC,CAAC,CAAC,EAAE,CAAC;YACL,aAAa,CAAC,KAAK,CAAC,GAAG,EAAE;gBACvB,aAAa,GAAG,IAAI,CAAC,CAAC,0CAA0C;YAClE,CAAC,CAAC,CAAC;QACL,CAAC;QACD,OAAO,aAAa,CAAC;IACvB,CAAC,CAAC;IAEF,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,IAAI,eAAe,CAAC;IAEjD,OAAO,CAAC,OAAO,EAAE,EAAE,CACjB,OAAO,CAAC,KAAK,IAA4B,EAAE;QACzC,IAAI,OAAO,CAAC,MAAM,CAAC,OAAO;YAAE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;QAC5E,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,YAAY,EAAE,CAAC;QACzD,MAAM,IAAI,GAAoB;YAC5B,IAAI,EAAE,OAAO,CAAC,MAAM;YACpB,MAAM,EAAE,MAAM;YACd,IAAI;YACJ,KAAK,EAAE,OAAO;YACd,UAAU,EAAE,IAAI,KAAK,SAAS;YAC9B,GAAG,EAAE,OAAO,CAAC,GAAG;SACjB,CAAC;QAEF,MAAM,MAAM,GAAe,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;QACxC,MAAM,IAAI,GAAG,CAAC,IAAY,EAAQ,EAAE;YAClC,KAAK,MAAM,MAAM,IAAI,eAAe,CAAC,IAAI,CAAC;gBAAE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACvE,CAAC,CAAC;QACF,MAAM,OAAO,GAAG,aAAa,CAAC,CAAC,KAAK,EAAE,EAAE;YACtC,MAAM,CAAC,IAAI,IAAI,KAAK,CAAC;YACrB,UAAU,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;QAClC,CAAC,CAAC,CAAC;QACH,MAAM,eAAe,GAAG,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;QAC5D,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,GAAG,GAAG,CAAC;QAE1C,IAAI,QAAQ,GAAG,CAAC,CAAC;QACjB,IAAI,CAAC;YACH,QAAQ,GAAG,MAAM,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;QAC1D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,QAAQ,CACd,iBAAiB,CAAC,oCAAoC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAC5G,CAAC;YACF,QAAQ,GAAG,CAAC,CAAC;QACf,CAAC;gBAAS,CAAC;YACT,IAAI,eAAe,KAAK,SAAS;gBAAE,OAAO,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;;gBACzE,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,GAAG,eAAe,CAAC;YAC3D,OAAO,EAAE,CAAC;YACV,UAAU,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QACjC,CAAC;QAED,OAAO;YACL,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,iBAAiB,CAAC,QAAQ,CAAC;YAC9E,QAAQ;SACT,CAAC;IACJ,CAAC,CAAC,CAAC;AACP,CAAC;AAED;;;;;;GAMG;AACH,SAAS,iBAAiB,CAAC,QAAgB;IACzC,OAAO,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;AACjD,CAAC;AAED,0EAA0E;AAC1E,KAAK,UAAU,eAAe,CAC5B,IAAqB,EACrB,QAAgB,EAChB,KAAa,EACb,MAAe;IAEf,MAAM,EAAE,oBAAoB,EAAE,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC;IACnE,OAAO,oBAAoB,CACzB,IAAI,EACJ,QAAQ,EACR,KAAK,EACL,MAAoD,CACrD,CAAC;AACJ,CAAC"}

package/dist/cli/commands/report.js

@@ -0,0 +1,273 @@
+/**
+ * commands/report — `/report`: one aggregate view of the ACTIVE session spine.
+ *
+ * WHAT IT READS: the session spine (`<sessionsDir>/<sessionId>/events.jsonl`,
+ * ADR-0016 — `resolveSessionsDir` honors ZELARI_SESSIONS_DIR + workspaceRoot),
+ * parsed with the CORE reader (`parseSessionLogText` → `buildProjection`,
+ * @zelari/core/session). Nothing is re-parsed by hand: the tolerant reader
+ * already reports corrupt lines as `ReplayIssue`s and skips retired kinds.
+ *
+ * WHAT IT PRINTS (markdown-ish text, deterministic order):
+ *   - header: session id, event count, issues (corrupt/unknown lines);
+ *   - files touched: unique paths + per-kind counters (`file.read`,
+ *     `file.applied`, `file.rejected` — the ADR-0033 spine SSOT). Spines that
+ *     predate ADR-0033 fall back to the `tool.call` args of the file tools,
+ *     and the header SAYS SO (never a silent different source);
+ *   - tool calls per tool (`tool.call`), with the result count;
+ *   - verify outcomes: the LAST `verification.run` per criterion + totals;
+ *   - tokens/cost: ONLY when those numbers are already on the spine
+ *     (compaction projections + any event carrying usage/cost fields).
+ *
+ * FAIL-SOFT: a missing sessions dir, an unknown session id, an unreadable
+ * file, or a spine with no events all produce a clear message and exit 0 —
+ * this command is diagnostics, never a gate.
+ */
+import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import path from 'node:path';
+import { buildProjection, parseSessionLogText, resolveSessionsDir } from '@zelari/core/session';
+import { getCurrentSessionId } from '../sessionManager.js';
+const FILE_TOOLS = new Set(['read_file', 'write_file', 'edit']);
+/** Newest spine session dir that actually holds an events.jsonl (null when none). */
+function newestSessionId(sessionsDir) {
+    try {
+        const names = readdirSync(sessionsDir).filter((n) => existsSync(path.join(sessionsDir, n, 'events.jsonl')));
+        if (names.length === 0)
+            return null;
+        const scored = names.map((n) => {
+            try {
+                const text = readFileSync(path.join(sessionsDir, n, 'events.jsonl'), 'utf-8');
+                const last = parseSessionLogText('events.jsonl', text).events;
+                return { n, ts: last[last.length - 1]?.ts ?? 0 };
+            }
+            catch {
+                return { n, ts: 0 };
+            }
+        });
+        scored.sort((a, b) => b.ts - a.ts);
+        return scored[0]?.n ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Human path (cwd-relative when possible) so the report stays readable. */
+function shortPath(p, cwd) {
+    const rel = path.relative(cwd, p);
+    return rel && !rel.startsWith('..') ? rel : p;
+}
+function render(report, cwd, sessionId) {
+    const projection = buildProjection(report.events, report.issues);
+    const lines = [];
+    lines.push(`# session report — ${sessionId}`);
+    lines.push('');
+    lines.push(`events: ${projection.eventCount}  tool calls: ${projection.toolCalls}  results: ${projection.toolResults}`);
+    if (report.issues.length > 0) {
+        const kinds = new Map();
+        for (const issue of report.issues)
+            kinds.set(issue.type, (kinds.get(issue.type) ?? 0) + 1);
+        lines.push(`spine issues: ${report.issues.length} (` +
+            [...kinds.entries()].map(([t, n]) => `${t}×${n}`).join(', ') +
+            ') — corrupt/unknown lines were skipped by the tolerant reader');
+    }
+    if (projection.startedAt !== undefined) {
+        lines.push(`started: ${new Date(projection.startedAt).toISOString()}`);
+    }
+    if (projection.endedAt !== undefined) {
+        lines.push(`ended:   ${new Date(projection.endedAt).toISOString()}`);
+    }
+    // ── files ───────────────────────────────────────────────────────────────
+    const files = new Map();
+    const touch = (p) => {
+        const key = p;
+        const found = files.get(key);
+        if (found)
+            return found;
+        const created = { path: p, read: 0, applied: 0, rejected: 0 };
+        files.set(key, created);
+        return created;
+    };
+    let fileEvents = 0;
+    for (const e of report.events) {
+        const p = typeof e.data.path === 'string' ? e.data.path : null;
+        if (!p)
+            continue;
+        if (e.kind === 'file.read') {
+            touch(p).read += 1;
+            fileEvents += 1;
+        }
+        else if (e.kind === 'file.applied') {
+            touch(p).applied += 1;
+            fileEvents += 1;
+        }
+        else if (e.kind === 'file.rejected') {
+            touch(p).rejected += 1;
+            fileEvents += 1;
+        }
+    }
+    let filesSource = 'file.* spine events (ADR-0033)';
+    if (fileEvents === 0) {
+        // Pre-ADR-0033 spine: derive from the tool.call args instead, and say so.
+        filesSource = 'tool.call args (legacy spine: no file.* events)';
+        for (const e of report.events) {
+            if (e.kind !== 'tool.call')
+                continue;
+            const tool = typeof e.data.tool === 'string' ? e.data.tool : '';
+            if (!FILE_TOOLS.has(tool))
+                continue;
+            const args = e.data.args;
+            const p = typeof args?.path === 'string' ? args.path : null;
+            if (p)
+                touch(p).applied += 1;
+        }
+    }
+    lines.push('');
+    lines.push(`## files touched — ${files.size} unique (${filesSource})`);
+    if (files.size === 0) {
+        lines.push('  (none)');
+    }
+    else {
+        const sorted = [...files.values()].sort((a, b) => a.path.localeCompare(b.path));
+        for (const f of sorted) {
+            const marks = [
+                f.read > 0 ? `read×${f.read}` : '',
+                f.applied > 0 ? `write×${f.applied}` : '',
+                f.rejected > 0 ? `rejected×${f.rejected}` : '',
+            ]
+                .filter(Boolean)
+                .join(' ');
+            lines.push(`  ${shortPath(f.path, cwd)}  ${marks}`);
+        }
+    }
+    // ── tools ───────────────────────────────────────────────────────────────
+    const byTool = new Map();
+    for (const e of report.events) {
+        if (e.kind !== 'tool.call')
+            continue;
+        const tool = typeof e.data.tool === 'string' && e.data.tool.length > 0 ? e.data.tool : '(unknown)';
+        byTool.set(tool, (byTool.get(tool) ?? 0) + 1);
+    }
+    lines.push('');
+    lines.push('## tool calls');
+    if (byTool.size === 0) {
+        lines.push('  (none)');
+    }
+    else {
+        const sorted = [...byTool.entries()].sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0]));
+        for (const [tool, count] of sorted)
+            lines.push(`  ${String(count).padStart(4)}  ${tool}`);
+    }
+    // ── verify ──────────────────────────────────────────────────────────────
+    lines.push('');
+    lines.push('## verify');
+    if (projection.verifications.length === 0) {
+        lines.push('  (no verification.run events on this spine)');
+    }
+    else {
+        const last = projection.verifications[projection.verifications.length - 1];
+        const pass = last.results.filter((r) => r.status === 'pass').length;
+        const fail = last.results.filter((r) => r.status !== 'pass').length;
+        lines.push(`  runs: ${projection.verifications.length}  last: ${new Date(last.at).toISOString()} — ` +
+            `${pass} pass / ${fail} fail${last.complete === undefined ? '' : last.complete ? ' (complete)' : ' (incomplete)'}`);
+        for (const r of last.results) {
+            lines.push(`  ${r.status.padEnd(8)} ${r.criterionId} (evidence ${r.evidenceCount})`);
+        }
+    }
+    // ── tokens / cost (only what the spine already carries) ─────────────────
+    let inputTokens = 0;
+    let outputTokens = 0;
+    let savedTokens = 0;
+    let costUsd = 0;
+    let sawTokens = false;
+    let sawCost = false;
+    for (const e of report.events) {
+        const d = e.data;
+        if (e.kind === 'session.compacted') {
+            if (typeof d.inputTokens === 'number') {
+                inputTokens += d.inputTokens;
+                sawTokens = true;
+            }
+            if (typeof d.outputTokens === 'number') {
+                outputTokens += d.outputTokens;
+                sawTokens = true;
+            }
+            if (typeof d.savedTokens === 'number') {
+                savedTokens += d.savedTokens;
+                sawTokens = true;
+            }
+        }
+        if (typeof d.costUsd === 'number') {
+            costUsd += d.costUsd;
+            sawCost = true;
+        }
+        const usage = d.usage;
+        if (usage && typeof usage === 'object') {
+            const u = usage;
+            if (typeof u.inputTokens === 'number') {
+                inputTokens += u.inputTokens;
+                sawTokens = true;
+            }
+            if (typeof u.outputTokens === 'number') {
+                outputTokens += u.outputTokens;
+                sawTokens = true;
+            }
+            if (typeof u.costUsd === 'number') {
+                costUsd += u.costUsd;
+                sawCost = true;
+            }
+        }
+    }
+    if (sawTokens || sawCost) {
+        lines.push('');
+        lines.push('## tokens / cost (as recorded on the spine)');
+        if (sawTokens) {
+            lines.push(`  compaction tokens: in ${inputTokens} / out ${outputTokens} / saved ${savedTokens}`);
+        }
+        if (sawCost)
+            lines.push(`  cost: $${costUsd.toFixed(4)}`);
+    }
+    return lines.join('\n');
+}
+/**
+ * Build the report. Never throws: every failure mode returns
+ * `{ ok: false, markdown: <clear message> }` (exit 0 by design).
+ */
+export function buildSessionReport(opts = {}) {
+    const cwd = opts.cwd ?? process.cwd();
+    const sessionsDir = resolveSessionsDir({ workspaceRoot: cwd, env: opts.env });
+    const marker = opts.sessionId ?? getCurrentSessionId() ?? undefined;
+    const marked = marker ? path.join(sessionsDir, marker, 'events.jsonl') : null;
+    const sessionId = marker && marked && existsSync(marked) ? marker : newestSessionId(sessionsDir);
+    if (!sessionId) {
+        return {
+            ok: false,
+            sessionId: '',
+            markdown: `no session spine found under ${sessionsDir} — nothing to report (this is not an error).`,
+        };
+    }
+    const eventsPath = path.join(sessionsDir, sessionId, 'events.jsonl');
+    let text;
+    try {
+        text = readFileSync(eventsPath, 'utf-8');
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return { ok: false, sessionId, markdown: `cannot read the session spine at ${eventsPath}: ${msg}` };
+    }
+    const parsed = parseSessionLogText(eventsPath, text);
+    if (parsed.events.length === 0) {
+        return {
+            ok: false,
+            sessionId,
+            markdown: `session ${sessionId}: the spine holds no readable events (${parsed.issues.length} issue(s)) — ${eventsPath}`,
+        };
+    }
+    return { ok: true, sessionId, markdown: render(parsed, cwd, sessionId) };
+}
+/** CLI entry: print the report to stdout; ALWAYS exit 0 (fail-soft). */
+export function runReport(opts = {}) {
+    const report = buildSessionReport(opts);
+    // eslint-disable-next-line no-console
+    console.log(report.markdown);
+    return 0;
+}
+//# sourceMappingURL=report.js.map