@mcp-graph-workflow/mcp-graph 5.3.0 → 5.5.0

package/dist/core/skills/self-healing-listener.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"self-healing-listener.d.ts","sourceRoot":"","sources":["../../../src/core/skills/self-healing-listener.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAI5D,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,aAAa,CAAC;CACzB;AAED,2DAA2D;AAC3D,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CASvD;AAED,iEAAiE;AACjE,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAa3E;AAED,wCAAwC;AACxC,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,GACf,MAAM,CAiBR;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,IAAI,CAiDnF"}

package/dist/core/skills/self-healing-listener.js

@@ -0,0 +1,102 @@
+/**
+ * Self-Healing Listener — creates auto-memories when errors are detected.
+ * Subscribes to "error:detected" events on the GraphEventBus.
+ * Deduplicates via error hash to prevent flood.
+ */
+import { createHash } from "node:crypto";
+import { writeFileSync, existsSync, mkdirSync } from "node:fs";
+import path from "node:path";
+import { logger } from "../utils/logger.js";
+/** Categorize an error message into a healing category. */
+export function categorizeError(message) {
+    const lower = message.toLowerCase();
+    if (lower.includes("type") && (lower.includes("error") || lower.includes("mismatch")))
+        return "type-error";
+    if (lower.includes("validation") || lower.includes("invalid") || lower.includes("zod"))
+        return "validation-error";
+    if (lower.includes("build") || lower.includes("compile") || lower.includes("tsc"))
+        return "build-error";
+    if (lower.includes("test") && (lower.includes("fail") || lower.includes("assert")))
+        return "test-failure";
+    if (lower.includes("sqlite") || lower.includes("database") || lower.includes("migration"))
+        return "database-error";
+    if (lower.includes("import") || lower.includes("module") || lower.includes("require"))
+        return "module-error";
+    return "general-error";
+}
+/** Generate a short hash for deduplication of error patterns. */
+export function generateErrorHash(category, message) {
+    // Normalize: strip dynamic parts like timestamps, line numbers, ids
+    const normalized = message
+        .replace(/\d{4}-\d{2}-\d{2}T[\d:.Z]+/g, "")
+        .replace(/\b[a-f0-9]{12,}\b/g, "")
+        .replace(/line \d+/gi, "line N")
+        .replace(/:\d+:\d+/g, ":N:N")
+        .trim();
+    return createHash("sha256")
+        .update(`${category}:${normalized}`)
+        .digest("hex")
+        .slice(0, 12);
+}
+/** Build the healing memory content. */
+export function buildHealingMemory(category, errorMessage, toolName) {
+    const timestamp = new Date().toISOString();
+    return [
+        `# Self-Healing: ${category}`,
+        "",
+        "## Error Pattern",
+        errorMessage,
+        "",
+        "## Prevention Rule",
+        `When encountering similar ${category} issues, check the tool '${toolName}' inputs and outputs carefully.`,
+        "Apply validation at boundaries and verify types match expected schemas before proceeding.",
+        "",
+        "## Context",
+        `- Tool: ${toolName}`,
+        `- Category: ${category}`,
+        `- Date: ${timestamp}`,
+    ].join("\n");
+}
+/**
+ * Register the self-healing listener on the event bus.
+ * Returns an unsubscribe function.
+ */
+export function registerSelfHealingListener(options) {
+    const { memoriesDir, eventBus } = options;
+    // Ensure memories directory exists
+    if (!existsSync(memoriesDir)) {
+        mkdirSync(memoriesDir, { recursive: true });
+    }
+    const handler = (event) => {
+        if (event.type !== "error:detected")
+            return;
+        const { toolName, errorMessage, errorCategory, errorHash } = event.payload;
+        const memoryName = `healing-${errorCategory}-${errorHash}`;
+        const memoryPath = path.join(memoriesDir, `${memoryName}.md`);
+        // Deduplication: skip if memory already exists
+        if (existsSync(memoryPath)) {
+            logger.debug("self-healing:skip-duplicate", { memoryName });
+            return;
+        }
+        // Create healing memory
+        const content = buildHealingMemory(errorCategory, errorMessage, toolName);
+        try {
+            writeFileSync(memoryPath, content, "utf-8");
+            logger.info("self-healing:memory-created", { memoryName, category: errorCategory });
+            // Emit healing event
+            eventBus.emitTyped("healing:memory_created", {
+                memoryName,
+                errorCategory,
+                errorHash,
+            });
+        }
+        catch (err) {
+            logger.error("self-healing:write-failed", { memoryName, error: String(err) });
+        }
+    };
+    eventBus.on("error:detected", handler);
+    return () => {
+        eventBus.off("error:detected", handler);
+    };
+}
+//# sourceMappingURL=self-healing-listener.js.map

package/dist/core/skills/self-healing-listener.js.map

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

package/dist/core/skills/skill-store.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Skill Store — persistence layer for skill preferences and custom skills.
+ * Uses SQLite tables created by migration v9.
+ */
+import type Database from "better-sqlite3";
+import type { CustomSkill, CustomSkillInput } from "../../schemas/skill.schema.js";
+export declare function setSkillEnabled(db: Database.Database, projectId: string, skillName: string, enabled: boolean): void;
+export declare function getSkillPreferences(db: Database.Database, projectId: string): Map<string, boolean>;
+export declare function createCustomSkill(db: Database.Database, projectId: string, data: CustomSkillInput): CustomSkill;
+export declare function updateCustomSkill(db: Database.Database, projectId: string, id: string, data: Partial<CustomSkillInput>): CustomSkill;
+export declare function deleteCustomSkill(db: Database.Database, projectId: string, id: string): void;
+export declare function getCustomSkills(db: Database.Database, projectId: string): CustomSkill[];
+export declare function getCustomSkillByName(db: Database.Database, projectId: string, name: string): CustomSkill | undefined;
+//# sourceMappingURL=skill-store.d.ts.map

package/dist/core/skills/skill-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-store.d.ts","sourceRoot":"","sources":["../../../src/core/skills/skill-store.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAK3C,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAyCnF,wBAAgB,eAAe,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAOnH;AAED,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAUlG;AAID,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,GAAG,WAAW,CAgC/G;AAED,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,SAAS,EAAE,MAAM,EACjB,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAC9B,WAAW,CAkCb;AAED,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAS5F;AAED,wBAAgB,eAAe,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,GAAG,WAAW,EAAE,CAMvF;AAED,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAMpH"}

package/dist/core/skills/skill-store.js

@@ -0,0 +1,109 @@
+/**
+ * Skill Store — persistence layer for skill preferences and custom skills.
+ * Uses SQLite tables created by migration v9.
+ */
+import { generateId } from "../utils/id.js";
+import { now } from "../utils/time.js";
+import { logger } from "../utils/logger.js";
+import { ValidationError } from "../utils/errors.js";
+// ── Mapping helpers ──────────────────────────────────
+function rowToCustomSkill(row) {
+    return {
+        id: row.id,
+        projectId: row.project_id,
+        name: row.name,
+        description: row.description,
+        category: row.category,
+        phases: JSON.parse(row.phases),
+        instructions: row.instructions,
+        createdAt: row.created_at,
+        updatedAt: row.updated_at,
+    };
+}
+// ── Preferences ──────────────────────────────────────
+export function setSkillEnabled(db, projectId, skillName, enabled) {
+    logger.debug("skill-store:setEnabled", { projectId, skillName, enabled });
+    db.prepare(`
+    INSERT INTO skill_preferences (project_id, skill_name, enabled, updated_at)
+    VALUES (?, ?, ?, ?)
+    ON CONFLICT(project_id, skill_name) DO UPDATE SET enabled = excluded.enabled, updated_at = excluded.updated_at
+  `).run(projectId, skillName, enabled ? 1 : 0, now());
+}
+export function getSkillPreferences(db, projectId) {
+    const rows = db.prepare("SELECT skill_name, enabled FROM skill_preferences WHERE project_id = ?").all(projectId);
+    const map = new Map();
+    for (const row of rows) {
+        map.set(row.skill_name, row.enabled === 1);
+    }
+    return map;
+}
+// ── Custom Skills CRUD ───────────────────────────────
+export function createCustomSkill(db, projectId, data) {
+    const id = generateId("skill");
+    const timestamp = now();
+    logger.info("skill-store:create", { projectId, name: data.name });
+    try {
+        db.prepare(`
+      INSERT INTO custom_skills (id, project_id, name, description, category, phases, instructions, created_at, updated_at)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
+    `).run(id, projectId, data.name, data.description, data.category ?? "know-me", JSON.stringify(data.phases), data.instructions, timestamp, timestamp);
+    }
+    catch (err) {
+        if (err instanceof Error && err.message.includes("UNIQUE constraint")) {
+            throw new ValidationError(`Custom skill '${data.name}' already exists in this project`, []);
+        }
+        throw err;
+    }
+    return {
+        id,
+        projectId,
+        name: data.name,
+        description: data.description,
+        category: data.category ?? "know-me",
+        phases: data.phases,
+        instructions: data.instructions,
+        createdAt: timestamp,
+        updatedAt: timestamp,
+    };
+}
+export function updateCustomSkill(db, projectId, id, data) {
+    const existing = db.prepare("SELECT * FROM custom_skills WHERE id = ? AND project_id = ?").get(id, projectId);
+    if (!existing) {
+        throw new ValidationError(`Custom skill not found: ${id}`, []);
+    }
+    const timestamp = now();
+    const updated = {
+        name: data.name ?? existing.name,
+        description: data.description ?? existing.description,
+        category: data.category ?? existing.category,
+        phases: data.phases ? JSON.stringify(data.phases) : existing.phases,
+        instructions: data.instructions ?? existing.instructions,
+    };
+    logger.info("skill-store:update", { projectId, id });
+    db.prepare(`
+    UPDATE custom_skills
+    SET name = ?, description = ?, category = ?, phases = ?, instructions = ?, updated_at = ?
+    WHERE id = ? AND project_id = ?
+  `).run(updated.name, updated.description, updated.category, updated.phases, updated.instructions, timestamp, id, projectId);
+    return rowToCustomSkill({
+        ...existing,
+        ...updated,
+        updated_at: timestamp,
+    });
+}
+export function deleteCustomSkill(db, projectId, id) {
+    logger.info("skill-store:delete", { projectId, id });
+    const result = db.prepare("DELETE FROM custom_skills WHERE id = ? AND project_id = ?").run(id, projectId);
+    if (result.changes === 0) {
+        throw new ValidationError(`Custom skill not found: ${id}`, []);
+    }
+}
+export function getCustomSkills(db, projectId) {
+    const rows = db.prepare("SELECT * FROM custom_skills WHERE project_id = ? ORDER BY created_at").all(projectId);
+    return rows.map(rowToCustomSkill);
+}
+export function getCustomSkillByName(db, projectId, name) {
+    const row = db.prepare("SELECT * FROM custom_skills WHERE project_id = ? AND name = ?").get(projectId, name);
+    return row ? rowToCustomSkill(row) : undefined;
+}
+//# sourceMappingURL=skill-store.js.map

package/dist/core/skills/skill-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-store.js","sourceRoot":"","sources":["../../../src/core/skills/skill-store.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAwBrD,wDAAwD;AAExD,SAAS,gBAAgB,CAAC,GAAmB;IAC3C,OAAO;QACL,EAAE,EAAE,GAAG,CAAC,EAAE;QACV,SAAS,EAAE,GAAG,CAAC,UAAU;QACzB,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAA0B;QACvD,YAAY,EAAE,GAAG,CAAC,YAAY;QAC9B,SAAS,EAAE,GAAG,CAAC,UAAU;QACzB,SAAS,EAAE,GAAG,CAAC,UAAU;KAC1B,CAAC;AACJ,CAAC;AAED,wDAAwD;AAExD,MAAM,UAAU,eAAe,CAAC,EAAqB,EAAE,SAAiB,EAAE,SAAiB,EAAE,OAAgB;IAC3G,MAAM,CAAC,KAAK,CAAC,wBAAwB,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;IAC1E,EAAE,CAAC,OAAO,CAAC;;;;GAIV,CAAC,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,EAAqB,EAAE,SAAiB;IAC1E,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CACrB,wEAAwE,CACzE,CAAC,GAAG,CAAC,SAAS,CAAoB,CAAC;IAEpC,MAAM,GAAG,GAAG,IAAI,GAAG,EAAmB,CAAC;IACvC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,OAAO,KAAK,CAAC,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,wDAAwD;AAExD,MAAM,UAAU,iBAAiB,CAAC,EAAqB,EAAE,SAAiB,EAAE,IAAsB;IAChG,MAAM,EAAE,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IAC/B,MAAM,SAAS,GAAG,GAAG,EAAE,CAAC;IAExB,MAAM,CAAC,IAAI,CAAC,oBAAoB,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAElE,IAAI,CAAC;QACH,EAAE,CAAC,OAAO,CAAC;;;KAGV,CAAC,CAAC,GAAG,CACJ,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,QAAQ,IAAI,SAAS,EACtE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,YAAY,EAAE,SAAS,EAAE,SAAS,CACrE,CAAC;IACJ,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,IAAI,GAAG,YAAY,KAAK,IAAI,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAAC;YACtE,MAAM,IAAI,eAAe,CAAC,iBAAiB,IAAI,CAAC,IAAI,kCAAkC,EAAE,EAAE,CAAC,CAAC;QAC9F,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;IAED,OAAO;QACL,EAAE;QACF,SAAS;QACT,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,SAAS;QACpC,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,SAAS,EAAE,SAAS;QACpB,SAAS,EAAE,SAAS;KACrB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,EAAqB,EACrB,SAAiB,EACjB,EAAU,EACV,IAA+B;IAE/B,MAAM,QAAQ,GAAG,EAAE,CAAC,OAAO,CACzB,6DAA6D,CAC9D,CAAC,GAAG,CAAC,EAAE,EAAE,SAAS,CAA+B,CAAC;IAEnD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,eAAe,CAAC,2BAA2B,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IACjE,CAAC;IAED,MAAM,SAAS,GAAG,GAAG,EAAE,CAAC;IACxB,MAAM,OAAO,GAAG;QACd,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,QAAQ,CAAC,IAAI;QAChC,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,QAAQ,CAAC,WAAW;QACrD,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,QAAQ;QAC5C,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM;QACnE,YAAY,EAAE,IAAI,CAAC,YAAY,IAAI,QAAQ,CAAC,YAAY;KACzD,CAAC;IAEF,MAAM,CAAC,IAAI,CAAC,oBAAoB,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,CAAC;IAErD,EAAE,CAAC,OAAO,CAAC;;;;GAIV,CAAC,CAAC,GAAG,CACJ,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,QAAQ,EACnD,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,CAC/D,CAAC;IAEF,OAAO,gBAAgB,CAAC;QACtB,GAAG,QAAQ;QACX,GAAG,OAAO;QACV,UAAU,EAAE,SAAS;KACtB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,EAAqB,EAAE,SAAiB,EAAE,EAAU;IACpF,MAAM,CAAC,IAAI,CAAC,oBAAoB,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,CAAC;IACrD,MAAM,MAAM,GAAG,EAAE,CAAC,OAAO,CACvB,2DAA2D,CAC5D,CAAC,GAAG,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;IAErB,IAAI,MAAM,CAAC,OAAO,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,eAAe,CAAC,2BAA2B,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IACjE,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,EAAqB,EAAE,SAAiB;IACtE,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CACrB,sEAAsE,CACvE,CAAC,GAAG,CAAC,SAAS,CAAqB,CAAC;IAErC,OAAO,IAAI,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,EAAqB,EAAE,SAAiB,EAAE,IAAY;IACzF,MAAM,GAAG,GAAG,EAAE,CAAC,OAAO,CACpB,+DAA+D,CAChE,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAA+B,CAAC;IAErD,OAAO,GAAG,CAAC,CAAC,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACjD,CAAC"}

package/dist/core/store/migrations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"migrations.d.ts","sourceRoot":"","sources":["../../../src/core/store/migrations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAiT3C,wBAAgB,aAAa,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,IAAI,CA6BzD;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,IAAI,CAGvD"}
+{"version":3,"file":"migrations.d.ts","sourceRoot":"","sources":["../../../src/core/store/migrations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAwV3C,wBAAgB,aAAa,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,IAAI,CA6BzD;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,IAAI,CAGvD"}

package/dist/core/store/migrations.js

@@ -293,6 +293,45 @@ const migrations = [
       CREATE INDEX IF NOT EXISTS idx_ttu_called  ON tool_token_usage(called_at);
     `,
     },
+    {
+        version: 8,
+        description: "Global mode — fs_path on projects, project_id on knowledge_documents",
+        sql: `
+      ALTER TABLE projects ADD COLUMN fs_path TEXT;
+      CREATE INDEX IF NOT EXISTS idx_projects_fs_path ON projects(fs_path);
+
+      ALTER TABLE knowledge_documents ADD COLUMN project_id TEXT;
+      CREATE INDEX IF NOT EXISTS idx_knowledge_project ON knowledge_documents(project_id);
+    `,
+    },
+    {
+        version: 9,
+        description: "Skill preferences and custom skills tables",
+        sql: `
+      CREATE TABLE IF NOT EXISTS skill_preferences (
+        project_id  TEXT NOT NULL,
+        skill_name  TEXT NOT NULL,
+        enabled     INTEGER NOT NULL DEFAULT 1,
+        updated_at  TEXT NOT NULL,
+        PRIMARY KEY (project_id, skill_name)
+      );
+
+      CREATE TABLE IF NOT EXISTS custom_skills (
+        id          TEXT PRIMARY KEY,
+        project_id  TEXT NOT NULL,
+        name        TEXT NOT NULL,
+        description TEXT NOT NULL,
+        category    TEXT NOT NULL DEFAULT 'know-me',
+        phases      TEXT NOT NULL,
+        instructions TEXT NOT NULL,
+        created_at  TEXT NOT NULL,
+        updated_at  TEXT NOT NULL,
+        UNIQUE(project_id, name)
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_custom_skills_project ON custom_skills(project_id);
+    `,
+    },
 ];
 export function runMigrations(db) {
     // Create migrations tracking table

package/dist/core/store/migrations.js.map

@@ -1 +1 @@
-{"version":3,"file":"migrations.js","sourceRoot":"","sources":["../../../src/core/store/migrations.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAQ5C,MAAM,UAAU,GAAgB;IAC9B;QACE,OAAO,EAAE,CAAC;QACV,WAAW,EAAE,oEAAoE;QACjF,GAAG,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAsEJ;KACF;IACD;QACE,OAAO,EAAE,CAAC;QACV,WAAW,EAAE,sCAAsC;QACnD,GAAG,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;KA4BJ;KACF;IACD;QACE,OAAO,EAAE,CAAC;QACV,WAAW,EAAE,6DAA6D;QAC1E,GAAG,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAiCJ;KACF;IACD;QACE,OAAO,EAAE,CAAC;QACV,WAAW,EAAE,uEAAuE;QACpF,GAAG,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAwCJ;KACF;IACD;QACE,OAAO,EAAE,CAAC;QACV,WAAW,EAAE,0DAA0D;QACvE,GAAG,EAAE;;;;;;;;KAQJ;KACF;IACD;QACE,OAAO,EAAE,CAAC;QACV,WAAW,EAAE,oEAAoE;QACjF,GAAG,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAkEJ;KACF;IACD;QACE,OAAO,EAAE,CAAC;QACV,WAAW,EAAE,mDAAmD;QAChE,GAAG,EAAE;;;;;;;;;;;;;KAaJ;KACF;CACF,CAAC;AAEF,MAAM,UAAU,aAAa,CAAC,EAAqB;IACjD,mCAAmC;IACnC,EAAE,CAAC,IAAI,CAAC;;;;;;GAMP,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,IAAI,GAAG,CACrB,EAAE;SACC,OAAO,CAAC,iCAAiC,CAAC;SAC1C,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAE,GAA2B,CAAC,OAAO,CAAC,CACtD,CAAC;IAEF,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC;YAAE,SAAS;QAE7C,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,OAAO,EAAE,SAAS,CAAC,OAAO,EAAE,WAAW,EAAE,SAAS,CAAC,WAAW,EAAE,CAAC,CAAC;QACjG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE;YAClB,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;YACvB,EAAE,CAAC,OAAO,CACR,6EAA6E,CAC9E,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,EAAE,SAAS,CAAC,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;QAC5E,CAAC,CAAC,EAAE,CAAC;QACL,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,OAAO,EAAE,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC;IAC9D,CAAC;AACH,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,EAAqB;IAC/C,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAChC,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;AACjC,CAAC"}
+{"version":3,"file":"migrations.js","sourceRoot":"","sources":["../../../src/core/store/migrations.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAQ5C,MAAM,UAAU,GAAgB;IAC9B;QACE,OAAO,EAAE,CAAC;QACV,WAAW,EAAE,oEAAoE;QACjF,GAAG,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAsEJ;KACF;IACD;QACE,OAAO,EAAE,CAAC;QACV,WAAW,EAAE,sCAAsC;QACnD,GAAG,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;KA4BJ;KACF;IACD;QACE,OAAO,EAAE,CAAC;QACV,WAAW,EAAE,6DAA6D;QAC1E,GAAG,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAiCJ;KACF;IACD;QACE,OAAO,EAAE,CAAC;QACV,WAAW,EAAE,uEAAuE;QACpF,GAAG,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAwCJ;KACF;IACD;QACE,OAAO,EAAE,CAAC;QACV,WAAW,EAAE,0DAA0D;QACvE,GAAG,EAAE;;;;;;;;KAQJ;KACF;IACD;QACE,OAAO,EAAE,CAAC;QACV,WAAW,EAAE,oEAAoE;QACjF,GAAG,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAkEJ;KACF;IACD;QACE,OAAO,EAAE,CAAC;QACV,WAAW,EAAE,mDAAmD;QAChE,GAAG,EAAE;;;;;;;;;;;;;KAaJ;KACF;IACD;QACE,OAAO,EAAE,CAAC;QACV,WAAW,EAAE,sEAAsE;QACnF,GAAG,EAAE;;;;;;KAMJ;KACF;IACD;QACE,OAAO,EAAE,CAAC;QACV,WAAW,EAAE,4CAA4C;QACzD,GAAG,EAAE;;;;;;;;;;;;;;;;;;;;;;;KAuBJ;KACF;CACF,CAAC;AAEF,MAAM,UAAU,aAAa,CAAC,EAAqB;IACjD,mCAAmC;IACnC,EAAE,CAAC,IAAI,CAAC;;;;;;GAMP,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,IAAI,GAAG,CACrB,EAAE;SACC,OAAO,CAAC,iCAAiC,CAAC;SAC1C,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAE,GAA2B,CAAC,OAAO,CAAC,CACtD,CAAC;IAEF,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC;YAAE,SAAS;QAE7C,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,OAAO,EAAE,SAAS,CAAC,OAAO,EAAE,WAAW,EAAE,SAAS,CAAC,WAAW,EAAE,CAAC,CAAC;QACjG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE;YAClB,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;YACvB,EAAE,CAAC,OAAO,CACR,6EAA6E,CAC9E,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,EAAE,SAAS,CAAC,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;QAC5E,CAAC,CAAC,EAAE,CAAC;QACL,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,OAAO,EAAE,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC;IAC9D,CAAC;AACH,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,EAAqB;IAC/C,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAChC,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;AACjC,CAAC"}

package/dist/core/store/path-resolver.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Centralized store path resolution for global/local/explicit modes.
+ *
+ * Resolution precedence:
+ * 1. --db flag / MCP_GRAPH_DB env (explicit)
+ * 2. {cwd}/workflow-graph/graph.db (local — backward compat)
+ * 3. ~/.mcp-graph/graph.db (global — default)
+ */
+export type StoreMode = "local" | "global" | "explicit";
+export interface ResolvedStore {
+    /** How the DB was resolved */
+    mode: StoreMode;
+    /** Absolute path to the graph.db file */
+    dbPath: string;
+    /** Project root directory (for code index, PRD, etc.) */
+    basePath: string;
+    /** Absolute path to memories directory */
+    memoriesPath: string;
+}
+export interface ResolveOptions {
+    /** Explicit DB path override (--db flag or MCP_GRAPH_DB env) */
+    explicitDb?: string;
+    /** Current working directory (defaults to process.cwd()) */
+    cwd?: string;
+    /** Global store directory (defaults to ~/.mcp-graph/) — injectable for tests */
+    globalDir?: string;
+    /** Project ID for global memories scoping */
+    projectId?: string;
+    /** If true, creates global DB when no DB exists anywhere. Default: false */
+    createGlobal?: boolean;
+}
+/**
+ * Resolve which store DB to use based on precedence rules.
+ *
+ * @throws {Error} If no DB can be found and createGlobal is false.
+ */
+export declare function resolveStorePath(options?: ResolveOptions): ResolvedStore;
+//# sourceMappingURL=path-resolver.d.ts.map

package/dist/core/store/path-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-resolver.d.ts","sourceRoot":"","sources":["../../../src/core/store/path-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AASH,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,UAAU,CAAC;AAExD,MAAM,WAAW,aAAa;IAC5B,8BAA8B;IAC9B,IAAI,EAAE,SAAS,CAAC;IAChB,yCAAyC;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,QAAQ,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,gEAAgE;IAChE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4DAA4D;IAC5D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gFAAgF;IAChF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4EAA4E;IAC5E,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,aAAa,CA+DxE"}

package/dist/core/store/path-resolver.js

@@ -0,0 +1,92 @@
+/**
+ * Centralized store path resolution for global/local/explicit modes.
+ *
+ * Resolution precedence:
+ * 1. --db flag / MCP_GRAPH_DB env (explicit)
+ * 2. {cwd}/workflow-graph/graph.db (local — backward compat)
+ * 3. ~/.mcp-graph/graph.db (global — default)
+ */
+import path from "node:path";
+import { existsSync, mkdirSync } from "node:fs";
+import Database from "better-sqlite3";
+import { STORE_DIR, DB_FILE, GLOBAL_DB_DIR } from "../utils/constants.js";
+import { configureDb, runMigrations } from "./migrations.js";
+import { logger } from "../utils/logger.js";
+/**
+ * Resolve which store DB to use based on precedence rules.
+ *
+ * @throws {Error} If no DB can be found and createGlobal is false.
+ */
+export function resolveStorePath(options) {
+    const cwd = options?.cwd ?? process.cwd();
+    const globalDir = options?.globalDir ?? GLOBAL_DB_DIR;
+    const createGlobal = options?.createGlobal ?? false;
+    // 1. Explicit mode: --db flag or MCP_GRAPH_DB env
+    if (options?.explicitDb) {
+        logger.debug("path-resolver:explicit", { dbPath: options.explicitDb });
+        return {
+            mode: "explicit",
+            dbPath: options.explicitDb,
+            basePath: cwd,
+            memoriesPath: resolveMemoriesDir("explicit", cwd, globalDir, options.projectId),
+        };
+    }
+    // 2. Local mode: {cwd}/workflow-graph/graph.db
+    const localDbPath = path.join(cwd, STORE_DIR, DB_FILE);
+    if (existsSync(localDbPath)) {
+        logger.debug("path-resolver:local", { dbPath: localDbPath });
+        return {
+            mode: "local",
+            dbPath: localDbPath,
+            basePath: cwd,
+            memoriesPath: resolveMemoriesDir("local", cwd, globalDir, options?.projectId),
+        };
+    }
+    // 3. Global mode: ~/.mcp-graph/graph.db
+    const globalDbPath = path.join(globalDir, DB_FILE);
+    if (existsSync(globalDbPath)) {
+        logger.debug("path-resolver:global", { dbPath: globalDbPath });
+        return {
+            mode: "global",
+            dbPath: globalDbPath,
+            basePath: cwd,
+            memoriesPath: resolveMemoriesDir("global", cwd, globalDir, options?.projectId),
+        };
+    }
+    // 4. No DB found — create global if requested
+    if (createGlobal) {
+        logger.info("path-resolver:create-global", { globalDir });
+        mkdirSync(globalDir, { recursive: true });
+        const db = new Database(globalDbPath);
+        configureDb(db);
+        runMigrations(db);
+        db.close();
+        return {
+            mode: "global",
+            dbPath: globalDbPath,
+            basePath: cwd,
+            memoriesPath: resolveMemoriesDir("global", cwd, globalDir, options?.projectId),
+        };
+    }
+    throw new Error(`No graph database found. Checked:\n` +
+        `  local:  ${localDbPath}\n` +
+        `  global: ${globalDbPath}\n` +
+        `Run 'mcp-graph init' to create a local store, or 'mcp-graph init --global' for a global one.`);
+}
+/**
+ * Resolve the memories directory based on mode.
+ * - local: {cwd}/workflow-graph/memories/
+ * - global: {globalDir}/memories/{projectId}/
+ * - explicit: same as local (basePath)
+ */
+function resolveMemoriesDir(mode, basePath, globalDir, projectId) {
+    if (mode === "global" && projectId) {
+        return path.join(globalDir, "memories", projectId);
+    }
+    if (mode === "global") {
+        return path.join(globalDir, "memories");
+    }
+    // local or explicit
+    return path.join(basePath, STORE_DIR, "memories");
+}
+//# sourceMappingURL=path-resolver.js.map

package/dist/core/store/path-resolver.js.map

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

package/dist/core/store/sqlite-store.d.ts

@@ -18,6 +18,12 @@ export declare class SqliteStore {
      * - If neither → create `workflow-graph/`
      */
     static open(basePath?: string): SqliteStore;
+    /**
+     * Open a store at an absolute DB file path.
+     * Creates the file and parent dirs if they don't exist.
+     * Useful for global mode where the DB is at ~/.mcp-graph/graph.db.
+     */
+    static openDb(dbPath: string): SqliteStore;
     /** Expose the raw database instance for extension modules (e.g. DocsCacheStore). */
     getDb(): Database.Database;
     close(): void;
@@ -29,6 +35,21 @@ export declare class SqliteStore {
     listProjects(): GraphProject[];
     /** Switch the active project. Throws if project ID does not exist. */
     activateProject(projectId: string): void;
+    /**
+     * Find a project by its filesystem path.
+     * Returns null if no project is registered at that path.
+     */
+    findProjectByPath(fsPath: string): GraphProject | null;
+    /**
+     * Register a project with a filesystem path.
+     * If a project already exists at that path, returns the existing one.
+     * Creates and activates a new project otherwise.
+     */
+    registerProject(name: string, fsPath: string): GraphProject;
+    /**
+     * Set or update the filesystem path for a project.
+     */
+    setProjectFsPath(projectId: string, fsPath: string): void;
     private ensureProject;
     insertNode(node: GraphNode): void;
     getNodeById(id: string): GraphNode | null;

package/dist/core/store/sqlite-store.d.ts.map

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