twining-mcp 1.3.0

package/dist/index.js

@@ -0,0 +1,32 @@
+#!/usr/bin/env node
+/**
+ * Twining MCP Server entry point.
+ * Connects via stdio transport — never use console.log (corrupts JSON-RPC).
+ */
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createServer } from "./server.js";
+import { startDashboard, setupDashboardShutdown } from "./dashboard/http-server.js";
+async function main() {
+    // Parse --project argument, default to cwd
+    let projectRoot = process.cwd();
+    const projectArgIndex = process.argv.indexOf("--project");
+    if (projectArgIndex !== -1 && process.argv[projectArgIndex + 1]) {
+        projectRoot = process.argv[projectArgIndex + 1];
+    }
+    const server = createServer(projectRoot);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // Start dashboard HTTP server (fire-and-forget — never blocks MCP)
+    startDashboard(projectRoot).then((result) => {
+        if (result) {
+            setupDashboardShutdown(result.server);
+        }
+    }).catch((err) => {
+        console.error("[twining] Dashboard failed to start (non-fatal):", err.message);
+    });
+}
+main().catch((err) => {
+    console.error("Fatal:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;GAGG;AACH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAEpF,KAAK,UAAU,IAAI;IACjB,2CAA2C;IAC3C,IAAI,WAAW,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAChC,MAAM,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAC1D,IAAI,eAAe,KAAK,CAAC,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,eAAe,GAAG,CAAC,CAAC,EAAE,CAAC;QAChE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,eAAe,GAAG,CAAC,CAAE,CAAC;IACnD,CAAC;IAED,MAAM,MAAM,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC;IACzC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,mEAAmE;IACnE,cAAc,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;QAC1C,IAAI,MAAM,EAAE,CAAC;YACX,sBAAsB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACxC,CAAC;IACH,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;QACf,OAAO,CAAC,KAAK,CAAC,kDAAkD,EAAG,GAAa,CAAC,OAAO,CAAC,CAAC;IAC5F,CAAC,CAAC,CAAC;AACL,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAC7B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,7 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Create and configure the Twining MCP server.
+ * Auto-creates .twining/ directory on first use.
+ */
+export declare function createServer(projectRoot: string): McpServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA8BpE;;;GAGG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CA+F3D"}

package/dist/server.js

@@ -0,0 +1,82 @@
+/**
+ * MCP server creation with all tool registrations.
+ * Creates stores, engines, and registers all tools.
+ * Phase 3: Adds knowledge graph layer and lifecycle management.
+ */
+import { createRequire } from "node:module";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { ensureInitialized } from "./storage/init.js";
+const require = createRequire(import.meta.url);
+const { version: PKG_VERSION } = require("../package.json");
+import { loadConfig } from "./config.js";
+import { BlackboardStore } from "./storage/blackboard-store.js";
+import { DecisionStore } from "./storage/decision-store.js";
+import { GraphStore } from "./storage/graph-store.js";
+import { BlackboardEngine } from "./engine/blackboard.js";
+import { DecisionEngine } from "./engine/decisions.js";
+import { GraphEngine } from "./engine/graph.js";
+import { Archiver } from "./engine/archiver.js";
+import { ContextAssembler } from "./engine/context-assembler.js";
+import { PlanningBridge } from "./engine/planning-bridge.js";
+import { Embedder } from "./embeddings/embedder.js";
+import { IndexManager } from "./embeddings/index-manager.js";
+import { SearchEngine } from "./embeddings/search.js";
+import { registerBlackboardTools } from "./tools/blackboard-tools.js";
+import { registerDecisionTools } from "./tools/decision-tools.js";
+import { registerContextTools } from "./tools/context-tools.js";
+import { registerLifecycleTools } from "./tools/lifecycle-tools.js";
+import { registerGraphTools } from "./tools/graph-tools.js";
+import { Exporter } from "./engine/exporter.js";
+import { registerExportTools } from "./tools/export-tools.js";
+import { AgentStore } from "./storage/agent-store.js";
+import { HandoffStore } from "./storage/handoff-store.js";
+import { CoordinationEngine } from "./engine/coordination.js";
+import { registerCoordinationTools } from "./tools/coordination-tools.js";
+/**
+ * Create and configure the Twining MCP server.
+ * Auto-creates .twining/ directory on first use.
+ */
+export function createServer(projectRoot) {
+    // Ensure .twining/ directory exists
+    const twiningDir = ensureInitialized(projectRoot);
+    // Load config
+    const config = loadConfig(twiningDir);
+    // Create stores
+    const blackboardStore = new BlackboardStore(twiningDir);
+    const decisionStore = new DecisionStore(twiningDir);
+    const graphStore = new GraphStore(twiningDir);
+    // Create embedding layer (lazy-loaded — no ONNX init cost at startup)
+    const embedder = new Embedder(twiningDir);
+    const indexManager = new IndexManager(twiningDir);
+    const searchEngine = new SearchEngine(embedder, indexManager);
+    // Create engines (with embedding support)
+    const blackboardEngine = new BlackboardEngine(blackboardStore, embedder, indexManager, searchEngine);
+    const graphEngine = new GraphEngine(graphStore);
+    const decisionEngine = new DecisionEngine(decisionStore, blackboardEngine, embedder, indexManager, projectRoot, searchEngine, graphEngine);
+    const archiver = new Archiver(twiningDir, blackboardStore, blackboardEngine, indexManager);
+    const planningBridge = new PlanningBridge(projectRoot);
+    // Create coordination stores (before ContextAssembler which depends on them)
+    const agentStore = new AgentStore(twiningDir);
+    const handoffStore = new HandoffStore(twiningDir);
+    const contextAssembler = new ContextAssembler(blackboardStore, decisionStore, searchEngine, config, graphEngine, planningBridge, handoffStore, // for recent handoffs in assembly
+    agentStore);
+    // Create coordination engine
+    const coordinationEngine = new CoordinationEngine(agentStore, handoffStore, blackboardEngine, decisionStore, blackboardStore, config);
+    // Create exporter
+    const exporter = new Exporter(blackboardStore, decisionStore, graphStore);
+    // Create MCP server
+    const server = new McpServer({
+        name: "twining-mcp",
+        version: PKG_VERSION,
+    });
+    // Register all tools
+    registerBlackboardTools(server, blackboardEngine);
+    registerDecisionTools(server, decisionEngine);
+    registerContextTools(server, contextAssembler);
+    registerLifecycleTools(server, twiningDir, blackboardStore, decisionStore, graphStore, archiver, config, agentStore);
+    registerGraphTools(server, graphEngine);
+    registerExportTools(server, exporter);
+    registerCoordinationTools(server, agentStore, coordinationEngine, config);
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/storage/agent-store.d.ts

@@ -0,0 +1,36 @@
+import type { AgentRecord } from "../utils/types.js";
+export declare class AgentStore {
+    private readonly registryPath;
+    private readonly agentsDir;
+    constructor(twiningDir: string);
+    /** Read the registry, returning empty array if file doesn't exist. */
+    private readRegistry;
+    /** Write the registry, ensuring agents/ directory exists. */
+    private writeRegistry;
+    /**
+     * Create or update an agent record.
+     * - If agent_id exists: merge capabilities (union), overwrite role/description if provided
+     * - If agent_id doesn't exist: create new record
+     */
+    upsert(input: {
+        agent_id: string;
+        capabilities?: string[];
+        role?: string;
+        description?: string;
+    }): Promise<AgentRecord>;
+    /**
+     * Update last_active timestamp, creating a minimal record if agent doesn't exist.
+     * This is the auto-register path (REG-01).
+     */
+    touch(agentId: string): Promise<AgentRecord>;
+    /** Get a single agent by agent_id, or null if not found. */
+    get(agentId: string): Promise<AgentRecord | null>;
+    /** Get all agents from registry. */
+    getAll(): Promise<AgentRecord[]>;
+    /**
+     * Find agents with any matching capability tag (OR match).
+     * Input tags are normalized before matching.
+     */
+    findByCapabilities(tags: string[]): Promise<AgentRecord[]>;
+}
+//# sourceMappingURL=agent-store.d.ts.map

package/dist/storage/agent-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-store.d.ts","sourceRoot":"","sources":["../../src/storage/agent-store.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,UAAU,EAAE,MAAM;IAK9B,sEAAsE;YACxD,YAAY;IAS1B,6DAA6D;YAC/C,aAAa;IAK3B;;;;OAIG;IACG,MAAM,CAAC,KAAK,EAAE;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;QACxB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,GAAG,OAAO,CAAC,WAAW,CAAC;IAyCxB;;;OAGG;IACG,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAwBlD,4DAA4D;IACtD,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAKvD,oCAAoC;IAC9B,MAAM,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAItC;;;OAGG;IACG,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;CASjE"}

package/dist/storage/agent-store.js

@@ -0,0 +1,119 @@
+/**
+ * Agent registry storage layer.
+ * Manages agent records in `.twining/agents/registry.json` as a JSON array.
+ * Uses file-store readJSON/writeJSON for locked file I/O.
+ * Upsert semantics by agent_id with capability merging.
+ */
+import path from "node:path";
+import { readJSON, writeJSON, ensureDir } from "./file-store.js";
+import { normalizeTags } from "../utils/tags.js";
+export class AgentStore {
+    registryPath;
+    agentsDir;
+    constructor(twiningDir) {
+        this.agentsDir = path.join(twiningDir, "agents");
+        this.registryPath = path.join(this.agentsDir, "registry.json");
+    }
+    /** Read the registry, returning empty array if file doesn't exist. */
+    async readRegistry() {
+        try {
+            return await readJSON(this.registryPath);
+        }
+        catch {
+            // File doesn't exist or is corrupt — treat as empty
+            return [];
+        }
+    }
+    /** Write the registry, ensuring agents/ directory exists. */
+    async writeRegistry(agents) {
+        ensureDir(this.agentsDir);
+        await writeJSON(this.registryPath, agents);
+    }
+    /**
+     * Create or update an agent record.
+     * - If agent_id exists: merge capabilities (union), overwrite role/description if provided
+     * - If agent_id doesn't exist: create new record
+     */
+    async upsert(input) {
+        const agents = await this.readRegistry();
+        const now = new Date().toISOString();
+        const normalizedCaps = normalizeTags(input.capabilities ?? []);
+        const existingIdx = agents.findIndex((a) => a.agent_id === input.agent_id);
+        if (existingIdx >= 0) {
+            const existing = agents[existingIdx];
+            // Merge capabilities: union of existing + new, then normalize
+            const mergedCaps = normalizeTags([
+                ...existing.capabilities,
+                ...normalizedCaps,
+            ]);
+            existing.capabilities = mergedCaps;
+            // Overwrite role/description only if explicitly provided (not undefined)
+            if (input.role !== undefined) {
+                existing.role = input.role;
+            }
+            if (input.description !== undefined) {
+                existing.description = input.description;
+            }
+            existing.last_active = now;
+            await this.writeRegistry(agents);
+            return existing;
+        }
+        // Create new record
+        const agent = {
+            agent_id: input.agent_id,
+            capabilities: normalizedCaps,
+            role: input.role,
+            description: input.description,
+            registered_at: now,
+            last_active: now,
+        };
+        agents.push(agent);
+        await this.writeRegistry(agents);
+        return agent;
+    }
+    /**
+     * Update last_active timestamp, creating a minimal record if agent doesn't exist.
+     * This is the auto-register path (REG-01).
+     */
+    async touch(agentId) {
+        const agents = await this.readRegistry();
+        const now = new Date().toISOString();
+        const existing = agents.find((a) => a.agent_id === agentId);
+        if (existing) {
+            existing.last_active = now;
+            await this.writeRegistry(agents);
+            return existing;
+        }
+        // Create minimal record
+        const agent = {
+            agent_id: agentId,
+            capabilities: [],
+            registered_at: now,
+            last_active: now,
+        };
+        agents.push(agent);
+        await this.writeRegistry(agents);
+        return agent;
+    }
+    /** Get a single agent by agent_id, or null if not found. */
+    async get(agentId) {
+        const agents = await this.readRegistry();
+        return agents.find((a) => a.agent_id === agentId) ?? null;
+    }
+    /** Get all agents from registry. */
+    async getAll() {
+        return this.readRegistry();
+    }
+    /**
+     * Find agents with any matching capability tag (OR match).
+     * Input tags are normalized before matching.
+     */
+    async findByCapabilities(tags) {
+        const normalizedInput = normalizeTags(tags);
+        if (normalizedInput.length === 0)
+            return [];
+        const agents = await this.readRegistry();
+        return agents.filter((agent) => agent.capabilities.some((cap) => normalizedInput.includes(cap)));
+    }
+}
+//# sourceMappingURL=agent-store.js.map

package/dist/storage/agent-store.js.map

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

package/dist/storage/blackboard-store.d.ts

@@ -0,0 +1,21 @@
+import type { BlackboardEntry } from "../utils/types.js";
+export declare class BlackboardStore {
+    private readonly blackboardPath;
+    constructor(twiningDir: string);
+    /** Append a new entry, generating ID and timestamp. */
+    append(entry: Omit<BlackboardEntry, "id" | "timestamp">): Promise<BlackboardEntry>;
+    /** Read entries with optional filters. */
+    read(filters?: {
+        entry_types?: string[];
+        tags?: string[];
+        scope?: string;
+        since?: string;
+        limit?: number;
+    }): Promise<{
+        entries: BlackboardEntry[];
+        total_count: number;
+    }>;
+    /** Get the N most recent entries, optionally filtered by type. */
+    recent(n?: number, entry_types?: string[]): Promise<BlackboardEntry[]>;
+}
+//# sourceMappingURL=blackboard-store.d.ts.map

package/dist/storage/blackboard-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blackboard-store.d.ts","sourceRoot":"","sources":["../../src/storage/blackboard-store.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;gBAE5B,UAAU,EAAE,MAAM;IAI9B,uDAAuD;IACjD,MAAM,CACV,KAAK,EAAE,IAAI,CAAC,eAAe,EAAE,IAAI,GAAG,WAAW,CAAC,GAC/C,OAAO,CAAC,eAAe,CAAC;IAU3B,0CAA0C;IACpC,IAAI,CAAC,OAAO,CAAC,EAAE;QACnB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;QACvB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,eAAe,EAAE,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IAqChE,kEAAkE;IAC5D,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;CAU7E"}

package/dist/storage/blackboard-store.js

@@ -0,0 +1,56 @@
+/**
+ * Blackboard CRUD operations.
+ * Append-only JSONL storage for shared state entries.
+ */
+import path from "node:path";
+import { appendJSONL, readJSONL } from "./file-store.js";
+import { generateId } from "../utils/ids.js";
+export class BlackboardStore {
+    blackboardPath;
+    constructor(twiningDir) {
+        this.blackboardPath = path.join(twiningDir, "blackboard.jsonl");
+    }
+    /** Append a new entry, generating ID and timestamp. */
+    async append(entry) {
+        const full = {
+            ...entry,
+            id: generateId(),
+            timestamp: new Date().toISOString(),
+        };
+        await appendJSONL(this.blackboardPath, full);
+        return full;
+    }
+    /** Read entries with optional filters. */
+    async read(filters) {
+        let entries = await readJSONL(this.blackboardPath);
+        if (filters?.entry_types && filters.entry_types.length > 0) {
+            entries = entries.filter((e) => filters.entry_types.includes(e.entry_type));
+        }
+        if (filters?.tags && filters.tags.length > 0) {
+            entries = entries.filter((e) => e.tags.some((t) => filters.tags.includes(t)));
+        }
+        if (filters?.scope) {
+            const filterScope = filters.scope;
+            entries = entries.filter((e) => e.scope.startsWith(filterScope) || filterScope.startsWith(e.scope));
+        }
+        if (filters?.since) {
+            const sinceTime = filters.since;
+            entries = entries.filter((e) => e.timestamp >= sinceTime);
+        }
+        const total_count = entries.length;
+        if (filters?.limit !== undefined && filters.limit > 0) {
+            entries = entries.slice(-filters.limit);
+        }
+        return { entries, total_count };
+    }
+    /** Get the N most recent entries, optionally filtered by type. */
+    async recent(n, entry_types) {
+        let entries = await readJSONL(this.blackboardPath);
+        if (entry_types && entry_types.length > 0) {
+            entries = entries.filter((e) => entry_types.includes(e.entry_type));
+        }
+        const count = n ?? 20;
+        return entries.slice(-count).reverse();
+    }
+}
+//# sourceMappingURL=blackboard-store.js.map

package/dist/storage/blackboard-store.js.map

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

package/dist/storage/decision-store.d.ts

@@ -0,0 +1,23 @@
+import type { Decision, DecisionIndexEntry, DecisionStatus } from "../utils/types.js";
+export declare class DecisionStore {
+    private readonly decisionsDir;
+    private readonly indexPath;
+    constructor(twiningDir: string);
+    /** Create a new decision. Writes individual file and updates index atomically. */
+    create(input: Omit<Decision, "id" | "timestamp" | "status">): Promise<Decision>;
+    /** Get a single decision by ID. Returns null if not found. */
+    get(id: string): Promise<Decision | null>;
+    /** Get all decisions matching a scope (prefix match or affected files/symbols match). */
+    getByScope(scope: string): Promise<Decision[]>;
+    /** Update a decision's status (and optionally other fields). */
+    updateStatus(id: string, status: DecisionStatus, extra?: Partial<Decision>): Promise<void>;
+    /** Get the full decision index. */
+    getIndex(): Promise<DecisionIndexEntry[]>;
+    /** Link a commit hash to an existing decision. Updates both file and index. */
+    linkCommit(id: string, commitHash: string): Promise<void>;
+    /** Get decisions linked to a specific commit hash. */
+    getByCommitHash(commitHash: string): Promise<Decision[]>;
+    /** Extract index entry from a full decision. */
+    private toIndexEntry;
+}
+//# sourceMappingURL=decision-store.d.ts.map

package/dist/storage/decision-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision-store.d.ts","sourceRoot":"","sources":["../../src/storage/decision-store.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,QAAQ,EACR,kBAAkB,EAClB,cAAc,EACf,MAAM,mBAAmB,CAAC;AAO3B,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,UAAU,EAAE,MAAM;IAK9B,kFAAkF;IAC5E,MAAM,CACV,KAAK,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,GAAG,WAAW,GAAG,QAAQ,CAAC,GACnD,OAAO,CAAC,QAAQ,CAAC;IA8BpB,8DAA8D;IACxD,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAM/C,yFAAyF;IACnF,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IA8BpD,gEAAgE;IAC1D,YAAY,CAChB,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,cAAc,EACtB,KAAK,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,GACxB,OAAO,CAAC,IAAI,CAAC;IAmChB,mCAAmC;IAC7B,QAAQ,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAI/C,+EAA+E;IACzE,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA4C/D,sDAAsD;IAChD,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAsB9D,gDAAgD;IAChD,OAAO,CAAC,YAAY;CAcrB"}

package/dist/storage/decision-store.js

@@ -0,0 +1,179 @@
+/**
+ * Decision CRUD operations.
+ * Individual JSON files per decision with a fast-lookup index.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import lockfile from "proper-lockfile";
+import { readJSON, writeJSON } from "./file-store.js";
+import { generateId } from "../utils/ids.js";
+const INDEX_LOCK_OPTIONS = {
+    retries: { retries: 10, factor: 1.5, minTimeout: 50, maxTimeout: 1000 },
+    stale: 10000,
+};
+export class DecisionStore {
+    decisionsDir;
+    indexPath;
+    constructor(twiningDir) {
+        this.decisionsDir = path.join(twiningDir, "decisions");
+        this.indexPath = path.join(this.decisionsDir, "index.json");
+    }
+    /** Create a new decision. Writes individual file and updates index atomically. */
+    async create(input) {
+        const decision = {
+            ...input,
+            commit_hashes: input.commit_hashes ?? [],
+            id: generateId(),
+            timestamp: new Date().toISOString(),
+            status: "active",
+        };
+        const filePath = path.join(this.decisionsDir, `${decision.id}.json`);
+        // Lock index for atomic read-modify-write
+        const release = await lockfile.lock(this.indexPath, INDEX_LOCK_OPTIONS);
+        try {
+            // Write individual decision file
+            fs.writeFileSync(filePath, JSON.stringify(decision, null, 2));
+            // Update index
+            const index = JSON.parse(fs.readFileSync(this.indexPath, "utf-8"));
+            index.push(this.toIndexEntry(decision));
+            fs.writeFileSync(this.indexPath, JSON.stringify(index, null, 2));
+        }
+        finally {
+            await release();
+        }
+        return decision;
+    }
+    /** Get a single decision by ID. Returns null if not found. */
+    async get(id) {
+        const filePath = path.join(this.decisionsDir, `${id}.json`);
+        if (!fs.existsSync(filePath))
+            return null;
+        return readJSON(filePath);
+    }
+    /** Get all decisions matching a scope (prefix match or affected files/symbols match). */
+    async getByScope(scope) {
+        const index = await this.getIndex();
+        const matching = index.filter((entry) => entry.scope.startsWith(scope) ||
+            scope.startsWith(entry.scope) ||
+            entry.affected_files.some((f) => f.startsWith(scope) || scope.startsWith(f)) ||
+            entry.affected_symbols.some((s) => s === scope));
+        // Load full decision files for matches
+        const decisions = [];
+        for (const entry of matching) {
+            const decision = await this.get(entry.id);
+            if (decision)
+                decisions.push(decision);
+        }
+        // Sort by timestamp descending, then by ID descending (ULID is monotonic)
+        decisions.sort((a, b) => b.timestamp.localeCompare(a.timestamp) ||
+            b.id.localeCompare(a.id));
+        return decisions;
+    }
+    /** Update a decision's status (and optionally other fields). */
+    async updateStatus(id, status, extra) {
+        const filePath = path.join(this.decisionsDir, `${id}.json`);
+        if (!fs.existsSync(filePath))
+            return;
+        // Lock and update individual file
+        const fileRelease = await lockfile.lock(filePath, INDEX_LOCK_OPTIONS);
+        try {
+            const decision = JSON.parse(fs.readFileSync(filePath, "utf-8"));
+            decision.status = status;
+            if (extra) {
+                Object.assign(decision, extra);
+            }
+            fs.writeFileSync(filePath, JSON.stringify(decision, null, 2));
+        }
+        finally {
+            await fileRelease();
+        }
+        // Update index
+        const release = await lockfile.lock(this.indexPath, INDEX_LOCK_OPTIONS);
+        try {
+            const index = JSON.parse(fs.readFileSync(this.indexPath, "utf-8"));
+            const indexEntry = index.find((e) => e.id === id);
+            if (indexEntry) {
+                indexEntry.status = status;
+            }
+            fs.writeFileSync(this.indexPath, JSON.stringify(index, null, 2));
+        }
+        finally {
+            await release();
+        }
+    }
+    /** Get the full decision index. */
+    async getIndex() {
+        return readJSON(this.indexPath);
+    }
+    /** Link a commit hash to an existing decision. Updates both file and index. */
+    async linkCommit(id, commitHash) {
+        const filePath = path.join(this.decisionsDir, `${id}.json`);
+        if (!fs.existsSync(filePath)) {
+            throw new Error(`Decision not found: ${id}`);
+        }
+        // Lock and update individual decision file
+        const fileRelease = await lockfile.lock(filePath, INDEX_LOCK_OPTIONS);
+        try {
+            const decision = JSON.parse(fs.readFileSync(filePath, "utf-8"));
+            if (!decision.commit_hashes) {
+                decision.commit_hashes = [];
+            }
+            if (!decision.commit_hashes.includes(commitHash)) {
+                decision.commit_hashes.push(commitHash);
+            }
+            fs.writeFileSync(filePath, JSON.stringify(decision, null, 2));
+        }
+        finally {
+            await fileRelease();
+        }
+        // Update index
+        const release = await lockfile.lock(this.indexPath, INDEX_LOCK_OPTIONS);
+        try {
+            const index = JSON.parse(fs.readFileSync(this.indexPath, "utf-8"));
+            const indexEntry = index.find((e) => e.id === id);
+            if (indexEntry) {
+                if (!indexEntry.commit_hashes) {
+                    indexEntry.commit_hashes = [];
+                }
+                if (!indexEntry.commit_hashes.includes(commitHash)) {
+                    indexEntry.commit_hashes.push(commitHash);
+                }
+            }
+            fs.writeFileSync(this.indexPath, JSON.stringify(index, null, 2));
+        }
+        finally {
+            await release();
+        }
+    }
+    /** Get decisions linked to a specific commit hash. */
+    async getByCommitHash(commitHash) {
+        const index = await this.getIndex();
+        const matching = index.filter((entry) => entry.commit_hashes && entry.commit_hashes.includes(commitHash));
+        const decisions = [];
+        for (const entry of matching) {
+            const decision = await this.get(entry.id);
+            if (decision)
+                decisions.push(decision);
+        }
+        // Sort by timestamp descending
+        decisions.sort((a, b) => b.timestamp.localeCompare(a.timestamp) ||
+            b.id.localeCompare(a.id));
+        return decisions;
+    }
+    /** Extract index entry from a full decision. */
+    toIndexEntry(decision) {
+        return {
+            id: decision.id,
+            timestamp: decision.timestamp,
+            domain: decision.domain,
+            scope: decision.scope,
+            summary: decision.summary,
+            confidence: decision.confidence,
+            status: decision.status,
+            affected_files: decision.affected_files,
+            affected_symbols: decision.affected_symbols,
+            commit_hashes: decision.commit_hashes ?? [],
+        };
+    }
+}
+//# sourceMappingURL=decision-store.js.map

package/dist/storage/decision-store.js.map

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

package/dist/storage/file-store.d.ts

@@ -0,0 +1,20 @@
+/** Read and parse a JSON file. Throws if file doesn't exist. */
+export declare function readJSON<T>(filePath: string): Promise<T>;
+/** Write JSON to file under advisory lock. */
+export declare function writeJSON(filePath: string, data: unknown): Promise<void>;
+/** Append a single JSON object as a line to a JSONL file under advisory lock. */
+export declare function appendJSONL(filePath: string, data: unknown): Promise<void>;
+/**
+ * Read a JSONL file and parse each line.
+ * Corrupt lines are skipped with a warning to stderr.
+ * No locking needed for reads.
+ */
+export declare function readJSONL<T>(filePath: string): Promise<T[]>;
+/**
+ * Overwrite a JSONL file atomically under lock.
+ * Used by archiver to rewrite blackboard after removing archived entries.
+ */
+export declare function writeJSONL(filePath: string, data: unknown[]): Promise<void>;
+/** Ensure a directory exists, creating it recursively if needed. */
+export declare function ensureDir(dirPath: string): void;
+//# sourceMappingURL=file-store.d.ts.map

package/dist/storage/file-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-store.d.ts","sourceRoot":"","sources":["../../src/storage/file-store.ts"],"names":[],"mappings":"AAiBA,gEAAgE;AAChE,wBAAsB,QAAQ,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAG9D;AAED,8CAA8C;AAC9C,wBAAsB,SAAS,CAC7B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC,IAAI,CAAC,CAgBf;AAED,iFAAiF;AACjF,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC,IAAI,CAAC,CAef;AAED;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAejE;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,OAAO,EAAE,GACd,OAAO,CAAC,IAAI,CAAC,CAoBf;AAED,oEAAoE;AACpE,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE/C"}