ai-spector 0.8.5 → 0.8.7

package/dist/interfaces/mcp/schemas.d.ts

@@ -82,6 +82,12 @@ export declare const DocsSearchSchema: z.ZodObject<{
     limit: z.ZodOptional<z.ZodNumber>;
     threshold: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
+export declare const CocoindexStatusSchema: z.ZodObject<{
+    root: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const CocoindexIndexSchema: z.ZodObject<{
+    root: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
 export declare const GraphQueryFuzzySchema: z.ZodObject<{
     root: z.ZodOptional<z.ZodString>;
     query: z.ZodString;
@@ -93,6 +99,27 @@ export declare const GraphQueryFuzzySchema: z.ZodObject<{
     depth: z.ZodOptional<z.ZodNumber>;
     threshold: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
+export declare const AnalyzeSchema: z.ZodObject<{
+    root: z.ZodOptional<z.ZodString>;
+    merge: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare const KnowledgeStatusSchema: z.ZodObject<{
+    root: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const KnowledgeValidateSchema: z.ZodObject<{
+    root: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const LangQueueSchema: z.ZodObject<{
+    root: z.ZodOptional<z.ZodString>;
+    lang: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    status: z.ZodOptional<z.ZodEnum<{
+        pending: "pending";
+        resolved: "resolved";
+        failed: "failed";
+        all: "all";
+    }>>;
+}, z.core.$strip>;
 export declare const TemplateListSchema: z.ZodObject<{
     root: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;

package/dist/interfaces/mcp/schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/interfaces/mcp/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,UAAU;;iBAErB,CAAC;AAIH,eAAO,MAAM,gBAAgB;;;;;;;;;;iBAW3B,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;iBAO5B,CAAC;AAEH,eAAO,MAAM,mBAAmB;;iBAAa,CAAC;AAE9C,eAAO,MAAM,gBAAgB;;;iBAK3B,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;;iBAK5B,CAAC;AAIH,eAAO,MAAM,WAAW;;;;;;;;iBAUtB,CAAC;AAIH,eAAO,MAAM,kBAAkB;;;;;;;;iBAM7B,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;;;iBAM9B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;iBAG7B,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;iBAKhC,CAAC;AAIH,eAAO,MAAM,gBAAgB;;;;;iBAe3B,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;;;;;iBAahC,CAAC;AAIH,eAAO,MAAM,kBAAkB;;iBAAa,CAAC;AAE7C,eAAO,MAAM,qBAAqB;;;iBAEhC,CAAC"}
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/interfaces/mcp/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,UAAU;;iBAErB,CAAC;AAIH,eAAO,MAAM,gBAAgB;;;;;;;;;;iBAW3B,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;iBAO5B,CAAC;AAEH,eAAO,MAAM,mBAAmB;;iBAAa,CAAC;AAE9C,eAAO,MAAM,gBAAgB;;;iBAK3B,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;;iBAK5B,CAAC;AAIH,eAAO,MAAM,WAAW;;;;;;;;iBAUtB,CAAC;AAIH,eAAO,MAAM,kBAAkB;;;;;;;;iBAM7B,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;;;iBAM9B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;iBAG7B,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;iBAKhC,CAAC;AAIH,eAAO,MAAM,gBAAgB;;;;;iBAe3B,CAAC;AAEH,eAAO,MAAM,qBAAqB;;iBAAa,CAAC;AAEhD,eAAO,MAAM,oBAAoB;;iBAAa,CAAC;AAE/C,eAAO,MAAM,qBAAqB;;;;;;;;;;iBAahC,CAAC;AAIH,eAAO,MAAM,aAAa;;;iBAKxB,CAAC;AAEH,eAAO,MAAM,qBAAqB;;iBAAa,CAAC;AAEhD,eAAO,MAAM,uBAAuB;;iBAAa,CAAC;AAIlD,eAAO,MAAM,eAAe;;;;;;;;;;iBAO1B,CAAC;AAIH,eAAO,MAAM,kBAAkB;;iBAAa,CAAC;AAE7C,eAAO,MAAM,qBAAqB;;;iBAEhC,CAAC"}

package/dist/interfaces/mcp/schemas.js

@@ -91,6 +91,8 @@ export const DocsSearchSchema = RootSchema.extend({
         .optional()
         .describe("Minimum similarity score 0–1 (default: 0.75)"),
 });
+export const CocoindexStatusSchema = RootSchema;
+export const CocoindexIndexSchema = RootSchema;
 export const GraphQueryFuzzySchema = RootSchema.extend({
     query: z.string().describe("Natural language description of the graph node to find"),
     direction: z
@@ -105,6 +107,24 @@ export const GraphQueryFuzzySchema = RootSchema.extend({
         .optional()
         .describe("Minimum similarity score for node resolution (default: 0.75)"),
 });
+// ── Analyze / Knowledge ───────────────────────────────────────────────────────
+export const AnalyzeSchema = RootSchema.extend({
+    merge: z
+        .boolean()
+        .optional()
+        .describe("Also merge knowledge.json into graph after prep (if knowledge.json exists)"),
+});
+export const KnowledgeStatusSchema = RootSchema;
+export const KnowledgeValidateSchema = RootSchema;
+// ── Lang queue ────────────────────────────────────────────────────────────────
+export const LangQueueSchema = RootSchema.extend({
+    lang: z.string().optional().describe("Filter by language code (e.g. 'jp', 'vi')"),
+    limit: z.number().int().min(1).optional().describe("Max pending jobs to return (default: all)"),
+    status: z
+        .enum(["pending", "failed", "resolved", "all"])
+        .optional()
+        .describe("Which queue to read (default: pending)"),
+});
 // ── Template ──────────────────────────────────────────────────────────────────
 export const TemplateListSchema = RootSchema;
 export const TemplateInspectSchema = RootSchema.extend({

package/dist/interfaces/mcp/schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../src/interfaces/mcp/schemas.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../src/interfaces/mcp/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,iFAAiF;AAEjF,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mDAAmD,CAAC;CAC1F,CAAC,CAAC;AAEH,iFAAiF;AAEjF,MAAM,CAAC,MAAM,gBAAgB,GAAG,UAAU,CAAC,MAAM,CAAC;IAChD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;IAClE,SAAS,EAAE,CAAC;SACT,IAAI,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;SAC3B,QAAQ,EAAE;SACV,QAAQ,CAAC,yCAAyC,CAAC;IACtD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;IACtF,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,oEAAoE,CAAC;CAClF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG,UAAU,CAAC,MAAM,CAAC;IACjD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;IACnE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;IAChF,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;IACxE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;IAC1E,GAAG,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;IAC1E,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;CAChF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAG,UAAU,CAAC;AAE9C,MAAM,CAAC,MAAM,gBAAgB,GAAG,UAAU,CAAC,MAAM,CAAC;IAChD,aAAa,EAAE,CAAC;SACb,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CAAC,gDAAgD,CAAC;CAC9D,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG,UAAU,CAAC,MAAM,CAAC;IACjD,MAAM,EAAE,CAAC;SACN,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;SAClC,QAAQ,EAAE;SACV,QAAQ,CAAC,+BAA+B,CAAC;CAC7C,CAAC,CAAC;AAEH,iFAAiF;AAEjF,MAAM,CAAC,MAAM,WAAW,GAAG,UAAU,CAAC,MAAM,CAAC;IAC3C,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;IAClF,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;IACjF,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;IAC5E,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;IAC3E,gBAAgB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;IAClF,aAAa,EAAE,CAAC;SACb,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CAAC,uFAAuF,CAAC;CACrG,CAAC,CAAC;AAEH,iFAAiF;AAEjF,MAAM,CAAC,MAAM,kBAAkB,GAAG,UAAU,CAAC,MAAM,CAAC;IAClD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC;IAC/D,MAAM,EAAE,CAAC;SACN,IAAI,CAAC,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;SACjC,QAAQ,EAAE;SACV,QAAQ,CAAC,kCAAkC,CAAC;CAChD,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAG,UAAU,CAAC,MAAM,CAAC;IACnD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC;IAC/D,MAAM,EAAE,CAAC;SACN,IAAI,CAAC,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;SACjC,QAAQ,EAAE;SACV,QAAQ,CAAC,kCAAkC,CAAC;CAChD,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAG,UAAU,CAAC,MAAM,CAAC;IAClD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;IAClD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC;CAC5D,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAG,UAAU,CAAC,MAAM,CAAC;IACrD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;IAC7D,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;IACrE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;IAChF,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;CAC9E,CAAC,CAAC;AAEH,iFAAiF;AAEjF,MAAM,CAAC,MAAM,gBAAgB,GAAG,UAAU,CAAC,MAAM,CAAC;IAChD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iDAAiD,CAAC;IAC7E,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,EAAE,CAAC;SACP,QAAQ,EAAE;SACV,QAAQ,CAAC,oCAAoC,CAAC;IACjD,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,EAAE;SACV,QAAQ,CAAC,8CAA8C,CAAC;CAC5D,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAG,UAAU,CAAC;AAEhD,MAAM,CAAC,MAAM,oBAAoB,GAAG,UAAU,CAAC;AAE/C,MAAM,CAAC,MAAM,qBAAqB,GAAG,UAAU,CAAC,MAAM,CAAC;IACrD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wDAAwD,CAAC;IACpF,SAAS,EAAE,CAAC;SACT,IAAI,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;SAC3B,QAAQ,EAAE;SACV,QAAQ,CAAC,+DAA+D,CAAC;IAC5E,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;IACtF,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,EAAE;SACV,QAAQ,CAAC,8DAA8D,CAAC;CAC5E,CAAC,CAAC;AAEH,iFAAiF;AAEjF,MAAM,CAAC,MAAM,aAAa,GAAG,UAAU,CAAC,MAAM,CAAC;IAC7C,KAAK,EAAE,CAAC;SACL,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CAAC,4EAA4E,CAAC;CAC1F,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAG,UAAU,CAAC;AAEhD,MAAM,CAAC,MAAM,uBAAuB,GAAG,UAAU,CAAC;AAElD,iFAAiF;AAEjF,MAAM,CAAC,MAAM,eAAe,GAAG,UAAU,CAAC,MAAM,CAAC;IAC/C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;IACjF,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;IAC/F,MAAM,EAAE,CAAC;SACN,IAAI,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;SAC9C,QAAQ,EAAE;SACV,QAAQ,CAAC,wCAAwC,CAAC;CACtD,CAAC,CAAC;AAEH,iFAAiF;AAEjF,MAAM,CAAC,MAAM,kBAAkB,GAAG,UAAU,CAAC;AAE7C,MAAM,CAAC,MAAM,qBAAqB,GAAG,UAAU,CAAC,MAAM,CAAC;IACrD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;CAClD,CAAC,CAAC"}

package/dist/interfaces/mcp/server.js

@@ -2,12 +2,14 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { createRequire } from "node:module";
-import { GraphQuerySchema, GraphImpactSchema, GraphValidateSchema, GraphMergeSchema, IndexSchema, CommentsListSchema, CommentsInboxSchema, CommentsShowSchema, CommentsResolveSchema, TemplateListSchema, TemplateInspectSchema, DocsSearchSchema, GraphQueryFuzzySchema, } from "./schemas.js";
-import { toolGraphQuery, toolGraphImpact, toolGraphValidate, toolGraphMerge } from "./tools/graph.js";
+import { GraphQuerySchema, GraphImpactSchema, GraphValidateSchema, GraphMergeSchema, GraphReportSchema, IndexSchema, AnalyzeSchema, KnowledgeStatusSchema, KnowledgeValidateSchema, LangQueueSchema, CommentsListSchema, CommentsInboxSchema, CommentsShowSchema, CommentsResolveSchema, TemplateListSchema, TemplateInspectSchema, DocsSearchSchema, GraphQueryFuzzySchema, CocoindexStatusSchema, CocoindexIndexSchema, } from "./schemas.js";
+import { toolGraphQuery, toolGraphImpact, toolGraphValidate, toolGraphMerge, toolGraphReport } from "./tools/graph.js";
+import { toolAnalyze, toolKnowledgeStatus, toolKnowledgeValidate } from "./tools/analyze.js";
+import { toolLangQueue } from "./tools/lang.js";
 import { toolIndex } from "./tools/index.js";
 import { toolCommentsList, toolCommentsInbox, toolCommentsShow, toolCommentsResolve, } from "./tools/comments.js";
 import { toolTemplateList, toolTemplateInspect } from "./tools/template.js";
-import { toolDocsSearch, toolGraphQueryFuzzy } from "./tools/cocoindex.js";
+import { toolDocsSearch, toolGraphQueryFuzzy, toolCocoindexStatus, toolCocoindexIndex } from "./tools/cocoindex.js";
 const require = createRequire(import.meta.url);
 const pkg = require("../../../package.json");
 const server = new McpServer({
@@ -43,6 +45,43 @@ server.registerTool("graph_merge", {
     const result = await toolGraphMerge(input);
     return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
 });
+server.registerTool("graph_report", {
+    description: "Audit graph layer health — returns provenance coverage, hub completeness, empty domain layers, and missing traceability links",
+    inputSchema: GraphReportSchema.shape,
+}, async (input) => {
+    const result = await toolGraphReport(input);
+    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+});
+// ── Analyze / Knowledge tools ─────────────────────────────────────────────────
+server.registerTool("analyze", {
+    description: "Prepare graph scaffold from project templates — creates section/document nodes and writes the section registry. Run before entity extraction. Replaces `npx ai-spector analyze` for the structure-prep step.",
+    inputSchema: AnalyzeSchema.shape,
+}, async (input) => {
+    const result = await toolAnalyze(input);
+    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+});
+server.registerTool("knowledge_status", {
+    description: "Check whether knowledge.json is present and report entity counts (actors, useCases, features, …). Use before graph_merge to confirm extraction is complete.",
+    inputSchema: KnowledgeStatusSchema.shape,
+}, async (input) => {
+    const result = await toolKnowledgeStatus(input);
+    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+});
+server.registerTool("knowledge_validate", {
+    description: "Validate knowledge.json against schema.knowledge.json and return any errors or warnings. Run after entity extraction and before graph_merge.",
+    inputSchema: KnowledgeValidateSchema.shape,
+}, async (input) => {
+    const result = await toolKnowledgeValidate(input);
+    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+});
+// ── Lang queue tool ───────────────────────────────────────────────────────────
+server.registerTool("lang_queue", {
+    description: "Read the translation queue — returns pending/failed/resolved jobs and summary counts. Use after doc edits or before starting translation work to see what needs updating.",
+    inputSchema: LangQueueSchema.shape,
+}, async (input) => {
+    const result = await toolLangQueue(input);
+    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+});
 // ── Index tool ────────────────────────────────────────────────────────────────
 server.registerTool("index", {
     description: "Re-index the project: rebuild graph structure, merge knowledge, build doc indexes",
@@ -96,6 +135,20 @@ server.registerTool("template_inspect", {
     return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
 });
 // ── CocoIndex tools ───────────────────────────────────────────────────────────
+server.registerTool("cocoindex_status", {
+    description: "Check whether CocoIndex is configured and ready: Python version, dependencies installed, index built. Use to diagnose why cocoindexSync was skipped or docs_search returned no results.",
+    inputSchema: CocoindexStatusSchema.shape,
+}, async (input) => {
+    const result = await toolCocoindexStatus(input);
+    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+});
+server.registerTool("cocoindex_index", {
+    description: "Run the CocoIndex pipeline update — rebuilds semantic embeddings from project docs. Call after adding or editing doc files. Equivalent to `npx ai-spector cocoindex index`.",
+    inputSchema: CocoindexIndexSchema.shape,
+}, async (input) => {
+    const result = await toolCocoindexIndex(input);
+    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+});
 server.registerTool("docs_search", {
     description: "Semantic search over project documentation. Returns matching sections with similarity scores and traceability graph node IDs. Requires CocoIndex to be set up (npx ai-spector cocoindex setup).",
     inputSchema: DocsSearchSchema.shape,

package/dist/interfaces/mcp/server.js.map

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

package/dist/interfaces/mcp/tools/analyze.d.ts

@@ -0,0 +1,47 @@
+import type { AnalyzeSchema, KnowledgeStatusSchema, KnowledgeValidateSchema } from "../schemas.js";
+import type { z } from "zod";
+export declare function toolAnalyze(input: z.infer<typeof AnalyzeSchema>): Promise<import("../../../core/operations/analyze.js").AnalyzePrepResult>;
+export declare function toolKnowledgeStatus(input: z.infer<typeof KnowledgeStatusSchema>): Promise<{
+    ready: boolean;
+    knowledgeExists: boolean;
+    gapsExists: boolean;
+    scopeExists: boolean;
+    message: string;
+    lastModified?: undefined;
+    entityCounts?: undefined;
+    totalEntities?: undefined;
+} | {
+    ready: boolean;
+    knowledgeExists: boolean;
+    gapsExists: boolean;
+    scopeExists: boolean;
+    lastModified: string;
+    entityCounts: {
+        actors: number;
+        useCases: number;
+        features: number;
+        functionalRequirements: number;
+        nonFunctionalRequirements: number;
+        dataEntities: number;
+    };
+    totalEntities: number;
+    message: string;
+}>;
+export declare function toolKnowledgeValidate(input: z.infer<typeof KnowledgeValidateSchema>): Promise<{
+    valid: boolean;
+    errors: {
+        message: string;
+        path: string;
+    }[];
+    warnings: never[];
+    knowledgePath?: undefined;
+} | {
+    valid: boolean;
+    errors: {
+        path: string;
+        message: string;
+    }[];
+    warnings: never[];
+    knowledgePath: string;
+}>;
+//# sourceMappingURL=analyze.d.ts.map

package/dist/interfaces/mcp/tools/analyze.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze.d.ts","sourceRoot":"","sources":["../../../../src/interfaces/mcp/tools/analyze.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACnG,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAI7B,wBAAsB,WAAW,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,4EAGrE;AAaD,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;GAmDrF;AAID,wBAAsB,qBAAqB,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC;;;;;;;;;;;;;;;;GAyCzF"}

package/dist/interfaces/mcp/tools/analyze.js

@@ -0,0 +1,94 @@
+import { join } from "node:path";
+import { loadDocflowConfig } from "../../../core/config/load.js";
+import { runAnalyzePrep } from "../../../core/operations/analyze.js";
+import { pathExists, readJson } from "../../../core/util/fs.js";
+import { packageBundleRoot } from "../../../core/config/load.js";
+// ── analyze ───────────────────────────────────────────────────────────────────
+export async function toolAnalyze(input) {
+    const result = await runAnalyzePrep(input.root, { merge: input.merge });
+    return result;
+}
+export async function toolKnowledgeStatus(input) {
+    const { root: projectRoot } = await loadDocflowConfig(input.root);
+    const analysisDir = join(projectRoot, ".ai-spector/.docflow/analysis");
+    const knowledgePath = join(analysisDir, "knowledge.json");
+    const gapsPath = join(analysisDir, "gaps.json");
+    const scopePath = join(analysisDir, "scope.json");
+    const [knowledgeExists, gapsExists, scopeExists] = await Promise.all([
+        pathExists(knowledgePath),
+        pathExists(gapsPath),
+        pathExists(scopePath),
+    ]);
+    if (!knowledgeExists) {
+        return {
+            ready: false,
+            knowledgeExists: false,
+            gapsExists,
+            scopeExists,
+            message: "knowledge.json not found — run 'analyze' to extract entities from data-source",
+        };
+    }
+    const [knowledge, knowledgeStat] = await Promise.all([
+        readJson(knowledgePath),
+        import("node:fs/promises").then((fs) => fs.stat(knowledgePath)),
+    ]);
+    const counts = {
+        actors: knowledge.actors?.length ?? 0,
+        useCases: knowledge.useCases?.length ?? 0,
+        features: knowledge.features?.length ?? 0,
+        functionalRequirements: knowledge.functionalRequirements?.length ?? 0,
+        nonFunctionalRequirements: knowledge.nonFunctionalRequirements?.length ?? 0,
+        dataEntities: knowledge.dataEntities?.length ?? 0,
+    };
+    const total = Object.values(counts).reduce((a, b) => a + b, 0);
+    return {
+        ready: total > 0,
+        knowledgeExists: true,
+        gapsExists,
+        scopeExists,
+        lastModified: knowledgeStat.mtime.toISOString(),
+        entityCounts: counts,
+        totalEntities: total,
+        message: total === 0
+            ? "knowledge.json exists but contains no entities — re-run analysis"
+            : `${total} entities ready to merge`,
+    };
+}
+// ── knowledge_validate ────────────────────────────────────────────────────────
+export async function toolKnowledgeValidate(input) {
+    const { root: projectRoot } = await loadDocflowConfig(input.root);
+    const knowledgePath = join(projectRoot, ".ai-spector/.docflow/analysis/knowledge.json");
+    if (!(await pathExists(knowledgePath))) {
+        return {
+            valid: false,
+            errors: [{ message: "knowledge.json not found", path: knowledgePath }],
+            warnings: [],
+        };
+    }
+    const { createRequire } = await import("node:module");
+    const _require = createRequire(import.meta.url);
+    const Ajv = _require("ajv/dist/2020.js");
+    const addFormats = _require("ajv-formats");
+    const schemaPath = join(packageBundleRoot(), "schemas/schema.knowledge.json");
+    const [knowledge, schema] = await Promise.all([
+        readJson(knowledgePath),
+        readJson(schemaPath),
+    ]);
+    const ajv = new Ajv({ allErrors: true, strict: false });
+    addFormats(ajv);
+    const validateFn = ajv.compile(schema);
+    const valid = validateFn(knowledge);
+    const errors = valid
+        ? []
+        : (validateFn.errors ?? []).map((e) => ({
+            path: e.instancePath || "/",
+            message: e.message ?? "unknown error",
+        }));
+    return {
+        valid,
+        errors,
+        warnings: [],
+        knowledgePath,
+    };
+}
+//# sourceMappingURL=analyze.js.map

package/dist/interfaces/mcp/tools/analyze.js.map

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

package/dist/interfaces/mcp/tools/cocoindex.d.ts

@@ -1,9 +1,32 @@
-import type { DocsSearchSchema, GraphQueryFuzzySchema } from "../schemas.js";
+import type { DocsSearchSchema, GraphQueryFuzzySchema, CocoindexStatusSchema, CocoindexIndexSchema } from "../schemas.js";
 import type { z } from "zod";
 export declare function toolDocsSearch(input: z.infer<typeof DocsSearchSchema>): Promise<import("../../../core/operations/cocoindex.js").CocoindexSearchResult | {
     error: string;
     cocoindexConfigured: boolean;
 }>;
+export declare function toolCocoindexStatus(input: z.infer<typeof CocoindexStatusSchema>): Promise<{
+    configured: boolean;
+    message: string;
+    pythonBin?: undefined;
+    pythonVersion?: undefined;
+    depsInstalled?: undefined;
+    indexed?: undefined;
+    ready?: undefined;
+    issues?: undefined;
+} | {
+    configured: boolean;
+    pythonBin: string | null;
+    pythonVersion: string | null;
+    depsInstalled: boolean;
+    indexed: boolean;
+    ready: boolean;
+    issues: string[];
+    message?: undefined;
+}>;
+export declare function toolCocoindexIndex(input: z.infer<typeof CocoindexIndexSchema>): Promise<{
+    updated: boolean;
+    output: string;
+}>;
 export declare function toolGraphQueryFuzzy(input: z.infer<typeof GraphQueryFuzzySchema>): Promise<import("../../../core/operations/cocoindex.js").FuzzyQueryResult | {
     error: string;
     cocoindexConfigured: boolean;

package/dist/interfaces/mcp/tools/cocoindex.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cocoindex.d.ts","sourceRoot":"","sources":["../../../../src/interfaces/mcp/tools/cocoindex.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAC7E,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,wBAAsB,cAAc,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC;;;GAmB3E;AAED,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC;;;;;;GAsBrF"}
+{"version":3,"file":"cocoindex.d.ts","sourceRoot":"","sources":["../../../../src/interfaces/mcp/tools/cocoindex.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EACV,gBAAgB,EAChB,qBAAqB,EACrB,qBAAqB,EACrB,oBAAoB,EACrB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,wBAAsB,cAAc,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC;;;GAmB3E;AAED,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC;;;;;;;;;;;;;;;;;;GA0BrF;AAED,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC;;;GAiCnF;AAED,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC;;;;;;GAsBrF"}

package/dist/interfaces/mcp/tools/cocoindex.js

@@ -1,4 +1,6 @@
-import { runCocoindexSearch, runGraphQueryFuzzy, isCocoindexConfigured, } from "../../../core/operations/cocoindex.js";
+import { join } from "node:path";
+import { runCocoindexSearch, runGraphQueryFuzzy, isCocoindexConfigured, checkCocoindexReadiness, cocoindexDir, cocoindexPipelinePath, findPython, } from "../../../core/operations/cocoindex.js";
+import { loadDocflowConfig } from "../../../core/config/load.js";
 export async function toolDocsSearch(input) {
     const root = input.root;
     const configured = await isCocoindexConfigured(root ?? process.cwd());
@@ -16,6 +18,65 @@ export async function toolDocsSearch(input) {
     });
     return result;
 }
+export async function toolCocoindexStatus(input) {
+    const { root: projectRoot } = await loadDocflowConfig(input.root);
+    const readiness = await checkCocoindexReadiness(projectRoot);
+    if (!readiness.configured) {
+        return {
+            configured: false,
+            message: "CocoIndex not set up. Run: npx ai-spector cocoindex setup",
+        };
+    }
+    const issues = [];
+    if (!readiness.pythonBin)
+        issues.push("Python not found (need Python 3.11+)");
+    else if (!readiness.pythonVersion)
+        issues.push("Could not determine Python version");
+    if (!readiness.depsInstalled)
+        issues.push("Dependencies not installed — run: npx ai-spector cocoindex setup");
+    if (!readiness.indexed)
+        issues.push("Index not built yet — run: cocoindex_index or npx ai-spector cocoindex index");
+    return {
+        configured: true,
+        pythonBin: readiness.pythonBin,
+        pythonVersion: readiness.pythonVersion,
+        depsInstalled: readiness.depsInstalled,
+        indexed: readiness.indexed,
+        ready: issues.length === 0,
+        issues,
+    };
+}
+export async function toolCocoindexIndex(input) {
+    const { root: projectRoot } = await loadDocflowConfig(input.root);
+    const readiness = await checkCocoindexReadiness(projectRoot);
+    if (!readiness.configured) {
+        throw new Error("CocoIndex not set up. Run: npx ai-spector cocoindex setup");
+    }
+    if (!readiness.depsInstalled) {
+        throw new Error("CocoIndex dependencies not installed. Run: npx ai-spector cocoindex setup");
+    }
+    const cocoDir = cocoindexDir(projectRoot);
+    const pipelinePath = cocoindexPipelinePath(projectRoot);
+    const pythonBin = await findPython(cocoDir);
+    const { execFile } = await import("node:child_process");
+    const { promisify } = await import("node:util");
+    const exec = promisify(execFile);
+    try {
+        const { stdout, stderr } = await exec(pythonBin, [pipelinePath, "update"], {
+            cwd: cocoDir,
+            env: {
+                ...process.env,
+                AI_SPECTOR_ROOT: projectRoot,
+                COCOINDEX_DB: join(cocoDir, "cocoindex_state"),
+            },
+        });
+        return { updated: true, output: stdout || stderr || "Index updated." };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        throw new Error(`CocoIndex update failed: ${msg}`);
+    }
+}
 export async function toolGraphQueryFuzzy(input) {
     const configured = await isCocoindexConfigured(input.root ?? process.cwd());
     if (!configured) {

package/dist/interfaces/mcp/tools/cocoindex.js.map

@@ -1 +1 @@
-{"version":3,"file":"cocoindex.js","sourceRoot":"","sources":["../../../../src/interfaces/mcp/tools/cocoindex.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,uCAAuC,CAAC;AAI/C,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,KAAuC;IAC1E,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;IACxB,MAAM,UAAU,GAAG,MAAM,qBAAqB,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAEtE,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO;YACL,KAAK,EAAE,2DAA2D;YAClE,mBAAmB,EAAE,KAAK;SAC3B,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC;QACtC,IAAI;QACJ,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,SAAS,EAAE,KAAK,CAAC,SAAS;KAC3B,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,KAA4C;IACpF,MAAM,UAAU,GAAG,MAAM,qBAAqB,CAAC,KAAK,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAE5E,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO;YACL,KAAK,EAAE,2DAA2D;YAClE,mBAAmB,EAAE,KAAK;SAC3B,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC;YACtC,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,SAAS,EAAE,KAAK,CAAC,SAAS;SAC3B,CAAC,CAAC;QACH,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,EAAE,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;IACrE,CAAC;AACH,CAAC"}
+{"version":3,"file":"cocoindex.js","sourceRoot":"","sources":["../../../../src/interfaces/mcp/tools/cocoindex.ts"],"names":[],"mappings":"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"}

package/dist/interfaces/mcp/tools/graph.d.ts

@@ -1,4 +1,4 @@
-import type { GraphQuerySchema, GraphImpactSchema, GraphValidateSchema, GraphMergeSchema } from "../schemas.js";
+import type { GraphQuerySchema, GraphImpactSchema, GraphValidateSchema, GraphMergeSchema, GraphReportSchema } from "../schemas.js";
 import type { z } from "zod";
 export declare function toolGraphQuery(input: z.infer<typeof GraphQuerySchema>): Promise<import("../../../core/graph/query.js").GraphQueryResult>;
 export declare function toolGraphImpact(input: z.infer<typeof GraphImpactSchema>): Promise<import("../../../core/graph/impact.js").ImpactResult | {
@@ -21,4 +21,5 @@ export declare function toolGraphValidate(input: z.infer<typeof GraphValidateSch
 export declare function toolGraphMerge(input: z.infer<typeof GraphMergeSchema>): Promise<{
     merged: boolean;
 }>;
+export declare function toolGraphReport(input: z.infer<typeof GraphReportSchema>): Promise<import("../../sdk/index.js").LayerAuditReport>;
 //# sourceMappingURL=graph.d.ts.map

package/dist/interfaces/mcp/tools/graph.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../../../src/interfaces/mcp/tools/graph.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EACjB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,wBAAsB,cAAc,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,oEAyB3E;AAED,wBAAsB,eAAe,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC;;;;;;;;;;;GA0C7E;AAED,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC;;;;GAWjF;AAED,wBAAsB,cAAc,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC;;GAS3E"}
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../../../src/interfaces/mcp/tools/graph.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,wBAAsB,cAAc,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,oEAyB3E;AAED,wBAAsB,eAAe,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC;;;;;;;;;;;GA0C7E;AAED,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC;;;;GAWjF;AAED,wBAAsB,cAAc,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC;;GAS3E;AAED,wBAAsB,eAAe,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,0DAE7E"}

package/dist/interfaces/mcp/tools/graph.js

@@ -6,6 +6,7 @@ import { resolveImpactOrigins, pickPrimaryImpactOrigin, resolveFromGitDiff, pars
 import { collectGitDiff } from "../../../core/util/git-diff.js";
 import { validateGraph } from "../../../core/operations/validate.js";
 import { runGraphMerge } from "../../../core/operations/graph-merge.js";
+import { runGraphReport } from "../../../core/operations/graph-report.js";
 export async function toolGraphQuery(input) {
     const paths = await resolveProjectPaths(input.root);
     const g = await loadInMemoryGraph(paths.graph);
@@ -84,4 +85,7 @@ export async function toolGraphMerge(input) {
     });
     return { merged: true };
 }
+export async function toolGraphReport(input) {
+    return runGraphReport({ root: input.root });
+}
 //# sourceMappingURL=graph.js.map

package/dist/interfaces/mcp/tools/graph.js.map

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

package/dist/interfaces/mcp/tools/lang.d.ts

@@ -0,0 +1,21 @@
+import type { LangQueueSchema } from "../schemas.js";
+import type { z } from "zod";
+export declare function toolLangQueue(input: z.infer<typeof LangQueueSchema>): Promise<{
+    skipped: boolean;
+    skipReason: string | undefined;
+    jobs: never[];
+    summary?: undefined;
+    status?: undefined;
+} | {
+    skipped: boolean;
+    summary: {
+        pending: number;
+        enqueued: number;
+        resolved: number;
+        failed: number;
+    };
+    status: "pending" | "resolved" | "failed" | "all";
+    jobs: unknown[];
+    skipReason?: undefined;
+}>;
+//# sourceMappingURL=lang.d.ts.map

package/dist/interfaces/mcp/tools/lang.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lang.d.ts","sourceRoot":"","sources":["../../../../src/interfaces/mcp/tools/lang.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,wBAAsB,aAAa,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC;;;;;;;;;;;;;;;;;GA+BzE"}

package/dist/interfaces/mcp/tools/lang.js

@@ -0,0 +1,31 @@
+import { runLangQueueScan, runLangQueuePending, runLangQueueFailed, runLangQueueResolved, } from "../../../core/operations/lang-queue.js";
+export async function toolLangQueue(input) {
+    const opts = { root: input.root, lang: input.lang, limit: input.limit };
+    const status = input.status ?? "pending";
+    const scan = await runLangQueueScan(opts);
+    if (scan.skipped) {
+        return { skipped: true, skipReason: scan.skipReason, jobs: [] };
+    }
+    let jobs = [];
+    if (status === "pending" || status === "all") {
+        jobs = [...jobs, ...(await runLangQueuePending(opts))];
+    }
+    if (status === "failed" || status === "all") {
+        jobs = [...jobs, ...(await runLangQueueFailed(opts))];
+    }
+    if (status === "resolved" || status === "all") {
+        jobs = [...jobs, ...(await runLangQueueResolved(opts))];
+    }
+    return {
+        skipped: false,
+        summary: {
+            pending: scan.pendingCount ?? 0,
+            enqueued: scan.enqueued ?? 0,
+            resolved: scan.resolved ?? 0,
+            failed: scan.failed ?? 0,
+        },
+        status,
+        jobs,
+    };
+}
+//# sourceMappingURL=lang.js.map

package/dist/interfaces/mcp/tools/lang.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lang.js","sourceRoot":"","sources":["../../../../src/interfaces/mcp/tools/lang.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,wCAAwC,CAAC;AAIhD,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,KAAsC;IACxE,MAAM,IAAI,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC;IACxE,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,SAAS,CAAC;IAEzC,MAAM,IAAI,GAAG,MAAM,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAC1C,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;IAClE,CAAC;IAED,IAAI,IAAI,GAAc,EAAE,CAAC;IACzB,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;QAC7C,IAAI,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,CAAC,MAAM,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACzD,CAAC;IACD,IAAI,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;QAC5C,IAAI,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,CAAC,MAAM,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACxD,CAAC;IACD,IAAI,MAAM,KAAK,UAAU,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;QAC9C,IAAI,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,CAAC,MAAM,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC1D,CAAC;IAED,OAAO;QACL,OAAO,EAAE,KAAK;QACd,OAAO,EAAE;YACP,OAAO,EAAE,IAAI,CAAC,YAAY,IAAI,CAAC;YAC/B,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,CAAC;YAC5B,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,CAAC;YAC5B,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,CAAC;SACzB;QACD,MAAM;QACN,IAAI;KACL,CAAC;AACJ,CAAC"}

package/package.json

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

package/scaffold/claude/.claude/skills/ai-spector-graph/skill.md

@@ -13,86 +13,88 @@ description: "Runs AI Spector traceability graph operations: analyze data-source
 - "what's the impact of my changes", "what should I regenerate"
 - "visualize the graph"
 
-## Workflow
+## Invocation rule
 
-```
-1. Identify intent → pick runbook below
-2. Run CLI from project root (npx ai-spector)
-3. On failure: show output, offer fix/workaround/pause
-4. If the tool or workflow caused friction (even if recovered): offer to write a feedback report to docs/feedback/
-```
+Use **MCP tools** when `ai-spector` server is configured. CLI is fallback only.
 
 ## Runbooks by intent
 
 ### Analyze (ingest data-source)
 
-```bash
-npx ai-spector analyze
+```
+analyze({})                              # MCP — prepare graph scaffold
+# agent extracts entities → writes knowledge.json
+knowledge_validate({})                   # MCP — validate before merge
+knowledge_status({})                     # MCP — confirm entity counts
+graph_merge({ fromKnowledge: true })     # MCP — commit to graph
+graph_validate({})                       # MCP — verify result
 ```
 
-Reads `docs/data-source/`, builds knowledge graph, writes `.ai-spector/graph/`. Run after adding or changing source files.
+CLI fallback: `npx ai-spector analyze` → `npx ai-spector graph merge --from-knowledge` → `npx ai-spector graph validate`
 
 ### Index (refresh after doc edits)
 
-```bash
-npx ai-spector index
 ```
+index({ cocoindexSync: true })           # MCP — refresh graph + embeddings
+```
+
+CLI fallback: `npx ai-spector index && npx ai-spector cocoindex index`
 
-Updates fingerprints, reconciles translation queue. Run after any doc edit. **Always run index before checking translation status.**
+**Always run index before checking translation status.**
 
 ### Validate
 
-```bash
-npx ai-spector graph validate
+```
+graph_validate({})                       # MCP
+graph_report({})                         # MCP — layer health audit
 ```
 
-Reports broken references, missing nodes, DAG errors. Fix errors before generating docs.
+CLI fallback: `npx ai-spector graph validate`
 
 ### Impact (what to regenerate)
 
-```bash
-# Current git diff (most common)
-npx ai-spector graph impact --git --change content_change --json
-
-# Specific file
-npx ai-spector graph impact --file <repo-relative-path> --json
-
-# Specific node
-npx ai-spector graph impact <originId> --change content_change --json
+```
+graph_impact({ git: true, change: "content_change" })        # git diff
+graph_impact({ originId: "<id>", change: "content_change" }) # specific node
+graph_impact({ file: "<path>", change: "content_change" })   # specific file
 ```
 
-Output buckets: `regenerate` (must redo), `review` (may need update).
-- `noTraceabilityImpact: true` → changed files not in graph (config, source code, etc.) — no doc regen needed
-- `truncated: true` → BFS hit propagation cap — results may be incomplete, warn user
+CLI fallback: `npx ai-spector graph impact --git --change content_change --json`
 
-Report the table with `projectionPath`. For each `regenerate` entry, suggest the appropriate generate skill.
+Output buckets: `regenerate` (must redo), `review` (may need update), `semanticSuggestions` (CocoIndex).
+- `noTraceabilityImpact: true` → changed files not in graph — no doc regen needed
+- `truncated: true` → BFS hit cap — results may be incomplete, warn user
 
-**Run this after every doc edit**, then run `npx ai-spector index`.
+**Run after every doc edit**, then `index({ cocoindexSync: true })`.
 
-### Visualize
+### Query a node
 
-```bash
-npx ai-spector graph visualize --open
+```
+graph_query({ seedId: "<id>" })          # MCP — walk subgraph
+graph_query_fuzzy({ query: "…" })       # MCP — natural language lookup
 ```
 
-### Query a node
+CLI fallback: `npx ai-spector graph query <id> --json`
+
+### Visualize
 
 ```bash
-npx ai-spector graph query <id-or-text> --json
+npx ai-spector graph visualize --open    # CLI only — no MCP equivalent
 ```
 
 ## Checklist
 
 ```
 - [ ] Identified correct runbook
-- [ ] Ran CLI from project root
+- [ ] Used MCP tools (not CLI) when ai-spector server is configured
+- [ ] After doc edits: graph_impact + index({ cocoindexSync: true })
 - [ ] Presented output to user (impact table, validate errors, etc.)
-- [ ] After doc edits: ran impact + index
 - [ ] On failure: showed output, offered fix/workaround
 ```
 
 ## Rules
 
-- Do not implement impact BFS manually — always use CLI
-- Do not invent regen lists if impact CLI failed
-- Do not run whole-repo regen outside CLI buckets
+- Do not implement impact BFS manually — always use MCP or CLI tool
+- Do not invent regen lists if impact tool failed
+- Do not run whole-repo regen outside tool buckets
+- Never skip `cocoindexSync` when CocoIndex is configured and docs changed

package/scaffold/claude/.claude/skills/ai-spector-lang-status/skill.md

@@ -21,14 +21,23 @@ If only one language: reply "Only one language configured — nothing to compare
 
 ### 2. Refresh the index first (MANDATORY)
 
-```bash
-npx ai-spector index
+```
+index({})                    # MCP preferred
+npx ai-spector index         # CLI fallback
 ```
 
 The queue is only accurate after indexing. **Never skip this step** — reading `pending.json` without indexing shows stale data.
 
 ### 3. Read the queue
 
+**MCP (preferred):**
+```
+lang_queue({})                      # pending + summary
+lang_queue({ status: "failed" })    # failed jobs
+lang_queue({ lang: "jp" })          # filter by language
+```
+
+**CLI fallback:**
 ```bash
 npx ai-spector lang queue pending --json
 npx ai-spector lang queue failed --json
@@ -70,9 +79,9 @@ If queue is empty or missing after index, fall back to git mtime comparison acro
 
 ```
 - [ ] Read docflow.config.json → languages[]
-- [ ] Ran npx ai-spector index (mandatory before queue read)
-- [ ] Ran lang queue pending --json
-- [ ] Ran lang queue failed --json
+- [ ] Ran index({}) MCP (or npx ai-spector index) — mandatory before queue read
+- [ ] Ran lang_queue({}) MCP (or lang queue pending --json)
+- [ ] Ran lang_queue({ status: "failed" }) MCP (or lang queue failed --json)
 - [ ] Rendered pending + failed tables
 - [ ] Offered resolve-translation if pending jobs exist
 ```

package/scaffold/claude/CLAUDE.md

@@ -30,33 +30,46 @@ npx ai-spector index         # CLI fallback
 
 Then read the queue. **Never read `.ai-spector/.docflow/translation-queue/pending.json` without running index first** — the queue is only accurate after indexing.
 
-### 3. Check impact before finishing any doc edit
+### 3. Check impact and refresh embeddings after any doc edit
 
-After editing any file under `docs/srs/`, `docs/basic-design/`, or `docs/detail-design/`, run impact before closing the task:
+After editing any file under `docs/srs/`, `docs/basic-design/`, or `docs/detail-design/`:
 
+**a) Impact:**
 ```
 graph_impact({ git: true, change: "content_change" })   # MCP preferred
 npx ai-spector graph impact --git --change content_change --json  # CLI fallback
 ```
 
-Then refresh index:
+**b) Re-index + embeddings (mandatory when CocoIndex is configured):**
+```
+index({ cocoindexSync: true })    # preferred — refreshes graph + embeddings in one call
+```
 
+Or separately:
 ```
 index({})
+cocoindex_index({})
 ```
 
-Skip only when the user explicitly says it was a typo-only fix with no traceability concern.
+CLI fallback: `npx ai-spector index && npx ai-spector cocoindex index`
+
+Skip impact/index only when the user explicitly says it was a typo-only fix with no traceability concern. **Never skip `cocoindexSync` when CocoIndex is configured** — semantic search goes stale silently.
 
 ### 4. Use MCP/graph — not file search
 
 | Need | MCP (preferred) | CLI fallback |
 |------|-----------------|--------------|
+| Prepare graph scaffold | `analyze({})` | `npx ai-spector analyze` |
+| Check knowledge.json before merge | `knowledge_status({})` · `knowledge_validate({})` | *(no CLI)* |
+| Merge knowledge → graph | `graph_merge({ fromKnowledge: true })` | `npx ai-spector graph merge --from-knowledge` |
 | Find what needs regeneration | `graph_impact({ git: true, change: "content_change" })` | `npx ai-spector graph impact --git --json` |
-| Find node by exact ID | `graph_query({ id: "…" })` | `npx ai-spector graph query <id> --json` |
-| Find node by concept | `graph_query_fuzzy(query: "…")` — requires CocoIndex | — |
-| Search docs by meaning | `docs_search(query: "…")` — requires CocoIndex | — |
-| Check graph health | `graph_validate({})` | `npx ai-spector graph validate` |
-| See pending translations | *(CLI only)* | `npx ai-spector lang queue pending --json` (after index) |
+| Find node by exact ID | `graph_query({ seedId: "…" })` | `npx ai-spector graph query <id> --json` |
+| Find node by concept | `graph_query_fuzzy({ query: "…" })` — requires CocoIndex | — |
+| Search docs by meaning | `docs_search({ query: "…" })` — requires CocoIndex | — |
+| Check graph health | `graph_validate({})` · `graph_report({})` | `npx ai-spector graph validate` |
+| Translation queue | `lang_queue({})` | `npx ai-spector lang queue pending --json` (after index) |
+| CocoIndex readiness | `cocoindex_status({})` | `npx ai-spector setup --check` |
+| Rebuild embeddings | `cocoindex_index({})` or `index({ cocoindexSync: true })` | `npx ai-spector cocoindex index` |
 
 **Only fall back to `grep` or `Read` when the tool returns no results or you need raw file content for editing.**
 
@@ -83,11 +96,21 @@ Skip only when the user explicitly says it was a typo-only fix with no traceabil
 
 | Tool | Purpose |
 |------|---------|
-| `index({})` | Refresh fingerprints + translation queue |
+| `analyze({})` | Prepare graph scaffold from templates |
+| `knowledge_status({})` | Check knowledge.json entity counts |
+| `knowledge_validate({})` | Validate knowledge.json schema |
 | `graph_merge({ fromKnowledge: true })` | Merge knowledge.json into graph |
 | `graph_validate({})` | Check graph integrity |
-| `graph_impact({ git: true, change: "content_change" })` | Impact of current git diff |
-| `graph_query({ id: "…" })` | Walk graph from a node |
+| `graph_report({})` | Graph layer health audit |
+| `graph_impact({ git: true, change: "…" })` | Impact of current git diff |
+| `graph_query({ seedId: "…" })` | Walk graph from a node |
+| `index({})` | Refresh graph + translation queue |
+| `index({ cocoindexSync: true })` | Refresh graph + translation queue + embeddings |
+| `lang_queue({})` | Translation queue status |
+| `cocoindex_status({})` | CocoIndex readiness check |
+| `cocoindex_index({})` | Rebuild semantic embeddings |
+| `docs_search({ query })` | Semantic doc search (CocoIndex) |
+| `graph_query_fuzzy({ query })` | Natural language graph lookup (CocoIndex) |
 
 ### CLI (fallback / MCP-unavailable or no tool equivalent)
 

package/scaffold/cursor/WORKFLOW.md

@@ -1,6 +1,6 @@
 # AI Spector workflow
 
-**You describe what you need in chat.** Cursor picks the right **skill**; the agent runs **`npx ai-spector`** CLI. You do not need to memorize command names.
+**You describe what you need in chat.** Cursor picks the right **skill**; the agent calls **MCP tools** (when `ai-spector` server is configured) or falls back to **`npx ai-spector`** CLI. You do not need to memorize command names.
 
 Enable all skills under `.cursor/skills/` (see [skills/README.md](./skills/README.md)). On CLI or tool failure: agent pauses, shows output, and offers fix / workaround / pause — [cli-failures](./skills/ai-spector/references/cli-failures.md).
 
@@ -21,24 +21,24 @@ Then: add files under `docs/data-source/`, enable **all** skills under `.cursor/
 
 ## What to say → skill → agent does
 
-| You want to… | Say (examples) | Skill | Agent runs (summary) |
-|--------------|----------------|-------|----------------------|
+| You want to… | Say (examples) | Skill | Agent runs (MCP preferred) |
+|--------------|----------------|-------|---------------------------|
 | **Setup project** | “setup ai-spector”, “initialize project”, “get started” | `ai-spector-setup` | `setup --check` → `setup -y` → enable skills checklist |
-| Ingest sources | “analyze my data source”, “build the knowledge graph” | `ai-spector-graph` | `analyze` → read markdown → merge knowledge → validate |
-| Check graph | “validate the graph”, “graph errors” | `ai-spector-graph` | `graph validate` |
-| Refresh after edits | “re-index”, “sync the graph” | `ai-spector-graph` | `npx ai-spector index` |
-| Write SRS | “generate SRS”, “write use cases” | `ai-spector-generate-srs` | DAG waves → docs/srs → merge → index |
-| Basic design | “screen list”, “API design”, “wireframes” | `ai-spector-generate-basic-design` | docs/basic-design → merge → index each wave |
+| Ingest sources | “analyze my data source”, “build the knowledge graph” | `ai-spector-graph` | `analyze({})` → agent extracts → `knowledge_validate` → `graph_merge` → `graph_validate` |
+| Check graph health | “validate the graph”, “graph errors”, “graph report” | `ai-spector-graph` | `graph_validate({})` · `graph_report({})` |
+| Refresh after edits | “re-index”, “sync the graph” | `ai-spector-graph` | `index({ cocoindexSync: true })` (or `index({})` if no CocoIndex) |
+| Write SRS | “generate SRS”, “write use cases” | `ai-spector-generate-srs` | DAG waves → docs/srs → `graph_merge` → `index({ cocoindexSync: true })` |
+| Basic design | “screen list”, “API design”, “wireframes” | `ai-spector-generate-basic-design` | docs/basic-design → `graph_merge` → `index({ cocoindexSync: true })` each wave |
 | Detail design | “detail design for checkout” | `ai-spector-generate-detail-design` | docs/detail-design |
 | HTML prototype | “HTML mockup”, “prototype with stripe theme” | `ai-spector-generate-prototype` | auth picker (if needed) → theme picker → setup → HTML → validate |
-| Pick / preview UI theme | “help me pick a theme”, “show me themes”, “what fits my app?” | `ai-spector-generate-prototype` | read project context → recommend 3 → `prototype preview` ×3 |
-| What to redo | “what’s impacted”, “what should I regenerate” | `ai-spector-graph` | `graph impact` / git diff — includes semantic suggestions if CocoIndex configured |
-| Find docs by concept | “find all mentions of rate limiting”, “which docs describe login?” | `ai-spector-search` | `docs_search` MCP tool or `cocoindex search --query` |
-| Find graph node by name | “show graph for user login” (node ID unknown) | `ai-spector-search` | `graph_query_fuzzy` MCP tool |
-| Translation status | “what’s stale in JP”, “pending translations” | `ai-spector-lang-status` | `lang queue pending` |
-| Sync translations | “resolve translations”, “update JP from EN” | `ai-spector-resolve-translation` | read queue → translate → `index` |
+| Pick / preview UI theme | “help me pick a theme”, “show me themes” | `ai-spector-generate-prototype` | read project context → recommend 3 → `prototype preview` ×3 |
+| What to redo | “what’s impacted”, “what should I regenerate” | `ai-spector-graph` | `graph_impact({ git: true, change: “…” })` — includes `semanticSuggestions` when CocoIndex ready |
+| Find docs by concept | “find all mentions of rate limiting”, “which docs describe login?” | `ai-spector-search` | `docs_search({ query })` MCP |
+| Find graph node by name | “show graph for user login” (node ID unknown) | `ai-spector-search` | `graph_query_fuzzy({ query })` MCP |
+| Translation status | “what’s stale in JP”, “pending translations” | `ai-spector-lang-status` | `lang_queue({})` MCP |
+| Sync translations | “resolve translations”, “update JP from EN” | `ai-spector-resolve-translation` | read queue → translate → `index({ cocoindexSync: true })` |
 | Review comments | “resolve comments”, “fix C-001” | `ai-spector-resolve-comments` | inbox → plan → edit → commit |
-| Explore graph | “show the graph” | `ai-spector-graph` | `graph visualize --open` |
+| Explore graph | “show the graph” | `ai-spector-graph` | `npx ai-spector graph visualize --open` (no MCP equivalent) |
 
 Unsure? The agent uses [skills/_skill-router.md](./skills/_skill-router.md) or asks one clarifying question.
 

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

@@ -18,14 +18,40 @@ When the `ai-spector` MCP server is enabled (`.cursor/mcp.json` or `.mcp.json` l
 
 | Operation | MCP tool | CLI fallback |
 |-----------|----------|--------------|
-| Re-index project | `index({})` | `npx ai-spector index` |
+| Prepare graph scaffold | `analyze({})` | `npx ai-spector analyze` |
+| Check knowledge.json entity counts | `knowledge_status({})` | *(no CLI equivalent)* |
+| Validate knowledge.json schema | `knowledge_validate({})` | *(no CLI equivalent)* |
 | Merge knowledge → graph | `graph_merge({ fromKnowledge: true })` | `npx ai-spector graph merge --from-knowledge` |
 | Validate graph | `graph_validate({})` | `npx ai-spector graph validate` |
+| Graph layer health audit | `graph_report({})` | `npx ai-spector graph report --json` |
 | Impact analysis | `graph_impact({ originId, change })` | `npx ai-spector graph impact …` |
-| Walk graph from node | `graph_query({ id, … })` | `npx ai-spector graph query <id> --json` |
-| **Analyze data-source** | *(no MCP tool — CLI only)* | `npx ai-spector analyze` |
+| Walk graph from node | `graph_query({ seedId })` | `npx ai-spector graph query <id> --json` |
+| Re-index project | `index({})` | `npx ai-spector index` |
+| Re-index + refresh embeddings | `index({ cocoindexSync: true })` | `npx ai-spector index && npx ai-spector cocoindex index` |
+| Translation queue status | `lang_queue({})` | `npx ai-spector lang queue pending --json` |
+| CocoIndex readiness | `cocoindex_status({})` | `npx ai-spector setup --check` |
+| Rebuild semantic embeddings | `cocoindex_index({})` | `npx ai-spector cocoindex index` |
+| Semantic doc search | `docs_search({ query })` | `npx ai-spector cocoindex search --query …` |
+| Natural language graph lookup | `graph_query_fuzzy({ query })` | *(no CLI equivalent)* |
+| **Visualize graph** | *(no MCP tool)* | `npx ai-spector graph visualize --open` |
+
+Use CLI **only** when: MCP server is not configured, the tool errors, or no MCP equivalent exists (visualize, `lang add`, template mutations).
+
+### After any batch of doc edits
+
+When you finish editing files under `docs/` — always close out with:
+
+```
+index({ cocoindexSync: true })   # preferred: refreshes graph + embeddings in one call
+```
+
+Or if CocoIndex is not configured:
+
+```
+index({})
+```
 
-Use CLI **only** when: MCP server is not configured, the tool errors and MCP is unavailable, or the operation has no MCP equivalent (e.g. `analyze`).
+**Never skip the embedding refresh** when CocoIndex is set up — semantic search and `graph_impact` `semanticSuggestions` go stale silently.
 
 ## CLI and tool failure (non-negotiable)
 

package/scaffold/cursor/skills/ai-spector-graph/references/analyze.md

@@ -2,7 +2,7 @@
 
 Ingest `docs/data-source/` and commit knowledge into the traceability graph.
 
-Step 0 (`npx ai-spector analyze`) is **CLI-only** — no MCP equivalent. Steps B (merge, validate) use **MCP when available**.
+All steps have MCP equivalents. Use MCP when the `ai-spector` server is configured.
 
 ## Usage
 
@@ -20,6 +20,12 @@ Step 0 (`npx ai-spector analyze`) is **CLI-only** — no MCP equivalent. Steps B
 
 ### 0. Prepare graph structure
 
+**MCP (preferred):**
+```
+analyze({})
+```
+
+**CLI fallback:**
 ```bash
 npx ai-spector analyze
 ```
@@ -82,7 +88,10 @@ Update `state.json`: `analysis.lastRunAt`, `analysis.dataSource`, scope hash. Me
 
 | Step | MCP (preferred) | CLI fallback |
 |------|-----------------|--------------|
-| 0 | *(CLI only — no MCP tool)* | `npx ai-spector analyze` |
+| 0 prepare | `analyze({})` | `npx ai-spector analyze` |
+| A extraction | Agent writes `knowledge.json` | Agent writes `knowledge.json` |
+| A verify | `knowledge_status({})` → check `ready: true` | *(no CLI)* |
+| A validate | `knowledge_validate({})` → check `valid: true` | *(no CLI)* |
 | B merge | `graph_merge({ fromKnowledge: true })` | `npx ai-spector graph merge --from-knowledge` |
 | B validate | `graph_validate({})` | `npx ai-spector graph validate` |
 

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

@@ -20,14 +20,24 @@ paths:
 
 2. **Refresh the index first** — the queue is only accurate after indexing:
 
-```bash
-npx ai-spector index
 ```
+index({})                    # MCP preferred
+npx ai-spector index         # CLI fallback
+```
+
+Skip only if the user explicitly says they just ran it.
 
-This scans all doc files, updates fingerprints, and reconciles pending/resolved jobs in the translation queue. Skip only if the user explicitly says they just ran it.
+3. Read the translation queue (primary source of truth):
 
-3. Run the translation queue CLI (primary source of truth):
+**MCP (preferred):**
+```
+lang_queue({})                          # pending jobs + summary
+lang_queue({ status: "failed" })        # failed jobs
+lang_queue({ status: "all" })           # everything
+lang_queue({ lang: "jp" })              # filter by language
+```
 
+**CLI fallback:**
 ```bash
 npx ai-spector lang queue pending --json
 npx ai-spector lang queue failed --json
@@ -113,7 +123,7 @@ List actionable items per job:
 
 ## After any file edit (outside of generate skills)
 
-When the user edits any language file directly, run `npx ai-spector index` (or `lang queue scan`). The queue enqueues section-level sync jobs automatically — no manual stale notes needed.
+When the user edits any language file directly, run `index({})` (MCP) or `npx ai-spector index`. The queue enqueues section-level sync jobs automatically — no manual stale notes needed.
 
 If the user defers translation, the job stays in `pending.json` until processed.
 

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

@@ -35,15 +35,16 @@ surface related docs that have no formal graph edge.
 
 Find all document sections about a concept:
 
-```bash
-npx ai-spector cocoindex search --query "rate limiting" --json
-```
-
-Or via MCP:
+**MCP (preferred):**
 ```
 docs_search(query: "rate limiting", limit: 5)
 ```
 
+**CLI fallback:**
+```bash
+npx ai-spector cocoindex search --query "rate limiting" --json
+```
+
 Response includes `graphNodeId` when the matched section maps to a traceability node.
 Use that to run `graph_query` for full context.
 
@@ -109,19 +110,37 @@ No code change needed — chain two MCP calls:
 
 ## Setup check
 
-Before using any semantic workflow, verify CocoIndex is configured:
+Before using any semantic workflow, verify CocoIndex is ready:
+
+**MCP (preferred):**
+```
+cocoindex_status({})
+```
+
+Check `ready: true`. If any issue is listed, fix it before searching.
 
+**CLI fallback:**
 ```bash
 npx ai-spector setup --check
 ```
 
-If CocoIndex is missing:
-```bash
-npx ai-spector cocoindex setup
-cd .ai-spector/.docflow/cocoindex
-cp .env.example .env   # edit if needed
-pip install -r requirements.txt
-python pipeline.py cocoindex update
+If CocoIndex is missing, run `npx ai-spector cocoindex setup` (or ask agent to set it up via `ai-spector-setup` skill).
+
+---
+
+## Rebuild embeddings after doc edits
+
+Semantic search goes stale when docs change. After any batch of doc edits:
+
+**Preferred — one call:**
+```
+index({ cocoindexSync: true })
+```
+
+**Or separately:**
+```
+cocoindex_index({})
+index({})
 ```
 
 ---
@@ -129,8 +148,8 @@ python pipeline.py cocoindex update
 ## Checklist
 
 ```
-- [ ] CocoIndex configured (pipeline.py present)
-- [ ] Embeddings up to date (run pipeline.py cocoindex update after doc edits)
+- [ ] cocoindex_status({}) → ready: true (or setup done)
+- [ ] Embeddings refreshed after doc edits: index({ cocoindexSync: true })
 - [ ] Used graph_query_fuzzy when node ID is unknown (not graph_query with a guess)
 - [ ] Treated semanticSuggestions as "review recommended", not "must regenerate"
 ```