@geohar/pi-cribsheet 0.10.0 → 0.11.0

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AA8BA,OAAO,KAAK,EAER,YAAY,EAIf,MAAM,SAAS,CAAA;AA0GhB,MAAM,CAAC,OAAO,UAAU,SAAS,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CAyIxD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AA+BA,OAAO,KAAK,EAER,YAAY,EAIf,MAAM,SAAS,CAAA;AA8GhB,MAAM,CAAC,OAAO,UAAU,SAAS,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CA2JxD"}

package/dist/index.js

@@ -24,9 +24,11 @@
 // — see mcp.json.example and the README; static, and unnecessary when combiner-served.
 // The sharedserver resolution is ported faithfully from plugins/opencode/src/index.ts.
 import { spawnSync } from "node:child_process";
-import { existsSync, readFileSync } from "node:fs";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
 import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
+import { installCribPlanSource } from "./plan-source.js";
 import { resolveSharedserver } from "./sharedserver-resolve.js";
 const DEFAULT_PORT = 7732;
 const DEFAULT_HOST = "127.0.0.1";
@@ -113,7 +115,10 @@ function detach() {
         return;
     const { binary, name } = attachment;
     attachment = null;
-    spawnSync(binary, ["unuse", name, "--pid", String(process.pid)], { stdio: "ignore", env: process.env });
+    spawnSync(binary, ["unuse", name, "--pid", String(process.pid)], {
+        stdio: "ignore",
+        env: process.env,
+    });
 }
 // ── the extension ──────────────────────────────────────────────────
 export default function cribsheet(pi) {
@@ -134,7 +139,7 @@ export default function cribsheet(pi) {
     // ── /crib command: recall memory + code index, then steer the model ──
     if (wantCommand) {
         pi.registerCommand("crib", {
-            description: "Consult crib (recall memory + code index); verb: system-prompt shows the directive",
+            description: "Consult crib (recall memory + code index); verbs: system-prompt (show the directive), install-config [path] (write mcp.json)",
             getArgumentCompletions: (prefix) => completeVerbs(prefix),
             handler: async (args, ctx) => {
                 const arg = args.trim();
@@ -142,6 +147,10 @@ export default function cribsheet(pi) {
                     showDirective(ctx, "cribsheet", CRIB_DIRECTIVE, wantInstructions);
                     return;
                 }
+                if (arg === "install-config" || arg.startsWith("install-config ")) {
+                    installConfig(ctx, arg.slice("install-config".length).trim() || undefined);
+                    return;
+                }
                 const topic = arg;
                 if (!topic) {
                     ctx.ui?.notify?.("crib: give me a topic (e.g. /crib auth flow), or /crib system-prompt", "warn");
@@ -171,10 +180,19 @@ export default function cribsheet(pi) {
                     "back, say so plainly rather than guessing.\n\n" +
                     `Memory — semantic recall (crib note apropos):\n${memory}\n\n` +
                     `Code index — symbols by concept or name (crib code lookup):\n${code}`;
-                pi.sendMessage({ customType: "crib-recall", content, display: true, details: { topic } }, { triggerTurn: true, deliverAs: "steer" });
+                pi.sendMessage({
+                    customType: "crib-recall",
+                    content,
+                    display: true,
+                    details: { topic },
+                }, { triggerTurn: true, deliverAs: "steer" });
             },
         });
     }
+    // The crib PLAN SOURCE emits `plan:snapshot` events for a plan sidebar. Independent of
+    // server management (it reads via the crib CLI over the in-process bus), so it runs
+    // whether or not this plugin launches the backend — register it before the early return.
+    installCribPlanSource(pi, { resolveCrib });
     // Combiner-served or manage=false: nothing to launch (crib runs elsewhere). The
     // directive + command above still apply.
     if (served || !manage)
@@ -219,7 +237,10 @@ export default function cribsheet(pi) {
             useArgs.push("--log-file", logFile);
         useArgs.push("--", crib.cmd, ...crib.args, ...serve);
         installProcessCleanup();
-        const result = spawnSync(binary, useArgs, { stdio: "pipe", env: process.env });
+        const result = spawnSync(binary, useArgs, {
+            stdio: "pipe",
+            env: process.env,
+        });
         if (result.error) {
             log("error", `${name}: failed to spawn sharedserver (${result.error.message})`);
             return;
@@ -241,12 +262,91 @@ export default function cribsheet(pi) {
 // Slash-command verbs. `system-prompt` shows the directive this extension injects — the
 // show-command pattern from pi-custom-system-prompt, since `before_agent_start`
 // injections are per-turn and never appear in Pi's own `/system-prompt` (base only).
-const COMMAND_VERBS = ["system-prompt"];
+const COMMAND_VERBS = ["system-prompt", "install-config"];
 function completeVerbs(prefix) {
     const p = prefix.trim();
     const matches = COMMAND_VERBS.filter((v) => v.startsWith(p));
     return matches.length ? matches.map((v) => ({ value: v, label: v })) : null;
 }
+// ── /crib install-config: write the pi-mcp-adapter mcp.json entry ──
+// A USER-INVOKED write — merge the cribsheet entry into pi-mcp-adapter's mcp.json,
+// wired for crib's optional inbound bearer auth:
+//
+//   { "url": "…/mcp", "auth": "bearer", "bearerTokenEnv": "CRIBSHEET_AUTH_TOKEN" }
+//
+// - auth:"bearer" → the adapter attaches `Authorization: Bearer <token>` (it gates the
+//   header on `auth === "bearer"`, NOT on bearerTokenEnv alone), AND makes
+//   supportsOAuth() false so a wrong/missing token surfaces as an honest 401 rather
+//   than a Dynamic-Client-Registration 404.
+// - bearerTokenEnv → names the env var the token is read from at connect (nothing
+//   written to disk). The backend enforces only when CRIBSHEET_AUTH_TOKEN is set on ITS
+//   side; unset ⇒ open, the env var is unset here too so no header is sent. The one
+//   shape is correct whether or not auth is enabled. Ported from mcp-companion's
+//   /mcp-combiner install-config.
+function expandHome(p) {
+    if (p === "~")
+        return homedir();
+    if (p.startsWith("~/"))
+        return join(homedir(), p.slice(2));
+    return p;
+}
+/** The URL the adapter should reach cribsheet at — 127.0.0.1:<port>/mcp with the same
+ *  port defaults the backend serves on ($PI_CRIBSHEET_PORT, else 7732). */
+function defaultCribUrl() {
+    let port = DEFAULT_PORT;
+    const raw = env("PI_CRIBSHEET_PORT");
+    if (raw !== undefined) {
+        const n = Number(raw);
+        if (Number.isInteger(n) && n > 0)
+            port = n;
+    }
+    return `http://127.0.0.1:${port}/mcp`;
+}
+function installConfig(ctx, pathArg) {
+    const target = pathArg ? expandHome(pathArg) : join(homedir(), ".config", "mcp", "mcp.json");
+    const key = DEFAULT_NAME;
+    // Read + parse existing (tolerate absence; refuse to clobber non-JSON).
+    let doc = {};
+    if (existsSync(target)) {
+        try {
+            const parsed = JSON.parse(readFileSync(target, "utf8"));
+            if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+                ctx.ui?.notify?.(`cribsheet: ${target} is not a JSON object; not overwriting`, "error");
+                return;
+            }
+            doc = parsed;
+        }
+        catch (e) {
+            ctx.ui?.notify?.(`cribsheet: ${target} is not valid JSON; not overwriting (${e})`, "error");
+            return;
+        }
+    }
+    const servers = (doc.mcpServers ??= {});
+    const prev = (servers[key] ?? {});
+    const before = JSON.stringify(prev);
+    // Preserve any existing url and other fields; only ensure the auth-wiring keys.
+    servers[key] = {
+        ...prev,
+        url: typeof prev.url === "string" && prev.url ? prev.url : defaultCribUrl(),
+        auth: "bearer",
+        bearerTokenEnv: "CRIBSHEET_AUTH_TOKEN",
+    };
+    const existed = before !== "{}" && Object.keys(prev).length > 0;
+    const changed = before !== JSON.stringify(servers[key]);
+    try {
+        mkdirSync(dirname(target), { recursive: true });
+        writeFileSync(target, `${JSON.stringify(doc, null, 2)}\n`, "utf8");
+    }
+    catch (e) {
+        ctx.ui?.notify?.(`cribsheet: failed to write ${target} (${e})`, "error");
+        return;
+    }
+    const what = existed ? changed ? "updated" : "already configured" : "added";
+    ctx.ui?.notify?.(`cribsheet: ${what} "${key}" in ${target}\n` +
+        `Sends "Authorization: Bearer $CRIBSHEET_AUTH_TOKEN" when that env var is set ` +
+        `(auth:"bearer" both sends the token and suppresses OAuth probing). ` +
+        `Run /reload so pi-mcp-adapter re-reads mcp.json.`, "info");
+}
 const SHOW_LIMIT = 1600;
 function showDirective(ctx, label, directive, enabled) {
     if (!directive) {

package/dist/index.js.map

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

package/dist/pi.d.ts

@@ -14,6 +14,15 @@ export type BeforeAgentStartEvent = {
 export type BeforeAgentStartResult = {
     systemPrompt?: string;
 } | void;
+/** Fired after a tool finishes. We read only `toolName` (to spot crib plan mutations). */
+export type ToolExecutionEndEvent = {
+    toolName: string;
+    args?: unknown;
+    result?: unknown;
+    isError?: boolean;
+};
+/** Fired at the end of an agent turn — our natural coalescing point for re-snapshots. */
+export type TurnEndEvent = Record<string, never>;
 export type ExtensionContext = {
     cwd: string;
     mode: "tui" | "rpc" | "json" | "print";
@@ -63,8 +72,19 @@ export interface ExtensionAPI {
     on(event: "session_start", handler: (event: SessionStartEvent, ctx: ExtensionContext) => void | Promise<void>): void;
     on(event: "session_shutdown", handler: (event: SessionShutdownEvent, ctx: ExtensionContext) => void | Promise<void>): void;
     on(event: "before_agent_start", handler: (event: BeforeAgentStartEvent, ctx: ExtensionContext) => BeforeAgentStartResult | Promise<BeforeAgentStartResult>): void;
+    on(event: "tool_execution_end", handler: (event: ToolExecutionEndEvent, ctx: ExtensionContext) => void | Promise<void>): void;
+    on(event: "turn_end", handler: (event: TurnEndEvent, ctx: ExtensionContext) => void | Promise<void>): void;
     registerCommand(name: string, spec: CommandSpec): void;
     exec(command: string, args: string[], options?: ExecOptions): Promise<ExecResult>;
     sendMessage(message: SendMessage, options?: SendMessageOptions): void;
+    /** Persist a custom session entry; emits `entry_appended` (forwarded over RPC, but NOT
+     *  delivered to in-process extension `on` handlers). For RPC consumers (pi-acp). */
+    appendEntry(customType: string, data?: unknown): string;
+    /** Shared in-process pub/sub bus across all extensions (how `subagents:*` crosses
+     *  extensions). The channel for in-process consumers like pi-plan's TUI. Not RPC-forwarded. */
+    events: {
+        on(channel: string, handler: (data: unknown) => void): () => void;
+        emit(channel: string, data?: unknown): void;
+    };
 }
 //# sourceMappingURL=pi.d.ts.map

package/dist/pi.d.ts.map

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

package/dist/plan-source.d.ts

@@ -0,0 +1,67 @@
+import type { ExtensionAPI } from "./pi.js";
+/** One item in the shared plan wire format. Rich fields (`kind`, `tainted`, `deps`) are
+ *  populated by cribsheet; a simpler source may omit them. */
+export interface PlanItem {
+    /** crib's namespaced id, `<kind>:<slug>` (already the wire id scheme). */
+    id: string;
+    /** display text (the wire field is `title`). */
+    title: string;
+    /** kind passed through verbatim from crib (plan|design|note). */
+    kind: string;
+    status: string | null;
+    /** must-precede refs (this item depends on these), by node id. */
+    deps: string[];
+    tainted?: boolean;
+    ulid?: string;
+    updated?: string;
+}
+/** A full-replace snapshot on the `plan:snapshot` channel. `ns` attributes the source;
+ *  `seq` lets a consumer drop out-of-order arrivals. */
+export interface PlanSnapshot {
+    ns: "cribsheet";
+    seq: number;
+    project?: string;
+    items: PlanItem[];
+}
+interface CribNode {
+    id: string;
+    ulid?: string;
+    name?: string;
+    kind?: string;
+    status?: string | null;
+    updated?: string;
+    tainted?: boolean;
+}
+interface CribEdge {
+    from: string;
+    to: string;
+    kind: string;
+}
+interface CribGraph {
+    project?: string;
+    nodes?: CribNode[];
+    edges?: CribEdge[];
+}
+/** Map a crib `plan graph` payload into a `source=plan` snapshot. Edge `from -> to`
+ *  (kind `dep`) means `from` depends on `to`, so `to` lands in `from`'s `deps`. */
+export declare function graphToSnapshot(graph: CribGraph, seq: number): PlanSnapshot;
+export declare function isCribPlanMutation(toolName: string): boolean;
+/** How to invoke crib — mirrors index.ts's resolveCrib() shape. */
+export type CribCommand = {
+    cmd: string;
+    args: string[];
+};
+export interface PlanSourceOptions {
+    /** Resolve the crib CLI (env command → `crib` on PATH → `uv run … crib`). */
+    resolveCrib: () => CribCommand | undefined;
+    /** Pull timeout in ms (default 15000). */
+    timeoutMs?: number;
+}
+/**
+ * Wire the crib plan source into the extension: prime on `session_start`, mark dirty when
+ * a crib plan-mutation tool completes, and re-snapshot at `turn_end` if dirty. Emits via
+ * `pi.events.emit("plan:snapshot", snapshot)` on the shared in-process bus (for pi-plan's TUI).
+ */
+export declare function installCribPlanSource(pi: ExtensionAPI, opts: PlanSourceOptions): void;
+export {};
+//# sourceMappingURL=plan-source.d.ts.map

package/dist/plan-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-source.d.ts","sourceRoot":"","sources":["../src/plan-source.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAE3C;8DAC8D;AAC9D,MAAM,WAAW,QAAQ;IACrB,0EAA0E;IAC1E,EAAE,EAAE,MAAM,CAAA;IACV,gDAAgD;IAChD,KAAK,EAAE,MAAM,CAAA;IACb,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,kEAAkE;IAClE,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;wDACwD;AACxD,MAAM,WAAW,YAAY;IACzB,EAAE,EAAE,WAAW,CAAA;IACf,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,QAAQ,EAAE,CAAA;CACpB;AAGD,UAAU,QAAQ;IACd,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,OAAO,CAAA;CACpB;AACD,UAAU,QAAQ;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;CACf;AACD,UAAU,SAAS;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAA;IAClB,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAA;CACrB;AAED;mFACmF;AACnF,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,YAAY,CAqB3E;AAiBD,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAS5D;AAED,mEAAmE;AACnE,MAAM,MAAM,WAAW,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAAA;AAEzD,MAAM,WAAW,iBAAiB;IAC9B,6EAA6E;IAC7E,WAAW,EAAE,MAAM,WAAW,GAAG,SAAS,CAAA;IAC1C,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAA;CACrB;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,iBAAiB,GAAG,IAAI,CAqDrF"}

package/dist/plan-source.js

@@ -0,0 +1,132 @@
+// The crib PLAN SOURCE: surfaces cribsheet's plan graph onto pi's in-process bus as
+// `plan:snapshot` events, so a plan sidebar (pi-plan TUI, or the pi-acp ACP adapter over
+// RPC) can render it. cribsheet is one PLAN source among many; it publishes the shared
+// wire format with `ns:"cribsheet"` — only this plugin knows crib's CLI/schema.
+//
+// Snapshot-based (not delta): each emit carries the WHOLE current cribsheet plan; consumers
+// replace their `cribsheet` slice. Prime on session_start; re-snapshot after a crib plan
+// MUTATION tool completes (coalesced to turn_end). A missed trigger self-heals on the next
+// snapshot — the trigger is a cache-invalidation ping, not the data.
+//
+// CHANNEL: emits on the shared in-process `pi.events` bus (`plan:snapshot`), which is how an
+// in-process consumer (pi-plan's TUI) receives it. `appendEntry` is NOT used here: pi-acp
+// runs its own bundled extension that re-emits this bus event as an `acp:plan` custom entry
+// to cross RPC (entry_appended is forwarded over RPC, but is NOT delivered to in-process
+// extension `on` handlers).
+/** Map a crib `plan graph` payload into a `source=plan` snapshot. Edge `from -> to`
+ *  (kind `dep`) means `from` depends on `to`, so `to` lands in `from`'s `deps`. */
+export function graphToSnapshot(graph, seq) {
+    const depsByNode = new Map();
+    for (const e of graph.edges ?? []) {
+        if (!e || e.kind !== "dep" || typeof e.from !== "string" || typeof e.to !== "string")
+            continue;
+        const arr = depsByNode.get(e.from);
+        if (arr)
+            arr.push(e.to);
+        else
+            depsByNode.set(e.from, [e.to]);
+    }
+    const items = (graph.nodes ?? [])
+        .filter((n) => !!n && typeof n.id === "string")
+        .map((n) => ({
+        id: n.id,
+        title: typeof n.name === "string" ? n.name : n.id,
+        kind: typeof n.kind === "string" ? n.kind : "plan",
+        status: n.status ?? null,
+        deps: depsByNode.get(n.id) ?? [],
+        tainted: n.tainted,
+        ulid: n.ulid,
+        updated: n.updated,
+    }));
+    return { ns: "cribsheet", seq, project: graph.project, items };
+}
+// ── crib plan MUTATION tools (reads are ignored) ───────────────────
+// Tools arrive combiner/client-PREFIXED (e.g. cribsheet_plan_add, or the longer
+// mcp__…-combiner__cribsheet_plan_add), so match on the TAIL, with a separator
+// boundary so `plan_add` can't spuriously match e.g. `explain_add`.
+const CRIB_PLAN_MUTATION_VERBS = [
+    "plan_dep_remove",
+    "plan_dep_add",
+    "plan_reaffirm",
+    "plan_import",
+    "plan_status",
+    "plan_forget",
+    "plan_move",
+    "plan_add",
+];
+export function isCribPlanMutation(toolName) {
+    for (const verb of CRIB_PLAN_MUTATION_VERBS) {
+        if (toolName === verb)
+            return true;
+        if (toolName.endsWith(verb)) {
+            const boundary = toolName[toolName.length - verb.length - 1];
+            if (boundary === "_" || boundary === ":" || boundary === "/")
+                return true;
+        }
+    }
+    return false;
+}
+/**
+ * Wire the crib plan source into the extension: prime on `session_start`, mark dirty when
+ * a crib plan-mutation tool completes, and re-snapshot at `turn_end` if dirty. Emits via
+ * `pi.events.emit("plan:snapshot", snapshot)` on the shared in-process bus (for pi-plan's TUI).
+ */
+export function installCribPlanSource(pi, opts) {
+    const timeout = opts.timeoutMs ?? 15_000;
+    let seq = 0;
+    let dirty = false;
+    let lastCwd;
+    // Guard against overlapping pulls (a burst of turn_end + a slow crib).
+    let pulling = false;
+    const pull = async (cwd, signal) => {
+        if (pulling)
+            return;
+        const crib = opts.resolveCrib();
+        if (!crib)
+            return;
+        pulling = true;
+        try {
+            // Global `--json` goes BEFORE the subcommand. Run crib IN the session cwd
+            // and select the project with `-P .` — the CLI resolves it to the absolute
+            // client path, so the daemon anchors on the right project (not `default`).
+            const res = await pi.exec(crib.cmd, [...crib.args, "--json", "plan", "graph", "-P", "."], {
+                signal,
+                timeout,
+                cwd,
+            });
+            if (res.code !== 0)
+                return;
+            let graph;
+            try {
+                graph = JSON.parse(res.stdout);
+            }
+            catch {
+                return;
+            }
+            pi.events.emit("plan:snapshot", graphToSnapshot(graph, seq++));
+        }
+        catch {
+            // best effort; a dropped snapshot self-heals on the next trigger
+        }
+        finally {
+            pulling = false;
+        }
+    };
+    pi.on("session_start", (_event, ctx) => {
+        lastCwd = ctx.cwd;
+        // Prime: surface whatever plan already exists (incl. edits from before this session).
+        void pull(ctx.cwd, ctx.signal);
+    });
+    pi.on("tool_execution_end", (event) => {
+        if (isCribPlanMutation(event.toolName))
+            dirty = true;
+    });
+    // Coalesce a turn's worth of mutations into one re-snapshot after they've all landed.
+    pi.on("turn_end", (_event, ctx) => {
+        if (!dirty)
+            return;
+        dirty = false;
+        void pull(ctx.cwd ?? lastCwd ?? process.cwd(), ctx.signal);
+    });
+}
+//# sourceMappingURL=plan-source.js.map

package/dist/plan-source.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@geohar/pi-cribsheet",
-    "version": "0.10.0",
+    "version": "0.11.0",
     "description": "Pi extension: run the crib (cribsheet) memory + code-index MCP server via sharedserver, inject the reach-for-crib directive, and ship the /crib recall command. Pairs with pi-mcp-adapter.",
     "type": "module",
     "main": "dist/index.js",

package/src/index.ts

@@ -25,7 +25,8 @@
 // The sharedserver resolution is ported faithfully from plugins/opencode/src/index.ts.
 
 import { spawnSync } from "node:child_process"
-import { existsSync, readFileSync } from "node:fs"
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs"
+import { homedir } from "node:os"
 import { dirname, join } from "node:path"
 import { fileURLToPath } from "node:url"
 import type {
@@ -35,6 +36,7 @@ import type {
     ExtensionContext,
     SessionShutdownEvent,
 } from "./pi.js"
+import { installCribPlanSource } from "./plan-source.js"
 import { resolveSharedserver } from "./sharedserver-resolve.js"
 
 const DEFAULT_PORT = 7732
@@ -135,7 +137,10 @@ function detach() {
     if (!attachment) return
     const { binary, name } = attachment
     attachment = null
-    spawnSync(binary, ["unuse", name, "--pid", String(process.pid)], { stdio: "ignore", env: process.env })
+    spawnSync(binary, ["unuse", name, "--pid", String(process.pid)], {
+        stdio: "ignore",
+        env: process.env,
+    })
 }
 
 // ── the extension ──────────────────────────────────────────────────
@@ -158,7 +163,8 @@ export default function cribsheet(pi: ExtensionAPI): void {
     // ── /crib command: recall memory + code index, then steer the model ──
     if (wantCommand) {
         pi.registerCommand("crib", {
-            description: "Consult crib (recall memory + code index); verb: system-prompt shows the directive",
+            description:
+                "Consult crib (recall memory + code index); verbs: system-prompt (show the directive), install-config [path] (write mcp.json)",
             getArgumentCompletions: (prefix) => completeVerbs(prefix),
             handler: async (args, ctx) => {
                 const arg = args.trim()
@@ -166,6 +172,10 @@ export default function cribsheet(pi: ExtensionAPI): void {
                     showDirective(ctx, "cribsheet", CRIB_DIRECTIVE, wantInstructions)
                     return
                 }
+                if (arg === "install-config" || arg.startsWith("install-config ")) {
+                    installConfig(ctx, arg.slice("install-config".length).trim() || undefined)
+                    return
+                }
                 const topic = arg
                 if (!topic) {
                     ctx.ui?.notify?.("crib: give me a topic (e.g. /crib auth flow), or /crib system-prompt", "warn")
@@ -196,13 +206,23 @@ export default function cribsheet(pi: ExtensionAPI): void {
                     `Memory — semantic recall (crib note apropos):\n${memory}\n\n` +
                     `Code index — symbols by concept or name (crib code lookup):\n${code}`
                 pi.sendMessage(
-                    { customType: "crib-recall", content, display: true, details: { topic } },
+                    {
+                        customType: "crib-recall",
+                        content,
+                        display: true,
+                        details: { topic },
+                    },
                     { triggerTurn: true, deliverAs: "steer" },
                 )
             },
         })
     }
 
+    // The crib PLAN SOURCE emits `plan:snapshot` events for a plan sidebar. Independent of
+    // server management (it reads via the crib CLI over the in-process bus), so it runs
+    // whether or not this plugin launches the backend — register it before the early return.
+    installCribPlanSource(pi, { resolveCrib })
+
     // Combiner-served or manage=false: nothing to launch (crib runs elsewhere). The
     // directive + command above still apply.
     if (served || !manage) return
@@ -259,7 +279,10 @@ export default function cribsheet(pi: ExtensionAPI): void {
         useArgs.push("--", crib.cmd, ...crib.args, ...serve)
 
         installProcessCleanup()
-        const result = spawnSync(binary, useArgs, { stdio: "pipe", env: process.env })
+        const result = spawnSync(binary, useArgs, {
+            stdio: "pipe",
+            env: process.env,
+        })
         if (result.error) {
             log("error", `${name}: failed to spawn sharedserver (${result.error.message})`)
             return
@@ -284,13 +307,98 @@ export default function cribsheet(pi: ExtensionAPI): void {
 // Slash-command verbs. `system-prompt` shows the directive this extension injects — the
 // show-command pattern from pi-custom-system-prompt, since `before_agent_start`
 // injections are per-turn and never appear in Pi's own `/system-prompt` (base only).
-const COMMAND_VERBS = ["system-prompt"]
+const COMMAND_VERBS = ["system-prompt", "install-config"]
 function completeVerbs(prefix: string): AutocompleteItem[] | null {
     const p = prefix.trim()
     const matches = COMMAND_VERBS.filter((v) => v.startsWith(p))
     return matches.length ? matches.map((v) => ({ value: v, label: v })) : null
 }
 
+// ── /crib install-config: write the pi-mcp-adapter mcp.json entry ──
+// A USER-INVOKED write — merge the cribsheet entry into pi-mcp-adapter's mcp.json,
+// wired for crib's optional inbound bearer auth:
+//
+//   { "url": "…/mcp", "auth": "bearer", "bearerTokenEnv": "CRIBSHEET_AUTH_TOKEN" }
+//
+// - auth:"bearer" → the adapter attaches `Authorization: Bearer <token>` (it gates the
+//   header on `auth === "bearer"`, NOT on bearerTokenEnv alone), AND makes
+//   supportsOAuth() false so a wrong/missing token surfaces as an honest 401 rather
+//   than a Dynamic-Client-Registration 404.
+// - bearerTokenEnv → names the env var the token is read from at connect (nothing
+//   written to disk). The backend enforces only when CRIBSHEET_AUTH_TOKEN is set on ITS
+//   side; unset ⇒ open, the env var is unset here too so no header is sent. The one
+//   shape is correct whether or not auth is enabled. Ported from mcp-companion's
+//   /mcp-combiner install-config.
+
+function expandHome(p: string): string {
+    if (p === "~") return homedir()
+    if (p.startsWith("~/")) return join(homedir(), p.slice(2))
+    return p
+}
+
+/** The URL the adapter should reach cribsheet at — 127.0.0.1:<port>/mcp with the same
+ *  port defaults the backend serves on ($PI_CRIBSHEET_PORT, else 7732). */
+function defaultCribUrl(): string {
+    let port = DEFAULT_PORT
+    const raw = env("PI_CRIBSHEET_PORT")
+    if (raw !== undefined) {
+        const n = Number(raw)
+        if (Number.isInteger(n) && n > 0) port = n
+    }
+    return `http://127.0.0.1:${port}/mcp`
+}
+
+function installConfig(ctx: ExtensionCommandContext, pathArg?: string): void {
+    const target = pathArg ? expandHome(pathArg) : join(homedir(), ".config", "mcp", "mcp.json")
+    const key = DEFAULT_NAME
+
+    // Read + parse existing (tolerate absence; refuse to clobber non-JSON).
+    let doc: Record<string, unknown> = {}
+    if (existsSync(target)) {
+        try {
+            const parsed = JSON.parse(readFileSync(target, "utf8"))
+            if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+                ctx.ui?.notify?.(`cribsheet: ${target} is not a JSON object; not overwriting`, "error")
+                return
+            }
+            doc = parsed as Record<string, unknown>
+        } catch (e) {
+            ctx.ui?.notify?.(`cribsheet: ${target} is not valid JSON; not overwriting (${e})`, "error")
+            return
+        }
+    }
+
+    const servers = (doc.mcpServers ??= {}) as Record<string, Record<string, unknown>>
+    const prev = (servers[key] ?? {}) as Record<string, unknown>
+    const before = JSON.stringify(prev)
+    // Preserve any existing url and other fields; only ensure the auth-wiring keys.
+    servers[key] = {
+        ...prev,
+        url: typeof prev.url === "string" && prev.url ? prev.url : defaultCribUrl(),
+        auth: "bearer",
+        bearerTokenEnv: "CRIBSHEET_AUTH_TOKEN",
+    }
+    const existed = before !== "{}" && Object.keys(prev).length > 0
+    const changed = before !== JSON.stringify(servers[key])
+
+    try {
+        mkdirSync(dirname(target), { recursive: true })
+        writeFileSync(target, `${JSON.stringify(doc, null, 2)}\n`, "utf8")
+    } catch (e) {
+        ctx.ui?.notify?.(`cribsheet: failed to write ${target} (${e})`, "error")
+        return
+    }
+
+    const what = existed ? changed ? "updated" : "already configured" : "added"
+    ctx.ui?.notify?.(
+        `cribsheet: ${what} "${key}" in ${target}\n` +
+            `Sends "Authorization: Bearer $CRIBSHEET_AUTH_TOKEN" when that env var is set ` +
+            `(auth:"bearer" both sends the token and suppresses OAuth probing). ` +
+            `Run /reload so pi-mcp-adapter re-reads mcp.json.`,
+        "info",
+    )
+}
+
 const SHOW_LIMIT = 1600
 function showDirective(ctx: ExtensionCommandContext, label: string, directive: string, enabled: boolean): void {
     if (!directive) {

package/src/pi.ts

@@ -10,17 +10,35 @@
 export type SessionStartReason = "startup" | "reload" | "new" | "resume" | "fork"
 export type SessionShutdownReason = "quit" | "reload" | "new" | "resume" | "fork"
 
-export type SessionStartEvent = { reason: SessionStartReason; previousSessionFile?: string }
-export type SessionShutdownEvent = { reason: SessionShutdownReason; targetSessionFile?: string }
+export type SessionStartEvent = {
+    reason: SessionStartReason
+    previousSessionFile?: string
+}
+export type SessionShutdownEvent = {
+    reason: SessionShutdownReason
+    targetSessionFile?: string
+}
 export type BeforeAgentStartEvent = { systemPrompt: string }
 export type BeforeAgentStartResult = { systemPrompt?: string } | void
 
+/** Fired after a tool finishes. We read only `toolName` (to spot crib plan mutations). */
+export type ToolExecutionEndEvent = {
+    toolName: string
+    args?: unknown
+    result?: unknown
+    isError?: boolean
+}
+/** Fired at the end of an agent turn — our natural coalescing point for re-snapshots. */
+export type TurnEndEvent = Record<string, never>
+
 export type ExtensionContext = {
     cwd: string
     mode: "tui" | "rpc" | "json" | "print"
     hasUI: boolean
     signal?: AbortSignal
-    ui?: { notify?: (message: string, level?: "info" | "warn" | "error") => void }
+    ui?: {
+        notify?: (message: string, level?: "info" | "warn" | "error") => void
+    }
 }
 
 /** Context handed to a command handler. Superset of ExtensionContext in practice; we
@@ -29,8 +47,18 @@ export type ExtensionCommandContext = ExtensionContext
 
 export type AutocompleteItem = { value: string; label?: string }
 
-export type ExecResult = { stdout: string; stderr: string; code: number; killed: boolean }
-export type ExecOptions = { signal?: AbortSignal; timeout?: number; cwd?: string; env?: NodeJS.ProcessEnv }
+export type ExecResult = {
+    stdout: string
+    stderr: string
+    code: number
+    killed: boolean
+}
+export type ExecOptions = {
+    signal?: AbortSignal
+    timeout?: number
+    cwd?: string
+    env?: NodeJS.ProcessEnv
+}
 
 /** An LLM-visible message injected from a command. `display:true` shows it in the TUI;
  *  `{triggerTurn:true, deliverAs:"steer"}` makes the model act on it this turn. */
@@ -40,7 +68,10 @@ export type SendMessage = {
     display?: boolean
     details?: Record<string, unknown>
 }
-export type SendMessageOptions = { triggerTurn?: boolean; deliverAs?: "steer" | "followUp" }
+export type SendMessageOptions = {
+    triggerTurn?: boolean
+    deliverAs?: "steer" | "followUp"
+}
 
 export type CommandSpec = {
     description: string
@@ -49,10 +80,7 @@ export type CommandSpec = {
 }
 
 export interface ExtensionAPI {
-    on(
-        event: "session_start",
-        handler: (event: SessionStartEvent, ctx: ExtensionContext) => void | Promise<void>,
-    ): void
+    on(event: "session_start", handler: (event: SessionStartEvent, ctx: ExtensionContext) => void | Promise<void>): void
     on(
         event: "session_shutdown",
         handler: (event: SessionShutdownEvent, ctx: ExtensionContext) => void | Promise<void>,
@@ -64,7 +92,21 @@ export interface ExtensionAPI {
             ctx: ExtensionContext,
         ) => BeforeAgentStartResult | Promise<BeforeAgentStartResult>,
     ): void
+    on(
+        event: "tool_execution_end",
+        handler: (event: ToolExecutionEndEvent, ctx: ExtensionContext) => void | Promise<void>,
+    ): void
+    on(event: "turn_end", handler: (event: TurnEndEvent, ctx: ExtensionContext) => void | Promise<void>): void
     registerCommand(name: string, spec: CommandSpec): void
     exec(command: string, args: string[], options?: ExecOptions): Promise<ExecResult>
     sendMessage(message: SendMessage, options?: SendMessageOptions): void
+    /** Persist a custom session entry; emits `entry_appended` (forwarded over RPC, but NOT
+     *  delivered to in-process extension `on` handlers). For RPC consumers (pi-acp). */
+    appendEntry(customType: string, data?: unknown): string
+    /** Shared in-process pub/sub bus across all extensions (how `subagents:*` crosses
+     *  extensions). The channel for in-process consumers like pi-plan's TUI. Not RPC-forwarded. */
+    events: {
+        on(channel: string, handler: (data: unknown) => void): () => void
+        emit(channel: string, data?: unknown): void
+    }
 }

package/src/plan-source.ts

@@ -0,0 +1,185 @@
+// The crib PLAN SOURCE: surfaces cribsheet's plan graph onto pi's in-process bus as
+// `plan:snapshot` events, so a plan sidebar (pi-plan TUI, or the pi-acp ACP adapter over
+// RPC) can render it. cribsheet is one PLAN source among many; it publishes the shared
+// wire format with `ns:"cribsheet"` — only this plugin knows crib's CLI/schema.
+//
+// Snapshot-based (not delta): each emit carries the WHOLE current cribsheet plan; consumers
+// replace their `cribsheet` slice. Prime on session_start; re-snapshot after a crib plan
+// MUTATION tool completes (coalesced to turn_end). A missed trigger self-heals on the next
+// snapshot — the trigger is a cache-invalidation ping, not the data.
+//
+// CHANNEL: emits on the shared in-process `pi.events` bus (`plan:snapshot`), which is how an
+// in-process consumer (pi-plan's TUI) receives it. `appendEntry` is NOT used here: pi-acp
+// runs its own bundled extension that re-emits this bus event as an `acp:plan` custom entry
+// to cross RPC (entry_appended is forwarded over RPC, but is NOT delivered to in-process
+// extension `on` handlers).
+
+import type { ExtensionAPI } from "./pi.js"
+
+/** One item in the shared plan wire format. Rich fields (`kind`, `tainted`, `deps`) are
+ *  populated by cribsheet; a simpler source may omit them. */
+export interface PlanItem {
+    /** crib's namespaced id, `<kind>:<slug>` (already the wire id scheme). */
+    id: string
+    /** display text (the wire field is `title`). */
+    title: string
+    /** kind passed through verbatim from crib (plan|design|note). */
+    kind: string
+    status: string | null
+    /** must-precede refs (this item depends on these), by node id. */
+    deps: string[]
+    tainted?: boolean
+    ulid?: string
+    updated?: string
+}
+
+/** A full-replace snapshot on the `plan:snapshot` channel. `ns` attributes the source;
+ *  `seq` lets a consumer drop out-of-order arrivals. */
+export interface PlanSnapshot {
+    ns: "cribsheet"
+    seq: number
+    project?: string
+    items: PlanItem[]
+}
+
+// ── crib `plan graph --json` shapes ────────────────────────────────
+interface CribNode {
+    id: string
+    ulid?: string
+    name?: string
+    kind?: string
+    status?: string | null
+    updated?: string
+    tainted?: boolean
+}
+interface CribEdge {
+    from: string
+    to: string
+    kind: string
+}
+interface CribGraph {
+    project?: string
+    nodes?: CribNode[]
+    edges?: CribEdge[]
+}
+
+/** Map a crib `plan graph` payload into a `source=plan` snapshot. Edge `from -> to`
+ *  (kind `dep`) means `from` depends on `to`, so `to` lands in `from`'s `deps`. */
+export function graphToSnapshot(graph: CribGraph, seq: number): PlanSnapshot {
+    const depsByNode = new Map<string, string[]>()
+    for (const e of graph.edges ?? []) {
+        if (!e || e.kind !== "dep" || typeof e.from !== "string" || typeof e.to !== "string") continue
+        const arr = depsByNode.get(e.from)
+        if (arr) arr.push(e.to)
+        else depsByNode.set(e.from, [e.to])
+    }
+    const items: PlanItem[] = (graph.nodes ?? [])
+        .filter((n): n is CribNode => !!n && typeof n.id === "string")
+        .map((n) => ({
+            id: n.id,
+            title: typeof n.name === "string" ? n.name : n.id,
+            kind: typeof n.kind === "string" ? n.kind : "plan",
+            status: n.status ?? null,
+            deps: depsByNode.get(n.id) ?? [],
+            tainted: n.tainted,
+            ulid: n.ulid,
+            updated: n.updated,
+        }))
+    return { ns: "cribsheet", seq, project: graph.project, items }
+}
+
+// ── crib plan MUTATION tools (reads are ignored) ───────────────────
+// Tools arrive combiner/client-PREFIXED (e.g. cribsheet_plan_add, or the longer
+// mcp__…-combiner__cribsheet_plan_add), so match on the TAIL, with a separator
+// boundary so `plan_add` can't spuriously match e.g. `explain_add`.
+const CRIB_PLAN_MUTATION_VERBS = [
+    "plan_dep_remove",
+    "plan_dep_add",
+    "plan_reaffirm",
+    "plan_import",
+    "plan_status",
+    "plan_forget",
+    "plan_move",
+    "plan_add",
+] as const
+
+export function isCribPlanMutation(toolName: string): boolean {
+    for (const verb of CRIB_PLAN_MUTATION_VERBS) {
+        if (toolName === verb) return true
+        if (toolName.endsWith(verb)) {
+            const boundary = toolName[toolName.length - verb.length - 1]
+            if (boundary === "_" || boundary === ":" || boundary === "/") return true
+        }
+    }
+    return false
+}
+
+/** How to invoke crib — mirrors index.ts's resolveCrib() shape. */
+export type CribCommand = { cmd: string; args: string[] }
+
+export interface PlanSourceOptions {
+    /** Resolve the crib CLI (env command → `crib` on PATH → `uv run … crib`). */
+    resolveCrib: () => CribCommand | undefined
+    /** Pull timeout in ms (default 15000). */
+    timeoutMs?: number
+}
+
+/**
+ * Wire the crib plan source into the extension: prime on `session_start`, mark dirty when
+ * a crib plan-mutation tool completes, and re-snapshot at `turn_end` if dirty. Emits via
+ * `pi.events.emit("plan:snapshot", snapshot)` on the shared in-process bus (for pi-plan's TUI).
+ */
+export function installCribPlanSource(pi: ExtensionAPI, opts: PlanSourceOptions): void {
+    const timeout = opts.timeoutMs ?? 15_000
+    let seq = 0
+    let dirty = false
+    let lastCwd: string | undefined
+    // Guard against overlapping pulls (a burst of turn_end + a slow crib).
+    let pulling = false
+
+    const pull = async (cwd: string, signal?: AbortSignal): Promise<void> => {
+        if (pulling) return
+        const crib = opts.resolveCrib()
+        if (!crib) return
+        pulling = true
+        try {
+            // Global `--json` goes BEFORE the subcommand. Run crib IN the session cwd
+            // and select the project with `-P .` — the CLI resolves it to the absolute
+            // client path, so the daemon anchors on the right project (not `default`).
+            const res = await pi.exec(crib.cmd, [...crib.args, "--json", "plan", "graph", "-P", "."], {
+                signal,
+                timeout,
+                cwd,
+            })
+            if (res.code !== 0) return
+            let graph: CribGraph
+            try {
+                graph = JSON.parse(res.stdout) as CribGraph
+            } catch {
+                return
+            }
+            pi.events.emit("plan:snapshot", graphToSnapshot(graph, seq++))
+        } catch {
+            // best effort; a dropped snapshot self-heals on the next trigger
+        } finally {
+            pulling = false
+        }
+    }
+
+    pi.on("session_start", (_event, ctx) => {
+        lastCwd = ctx.cwd
+        // Prime: surface whatever plan already exists (incl. edits from before this session).
+        void pull(ctx.cwd, ctx.signal)
+    })
+
+    pi.on("tool_execution_end", (event) => {
+        if (isCribPlanMutation(event.toolName)) dirty = true
+    })
+
+    // Coalesce a turn's worth of mutations into one re-snapshot after they've all landed.
+    pi.on("turn_end", (_event, ctx) => {
+        if (!dirty) return
+        dirty = false
+        void pull(ctx.cwd ?? lastCwd ?? process.cwd(), ctx.signal)
+    })
+}