@synap-core/cli 1.12.2 → 1.13.1-next.20261102.246dc73

package/dist/commands/statusline.now.test.js

@@ -0,0 +1,250 @@
+/**
+ * The statusline's per-conversation pod cache and its 4th ("now") line,
+ * driven through the REAL exported `statusline()`.
+ *
+ * The `/tmp/synap-statusline-*` caches live in an in-memory map (a test must
+ * never read or write the person's real cache); every other path is the real
+ * fs under the throwaway HOME of test/setup/temp-home.ts. fd 0 (stdin) returns
+ * the Claude Code JSON fixture.
+ */
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+const tmpFiles = new Map();
+let stdin = "";
+const isTmp = (p) => typeof p === "string" && p.startsWith("/tmp/synap-statusline");
+vi.mock("node:fs", async () => {
+    const real = await vi.importActual("node:fs");
+    const fs = {
+        ...real,
+        readFileSync: ((p, ...rest) => {
+            if (p === 0)
+                return stdin;
+            if (isTmp(p)) {
+                if (!tmpFiles.has(p))
+                    throw new Error(`ENOENT ${String(p)}`);
+                return tmpFiles.get(p);
+            }
+            return real.readFileSync(p, ...rest);
+        }),
+        writeFileSync: ((p, data, ...rest) => {
+            if (isTmp(p))
+                return void tmpFiles.set(p, String(data));
+            return real.writeFileSync(p, data, ...rest);
+        }),
+        unlinkSync: ((p) => {
+            if (isTmp(p))
+                return void tmpFiles.delete(p);
+            return real.unlinkSync(p);
+        }),
+        statSync: ((p, ...rest) => {
+            if (isTmp(p)) {
+                if (!tmpFiles.has(p))
+                    throw new Error(`ENOENT ${String(p)}`);
+                return { mtimeMs: Date.now(), size: tmpFiles.get(p).length };
+            }
+            return real.statSync(p, ...rest);
+        }),
+    };
+    // `default` last: `real` carries its own `default`, which must not win.
+    return { ...fs, default: fs };
+});
+// Every way out of the process throws: render must never need one.
+const spawn = vi.fn((_cmd, _args) => {
+    throw new Error("render must not spawn into the network");
+});
+const forbidden = (name) => () => {
+    throw new Error(`render must not call child_process.${name}`);
+};
+vi.mock("node:child_process", () => ({
+    spawn: (cmd, args) => spawn(cmd, args),
+    exec: forbidden("exec"),
+    execSync: forbidden("execSync"),
+    execFile: forbidden("execFile"),
+    execFileSync: forbidden("execFileSync"),
+}));
+const hubGet = vi.fn();
+vi.mock("../lib/hub-client.js", async () => {
+    const real = await vi.importActual("../lib/hub-client.js");
+    return {
+        ...real,
+        resolveHubConfig: async () => ({ podUrl: "https://pod.test", apiKey: "k", workspaceId: `ws-${process.env.SYNAP_LENS_SESSION}` }),
+        hubGet: (...args) => hubGet(...args),
+    };
+});
+vi.mock("../lib/session-lens.js", () => ({
+    resolveActiveLens: () => ({ focusSessionId: `fs-${process.env.SYNAP_LENS_SESSION}` }),
+}));
+vi.mock("../lib/pod.js", () => ({ getSurfaceAgentKey: () => null, SURFACE_NAMES: [] }));
+const { statusline, convCacheFile } = await import("./statusline.js");
+const SHARED = "/tmp/synap-statusline-cache.json";
+// eslint-disable-next-line no-control-regex
+const plain = (s) => s.replace(/\x1b\[[0-9;]*m|\x1b\]8;;[^\x1b]*\x1b\\/g, "");
+function podAnswers() {
+    hubGet.mockImplementation(async (p) => {
+        if (p === "/workspaces")
+            return { workspaces: [{ id: "ws-A", name: "Alpha", entityCount: 3 }, { id: "ws-B", name: "Beta", entityCount: 4 }] };
+        if (p.startsWith("/agent-skills"))
+            return { total: 7 };
+        if (p === "/needs-you")
+            return { count: { needsYou: 0, truncated: false } };
+        const m = /^\/focus-sessions\/fs-(\w+)$/.exec(p);
+        if (m)
+            return { id: `fs-${m[1]}`, goal: `goal of ${m[1]}` };
+        return null;
+    });
+}
+async function refreshAs(conv) {
+    vi.stubEnv("SYNAP_LENS_SESSION", conv);
+    await statusline({ refresh: true });
+}
+async function renderAs(conv, extra = {}) {
+    stdin = JSON.stringify({ session_id: conv, model: { display_name: "Opus" }, context_window: { used_percentage: 12 }, cost: { total_cost_usd: 1.5 }, ...extra });
+    const out = [];
+    const log = vi.spyOn(console, "log").mockImplementation((s) => void out.push(plain(String(s))));
+    try {
+        await statusline();
+    }
+    finally {
+        log.mockRestore();
+    }
+    return out;
+}
+beforeEach(() => {
+    tmpFiles.clear();
+    spawn.mockClear();
+    hubGet.mockReset();
+    vi.stubEnv("CLAUDE_CODE_SESSION_ID", "");
+    vi.stubEnv("SYNAP_STATUSLINE_TRANSCRIPT", "");
+    vi.stubEnv("COLUMNS", "");
+});
+afterEach(() => vi.unstubAllEnvs());
+describe("per-conversation pod cache", () => {
+    it("each conversation's session lives in its own file; the pod-wide burst runs once for both", async () => {
+        podAnswers();
+        await refreshAs("A");
+        await refreshAs("B");
+        expect(JSON.parse(tmpFiles.get(convCacheFile("A")))).toMatchObject({ sessionGoal: "goal of A", activeWorkspaceId: "ws-A" });
+        expect(JSON.parse(tmpFiles.get(convCacheFile("B")))).toMatchObject({ sessionGoal: "goal of B", activeWorkspaceId: "ws-B" });
+        // N conversations never multiply the pod-wide burst: B found the shared cache fresh.
+        expect(hubGet.mock.calls.filter(([p]) => p === "/workspaces")).toHaveLength(1);
+        expect(JSON.parse(tmpFiles.get(SHARED))).not.toHaveProperty("sessionGoal");
+        const a = await renderAs("A");
+        const b = await renderAs("B");
+        expect(a[1]).toContain("goal of A");
+        expect(a[1]).toContain("Alpha");
+        expect(a[1]).not.toContain("goal of B");
+        expect(b[1]).toContain("goal of B");
+        expect(b[1]).toContain("Beta");
+    });
+    it("a conversation with no cache of its own never shows the session another conversation left in an old shared cache", async () => {
+        tmpFiles.set(SHARED, JSON.stringify({ ts: Date.now(), attemptedTs: Date.now(), ok: true, workspaces: [], sessionGoal: "someone else's goal", sessionId: "x" }));
+        const out = await renderAs("C");
+        expect(out.join("\n")).not.toContain("someone else's goal");
+    });
+    it("a failing pod keeps the conversation's last good values and stamps its attempt", async () => {
+        podAnswers();
+        await refreshAs("A");
+        const before = JSON.parse(tmpFiles.get(convCacheFile("A")));
+        hubGet.mockRejectedValue(new Error("429"));
+        tmpFiles.set(convCacheFile("A"), JSON.stringify({ ...before, attemptedTs: 0 })); // due again
+        await refreshAs("A");
+        const after = JSON.parse(tmpFiles.get(convCacheFile("A")));
+        expect(after).toMatchObject({ ok: false, sessionGoal: "goal of A", ts: before.ts }); // a 429 keeps the last good value
+        expect(Date.now() - after.attemptedTs).toBeLessThan(5_000); // …and stamps the attempt (no storm)
+    });
+    it("render refreshes only when a cache is due, and a refresh of one conversation does not refetch the other's", async () => {
+        const fresh = { ts: Date.now(), attemptedTs: Date.now(), ok: true };
+        tmpFiles.set(SHARED, JSON.stringify({ ...fresh, workspaces: [] }));
+        tmpFiles.set(convCacheFile("A"), JSON.stringify(fresh));
+        await renderAs("A");
+        expect(spawn).not.toHaveBeenCalled();
+        await renderAs("B"); // B has no cache yet → a refresh is wanted (spawn throws; render goes on)
+        expect(spawn).toHaveBeenCalledTimes(1);
+    });
+});
+describe("render touches no network", () => {
+    it("prints all 4 lines from local files with fetch and every child_process call throwing", async () => {
+        const fetchSpy = vi.fn(() => {
+            throw new Error("render must not fetch");
+        });
+        vi.stubGlobal("fetch", fetchSpy);
+        try {
+            const home = os.homedir();
+            const conv = "11111111-2222-3333-4444-555555555555";
+            // Claude Code's registry: this conversation is idle (its turn ended).
+            fs.mkdirSync(path.join(home, ".claude", "sessions"), { recursive: true });
+            fs.writeFileSync(path.join(home, ".claude", "sessions", "999.json"), JSON.stringify({ pid: 999, sessionId: conv, status: "shell", statusUpdatedAt: Date.now() - 60_000, startedAt: Date.now() - 3_600_000 }));
+            // The transcript: one background agent, still running.
+            const transcript = path.join(home, "t.jsonl");
+            const ts = new Date(Date.now() - 5 * 60_000).toISOString();
+            fs.writeFileSync(transcript, [
+                JSON.stringify({ type: "assistant", timestamp: ts, message: { content: [{ type: "tool_use", id: "toolu_a", name: "Agent", input: { description: "Review the diff" } }] } }),
+                JSON.stringify({ type: "user", timestamp: ts, message: { content: [{ type: "tool_result", tool_use_id: "toolu_a", content: "ok" }] }, toolUseResult: { status: "async_launched", agentId: "a1" } }),
+            ].join("\n") + "\n");
+            // A typed wait, running.
+            const wdir = path.join(home, ".synap", "waits", conv);
+            fs.mkdirSync(wdir, { recursive: true });
+            fs.writeFileSync(path.join(wdir, "w.json"), JSON.stringify({ id: "w", kind: "devbox", ref: "w7", label: "", pid: process.pid, startedAt: Date.now() - 120_000, probedAt: Date.now(), changedAt: Date.now(), state: "running", detail: "be-file · 1/2 done", attempt: 1, probeErrors: 0 }));
+            const out = await renderAs(conv, { transcript_path: transcript, cwd: home, rate_limits: { five_hour: { used_percentage: 10 } } });
+            expect(fetchSpy).not.toHaveBeenCalled();
+            expect(out).toHaveLength(4);
+            expect(out[3]).toBe("⏳ waiting on 2 · devbox w7 running (be-file · 1/2 done) 2m · Review the diff 5m");
+            // The index it built is on disk for the next render.
+            expect(JSON.parse(fs.readFileSync(path.join(home, ".synap", "statusline", `${conv}.json`), "utf-8")).open.a1).toBeDefined();
+        }
+        finally {
+            vi.unstubAllGlobals();
+        }
+    });
+});
+describe("line 4 from the bridge's status file", () => {
+    /** This conversation's registry (idle, its process started an hour ago) and, when given, its status file. */
+    function conversation(conv, statusFile) {
+        const home = os.homedir();
+        fs.mkdirSync(path.join(home, ".claude", "sessions"), { recursive: true });
+        fs.writeFileSync(path.join(home, ".claude", "sessions", `${conv.slice(0, 4)}.json`), JSON.stringify({ pid: 4321, sessionId: conv, status: "idle", statusUpdatedAt: Date.now() - 60_000, startedAt: Date.now() - 3_600_000 }));
+        if (statusFile === undefined)
+            return;
+        const dir = path.join(home, ".synap", "bridge", "status");
+        fs.mkdirSync(dir, { recursive: true });
+        fs.writeFileSync(path.join(dir, `${conv}.json`), statusFile);
+    }
+    const bridgeFile = (writtenAt) => JSON.stringify({
+        v: 1,
+        writtenAt: new Date(writtenAt).toISOString(),
+        sessionId: "54436c32-783f-4a9d-9322-16ff18f448f7",
+        title: "Lane cli-statusfile",
+        live: null,
+        nextMove: { kind: "agent_slot", actor: "ai", label: "Open the PR", reason: "" },
+        waitingOn: [{ reason: "approval", count: 2 }],
+        workUnits: [],
+    });
+    it("a fresh file is drawn: what the pod says the conversation waits on", async () => {
+        const conv = "aaaa1111-2222-3333-4444-555555555555";
+        conversation(conv, bridgeFile(Date.now() - 30_000));
+        const out = await renderAs(conv);
+        expect(out[3]).toBe("⏳ waiting on 2 · approval (2) · next: Open the PR");
+    });
+    it("no file: the transcript index line, as before", async () => {
+        const conv = "bbbb1111-2222-3333-4444-555555555555";
+        conversation(conv);
+        const out = await renderAs(conv);
+        expect(out[3]).toBe("■ stopped · nothing running · 1m");
+    });
+    it("a file an earlier Claude Code process wrote is stale: the transcript index line", async () => {
+        const conv = "cccc1111-2222-3333-4444-555555555555";
+        conversation(conv, bridgeFile(Date.now() - 2 * 3_600_000));
+        const out = await renderAs(conv);
+        expect(out[3]).toBe("■ stopped · nothing running · 1m");
+    });
+    it("a malformed file falls back, never throws, and is marked as a failed read", async () => {
+        const conv = "dddd1111-2222-3333-4444-555555555555";
+        conversation(conv, '{"v":1,"writ');
+        const out = await renderAs(conv);
+        expect(out).toHaveLength(4);
+        expect(out[3]).toBe("■ stopped · nothing running · 1m · ⚑ bridge status not JSON");
+    });
+});
+//# sourceMappingURL=statusline.now.test.js.map

package/dist/commands/statusline.now.test.js.map

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

package/dist/commands/tracks.d.ts

@@ -1,13 +1,19 @@
 /**
- * `synap track` — a LASTING goal inside a project (Hub `/api/hub/tracks`).
- * Work in it = `synap session start --track <id>`. A legacy track also runs a
+ * `synap track` — a goal inside a project (Hub `/api/hub/tracks`).
+ * Work in it = `synap session start --track <id>`. A goal stays open as long as
+ * it matters, or a person closes it with a verdict. A legacy track also runs a
  * method (a project-scoped playbook) with steps; a new one needs none.
  *
- *   list        a project's tracks (defaults to the active project lens)
+ *   list        a project's tracks (the active project lens, else every goal on the pod)
  *   show        one track, its steps and where it stands
- *   start       start a track on a project (--name; --playbook is legacy)
+ *   start       start a track on a project (--name; --end-state, --criterion, … say what done is)
+ *   update      set a goal's direction, KPI and content
+ *   accept      the goal's judge accepts / sends back / rejects a claimed criterion
  *   advance     move a track to a step — returns the step's session OFFER
- *   status      pause / resume / complete / archive
+ *   status      move it through its lifecycle; close (completed) and drop
+ *               (archived) carry --verdict
+ *   reopen      a closed or dropped goal comes back as a NEW version
+ *   convert     (`synap goal convert`) make a goal / objective / OKR entity a goal
  *   params      answer the method's params (merged; `key=null` clears)
  *   start-step  start the work session of one step (default: current step)
  *
@@ -19,14 +25,45 @@
  */
 import { type BaseOpts } from "./data.js";
 type Json = Record<string, unknown>;
+/** The kinds of check a person can name for a criterion (`--criterion "judged: …"`). */
+export declare const CRITERION_KINDS: readonly ["measured", "judged", "handed_over", "learning", "decided_outside", "certified"];
+/**
+ * The stored evaluator a typed line gets for each kind — one the pod's
+ * `CHECK_MEANING_EVALUATORS` allows for it (a person typing a line cannot
+ * post evidence, so the person's grade wherever the meaning allows one);
+ * `test/goal-criterion-parity.test.ts` holds both tables to the pod's.
+ */
+/** The pod's criterion key length (`sessionCriterionSchema` `key` `.max`). */
+export declare const CRITERION_KEY_MAX = 80;
+export declare const CRITERION_EVALUATOR: Record<(typeof CRITERION_KINDS)[number], string>;
+/**
+ * `--criterion "[kind:] statement"` → a goal criterion. Kind defaults to
+ * `judged` (a person checks it); the key is a slug of the statement, made
+ * unique among `taken`. A `learning` criterion is about the method.
+ */
+export declare function parseCriterion(line: string, taken: Set<string>): Json;
+/** The goal-content flags shared by `track start` and `track update`. */
+interface GoalContentOpts {
+    endState?: string;
+    criterion?: string[];
+    dropCondition?: string[];
+    kind?: string;
+    uncertainty?: string;
+    loop?: string;
+}
+/** Goal-content flags → the body fields the pod reads (only what was typed). */
+export declare function goalContentBody(opts: GoalContentOpts): Json;
 /** `key=value` pairs → params. Values parse as JSON when they can (`null`, numbers, lists). */
 export declare function parseParamPairs(pairs: string[]): Json;
 export declare function listTracks(opts: BaseOpts & {
     project?: string;
     all?: boolean;
+    everywhere?: boolean;
+    limit?: string;
+    cursor?: string;
 }): Promise<void>;
 export declare function showTrack(id: string, opts: BaseOpts): Promise<void>;
-export declare function startTrack(opts: BaseOpts & {
+export declare function startTrack(opts: BaseOpts & GoalContentOpts & {
     playbook?: string;
     project?: string;
     name?: string;
@@ -39,6 +76,14 @@ export declare function advanceTrack(id: string, toStage: string, opts: BaseOpts
 }): Promise<void>;
 export declare function setTrackStatus(id: string, status: string, opts: BaseOpts & {
     reason?: string;
+    verdict?: string;
+    verdictReason?: string;
+    expected?: string;
+}): Promise<void>;
+/** A closed or dropped goal comes back as a NEW version — never moved back. */
+export declare function reopenTrack(id: string, opts: BaseOpts & {
+    name?: string;
+    reason?: string;
 }): Promise<void>;
 export declare function setTrackParams(id: string, pairs: string[], opts: BaseOpts & {
     reason?: string;
@@ -48,4 +93,21 @@ export declare function startStep(id: string, opts: BaseOpts & {
     title?: string;
     goal?: string;
 }): Promise<void>;
+/** Set where a goal is heading, its KPI and what it holds (PATCH /tracks/:id/direction). */
+export declare function updateTrack(id: string, opts: BaseOpts & GoalContentOpts & {
+    direction?: string;
+    kpiCurrent?: string;
+    kpiTarget?: string;
+    reason?: string;
+}): Promise<void>;
+/** The goal's JUDGE decides a claimed criterion (a person's act — an agent key is refused). */
+export declare function acceptCriterion(id: string, key: string, decision: string, opts: BaseOpts & {
+    note?: string;
+}): Promise<void>;
+/** "Make it a goal" — a goal / objective / okr entity becomes a goal, once. */
+export declare function convertToGoal(entityId: string, opts: BaseOpts & {
+    project?: string;
+    name?: string;
+    reason?: string;
+}): Promise<void>;
 export {};