@cliangdev/conductor 0.12.1 → 0.14.0

package/assets/cli-manifest.json

@@ -374,6 +374,85 @@
       "description": "Raise a gap report for a knowledge domain not yet in the registry. Claim-or-return on slug.",
       "category": "knowledge",
       "requiredParams": ["slug", "displayName", "reason"]
+    },
+    {
+      "name": "list_project_docs",
+      "description": "Map the project's Docs section — folder paths and every document as a \"Folder/Title\" path, or full-text search with query.",
+      "category": "project-docs"
+    },
+    {
+      "name": "read_project_doc",
+      "description": "Read one project document by path or docId — full Markdown plus taskLines (every checkbox with its line number and state).",
+      "category": "project-docs"
+    },
+    {
+      "name": "write_project_doc",
+      "description": "Create or replace a project document at a path, creating any missing folders.",
+      "category": "project-docs",
+      "requiredParams": ["path", "content"]
+    },
+    {
+      "name": "move_project_doc",
+      "description": "Rename a project document and/or move it to another folder.",
+      "category": "project-docs",
+      "requiredParams": ["newPath"]
+    },
+    {
+      "name": "delete_project_doc",
+      "description": "Delete a project document, along with its version history and comments.",
+      "category": "project-docs"
+    },
+    {
+      "name": "set_project_doc_task",
+      "description": "Check or uncheck one Markdown checkbox in a project document by 1-based line number.",
+      "category": "project-docs",
+      "requiredParams": ["lineNumber", "checked"]
+    },
+    {
+      "name": "list_project_doc_comments",
+      "description": "Read the line-anchored comments humans left on a project document, unresolved by default.",
+      "category": "project-docs"
+    },
+    {
+      "name": "comment_on_project_doc",
+      "description": "Leave a comment anchored to one line of a project document.",
+      "category": "project-docs",
+      "requiredParams": ["lineNumber", "content"]
+    },
+    {
+      "name": "respond_to_project_doc_comment",
+      "description": "Answer a comment thread on a project document — reply, resolve, or both.",
+      "category": "project-docs",
+      "requiredParams": ["commentId"]
+    },
+    {
+      "name": "list_project_doc_versions",
+      "description": "List a project document's edit history — version number, author and timestamp, newest first.",
+      "category": "project-docs"
+    },
+    {
+      "name": "restore_project_doc_version",
+      "description": "Roll a project document back to an earlier version, appended as a new version rather than a rewind.",
+      "category": "project-docs",
+      "requiredParams": ["versionNumber"]
+    },
+    {
+      "name": "upload_project_doc_image",
+      "description": "Upload a local image file to a project document and get the Markdown snippet to embed.",
+      "category": "project-docs",
+      "requiredParams": ["filePath"]
+    },
+    {
+      "name": "move_project_folder",
+      "description": "Rename a docs folder and/or move it under another one, taking its whole subtree with it.",
+      "category": "project-docs",
+      "requiredParams": ["path", "newPath"]
+    },
+    {
+      "name": "delete_project_folder",
+      "description": "Delete a docs folder and its subfolders; documents inside are kept and resurface at the project root.",
+      "category": "project-docs",
+      "requiredParams": ["path"]
     }
   ]
 }

package/dist/mcp/api.d.ts

@@ -16,4 +16,14 @@ export declare function apiPostWithStatus<T>(urlPath: string, body: unknown, con
 export declare function apiPatch<T>(urlPath: string, body: unknown, config: Config): Promise<T>;
 export declare function apiPut<T>(urlPath: string, body: unknown, config: Config): Promise<T>;
 export declare function apiDelete(urlPath: string, config: Config): Promise<void>;
+/**
+ * POSTs a single file as multipart/form-data. Deliberately does not set Content-Type: fetch has to
+ * generate it itself so the multipart boundary matches the body it builds.
+ */
+export declare function apiPostFile<T>(urlPath: string, file: {
+    fieldName: string;
+    filename: string;
+    contentType: string;
+    bytes: Uint8Array;
+}, config: Config): Promise<T>;
 //# sourceMappingURL=api.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/mcp/api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAyCzC;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAEnD;AAED,wBAAsB,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAE3E;AAED,wBAAsB,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAE3F;AAED;0GAC0G;AAC1G,wBAAsB,iBAAiB,CAAC,CAAC,EACvC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,MAAM,GACb,OAAO,CAAC;IAAE,IAAI,EAAE,CAAC,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAEtC;AAED,wBAAsB,QAAQ,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAE5F;AAED,wBAAsB,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAE1F;AAED,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE9E"}
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/mcp/api.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAyCzC;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAEnD;AAED,wBAAsB,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAE3E;AAED,wBAAsB,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAE3F;AAED;0GAC0G;AAC1G,wBAAsB,iBAAiB,CAAC,CAAC,EACvC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,MAAM,GACb,OAAO,CAAC;IAAE,IAAI,EAAE,CAAC,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAEtC;AAED,wBAAsB,QAAQ,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAE5F;AAED,wBAAsB,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAE1F;AAED,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE9E;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,CAAC,EACjC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAAE,EACrF,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,CAAC,CAAC,CAyBZ"}

package/dist/mcp/api.js

@@ -1,3 +1,4 @@
+import { Blob } from 'node:buffer';
 async function requestWithStatus(method, urlPath, body, config) {
     const url = `${config.apiUrl}${urlPath}`;
     const headers = {
@@ -49,4 +50,26 @@ export async function apiPut(urlPath, body, config) {
 export async function apiDelete(urlPath, config) {
     await request('DELETE', urlPath, undefined, config);
 }
+/**
+ * POSTs a single file as multipart/form-data. Deliberately does not set Content-Type: fetch has to
+ * generate it itself so the multipart boundary matches the body it builds.
+ */
+export async function apiPostFile(urlPath, file, config) {
+    // Copy into a plain ArrayBuffer: the incoming view may be backed by a pooled Node Buffer, which is
+    // both a type mismatch for Blob and a slice of a larger allocation.
+    const buffer = new ArrayBuffer(file.bytes.byteLength);
+    new Uint8Array(buffer).set(file.bytes);
+    const form = new FormData();
+    form.append(file.fieldName, new Blob([buffer], { type: file.contentType }), file.filename);
+    const response = await fetch(`${config.apiUrl}${urlPath}`, {
+        method: 'POST',
+        headers: { Authorization: `Bearer ${config.apiKey}` },
+        body: form,
+    });
+    if (!response.ok) {
+        const text = await response.text().catch(() => '');
+        throw new Error(`API error ${response.status}: ${text}`);
+    }
+    return (await response.json());
+}
 //# sourceMappingURL=api.js.map

package/dist/mcp/api.js.map

@@ -1 +1 @@
-{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/mcp/api.ts"],"names":[],"mappings":"AAEA,KAAK,UAAU,iBAAiB,CAC9B,MAAc,EACd,OAAe,EACf,IAAyB,EACzB,MAAc;IAEd,MAAM,GAAG,GAAG,GAAG,MAAM,CAAC,MAAM,GAAG,OAAO,EAAE,CAAA;IACxC,MAAM,OAAO,GAA2B;QACtC,aAAa,EAAE,UAAU,MAAM,CAAC,MAAM,EAAE;QACxC,cAAc,EAAE,kBAAkB;KACnC,CAAA;IAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;QAChC,MAAM;QACN,OAAO;QACP,IAAI,EAAE,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;KAC5D,CAAC,CAAA;IAEF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAA;QAClD,MAAM,IAAI,KAAK,CAAC,aAAa,QAAQ,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC,CAAA;IAC1D,CAAC;IAED,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;QACxB,OAAO,EAAE,IAAI,EAAE,SAAc,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAA;IAC1D,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAA;AACxE,CAAC;AAED,KAAK,UAAU,OAAO,CACpB,MAAc,EACd,OAAe,EACf,IAAyB,EACzB,MAAc;IAEd,OAAO,CAAC,MAAM,iBAAiB,CAAI,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAA;AACzE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,GAAY;IACxC,OAAO,GAAG,YAAY,KAAK,IAAI,mBAAmB,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;AACtE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,MAAM,CAAI,OAAe,EAAE,MAAc;IAC7D,OAAO,OAAO,CAAI,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,CAAA;AACtD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,OAAO,CAAI,OAAe,EAAE,IAAa,EAAE,MAAc;IAC7E,OAAO,OAAO,CAAI,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,CAAA;AAClD,CAAC;AAED;0GAC0G;AAC1G,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAAe,EACf,IAAa,EACb,MAAc;IAEd,OAAO,iBAAiB,CAAI,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,CAAA;AAC5D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAI,OAAe,EAAE,IAAa,EAAE,MAAc;IAC9E,OAAO,OAAO,CAAI,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,CAAA;AACnD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,MAAM,CAAI,OAAe,EAAE,IAAa,EAAE,MAAc;IAC5E,OAAO,OAAO,CAAI,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,CAAA;AACjD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAe,EAAE,MAAc;IAC7D,MAAM,OAAO,CAAO,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,CAAA;AAC3D,CAAC"}
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/mcp/api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AAGlC,KAAK,UAAU,iBAAiB,CAC9B,MAAc,EACd,OAAe,EACf,IAAyB,EACzB,MAAc;IAEd,MAAM,GAAG,GAAG,GAAG,MAAM,CAAC,MAAM,GAAG,OAAO,EAAE,CAAA;IACxC,MAAM,OAAO,GAA2B;QACtC,aAAa,EAAE,UAAU,MAAM,CAAC,MAAM,EAAE;QACxC,cAAc,EAAE,kBAAkB;KACnC,CAAA;IAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;QAChC,MAAM;QACN,OAAO;QACP,IAAI,EAAE,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;KAC5D,CAAC,CAAA;IAEF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAA;QAClD,MAAM,IAAI,KAAK,CAAC,aAAa,QAAQ,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC,CAAA;IAC1D,CAAC;IAED,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;QACxB,OAAO,EAAE,IAAI,EAAE,SAAc,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAA;IAC1D,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAA;AACxE,CAAC;AAED,KAAK,UAAU,OAAO,CACpB,MAAc,EACd,OAAe,EACf,IAAyB,EACzB,MAAc;IAEd,OAAO,CAAC,MAAM,iBAAiB,CAAI,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAA;AACzE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,GAAY;IACxC,OAAO,GAAG,YAAY,KAAK,IAAI,mBAAmB,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;AACtE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,MAAM,CAAI,OAAe,EAAE,MAAc;IAC7D,OAAO,OAAO,CAAI,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,CAAA;AACtD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,OAAO,CAAI,OAAe,EAAE,IAAa,EAAE,MAAc;IAC7E,OAAO,OAAO,CAAI,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,CAAA;AAClD,CAAC;AAED;0GAC0G;AAC1G,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAAe,EACf,IAAa,EACb,MAAc;IAEd,OAAO,iBAAiB,CAAI,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,CAAA;AAC5D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAI,OAAe,EAAE,IAAa,EAAE,MAAc;IAC9E,OAAO,OAAO,CAAI,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,CAAA;AACnD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,MAAM,CAAI,OAAe,EAAE,IAAa,EAAE,MAAc;IAC5E,OAAO,OAAO,CAAI,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,CAAA;AACjD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAe,EAAE,MAAc;IAC7D,MAAM,OAAO,CAAO,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,CAAA;AAC3D,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,OAAe,EACf,IAAqF,EACrF,MAAc;IAEd,mGAAmG;IACnG,oEAAoE;IACpE,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAA;IACrD,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAEtC,MAAM,IAAI,GAAG,IAAI,QAAQ,EAAE,CAAA;IAC3B,IAAI,CAAC,MAAM,CACT,IAAI,CAAC,SAAS,EACd,IAAI,IAAI,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,CAA+B,EAC5E,IAAI,CAAC,QAAQ,CACd,CAAA;IAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,OAAO,EAAE,EAAE;QACzD,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,MAAM,CAAC,MAAM,EAAE,EAAE;QACrD,IAAI,EAAE,IAAI;KACX,CAAC,CAAA;IAEF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAA;QAClD,MAAM,IAAI,KAAK,CAAC,aAAa,QAAQ,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC,CAAA;IAC1D,CAAC;IAED,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAM,CAAA;AACrC,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":";AAmmBA,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CA0clD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":";AAszBA,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAgmBlD"}

package/dist/mcp/index.js

@@ -11,6 +11,7 @@ import { listIntegrationTools, listConnectorCatalog } from './tools/integrations
 import { listAgents, createAgent, updateAgent, deleteAgent } from './tools/agents.js';
 import { listSkills, registerSkill } from './tools/skills.js';
 import { submitKnowledgeSource, readKnowledgeSources, searchKnowledge, readKnowledgePages, writeKnowledgePages, listKnowledgeDomains, suggestKnowledgeDomain, } from './tools/knowledge.js';
+import { listProjectDocs, readProjectDoc, writeProjectDoc, moveProjectDoc, deleteProjectDoc, setProjectDocTask, listProjectDocComments, commentOnProjectDoc, respondToProjectDocComment, listProjectDocVersions, restoreProjectDocVersion, uploadProjectDocImage, moveProjectFolder, deleteProjectFolder, } from './tools/project-docs.js';
 const TOOLS = [
     // --- Canonical Work Item tools (v2 /work-items surface) ---
     {
@@ -493,7 +494,7 @@ const TOOLS = [
     },
     {
         name: 'write_knowledge_pages',
-        description: "Create, update, or delete wiki pages atomically. Updating an existing page requires its current version as baseVersion (read_knowledge_pages first) — a stale write returns a structured {conflict: true, conflicts: [{path, currentVersion, currentContent}]} result instead of throwing; merge and retry once. Optionally pass sourceIds to mark those knowledge-inbox sources PROCESSED atomically with the write — pass writes: [] with sourceIds to ack a batch that warrants no wiki change. Verify with read_knowledge_pages.",
+        description: "Create, update, or delete wiki pages atomically, plus settle the ingestion sources this batch reviewed. Updating an existing page requires its current version as baseVersion (read_knowledge_pages first) — a stale write returns a structured {conflict: true, conflicts: [{path, currentVersion, currentContent}]} result instead of throwing; merge and retry once. sourceIds are sources you filed into a page (marked PROCESSED); skipped (with a required reason each) are sources you reviewed and deliberately did not file (marked SKIPPED — the reason is shown to a human in the Inbox). Both may be set in one call; a source id belongs to exactly one — the same id in both is rejected. writes may be empty when sourceIds/skipped cover the batch, to settle sources with no page change. Verify with read_knowledge_sources.",
         inputSchema: {
             type: 'object',
             properties: {
@@ -509,9 +510,21 @@ const TOOLS = [
                         },
                         required: ['path'],
                     },
-                    description: 'Pages to write or delete; may be empty when sourceIds is provided (no wiki change needed for this batch)',
+                    description: 'Pages to write or delete; may be empty when sourceIds/skipped cover the batch (no wiki change needed)',
                 },
                 sourceIds: { type: 'array', items: { type: 'string' }, description: 'Knowledge-inbox source IDs to mark PROCESSED atomically with this write (optional)' },
+                skipped: {
+                    type: 'array',
+                    items: {
+                        type: 'object',
+                        properties: {
+                            sourceId: { type: 'string' },
+                            reason: { type: 'string', description: "Why this source wasn't filed — required, shown to a human in the Inbox" },
+                        },
+                        required: ['sourceId', 'reason'],
+                    },
+                    description: 'Knowledge-inbox sources this batch reviewed and deliberately did not file; marked SKIPPED with the given reason atomically with this write (optional)',
+                },
             },
             required: ['writes'],
         },
@@ -540,6 +553,187 @@ const TOOLS = [
             required: ['slug', 'displayName', 'reason'],
         },
     },
+    // --- Project Docs (the project's own document tree, not Work Item documents) ---
+    {
+        name: 'list_project_docs',
+        description: "Map the project's Docs section: every document as a \"Folder/Title\" path with its docId, plus each folder with its docCount and lastUpdatedAt so you can judge which parts of the tree carry weight or have gone stale. Pass query to full-text search instead. Call this first to orient before reading or writing project docs.",
+        inputSchema: {
+            type: 'object',
+            properties: {
+                folder: { type: 'string', description: 'Limit to one folder path, e.g. "Plans/Q3" (omit for the whole tree)' },
+                query: { type: 'string', description: 'Full-text search over titles and content; returns matches with snippets instead of the tree' },
+            },
+            required: [],
+        },
+    },
+    {
+        name: 'read_project_doc',
+        description: 'Read one project document by path ("Plans/Q3 Roadmap") or docId. Returns full Markdown content plus taskLines — every checkbox with its 1-based line number and state, which is what set_project_doc_task takes. Pass versionNumber (from list_project_doc_versions) to read an earlier version instead of the current one.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                path: { type: 'string', description: 'Document path, e.g. "Plans/Q3 Roadmap"' },
+                docId: { type: 'string', description: 'Document ID — use instead of path when the title contains "/"' },
+                versionNumber: { type: 'number', description: 'Read this historical version instead of current content' },
+            },
+            required: [],
+        },
+    },
+    {
+        name: 'write_project_doc',
+        description: 'Create or replace a project document at a path, creating any missing folders (upsert). Replaces the whole document, records a version, and marks unresolved line comments stale — to tick a checkbox use set_project_doc_task instead, which does none of that. Verify with read_project_doc.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                path: { type: 'string', description: 'Destination path, e.g. "Plans/Q3 Roadmap" — folder segments are created if missing' },
+                content: { type: 'string', description: 'Full Markdown content' },
+            },
+            required: ['path', 'content'],
+        },
+    },
+    {
+        name: 'move_project_doc',
+        description: 'Rename a project document and/or move it to another folder, creating missing folders in the destination path. Verify with list_project_docs.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                path: { type: 'string', description: 'Current document path' },
+                docId: { type: 'string', description: 'Document ID — use instead of path' },
+                newPath: { type: 'string', description: 'New path, e.g. "Archive/Q2 Roadmap"' },
+            },
+            required: ['newPath'],
+        },
+    },
+    {
+        name: 'delete_project_doc',
+        description: 'Delete a project document. Irreversible — its version history and comments go with it. Verify with list_project_docs.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                path: { type: 'string', description: 'Document path' },
+                docId: { type: 'string', description: 'Document ID — use instead of path' },
+            },
+            required: [],
+        },
+    },
+    {
+        name: 'set_project_doc_task',
+        description: 'Check or uncheck one Markdown checkbox in a project document. lineNumber is 1-based against raw content including frontmatter — take it from read_project_doc\'s taskLines. Unlike write_project_doc this records no version and leaves comment anchors valid. Idempotent; returns conflict: true if that line is no longer a task item.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                path: { type: 'string', description: 'Document path' },
+                docId: { type: 'string', description: 'Document ID — use instead of path' },
+                lineNumber: { type: 'number', description: '1-based line number of the task item (from read_project_doc taskLines)' },
+                checked: { type: 'boolean', description: 'true to check the box, false to uncheck' },
+            },
+            required: ['lineNumber', 'checked'],
+        },
+    },
+    {
+        name: 'list_project_doc_comments',
+        description: 'Read the comments humans left on a project document — each with its anchored lineNumber, quotedText, lineStale flag and replies. Unresolved only by default. Answer them with respond_to_project_doc_comment.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                path: { type: 'string', description: 'Document path' },
+                docId: { type: 'string', description: 'Document ID — use instead of path' },
+                includeResolved: { type: 'boolean', description: 'Include already-resolved threads (default false)' },
+            },
+            required: [],
+        },
+    },
+    {
+        name: 'comment_on_project_doc',
+        description: 'Leave a comment anchored to one line of a project document. lineNumber is 1-based against raw content including frontmatter. Verify with list_project_doc_comments.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                path: { type: 'string', description: 'Document path' },
+                docId: { type: 'string', description: 'Document ID — use instead of path' },
+                lineNumber: { type: 'number', description: '1-based line number to anchor the comment to' },
+                content: { type: 'string', description: 'Comment text' },
+                quotedText: { type: 'string', description: 'Optional snippet of the line being commented on, shown as context' },
+            },
+            required: ['lineNumber', 'content'],
+        },
+    },
+    {
+        name: 'respond_to_project_doc_comment',
+        description: 'Answer a comment thread on a project document: post a reply, mark it resolved, or both. Verify with list_project_doc_comments.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                path: { type: 'string', description: 'Document path' },
+                docId: { type: 'string', description: 'Document ID — use instead of path' },
+                commentId: { type: 'string', description: 'ID of the comment thread (from list_project_doc_comments)' },
+                reply: { type: 'string', description: 'Reply text to post on the thread' },
+                resolve: { type: 'boolean', description: 'true to mark the thread resolved' },
+            },
+            required: ['commentId'],
+        },
+    },
+    {
+        name: 'list_project_doc_versions',
+        description: 'List a project document\'s edit history — versionNumber, who wrote it and when, newest first. Every full-content write adds one; ticking a checkbox does not. Read one with read_project_doc versionNumber, or roll back with restore_project_doc_version.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                path: { type: 'string', description: 'Document path' },
+                docId: { type: 'string', description: 'Document ID — use instead of path' },
+            },
+            required: [],
+        },
+    },
+    {
+        name: 'restore_project_doc_version',
+        description: 'Roll a project document back to an earlier version (from list_project_doc_versions). Appends the old content as a new version rather than rewinding, so the restore is itself undoable. Verify with read_project_doc.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                path: { type: 'string', description: 'Document path' },
+                docId: { type: 'string', description: 'Document ID — use instead of path' },
+                versionNumber: { type: 'number', description: 'Version to restore, from list_project_doc_versions' },
+            },
+            required: ['versionNumber'],
+        },
+    },
+    {
+        name: 'upload_project_doc_image',
+        description: 'Upload a local image file (png, jpeg, gif, webp) to a project document and get the Markdown snippet to embed. Include that snippet in the content you pass to write_project_doc — the link is stored as a stable reference and re-signed on every read, so it will not expire.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                path: { type: 'string', description: 'Document path the image belongs to' },
+                docId: { type: 'string', description: 'Document ID — use instead of path' },
+                filePath: { type: 'string', description: 'Path to the image file on this machine' },
+            },
+            required: ['filePath'],
+        },
+    },
+    {
+        name: 'move_project_folder',
+        description: 'Rename a docs folder and/or move it under another one, taking its whole subtree with it. Missing folders in the destination path are created. Cannot move a folder into its own subtree. Verify with list_project_docs.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                path: { type: 'string', description: 'Current folder path, e.g. "Plans/Q3"' },
+                newPath: { type: 'string', description: 'New folder path, e.g. "Archive/2026/Q3"' },
+            },
+            required: ['path', 'newPath'],
+        },
+    },
+    {
+        name: 'delete_project_folder',
+        description: 'Delete a docs folder and its subfolders. Not destructive to content: documents inside are kept and resurface at the project root. Use it to clear away empty or obsolete folders after reorganising. Verify with list_project_docs.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                path: { type: 'string', description: 'Folder path to delete, e.g. "Archive/Old"' },
+            },
+            required: ['path'],
+        },
+    },
 ];
 function authErrorResponse() {
     return {
@@ -857,6 +1051,7 @@ export async function runMcpServer() {
                     const result = await writeKnowledgePages({
                         writes: params['writes'] ?? [],
                         sourceIds: params['sourceIds'],
+                        skipped: params['skipped'],
                     }, config);
                     return successResponse(result);
                 }
@@ -874,6 +1069,115 @@ export async function runMcpServer() {
                     }, config);
                     return successResponse(result);
                 }
+                // --- Project Docs ---
+                case 'list_project_docs': {
+                    const result = await listProjectDocs({
+                        folder: params['folder'],
+                        query: params['query'],
+                    }, config);
+                    return successResponse(result);
+                }
+                case 'read_project_doc': {
+                    const result = await readProjectDoc({
+                        path: params['path'],
+                        docId: params['docId'],
+                        versionNumber: params['versionNumber'],
+                    }, config);
+                    return successResponse(result);
+                }
+                case 'write_project_doc': {
+                    const result = await writeProjectDoc({
+                        path: params['path'],
+                        content: params['content'],
+                    }, config);
+                    return successResponse(result);
+                }
+                case 'move_project_doc': {
+                    const result = await moveProjectDoc({
+                        path: params['path'],
+                        docId: params['docId'],
+                        newPath: params['newPath'],
+                    }, config);
+                    return successResponse(result);
+                }
+                case 'delete_project_doc': {
+                    const result = await deleteProjectDoc({
+                        path: params['path'],
+                        docId: params['docId'],
+                    }, config);
+                    return successResponse(result);
+                }
+                case 'set_project_doc_task': {
+                    const result = await setProjectDocTask({
+                        path: params['path'],
+                        docId: params['docId'],
+                        lineNumber: params['lineNumber'],
+                        checked: params['checked'],
+                    }, config);
+                    return successResponse(result);
+                }
+                case 'list_project_doc_comments': {
+                    const result = await listProjectDocComments({
+                        path: params['path'],
+                        docId: params['docId'],
+                        includeResolved: params['includeResolved'],
+                    }, config);
+                    return successResponse(result);
+                }
+                case 'comment_on_project_doc': {
+                    const result = await commentOnProjectDoc({
+                        path: params['path'],
+                        docId: params['docId'],
+                        lineNumber: params['lineNumber'],
+                        content: params['content'],
+                        quotedText: params['quotedText'],
+                    }, config);
+                    return successResponse(result);
+                }
+                case 'respond_to_project_doc_comment': {
+                    const result = await respondToProjectDocComment({
+                        path: params['path'],
+                        docId: params['docId'],
+                        commentId: params['commentId'],
+                        reply: params['reply'],
+                        resolve: params['resolve'],
+                    }, config);
+                    return successResponse(result);
+                }
+                case 'list_project_doc_versions': {
+                    const result = await listProjectDocVersions({
+                        path: params['path'],
+                        docId: params['docId'],
+                    }, config);
+                    return successResponse(result);
+                }
+                case 'restore_project_doc_version': {
+                    const result = await restoreProjectDocVersion({
+                        path: params['path'],
+                        docId: params['docId'],
+                        versionNumber: params['versionNumber'],
+                    }, config);
+                    return successResponse(result);
+                }
+                case 'move_project_folder': {
+                    const result = await moveProjectFolder({
+                        path: params['path'],
+                        newPath: params['newPath'],
+                    }, config);
+                    return successResponse(result);
+                }
+                case 'delete_project_folder': {
+                    const result = await deleteProjectFolder({ path: params['path'] }, config);
+                    return successResponse(result);
+                }
+                case 'upload_project_doc_image': {
+                    const result = await uploadProjectDocImage({
+                        path: params['path'],
+                        docId: params['docId'],
+                        filePath: params['filePath'],
+                    }, config);
+                    return successResponse(result);
+                }
                 default:
                     return errorResponse(`Unknown tool: ${name}`);
             }