twining-mcp 1.3.0

package/dist/storage/file-store.js

@@ -0,0 +1,108 @@
+/**
+ * Low-level file I/O with advisory locking.
+ * All writes use proper-lockfile for concurrent safety.
+ * Engine and store modules use these — never direct fs calls.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import lockfile from "proper-lockfile";
+const LOCK_OPTIONS = {
+    retries: { retries: 10, factor: 1.5, minTimeout: 50, maxTimeout: 1000 },
+    stale: 10000,
+    onCompromised: (err) => {
+        console.error("[twining] Lock compromised:", err.message);
+    },
+};
+/** Read and parse a JSON file. Throws if file doesn't exist. */
+export async function readJSON(filePath) {
+    const content = fs.readFileSync(filePath, "utf-8");
+    return JSON.parse(content);
+}
+/** Write JSON to file under advisory lock. */
+export async function writeJSON(filePath, data) {
+    // Ensure parent directory exists
+    const dir = path.dirname(filePath);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    // Ensure file exists for proper-lockfile (it locks based on file existence)
+    if (!fs.existsSync(filePath)) {
+        fs.writeFileSync(filePath, "");
+    }
+    const release = await lockfile.lock(filePath, LOCK_OPTIONS);
+    try {
+        fs.writeFileSync(filePath, JSON.stringify(data, null, 2));
+    }
+    finally {
+        await release();
+    }
+}
+/** Append a single JSON object as a line to a JSONL file under advisory lock. */
+export async function appendJSONL(filePath, data) {
+    // Ensure file exists for locking
+    if (!fs.existsSync(filePath)) {
+        const dir = path.dirname(filePath);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        fs.writeFileSync(filePath, "");
+    }
+    const release = await lockfile.lock(filePath, LOCK_OPTIONS);
+    try {
+        fs.appendFileSync(filePath, JSON.stringify(data) + "\n");
+    }
+    finally {
+        await release();
+    }
+}
+/**
+ * Read a JSONL file and parse each line.
+ * Corrupt lines are skipped with a warning to stderr.
+ * No locking needed for reads.
+ */
+export async function readJSONL(filePath) {
+    if (!fs.existsSync(filePath))
+        return [];
+    const content = fs.readFileSync(filePath, "utf-8");
+    const lines = content.split("\n").filter((line) => line.trim().length > 0);
+    const results = [];
+    for (const line of lines) {
+        try {
+            results.push(JSON.parse(line));
+        }
+        catch {
+            console.error(`[twining] Skipping corrupt JSONL line in ${path.basename(filePath)}`);
+        }
+    }
+    return results;
+}
+/**
+ * Overwrite a JSONL file atomically under lock.
+ * Used by archiver to rewrite blackboard after removing archived entries.
+ */
+export async function writeJSONL(filePath, data) {
+    // Ensure parent directory exists
+    const dir = path.dirname(filePath);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    // Ensure file exists for proper-lockfile
+    if (!fs.existsSync(filePath)) {
+        fs.writeFileSync(filePath, "");
+    }
+    const release = await lockfile.lock(filePath, LOCK_OPTIONS);
+    try {
+        const content = data.length > 0
+            ? data.map((item) => JSON.stringify(item)).join("\n") + "\n"
+            : "";
+        fs.writeFileSync(filePath, content);
+    }
+    finally {
+        await release();
+    }
+}
+/** Ensure a directory exists, creating it recursively if needed. */
+export function ensureDir(dirPath) {
+    fs.mkdirSync(dirPath, { recursive: true });
+}
+//# sourceMappingURL=file-store.js.map

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

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

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

@@ -0,0 +1,39 @@
+import type { Entity, Relation } from "../utils/types.js";
+export declare class GraphStore {
+    private readonly entitiesPath;
+    private readonly relationsPath;
+    private readonly graphDir;
+    constructor(twiningDir: string);
+    /** Ensure graph directory and files exist. */
+    private ensureFiles;
+    /**
+     * Add or update an entity.
+     * Upsert: match by name+type. If found, merge properties and update timestamp.
+     * If not found, create new entity with generated ID.
+     */
+    addEntity(input: {
+        name: string;
+        type: Entity["type"];
+        properties?: Record<string, string>;
+    }): Promise<Entity>;
+    /**
+     * Add a relation between two entities.
+     * Source/target can be entity ID or name.
+     * Resolves by ID first, then by name. Throws AMBIGUOUS_ENTITY if name matches multiple.
+     */
+    addRelation(input: {
+        source: string;
+        target: string;
+        type: Relation["type"];
+        properties?: Record<string, string>;
+    }): Promise<Relation>;
+    /** Get all entities. Returns [] if file doesn't exist. */
+    getEntities(): Promise<Entity[]>;
+    /** Get all relations. Returns [] if file doesn't exist. */
+    getRelations(): Promise<Relation[]>;
+    /** Find entity by ID. Returns undefined if not found. */
+    getEntityById(id: string): Promise<Entity | undefined>;
+    /** Find entities by name, optionally filtered by type. */
+    getEntityByName(name: string, type?: string): Promise<Entity[]>;
+}
+//# sourceMappingURL=graph-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"graph-store.d.ts","sourceRoot":"","sources":["../../src/storage/graph-store.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAS1D,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAEtB,UAAU,EAAE,MAAM;IAM9B,8CAA8C;IAC9C,OAAO,CAAC,WAAW;IAYnB;;;;OAIG;IACG,SAAS,CAAC,KAAK,EAAE;QACrB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QACrB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACrC,GAAG,OAAO,CAAC,MAAM,CAAC;IAgDnB;;;;OAIG;IACG,WAAW,CAAC,KAAK,EAAE;QACvB,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;QACvB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACrC,GAAG,OAAO,CAAC,QAAQ,CAAC;IA0DrB,0DAA0D;IACpD,WAAW,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAOtC,2DAA2D;IACrD,YAAY,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAOzC,yDAAyD;IACnD,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAK5D,0DAA0D;IACpD,eAAe,CACnB,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,MAAM,EAAE,CAAC;CAMrB"}

package/dist/storage/graph-store.js

@@ -0,0 +1,143 @@
+/**
+ * Knowledge graph storage layer.
+ * Manages entities (upsert semantics) and relations with entity resolution.
+ * Uses file-store readJSON/writeJSON with proper-lockfile for concurrent safety.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import lockfile from "proper-lockfile";
+import { generateId } from "../utils/ids.js";
+const LOCK_OPTIONS = {
+    retries: { retries: 10, factor: 1.5, minTimeout: 50, maxTimeout: 1000 },
+    stale: 10000,
+};
+import { TwiningError } from "../utils/errors.js";
+export class GraphStore {
+    entitiesPath;
+    relationsPath;
+    graphDir;
+    constructor(twiningDir) {
+        this.graphDir = path.join(twiningDir, "graph");
+        this.entitiesPath = path.join(this.graphDir, "entities.json");
+        this.relationsPath = path.join(this.graphDir, "relations.json");
+    }
+    /** Ensure graph directory and files exist. */
+    ensureFiles() {
+        if (!fs.existsSync(this.graphDir)) {
+            fs.mkdirSync(this.graphDir, { recursive: true });
+        }
+        if (!fs.existsSync(this.entitiesPath)) {
+            fs.writeFileSync(this.entitiesPath, JSON.stringify([]));
+        }
+        if (!fs.existsSync(this.relationsPath)) {
+            fs.writeFileSync(this.relationsPath, JSON.stringify([]));
+        }
+    }
+    /**
+     * Add or update an entity.
+     * Upsert: match by name+type. If found, merge properties and update timestamp.
+     * If not found, create new entity with generated ID.
+     */
+    async addEntity(input) {
+        this.ensureFiles();
+        const release = await lockfile.lock(this.entitiesPath, LOCK_OPTIONS);
+        try {
+            const entities = JSON.parse(fs.readFileSync(this.entitiesPath, "utf-8"));
+            const now = new Date().toISOString();
+            const existing = entities.find((e) => e.name === input.name && e.type === input.type);
+            if (existing) {
+                // Upsert: merge properties and update timestamp
+                existing.properties = {
+                    ...existing.properties,
+                    ...(input.properties ?? {}),
+                };
+                existing.updated_at = now;
+                fs.writeFileSync(this.entitiesPath, JSON.stringify(entities, null, 2));
+                return existing;
+            }
+            // Create new
+            const entity = {
+                id: generateId(),
+                name: input.name,
+                type: input.type,
+                properties: input.properties ?? {},
+                created_at: now,
+                updated_at: now,
+            };
+            entities.push(entity);
+            fs.writeFileSync(this.entitiesPath, JSON.stringify(entities, null, 2));
+            return entity;
+        }
+        finally {
+            await release();
+        }
+    }
+    /**
+     * Add a relation between two entities.
+     * Source/target can be entity ID or name.
+     * Resolves by ID first, then by name. Throws AMBIGUOUS_ENTITY if name matches multiple.
+     */
+    async addRelation(input) {
+        this.ensureFiles();
+        const entities = JSON.parse(fs.readFileSync(this.entitiesPath, "utf-8"));
+        const resolveEntity = (ref) => {
+            // Try by ID first
+            const byId = entities.find((e) => e.id === ref);
+            if (byId)
+                return byId;
+            // Try by name
+            const byName = entities.filter((e) => e.name === ref);
+            if (byName.length === 0) {
+                throw new TwiningError(`Entity not found: "${ref}"`, "NOT_FOUND");
+            }
+            if (byName.length > 1) {
+                const matches = byName.map((e) => `${e.name} (${e.type})`).join(", ");
+                throw new TwiningError(`Ambiguous entity name "${ref}" matches: ${matches}`, "AMBIGUOUS_ENTITY");
+            }
+            return byName[0];
+        };
+        const sourceEntity = resolveEntity(input.source);
+        const targetEntity = resolveEntity(input.target);
+        const release = await lockfile.lock(this.relationsPath, LOCK_OPTIONS);
+        try {
+            const relations = JSON.parse(fs.readFileSync(this.relationsPath, "utf-8"));
+            const relation = {
+                id: generateId(),
+                source: sourceEntity.id,
+                target: targetEntity.id,
+                type: input.type,
+                properties: input.properties ?? {},
+                created_at: new Date().toISOString(),
+            };
+            relations.push(relation);
+            fs.writeFileSync(this.relationsPath, JSON.stringify(relations, null, 2));
+            return relation;
+        }
+        finally {
+            await release();
+        }
+    }
+    /** Get all entities. Returns [] if file doesn't exist. */
+    async getEntities() {
+        if (!fs.existsSync(this.entitiesPath))
+            return [];
+        return JSON.parse(fs.readFileSync(this.entitiesPath, "utf-8"));
+    }
+    /** Get all relations. Returns [] if file doesn't exist. */
+    async getRelations() {
+        if (!fs.existsSync(this.relationsPath))
+            return [];
+        return JSON.parse(fs.readFileSync(this.relationsPath, "utf-8"));
+    }
+    /** Find entity by ID. Returns undefined if not found. */
+    async getEntityById(id) {
+        const entities = await this.getEntities();
+        return entities.find((e) => e.id === id);
+    }
+    /** Find entities by name, optionally filtered by type. */
+    async getEntityByName(name, type) {
+        const entities = await this.getEntities();
+        return entities.filter((e) => e.name === name && (type === undefined || e.type === type));
+    }
+}
+//# sourceMappingURL=graph-store.js.map

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

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

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

@@ -0,0 +1,44 @@
+import type { HandoffRecord, HandoffIndexEntry } from "../utils/types.js";
+export declare class HandoffStore {
+    private readonly handoffsDir;
+    private readonly indexPath;
+    constructor(twiningDir: string);
+    /**
+     * Create a new handoff record.
+     * Writes individual JSON file, then appends to JSONL index.
+     */
+    create(input: Omit<HandoffRecord, "id" | "created_at">): Promise<HandoffRecord>;
+    /**
+     * Get a single handoff by ID.
+     * Returns null if file doesn't exist.
+     */
+    get(id: string): Promise<HandoffRecord | null>;
+    /**
+     * List handoff index entries with optional filtering.
+     * Reads from JSONL index for fast listing.
+     */
+    list(filters?: {
+        source_agent?: string;
+        target_agent?: string;
+        scope?: string;
+        since?: string;
+        limit?: number;
+    }): Promise<HandoffIndexEntry[]>;
+    /**
+     * Acknowledge a handoff.
+     * Updates individual file and rewrites index entry.
+     */
+    acknowledge(id: string, acknowledgedBy: string): Promise<HandoffRecord>;
+    /**
+     * Compute aggregate result_status and create a lightweight index entry.
+     */
+    private toIndexEntry;
+    /**
+     * Compute aggregate result_status from results array.
+     * - If no results, "completed"
+     * - If all same status, that status
+     * - If mixed, "mixed"
+     */
+    private computeResultStatus;
+}
+//# sourceMappingURL=handoff-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"handoff-store.d.ts","sourceRoot":"","sources":["../../src/storage/handoff-store.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EACV,aAAa,EAEb,iBAAiB,EAClB,MAAM,mBAAmB,CAAC;AAE3B,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,UAAU,EAAE,MAAM;IAK9B;;;OAGG;IACG,MAAM,CACV,KAAK,EAAE,IAAI,CAAC,aAAa,EAAE,IAAI,GAAG,YAAY,CAAC,GAC9C,OAAO,CAAC,aAAa,CAAC;IAoBzB;;;OAGG;IACG,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAUpD;;;OAGG;IACG,IAAI,CACR,OAAO,CAAC,EAAE;QACR,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GACA,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAuC/B;;;OAGG;IACG,WAAW,CACf,EAAE,EAAE,MAAM,EACV,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,aAAa,CAAC;IA0BzB;;OAEG;IACH,OAAO,CAAC,YAAY;IAcpB;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;CAW5B"}

package/dist/storage/handoff-store.js

@@ -0,0 +1,136 @@
+/**
+ * Handoff CRUD operations.
+ * Individual JSON files per handoff with a JSONL index for fast listing.
+ * Follows DecisionStore's individual-file pattern.
+ */
+import path from "node:path";
+import { readJSON, writeJSON, appendJSONL, readJSONL, writeJSONL, ensureDir, } from "./file-store.js";
+import { generateId } from "../utils/ids.js";
+export class HandoffStore {
+    handoffsDir;
+    indexPath;
+    constructor(twiningDir) {
+        this.handoffsDir = path.join(twiningDir, "handoffs");
+        this.indexPath = path.join(this.handoffsDir, "index.jsonl");
+    }
+    /**
+     * Create a new handoff record.
+     * Writes individual JSON file, then appends to JSONL index.
+     */
+    async create(input) {
+        ensureDir(this.handoffsDir);
+        const record = {
+            ...input,
+            id: generateId(),
+            created_at: new Date().toISOString(),
+        };
+        // File-first: write individual file before updating index
+        const filePath = path.join(this.handoffsDir, `${record.id}.json`);
+        await writeJSON(filePath, record);
+        // Append lightweight index entry
+        const indexEntry = this.toIndexEntry(record);
+        await appendJSONL(this.indexPath, indexEntry);
+        return record;
+    }
+    /**
+     * Get a single handoff by ID.
+     * Returns null if file doesn't exist.
+     */
+    async get(id) {
+        const filePath = path.join(this.handoffsDir, `${id}.json`);
+        try {
+            return await readJSON(filePath);
+        }
+        catch {
+            // ENOENT or other error — return null
+            return null;
+        }
+    }
+    /**
+     * List handoff index entries with optional filtering.
+     * Reads from JSONL index for fast listing.
+     */
+    async list(filters) {
+        let entries = await readJSONL(this.indexPath);
+        if (filters) {
+            if (filters.source_agent) {
+                entries = entries.filter((e) => e.source_agent === filters.source_agent);
+            }
+            if (filters.target_agent) {
+                entries = entries.filter((e) => e.target_agent === filters.target_agent);
+            }
+            if (filters.scope) {
+                const filterScope = filters.scope;
+                entries = entries.filter((e) => e.scope?.startsWith(filterScope) ||
+                    filterScope.startsWith(e.scope ?? ""));
+            }
+            if (filters.since) {
+                const since = filters.since;
+                entries = entries.filter((e) => e.created_at >= since);
+            }
+        }
+        // Sort by created_at descending (newest first)
+        entries.sort((a, b) => b.created_at.localeCompare(a.created_at));
+        // Apply limit
+        if (filters?.limit !== undefined) {
+            entries = entries.slice(0, filters.limit);
+        }
+        return entries;
+    }
+    /**
+     * Acknowledge a handoff.
+     * Updates individual file and rewrites index entry.
+     */
+    async acknowledge(id, acknowledgedBy) {
+        const filePath = path.join(this.handoffsDir, `${id}.json`);
+        let record;
+        try {
+            record = await readJSON(filePath);
+        }
+        catch {
+            throw new Error(`Handoff not found: ${id}`);
+        }
+        // Update acknowledgment fields
+        record.acknowledged_by = acknowledgedBy;
+        record.acknowledged_at = new Date().toISOString();
+        // Rewrite individual file
+        await writeJSON(filePath, record);
+        // Rewrite index with updated entry
+        const entries = await readJSONL(this.indexPath);
+        const updatedEntries = entries.map((e) => e.id === id ? { ...e, acknowledged: true } : e);
+        await writeJSONL(this.indexPath, updatedEntries);
+        return record;
+    }
+    /**
+     * Compute aggregate result_status and create a lightweight index entry.
+     */
+    toIndexEntry(record) {
+        const resultStatus = this.computeResultStatus(record.results);
+        return {
+            id: record.id,
+            created_at: record.created_at,
+            source_agent: record.source_agent,
+            target_agent: record.target_agent,
+            scope: record.scope,
+            summary: record.summary,
+            result_status: resultStatus,
+            acknowledged: false,
+        };
+    }
+    /**
+     * Compute aggregate result_status from results array.
+     * - If no results, "completed"
+     * - If all same status, that status
+     * - If mixed, "mixed"
+     */
+    computeResultStatus(results) {
+        if (results.length === 0)
+            return "completed";
+        const statuses = new Set(results.map((r) => r.status));
+        if (statuses.size === 1) {
+            return results[0].status;
+        }
+        return "mixed";
+    }
+}
+//# sourceMappingURL=handoff-store.js.map

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

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

package/dist/storage/init.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Create the .twining/ directory structure if it doesn't exist.
+ * Silent auto-create per user decision — no user interaction.
+ */
+export declare function initTwiningDir(projectRoot: string): void;
+/**
+ * Ensure .twining/ is initialized. Returns the .twining/ path.
+ */
+export declare function ensureInitialized(projectRoot: string): string;
+//# sourceMappingURL=init.d.ts.map

package/dist/storage/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/storage/init.ts"],"names":[],"mappings":"AASA;;;GAGG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CA8CxD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAG7D"}

package/dist/storage/init.js

@@ -0,0 +1,48 @@
+/**
+ * Directory initialization for .twining/ structure.
+ * Creates all directories and default files on first tool call.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import yaml from "js-yaml";
+import { DEFAULT_CONFIG } from "../config.js";
+/**
+ * Create the .twining/ directory structure if it doesn't exist.
+ * Silent auto-create per user decision — no user interaction.
+ */
+export function initTwiningDir(projectRoot) {
+    const twiningDir = path.join(projectRoot, ".twining");
+    // If already exists, nothing to do
+    if (fs.existsSync(twiningDir))
+        return;
+    // Create directory structure (spec section 2.2)
+    fs.mkdirSync(twiningDir, { recursive: true });
+    fs.mkdirSync(path.join(twiningDir, "decisions"), { recursive: true });
+    fs.mkdirSync(path.join(twiningDir, "graph"), { recursive: true });
+    fs.mkdirSync(path.join(twiningDir, "embeddings"), { recursive: true });
+    fs.mkdirSync(path.join(twiningDir, "archive"), { recursive: true });
+    fs.mkdirSync(path.join(twiningDir, "agents"), { recursive: true });
+    fs.mkdirSync(path.join(twiningDir, "handoffs"), { recursive: true });
+    // Config with project name auto-detected
+    const config = {
+        ...DEFAULT_CONFIG,
+        project_name: path.basename(projectRoot),
+    };
+    fs.writeFileSync(path.join(twiningDir, "config.yml"), yaml.dump(config));
+    // Empty data files
+    fs.writeFileSync(path.join(twiningDir, "blackboard.jsonl"), "");
+    fs.writeFileSync(path.join(twiningDir, "decisions", "index.json"), JSON.stringify([], null, 2));
+    fs.writeFileSync(path.join(twiningDir, "graph", "entities.json"), JSON.stringify([], null, 2));
+    fs.writeFileSync(path.join(twiningDir, "graph", "relations.json"), JSON.stringify([], null, 2));
+    fs.writeFileSync(path.join(twiningDir, "agents", "registry.json"), JSON.stringify([], null, 2));
+    // Gitignore (spec section 2.3 + model cache)
+    fs.writeFileSync(path.join(twiningDir, ".gitignore"), "embeddings/*.index\narchive/\nmodels/\n");
+}
+/**
+ * Ensure .twining/ is initialized. Returns the .twining/ path.
+ */
+export function ensureInitialized(projectRoot) {
+    initTwiningDir(projectRoot);
+    return path.join(projectRoot, ".twining");
+}
+//# sourceMappingURL=init.js.map

package/dist/storage/init.js.map

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

package/dist/tools/blackboard-tools.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { BlackboardEngine } from "../engine/blackboard.js";
+export declare function registerBlackboardTools(server: McpServer, engine: BlackboardEngine): void;
+//# sourceMappingURL=blackboard-tools.d.ts.map

package/dist/tools/blackboard-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blackboard-tools.d.ts","sourceRoot":"","sources":["../../src/tools/blackboard-tools.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAIhE,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,gBAAgB,GACvB,IAAI,CAyJN"}