opensquid 0.5.395

package/dist/mcp/chat_bridge_subscriber.js

@@ -0,0 +1,227 @@
+/**
+ * chat-bridge subscriber — TPS.6 patch 3 (v0.5.127).
+ *
+ * Long-lived UDS connection from the MCP-bridge subprocess to the
+ * chat-daemon. Subscribes once on startup; thereafter, daemon-side
+ * `inbound_message` notifications populate a per-process LRU buffer
+ * that the `chat_poll_inbox` tool drains. The filesystem JSONL inbox
+ * remains the durable record + the cold-start catch-up path; the
+ * buffer is the hot-path cache that avoids per-poll fs reads.
+ *
+ * Wire shape (per `src/channels/daemon/protocol.ts`):
+ *   → {"jsonrpc":"2.0","id":1,"method":"subscribe","params":{...}}
+ *   ← {"jsonrpc":"2.0","id":1,"result":{"ok":true}}
+ *   ← {"jsonrpc":"2.0","method":"inbound_message","params":{...}}  (push, no id)
+ *   ← {"jsonrpc":"2.0","method":"daemon_shutdown","params":{...}}  (push)
+ *
+ * Reconnect: exponential backoff 1s → 60s cap. Triggered on socket
+ * 'close' / 'error' / refused-connect. On `daemon_shutdown` we
+ * lengthen the first delay to 5s (the daemon is restarting, not just
+ * a transient disconnect) to avoid hammering. session_id is stable
+ * across reconnects so the daemon can re-attach the slot.
+ *
+ * Buffer: LRU cap 1000 messages, 24h TTL. Past either bound, entries
+ * are silently evicted — `chat_poll_inbox` falls back to fs.readFile
+ * for the JSONL replay path.
+ *
+ * Why a separate module from `chat-bridge-server.ts`: the subscriber
+ * has its own lifecycle (connect / reconnect / timer) that's
+ * orthogonal to the MCP request/response surface. Keeping it
+ * isolated also lets `chat-bridge-server.test.ts` mock the subscriber
+ * cleanly via DI.
+ *
+ * No exported singleton — `main()` in chat-bridge-server.ts owns the
+ * single instance and passes it to handlers via closure. Tests
+ * construct their own.
+ */
+import { randomUUID } from 'node:crypto';
+import { connect } from 'node:net';
+import { LRUCache } from 'lru-cache';
+export const RECONNECT_BASE_MS = 1000;
+export const RECONNECT_MAX_MS = 60_000;
+export const SHUTDOWN_BACKOFF_MS = 5000;
+// ---------------------------------------------------------------------------
+// ChatBridgeSubscriber — the long-lived UDS client.
+// ---------------------------------------------------------------------------
+export class ChatBridgeSubscriber {
+    opts;
+    socket = null;
+    buf = '';
+    reconnectMs = RECONNECT_BASE_MS;
+    closed = false;
+    subscribeId = 0;
+    buffer;
+    setTimeoutFn;
+    connectFn;
+    constructor(opts) {
+        this.opts = opts;
+        this.buffer = new LRUCache({
+            max: opts.bufferMax ?? 1000,
+            ttl: opts.bufferTtlMs ?? 1000 * 60 * 60 * 24,
+        });
+        this.setTimeoutFn = opts.setTimeoutFn ?? ((cb, ms) => setTimeout(cb, ms));
+        this.connectFn = opts.connectFn ?? ((path) => connect(path));
+    }
+    /** Open the socket + send subscribe. Subsequent reconnects happen automatically. */
+    start() {
+        this.connectAndSubscribe();
+    }
+    /** Stop reconnecting + close the socket. Buffer is preserved for late polls. */
+    stop() {
+        this.closed = true;
+        if (this.socket) {
+            try {
+                this.socket.end();
+            }
+            catch {
+                /* already closed */
+            }
+            this.socket = null;
+        }
+    }
+    /**
+     * Return all buffered messages with `enqueued_at` (== received_at)
+     * strictly greater than `since` (or every buffered message if
+     * since is omitted). Ordering: ascending by received_at. Caller
+     * applies a per-call limit.
+     */
+    drainBuffer(since) {
+        const out = [];
+        for (const msg of this.buffer.values()) {
+            if (since && msg.received_at <= since)
+                continue;
+            out.push(msg);
+        }
+        out.sort((a, b) => a.received_at.localeCompare(b.received_at));
+        return out;
+    }
+    /** Diagnostic — current buffer size (test use). */
+    bufferSize() {
+        return this.buffer.size;
+    }
+    /** Diagnostic — true iff the socket is currently writable. */
+    isConnected() {
+        return this.socket !== null && !this.socket.destroyed;
+    }
+    // -----------------------------------------------------------------
+    // Internals
+    // -----------------------------------------------------------------
+    connectAndSubscribe() {
+        if (this.closed)
+            return;
+        let sock;
+        try {
+            sock = this.connectFn(this.opts.socketPath);
+        }
+        catch (err) {
+            this.scheduleReconnect(`connect threw: ${err instanceof Error ? err.message : String(err)}`);
+            return;
+        }
+        this.socket = sock;
+        this.buf = '';
+        sock.setEncoding('utf8');
+        sock.once('connect', () => this.sendSubscribe());
+        sock.on('data', (chunk) => this.onData(chunk));
+        sock.once('error', (err) => {
+            process.stderr.write(`[chat-bridge subscriber] socket error: ${err.message}\n`);
+        });
+        sock.once('close', () => {
+            this.socket = null;
+            this.scheduleReconnect('socket closed');
+        });
+    }
+    sendSubscribe() {
+        if (!this.socket)
+            return;
+        const id = `sub-${String(++this.subscribeId)}`;
+        const req = {
+            jsonrpc: '2.0',
+            id,
+            method: 'subscribe',
+            params: {
+                session_id: this.opts.sessionId,
+                workspace_uuid: this.opts.workspaceUuid,
+                workspace_path: this.opts.workspacePath,
+                chat_ids: this.opts.chatIds,
+            },
+        };
+        try {
+            this.socket.write(JSON.stringify(req) + '\n');
+            // Successful connection — reset backoff.
+            this.reconnectMs = RECONNECT_BASE_MS;
+        }
+        catch (err) {
+            process.stderr.write(`[chat-bridge subscriber] subscribe write failed: ${err instanceof Error ? err.message : String(err)}\n`);
+        }
+    }
+    onData(chunk) {
+        this.buf += typeof chunk === 'string' ? chunk : chunk.toString('utf8');
+        let nl;
+        while ((nl = this.buf.indexOf('\n')) >= 0) {
+            const line = this.buf.slice(0, nl);
+            this.buf = this.buf.slice(nl + 1);
+            if (line.length === 0)
+                continue;
+            this.dispatchLine(line);
+        }
+    }
+    dispatchLine(line) {
+        let parsed;
+        try {
+            parsed = JSON.parse(line);
+        }
+        catch {
+            process.stderr.write(`[chat-bridge subscriber] malformed JSON: ${line.slice(0, 200)}\n`);
+            return;
+        }
+        if (typeof parsed !== 'object' || parsed === null)
+            return;
+        const frame = parsed;
+        if (frame.method === 'inbound_message' && frame.params) {
+            const msg = frame.params;
+            if (typeof msg.delivery_id === 'string' && typeof msg.text === 'string') {
+                // LRU.set is naturally idempotent on delivery_id — re-pushed
+                // notifications during reconnect races overwrite the same slot.
+                this.buffer.set(msg.delivery_id, msg);
+            }
+            return;
+        }
+        if (frame.method === 'daemon_shutdown') {
+            process.stderr.write('[chat-bridge subscriber] daemon shutdown received; backing off\n');
+            // Lengthen the next reconnect delay so we don't hammer the
+            // restart. The 'close' event that follows will fire
+            // scheduleReconnect, which reads this.reconnectMs.
+            this.reconnectMs = Math.max(this.reconnectMs, SHUTDOWN_BACKOFF_MS);
+            return;
+        }
+        if (frame.result && typeof frame.result === 'object') {
+            // Subscribe ack — surface auto-boot bind for operator visibility
+            // when the daemon (TPS.6 patch 4) resolved-or-created a topic
+            // for this workspace. Successful write already reset backoff.
+            const result = frame.result;
+            if (result.ok && result.bound_topic_id !== undefined && result.bound_topic_name) {
+                process.stderr.write(`[chat-bridge subscriber] auto-bound to "${result.bound_topic_name}" (thread_id=${String(result.bound_topic_id)})\n`);
+            }
+        }
+    }
+    scheduleReconnect(reason) {
+        if (this.closed)
+            return;
+        const delay = this.reconnectMs;
+        process.stderr.write(`[chat-bridge subscriber] reconnecting in ${String(delay)}ms (${reason})\n`);
+        this.setTimeoutFn(() => this.connectAndSubscribe(), delay);
+        this.reconnectMs = Math.min(this.reconnectMs * 2, RECONNECT_MAX_MS);
+    }
+}
+// ---------------------------------------------------------------------------
+// Helper — generate a fresh session_id when the host environment doesn't
+// provide one. The id is stable per MCP-bridge process so the daemon
+// can re-attach on reconnect.
+// ---------------------------------------------------------------------------
+export function generateSessionId() {
+    const env = process.env.OPENSQUID_SESSION_ID;
+    if (env && env.length > 0)
+        return env;
+    return `mcp-${randomUUID()}`;
+}
+//# sourceMappingURL=chat_bridge_subscriber.js.map

package/dist/mcp/chat_bridge_subscriber.js.map

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

package/dist/mcp/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * MCP: server entrypoint and tool registration that exposes the runtime to
+ * Claude Code and other MCP hosts.
+ *
+ * The actual server lives in `server.ts` (wired as the `opensquid-mcp` bin
+ * in package.json). Tool handlers live under `tools/`. This re-export gives
+ * downstream importers a stable public surface — they get the handler types
+ * without depending on the server's stdio plumbing.
+ *
+ * Imports from: anything in src/ (top of the dependency tree alongside setup/).
+ * Imported by: nothing in src/.
+ */
+export { handleInspectSkill } from './tools/inspect-skill.js';
+export type { InspectSkillArgs } from './tools/inspect-skill.js';
+export { handleListPacks } from './tools/list-packs.js';
+export { handleListSkills } from './tools/list-skills.js';
+export type { ListSkillsArgs } from './tools/list-skills.js';
+export { handleReadState } from './tools/read-state.js';
+export type { ReadStateArgs } from './tools/read-state.js';
+export { handleReadViolations } from './tools/read-violations.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,YAAY,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,YAAY,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,YAAY,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/mcp/index.js

@@ -0,0 +1,18 @@
+/**
+ * MCP: server entrypoint and tool registration that exposes the runtime to
+ * Claude Code and other MCP hosts.
+ *
+ * The actual server lives in `server.ts` (wired as the `opensquid-mcp` bin
+ * in package.json). Tool handlers live under `tools/`. This re-export gives
+ * downstream importers a stable public surface — they get the handler types
+ * without depending on the server's stdio plumbing.
+ *
+ * Imports from: anything in src/ (top of the dependency tree alongside setup/).
+ * Imported by: nothing in src/.
+ */
+export { handleInspectSkill } from './tools/inspect-skill.js';
+export { handleListPacks } from './tools/list-packs.js';
+export { handleListSkills } from './tools/list-skills.js';
+export { handleReadState } from './tools/read-state.js';
+export { handleReadViolations } from './tools/read-violations.js';
+//# sourceMappingURL=index.js.map

package/dist/mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE9D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/mcp/server.d.ts

@@ -0,0 +1,39 @@
+#!/usr/bin/env node
+/**
+ * `opensquid-mcp` — MCP server entrypoint over stdio.
+ *
+ * Exposes the Phase-1 read-only tool set plus G.3's write surface:
+ *
+ *   list_packs         — currently active packs
+ *   list_skills        — skills (optionally scoped to a pack)
+ *   inspect_skill      — rules + load conditions + drift policy for one skill
+ *   read_state         — read a session state key (functions/state.ts companion)
+ *   read_violations    — return session violations.jsonl contents
+ *   list_drift_events  — aggregated drift catalog across packs + session (Task 5.4)
+ *   recall             — search the configured RAG backend for memory hits (Task T.5)
+ *   memorize           — persist a memory (G.3) — direct engine.memory.create
+ *   store_lesson       — capture a Stage-1 wedge-gate candidate (G.3)
+ *   forget             — delete a memory; user-immune by default (G.3)
+ *
+ * G.3 introduces the first three WRITE tools as an explicit architectural
+ * exception to the T.1.H read-only invariant — see each handler's header for
+ * per-tool justification. `lesson.promote` (Stage 2) is intentionally NOT
+ * exposed, so the wedge-gate outcome-validation moat cannot be bypassed by
+ * an external MCP client.
+ *
+ * Transport: stdio (StdioServerTransport). stdout is reserved for the
+ * JSON-RPC stream — NO `console.log` anywhere in this binary or any module
+ * it imports through this code path. Diagnostics must go to `process.stderr`
+ * exclusively. The `main().catch` at the bottom writes to stderr and exits
+ * non-zero so an unexpected crash is observable, not silent.
+ *
+ * Args are Zod-parsed BEFORE being handed to a tool handler. A bad-args
+ * `CallToolRequest` throws on the protocol level (which the MCP SDK turns
+ * into a JSON-RPC error response) rather than running with garbage input.
+ *
+ * Imports from: @modelcontextprotocol/sdk + mcp/tools/*.
+ * Imported by: nothing in src/. Wired as the `opensquid-mcp` bin in
+ * package.json.
+ */
+export {};
+//# sourceMappingURL=server.d.ts.map

package/dist/mcp/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG"}

package/dist/mcp/server.js

@@ -0,0 +1,298 @@
+#!/usr/bin/env node
+/**
+ * `opensquid-mcp` — MCP server entrypoint over stdio.
+ *
+ * Exposes the Phase-1 read-only tool set plus G.3's write surface:
+ *
+ *   list_packs         — currently active packs
+ *   list_skills        — skills (optionally scoped to a pack)
+ *   inspect_skill      — rules + load conditions + drift policy for one skill
+ *   read_state         — read a session state key (functions/state.ts companion)
+ *   read_violations    — return session violations.jsonl contents
+ *   list_drift_events  — aggregated drift catalog across packs + session (Task 5.4)
+ *   recall             — search the configured RAG backend for memory hits (Task T.5)
+ *   memorize           — persist a memory (G.3) — direct engine.memory.create
+ *   store_lesson       — capture a Stage-1 wedge-gate candidate (G.3)
+ *   forget             — delete a memory; user-immune by default (G.3)
+ *
+ * G.3 introduces the first three WRITE tools as an explicit architectural
+ * exception to the T.1.H read-only invariant — see each handler's header for
+ * per-tool justification. `lesson.promote` (Stage 2) is intentionally NOT
+ * exposed, so the wedge-gate outcome-validation moat cannot be bypassed by
+ * an external MCP client.
+ *
+ * Transport: stdio (StdioServerTransport). stdout is reserved for the
+ * JSON-RPC stream — NO `console.log` anywhere in this binary or any module
+ * it imports through this code path. Diagnostics must go to `process.stderr`
+ * exclusively. The `main().catch` at the bottom writes to stderr and exits
+ * non-zero so an unexpected crash is observable, not silent.
+ *
+ * Args are Zod-parsed BEFORE being handed to a tool handler. A bad-args
+ * `CallToolRequest` throws on the protocol level (which the MCP SDK turns
+ * into a JSON-RPC error response) rather than running with garbage input.
+ *
+ * Imports from: @modelcontextprotocol/sdk + mcp/tools/*.
+ * Imported by: nothing in src/. Wired as the `opensquid-mcp` bin in
+ * package.json.
+ */
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+import { z } from 'zod';
+import { zodToJsonSchema } from 'zod-to-json-schema';
+import { wedgeLessonStore } from '../rag/wedge/store.js';
+import { wedgeLessonsDbUrl, wedgeLessonsDir } from '../rag/wedge/paths.js';
+import { createBackend } from '../rag/backend_factory.js';
+import { resolveBackendConfig } from '../rag/config.js';
+import { OPENSQUID_HOME } from '../runtime/paths.js';
+import { workGraphStore } from '../workgraph/store.js';
+import { anchorProcessToProjectDir } from './anchor.js';
+import { handleForget, ForgetSchema } from './tools/forget.js';
+import { handleInspectSkill } from './tools/inspect-skill.js';
+import { handleListDriftEvents } from './tools/list-drift-events.js';
+import { handleListPacks } from './tools/list-packs.js';
+import { handleListSkills } from './tools/list-skills.js';
+import { handleLogPhase, LogPhaseSchema } from './tools/log_phase.js';
+import { handleMemorize, MemorizeSchema } from './tools/memorize.js';
+import { handleReadState } from './tools/read-state.js';
+import { handleReadViolations } from './tools/read-violations.js';
+import { handleRecall } from './tools/recall.js';
+import { handleStoreLesson, StoreLessonSchema, } from './tools/store-lesson.js';
+import { WgAddEdgeSchema, WgCreateSchema, WgIdSchema, WgListSchema, WgReadySchema, WgUpdateSchema, handleWgAddEdge, handleWgCreate, handleWgEvents, handleWgGet, handleWgList, handleWgReady, handleWgUpdate, } from './tools/workgraph.js';
+/**
+ * Lazy wedge lesson-store singleton (retire-Rust RES-3c — store_lesson no longer
+ * touches the Rust engine). Constructed + `init()`ed once per MCP-server process;
+ * the cached promise amortizes the schema setup across calls.
+ */
+let wedgeStoreReady = null;
+function wedgeStore() {
+    if (!wedgeStoreReady) {
+        const s = wedgeLessonStore({ dbUrl: wedgeLessonsDbUrl(), sourceDir: wedgeLessonsDir() });
+        wedgeStoreReady = s.init().then(() => s);
+    }
+    return wedgeStoreReady;
+}
+/**
+ * Build + init the configured RAG backend for a memory write/delete (retire-Rust write-path
+ * cutover). Mirrors recall.ts's seam: engine-present users hit the engine, no-engine users hit
+ * libSQL, via resolveBackendConfig. Per-call (cheap — the engine connection is the T.4 singleton;
+ * libSQL opens a local handle).
+ */
+async function ragBackend() {
+    const backend = createBackend(await resolveBackendConfig());
+    await backend.init();
+    return backend;
+}
+/**
+ * Lazy work-graph store singleton (T-WORKGRAPH-MCP). Promise-memoized so concurrent first-calls
+ * await a single `init()` (one schema creation). Dedicated `~/.opensquid/workgraph.db` + per-op
+ * git source under `store/issues`.
+ */
+let workGraphPromise = null;
+function getWorkGraph() {
+    workGraphPromise ??= (async () => {
+        const store = workGraphStore({
+            dbUrl: `file:${join(OPENSQUID_HOME(), 'workgraph.db')}`,
+            sourceDir: join(OPENSQUID_HOME(), 'store', 'issues'),
+        });
+        await store.init();
+        return store;
+    })();
+    return workGraphPromise;
+}
+// Each entry binds an args Zod schema to a handler that already accepts the
+// inferred shape. `safeParse` runs against `req.params.arguments` before the
+// handler ever sees the request — invalid input becomes a thrown Error which
+// the SDK translates into a JSON-RPC error response.
+const ToolHandlers = {
+    list_packs: {
+        schema: z.object({}),
+        handle: () => handleListPacks(),
+    },
+    list_skills: {
+        schema: z.object({ pack: z.string().optional() }),
+        handle: (args) => handleListSkills(args),
+    },
+    inspect_skill: {
+        schema: z.object({ pack: z.string(), skill: z.string() }),
+        handle: (args) => handleInspectSkill(args),
+    },
+    read_state: {
+        schema: z.object({ key: z.string() }),
+        handle: (args) => handleReadState(args),
+    },
+    read_violations: {
+        schema: z.object({}),
+        handle: () => handleReadViolations(),
+    },
+    list_drift_events: {
+        schema: z.object({ packs: z.array(z.string()).optional() }),
+        handle: (args) => handleListDriftEvents(args),
+    },
+    recall: {
+        schema: z.object({
+            query: z.string().min(1),
+            k: z.number().int().min(1).max(50).optional(),
+        }),
+        handle: (args) => handleRecall(args),
+    },
+    memorize: {
+        schema: MemorizeSchema,
+        handle: async (args) => JSON.stringify(await handleMemorize(args, await ragBackend())),
+    },
+    store_lesson: {
+        schema: StoreLessonSchema,
+        handle: async (args) => JSON.stringify(await handleStoreLesson(args, await wedgeStore())),
+    },
+    forget: {
+        schema: ForgetSchema,
+        handle: async (args) => JSON.stringify(await handleForget(args, await ragBackend())),
+    },
+    log_phase: {
+        schema: LogPhaseSchema,
+        handle: (args) => handleLogPhase(args).then((r) => JSON.stringify(r)),
+    },
+    workgraph_create_issue: {
+        schema: WgCreateSchema,
+        handle: async (a) => handleWgCreate(a, await getWorkGraph()),
+    },
+    workgraph_update_issue: {
+        schema: WgUpdateSchema,
+        handle: async (a) => handleWgUpdate(a, await getWorkGraph()),
+    },
+    workgraph_add_edge: {
+        schema: WgAddEdgeSchema,
+        handle: async (a) => handleWgAddEdge(a, await getWorkGraph()),
+    },
+    workgraph_ready: {
+        schema: WgReadySchema,
+        handle: async (a) => handleWgReady(a, await getWorkGraph()),
+    },
+    workgraph_get: {
+        schema: WgIdSchema,
+        handle: async (a) => handleWgGet(a, await getWorkGraph()),
+    },
+    workgraph_list: {
+        schema: WgListSchema,
+        handle: async (a) => handleWgList(a, await getWorkGraph()),
+    },
+    workgraph_events: {
+        schema: WgIdSchema,
+        handle: async (a) => handleWgEvents(a, await getWorkGraph()),
+    },
+};
+// T-MCP-TOOL-ANNOTATIONS: honest MCP behavior hints, emitted in tools/list so
+// annotation-aware hosts (codex's requires_mcp_tool_approval is the verified
+// consumer) can auto-approve reads and local additive writes while keeping
+// destructive tools prompted. CLIENT policy input only — never server-side
+// security; the moat stays in the handlers. Lock-step with `ToolHandlers`
+// (compile-enforced by Record over ToolName). NO idempotentHint anywhere:
+// the work-graph mutations append an op per call (store.ts:111-143), so
+// "repeated call has no additional effect" would be dishonest.
+const READ_ONLY = { readOnlyHint: true, openWorldHint: false };
+const LOCAL_WRITE = {
+    readOnlyHint: false,
+    destructiveHint: false,
+    openWorldHint: false,
+};
+const toolAnnotations = {
+    list_packs: READ_ONLY,
+    list_skills: READ_ONLY,
+    inspect_skill: READ_ONLY,
+    read_state: READ_ONLY,
+    read_violations: READ_ONLY,
+    list_drift_events: READ_ONLY,
+    recall: READ_ONLY,
+    workgraph_ready: READ_ONLY,
+    workgraph_get: READ_ONLY,
+    workgraph_list: READ_ONLY,
+    workgraph_events: READ_ONLY,
+    memorize: LOCAL_WRITE,
+    store_lesson: LOCAL_WRITE,
+    log_phase: LOCAL_WRITE,
+    workgraph_create_issue: LOCAL_WRITE,
+    workgraph_update_issue: LOCAL_WRITE,
+    workgraph_add_edge: LOCAL_WRITE,
+    // The one genuinely destructive tool: deletes a memory (tools/forget.ts).
+    forget: { readOnlyHint: false, destructiveHint: true, openWorldHint: false },
+};
+// Centralized so the description copy lives next to (not threaded through)
+// the handler map. Keys must stay in lock-step with `ToolHandlers`.
+const descriptions = {
+    list_packs: 'List loaded packs',
+    list_skills: 'List skills (optionally scoped to a pack)',
+    inspect_skill: 'Show rules, load conditions, drift policy of a skill',
+    read_state: 'Read a session state key',
+    read_violations: 'Read the session violations.jsonl',
+    list_drift_events: 'List drift events aggregated across packs + session',
+    recall: 'Find memories relevant to a query. Returns up to k ranked results.',
+    memorize: 'Persist a memory. authored_by="user" (default) makes it eviction-immune. Scope defaults to user.',
+    store_lesson: 'Capture a candidate lesson for Stage 1 (user validates classification). ' +
+        'Use this for in-session corrections; do NOT call promote_lesson — automation handles Stage 2.',
+    forget: 'Delete a memory by id. User-authored memories require force: true (eviction immunity).',
+    log_phase: 'Log a completed workflow phase (pre_research|learn|code|test|audit|post_research|fix) ' +
+        'for the active task. Writes the engine ledger + the gate state; the commit gate unblocks once all 7 are logged.',
+    workgraph_create_issue: 'Create a work-graph issue {title, body?}. Returns the issue (with its hash id). The work-graph is the agent’s structured, dependency-aware task store.',
+    workgraph_update_issue: 'Update a work-graph issue {id, status?(open|in_progress|closed), title?, body?}. Returns the updated issue.',
+    workgraph_add_edge: 'Add a dependency edge {from, to, type(blocks|parent-child|discovered-from|related)} between two issues (re-typing the same pair updates the type).',
+    workgraph_ready: 'List READY issues: open issues with no un-closed `blocks` blocker, oldest-first — the work to do next.',
+    workgraph_get: 'Get one work-graph issue by id (or null).',
+    workgraph_list: 'List work-graph issues, optionally filtered by status {status?}.',
+    workgraph_events: 'List the append-only op-log (history) for an issue by id.',
+};
+/**
+ * Read the published package version at runtime. T.1.H fix: the prior
+ * hardcoded `'0.5.9'` drifted ~100 patch bumps behind reality. Resolve
+ * `package.json` relative to this module's URL so the lookup works in
+ * both `dist/mcp/server.js` (built) and `src/mcp/server.ts` (vitest)
+ * layouts — package.json sits at the package root, two levels up.
+ */
+function readPackageVersion() {
+    try {
+        // This file lives at <root>/{dist,src}/mcp/server.{js,ts}; package.json
+        // sits at <root>/package.json — two levels up regardless of layout.
+        const pkgJsonPath = new URL('../../package.json', import.meta.url);
+        const raw = readFileSync(pkgJsonPath, 'utf8');
+        const parsed = JSON.parse(raw);
+        return parsed.version ?? '0.0.0';
+    }
+    catch {
+        return '0.0.0';
+    }
+}
+async function main() {
+    anchorProcessToProjectDir();
+    const server = new Server({ name: 'opensquid', version: readPackageVersion() }, { capabilities: { tools: {} } });
+    server.setRequestHandler(ListToolsRequestSchema, () => Promise.resolve({
+        tools: Object.keys(ToolHandlers).map((name) => ({
+            name,
+            description: descriptions[name],
+            annotations: toolAnnotations[name],
+            inputSchema: zodToJsonSchema(ToolHandlers[name].schema),
+        })),
+    }));
+    server.setRequestHandler(CallToolRequestSchema, async (req) => {
+        const name = req.params.name;
+        const handler = ToolHandlers[name];
+        if (!handler)
+            throw new Error(`Unknown tool: ${String(req.params.name)}`);
+        const parsed = handler.schema.safeParse(req.params.arguments ?? {});
+        if (!parsed.success) {
+            throw new Error(`Invalid args for ${name}: ${parsed.error.message}`);
+        }
+        // The cast lands at the call-site because each branch of `ToolHandlers`
+        // carries its own arg shape; the discriminated lookup is statically safe
+        // but TS cannot prove that across the union.
+        const text = await handler.handle(parsed.data);
+        return { content: [{ type: 'text', text }] };
+    });
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((e) => {
+    process.stderr.write(`opensquid-mcp crash: ${String(e)}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

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