ai-spector 0.1.3 → 0.1.4

package/README.md

@@ -15,7 +15,9 @@ npm install ai-spector
 npx ai-spector init
 ```
 
-Put your source files in `docs/data-source/`, open the folder in Cursor, and turn on the **ai-spector** skill.
+Put your source files in `docs/data-source/`, open the folder in Cursor, turn on the **ai-spector** skill, and **reload MCP** (init writes `.cursor/mcp.json` for Graphify).
+
+**Graphify requires:** [uv](https://docs.astral.sh/uv/) installed; package `graphifyy` is pulled via `uv tool run` on first MCP start.
 
 ### Then use slash commands
 
@@ -43,9 +45,15 @@ Command details live in `.cursor/commands/` after `init` (start with `_workflow.
 
 If a CLI step fails during a slash command, the agent should **stop**, show you the error, and help you fix it — not bypass the tool with manual edits. See `_cli-failures.md` in your project after `init`.
 
-### Why is `docs/data-source/graphify-out/` there?
+### Graphify MCP (configured on `init`)
+
+`init` adds **`.cursor/mcp.json`** (Graphify) and updates **`.gitignore`** (Graphify cache, HTML reports, legacy `docs/data-source/graphify-out/`).
+
+Graphify graph file:
+
+`.ai-spector/.docflow/graph/graphify-out/graph.json`
 
-That folder is from **Graphify MCP** during **`/analyze`**, not from `npx ai-spector analyze`. AI Spector’s files live under `.ai-spector/` (especially `knowledge.json` and the traceability graph). You can delete `graphify-out/`; new projects gitignore it. See `docs/data-source/README.md` after `init`.
+Restart Cursor or reload MCP after init. If you still see **`docs/data-source/graphify-out/`**, that is an old Graphify default — delete it; see `docs/data-source/README.md`.
 
 ---
 

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

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,wBAAsB,OAAO,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAiD9D"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,wBAAsB,OAAO,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAyD9D"}

package/dist/commands/init.js

@@ -2,6 +2,8 @@ import { mkdir, writeFile } from "node:fs/promises";
 import { join, resolve } from "node:path";
 import { scaffoldBundleRoot } from "../config/load.js";
 import { copyTree, pathExists, writeJson } from "../util/fs.js";
+import { ensureGraphifyMcpConfig } from "../util/mcp.js";
+import { ensureAiSpectorGitignore } from "../util/gitignore.js";
 export async function runInit(opts) {
     const root = resolve(opts.targetDir);
     const marker = join(root, ".ai-spector", "docflow.config.json");
@@ -15,6 +17,7 @@ export async function runInit(opts) {
         ".ai-spector/registry",
         ".ai-spector/.docflow/analysis",
         ".ai-spector/.docflow/extract",
+        ".ai-spector/.docflow/graph/graphify-out",
         ".ai-spector/views",
         "docs/srs",
         "docs/basic-design",
@@ -34,13 +37,19 @@ export async function runInit(opts) {
     if (!(await pathExists(gitkeep))) {
         await writeFile(gitkeep, "");
     }
+    const mcpPath = await ensureGraphifyMcpConfig(root);
+    const gitignorePath = await ensureAiSpectorGitignore(root);
     console.log(`Initialized AI Spector project at ${root}`);
     console.log("");
+    console.log(`  MCP       → ${mcpPath} (Graphify server added/updated)`);
+    console.log(`  gitignore → ${gitignorePath} (ai-spector block added/updated)`);
+    console.log("");
     console.log("Next steps (Cursor):");
     console.log("  1. Open this folder in Cursor");
-    console.log("  2. Enable the ai-spector skill (.cursor/skills/ai-spector/)");
-    console.log("  3. Add files under docs/data-source/");
-    console.log("  4. Run /analyze  →  /validate-graph  →  /generate-srs");
+    console.log("  2. Reload MCP (Settings → MCP) or restart Cursor — needs uv + graphifyy");
+    console.log("  3. Enable the ai-spector skill (.cursor/skills/ai-spector/)");
+    console.log("  4. Add files under docs/data-source/");
+    console.log("  5. Run /analyze  →  /validate-graph  →  /generate-srs");
     console.log("");
     console.log("See .cursor/commands/_workflow.md — you do not need other CLI commands.");
 }

package/dist/commands/init.js.map

@@ -1 +1 @@
-{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAOhE,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAiB;IAC7C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACrC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,EAAE,aAAa,EAAE,qBAAqB,CAAC,CAAC;IAEhE,IAAI,MAAM,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CACb,gCAAgC,MAAM,6CAA6C,CACpF,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,kBAAkB,EAAE,CAAC;IACtC,MAAM,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAE/B,MAAM,IAAI,GAAG;QACX,mBAAmB;QACnB,sBAAsB;QACtB,+BAA+B;QAC/B,8BAA8B;QAC9B,mBAAmB;QACnB,UAAU;QACV,mBAAmB;QACnB,oBAAoB;KACrB,CAAC;IACF,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAClD,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,EAAE,iCAAiC,CAAC,CAAC;IAChE,MAAM,SAAS,CAAC,SAAS,EAAE;QACzB,OAAO,EAAE,CAAC;QACV,aAAa,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACvC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE;QACpD,KAAK,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE;KAC3B,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,mBAAmB,CAAC,CAAC;IAChD,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;QACjC,MAAM,SAAS,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC/B,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,qCAAqC,IAAI,EAAE,CAAC,CAAC;IACzD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;IACpC,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;IAC/C,OAAO,CAAC,GAAG,CAAC,+DAA+D,CAAC,CAAC;IAC7E,OAAO,CAAC,GAAG,CAAC,wCAAwC,CAAC,CAAC;IACtD,OAAO,CAAC,GAAG,CAAC,yDAAyD,CAAC,CAAC;IACvE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,yEAAyE,CAAC,CAAC;AACzF,CAAC"}
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"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"}

package/dist/util/gitignore.d.ts

@@ -0,0 +1,9 @@
+export declare const GITIGNORE_BEGIN = "# >>> ai-spector (begin)";
+export declare const GITIGNORE_END = "# <<< ai-spector (end)";
+/** Lines merged into the project root .gitignore on init. */
+export declare const AI_SPECTOR_GITIGNORE_LINES: readonly ["# >>> ai-spector (begin)", "# Graphify MCP + local reports (see .cursor/mcp.json)", "docs/data-source/graphify-out/", ".ai-spector/.docflow/graph/graphify-index/", ".ai-spector/.docflow/graph/graphify-out/", ".ai-spector/views/", "# <<< ai-spector (end)", ""];
+/**
+ * Ensure project root `.gitignore` includes the ai-spector block.
+ */
+export declare function ensureAiSpectorGitignore(projectRoot: string): Promise<string>;
+//# sourceMappingURL=gitignore.d.ts.map

package/dist/util/gitignore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitignore.d.ts","sourceRoot":"","sources":["../../src/util/gitignore.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,eAAe,6BAA6B,CAAC;AAC1D,eAAO,MAAM,aAAa,2BAA2B,CAAC;AAEtD,6DAA6D;AAC7D,eAAO,MAAM,0BAA0B,gRAS7B,CAAC;AAqBX;;GAEG;AACH,wBAAsB,wBAAwB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAenF"}

package/dist/util/gitignore.js

@@ -0,0 +1,48 @@
+import { readFile, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { pathExists } from "./fs.js";
+export const GITIGNORE_BEGIN = "# >>> ai-spector (begin)";
+export const GITIGNORE_END = "# <<< ai-spector (end)";
+/** Lines merged into the project root .gitignore on init. */
+export const AI_SPECTOR_GITIGNORE_LINES = [
+    GITIGNORE_BEGIN,
+    "# Graphify MCP + local reports (see .cursor/mcp.json)",
+    "docs/data-source/graphify-out/",
+    ".ai-spector/.docflow/graph/graphify-index/",
+    ".ai-spector/.docflow/graph/graphify-out/",
+    ".ai-spector/views/",
+    GITIGNORE_END,
+    "",
+];
+function buildBlock() {
+    return `${AI_SPECTOR_GITIGNORE_LINES.join("\n")}`;
+}
+function replaceOrAppendBlock(existing, block) {
+    const begin = existing.indexOf(GITIGNORE_BEGIN);
+    const end = existing.indexOf(GITIGNORE_END);
+    if (begin !== -1 && end !== -1 && end > begin) {
+        const before = existing.slice(0, begin);
+        const after = existing.slice(end + GITIGNORE_END.length);
+        return `${before}${block}${after.replace(/^\n/, "")}`;
+    }
+    const trimmed = existing.replace(/\s*$/, "");
+    const separator = trimmed.length > 0 ? "\n\n" : "";
+    return `${trimmed}${separator}${block}`;
+}
+/**
+ * Ensure project root `.gitignore` includes the ai-spector block.
+ */
+export async function ensureAiSpectorGitignore(projectRoot) {
+    const gitignorePath = join(projectRoot, ".gitignore");
+    const block = buildBlock();
+    let existing = "";
+    if (await pathExists(gitignorePath)) {
+        existing = await readFile(gitignorePath, "utf8");
+    }
+    const next = replaceOrAppendBlock(existing, block);
+    if (next !== existing) {
+        await writeFile(gitignorePath, next.endsWith("\n") ? next : `${next}\n`, "utf8");
+    }
+    return gitignorePath;
+}
+//# sourceMappingURL=gitignore.js.map

package/dist/util/gitignore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitignore.js","sourceRoot":"","sources":["../../src/util/gitignore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC,MAAM,CAAC,MAAM,eAAe,GAAG,0BAA0B,CAAC;AAC1D,MAAM,CAAC,MAAM,aAAa,GAAG,wBAAwB,CAAC;AAEtD,6DAA6D;AAC7D,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,eAAe;IACf,uDAAuD;IACvD,gCAAgC;IAChC,4CAA4C;IAC5C,0CAA0C;IAC1C,oBAAoB;IACpB,aAAa;IACb,EAAE;CACM,CAAC;AAEX,SAAS,UAAU;IACjB,OAAO,GAAG,0BAA0B,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AACpD,CAAC;AAED,SAAS,oBAAoB,CAAC,QAAgB,EAAE,KAAa;IAC3D,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;IAChD,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IAE5C,IAAI,KAAK,KAAK,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,IAAI,GAAG,GAAG,KAAK,EAAE,CAAC;QAC9C,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QACxC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;QACzD,OAAO,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC;IACxD,CAAC;IAED,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC7C,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IACnD,OAAO,GAAG,OAAO,GAAG,SAAS,GAAG,KAAK,EAAE,CAAC;AAC1C,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,WAAmB;IAChE,MAAM,aAAa,GAAG,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IACtD,MAAM,KAAK,GAAG,UAAU,EAAE,CAAC;IAE3B,IAAI,QAAQ,GAAG,EAAE,CAAC;IAClB,IAAI,MAAM,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QACpC,QAAQ,GAAG,MAAM,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;IACnD,CAAC;IAED,MAAM,IAAI,GAAG,oBAAoB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACnD,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtB,MAAM,SAAS,CAAC,aAAa,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,EAAE,MAAM,CAAC,CAAC;IACnF,CAAC;IAED,OAAO,aAAa,CAAC;AACvB,CAAC"}

package/dist/util/mcp.d.ts

@@ -0,0 +1,16 @@
+export interface CursorMcpConfig {
+    mcpServers?: Record<string, McpServerEntry>;
+}
+export interface McpServerEntry {
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+}
+/** Graph JSON path relative to workspace (Cursor expands ${workspaceFolder}). */
+export declare const GRAPHIFY_GRAPH_ARG = "${workspaceFolder}/.ai-spector/.docflow/graph/graphify-out/graph.json";
+export declare function graphifyMcpServerEntry(): McpServerEntry;
+/**
+ * Ensure `.cursor/mcp.json` includes the Graphify server without removing other servers.
+ */
+export declare function ensureGraphifyMcpConfig(projectRoot: string): Promise<string>;
+//# sourceMappingURL=mcp.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/util/mcp.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,eAAe;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,iFAAiF;AACjF,eAAO,MAAM,kBAAkB,0EAC0C,CAAC;AAE1E,wBAAgB,sBAAsB,IAAI,cAAc,CAcvD;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAmBlF"}

package/dist/util/mcp.js

@@ -0,0 +1,41 @@
+import { join } from "node:path";
+import { pathExists, readJson, writeJson } from "./fs.js";
+/** Graph JSON path relative to workspace (Cursor expands ${workspaceFolder}). */
+export const GRAPHIFY_GRAPH_ARG = "${workspaceFolder}/.ai-spector/.docflow/graph/graphify-out/graph.json";
+export function graphifyMcpServerEntry() {
+    return {
+        command: "uv",
+        args: [
+            "tool",
+            "run",
+            "--from",
+            "graphifyy",
+            "python",
+            "-m",
+            "graphify.serve",
+            GRAPHIFY_GRAPH_ARG,
+        ],
+    };
+}
+/**
+ * Ensure `.cursor/mcp.json` includes the Graphify server without removing other servers.
+ */
+export async function ensureGraphifyMcpConfig(projectRoot) {
+    const mcpPath = join(projectRoot, ".cursor", "mcp.json");
+    let config = { mcpServers: {} };
+    if (await pathExists(mcpPath)) {
+        try {
+            config = await readJson(mcpPath);
+        }
+        catch {
+            config = { mcpServers: {} };
+        }
+    }
+    if (!config.mcpServers) {
+        config.mcpServers = {};
+    }
+    config.mcpServers.graphify = graphifyMcpServerEntry();
+    await writeJson(mcpPath, config);
+    return mcpPath;
+}
+//# sourceMappingURL=mcp.js.map

package/dist/util/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../src/util/mcp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAY1D,iFAAiF;AACjF,MAAM,CAAC,MAAM,kBAAkB,GAC7B,uEAAuE,CAAC;AAE1E,MAAM,UAAU,sBAAsB;IACpC,OAAO;QACL,OAAO,EAAE,IAAI;QACb,IAAI,EAAE;YACJ,MAAM;YACN,KAAK;YACL,QAAQ;YACR,WAAW;YACX,QAAQ;YACR,IAAI;YACJ,gBAAgB;YAChB,kBAAkB;SACnB;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,WAAmB;IAC/D,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;IACzD,IAAI,MAAM,GAAoB,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;IAEjD,IAAI,MAAM,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9B,IAAI,CAAC;YACH,MAAM,GAAG,MAAM,QAAQ,CAAkB,OAAO,CAAC,CAAC;QACpD,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,GAAG,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;QACvB,MAAM,CAAC,UAAU,GAAG,EAAE,CAAC;IACzB,CAAC;IAED,MAAM,CAAC,UAAU,CAAC,QAAQ,GAAG,sBAAsB,EAAE,CAAC;IACtD,MAAM,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACjC,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-spector",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "Cursor-first documentation workflow: traceability graph, SRS/basic/detail design templates, and ai-spector CLI",
   "type": "module",
   "license": "MIT",

package/scaffold/.ai-spector/.docflow/config/analyze.graphify.json

@@ -3,6 +3,7 @@
   "graphify": {
     "indexPath": ".ai-spector/.docflow/graph/graphify-index",
     "outputPath": ".ai-spector/.docflow/graph/graphify-out",
+    "graphJsonPath": ".ai-spector/.docflow/graph/graphify-out/graph.json",
     "defaultDataSource": "docs/data-source",
     "include": [
       "docs/data-source"

package/scaffold/.cursor/commands/_workflow.md

@@ -11,7 +11,7 @@ npm install ai-spector
 npx ai-spector init
 ```
 
-Add source material under `docs/data-source/`, open the project in Cursor, and enable the **ai-spector** skill.
+Add source material under `docs/data-source/`, open the project in Cursor, **reload MCP** (Graphify is in `.cursor/mcp.json` from `init`), and enable the **ai-spector** skill.
 
 ## Day-to-day (slash commands only)
 

package/scaffold/.cursor/commands/analyze.md

@@ -29,10 +29,11 @@ Creates section/document nodes from templates. Do not ask the user to run this s
 ### A. Extract (Graphify MCP)
 
 1. Load `data-source.json`, `analyze.graphify.json`.
-2. **Graphify paths (mandatory):**
+2. **Graphify paths (mandatory — set by `ai-spector init` in `.cursor/mcp.json`):**
+   - MCP graph file: `.ai-spector/.docflow/graph/graphify-out/graph.json`
    - Index: `.ai-spector/.docflow/graph/graphify-index` (`graphify.indexPath`)
-   - Output: `.ai-spector/.docflow/graph/graphify-out` (`graphify.outputPath`)
-   - **Do not** write under `docs/data-source/graphify-out/` — that is not AI Spector’s store; if Graphify created it, treat as disposable scratch or move into `.ai-spector/.docflow/graph/`.
+   - Output dir: `.ai-spector/.docflow/graph/graphify-out` (`graphify.outputPath`)
+   - **Do not** use `docs/data-source/graphify-out/` — legacy Graphify default; delete or gitignore if present.
 3. Resolve paths → `scope.json` → `sources`.
 4. Build/update Graphify index for that scope.
 5. Query / fallback to extract:

package/scaffold/.cursor/mcp.json

@@ -0,0 +1,17 @@
+{
+  "mcpServers": {
+    "graphify": {
+      "command": "uv",
+      "args": [
+        "tool",
+        "run",
+        "--from",
+        "graphifyy",
+        "python",
+        "-m",
+        "graphify.serve",
+        "${workspaceFolder}/.ai-spector/.docflow/graph/graphify-out/graph.json"
+      ]
+    }
+  }
+}

package/scaffold/.cursor/skills/ai-spector/SKILL.md

@@ -7,6 +7,8 @@ description: "Cursor-first docs: user runs slash commands; agent runs CLI; on CL
 
 **Workflow:** `.cursor/commands/_workflow.md` — user only runs `npx ai-spector init` once, then slash commands.
 
+**Graphify MCP:** `init` configures `.cursor/mcp.json` → graph file at `.ai-spector/.docflow/graph/graphify-out/graph.json` (not `docs/data-source/graphify-out/`).
+
 ## CLI failure rule (non-negotiable)
 
 When `ai-spector` exits non-zero or required `--json` is missing/invalid:

package/scaffold/docs/data-source/README.md

@@ -13,6 +13,4 @@ If you see `docs/data-source/graphify-out/`, it was created by **Graphify MCP**
 | `.ai-spector/.docflow/graph/graphify-out` | Preferred Graphify output (see `analyze.graphify.json`) |
 | `.ai-spector/.docflow/analysis/knowledge.json` | **AI Spector staging** → merged into the traceability graph |
 
-You can **delete** `graphify-out/` under `docs/data-source/`; it is gitignored. The agent should write extract results to `knowledge.json`, not rely on that folder.
-
 Override inputs: `/analyze path/to/other-folder`