@gwdn/nexus-mcp 0.7.0 → 0.8.1

package/dist/tools/directives.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"directives.js","sourceRoot":"","sources":["../../src/tools/directives.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAE3C,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAE9E,8DAA8D;AAC9D,SAAS,WAAW,CAAC,MAAgC;IACnD,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;aACvD;SACF;QACD,OAAO,EAAE,IAAI;KACd,CAAA;AACH,CAAC;AAED,8DAA8D;AAC9D,SAAS,QAAQ,CAAC,IAAS;IACzB,OAAO;QACL,OAAO,EAAE;YACP,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE;SAC/D;KACF,CAAA;AACH,CAAC;AAED,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,IAAI,EAAE;SACN,QAAQ,CAAC,cAAc,CAAC;IAC3B,OAAO,EAAE,CAAC;SACP,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CAAC,0BAA0B,CAAC;IACvC,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,OAAO,CAAC,EAAE,CAAC;SACX,QAAQ,CAAC,2BAA2B,CAAC;CACzC,CAAA;AASD,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,IAAgB;IAC3C,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,qBAAqB,EAAE;QACpD,MAAM,EAAE,SAAS;QACjB,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE;KACxB,CAAC,CAAA;IAEF,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,WAAW,CAAC,MAAM,CAAC,CAAA;IAC1C,OAAO,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;AAC9B,CAAC;AAED,8EAA8E;AAC9E,SAAS;AACT,8EAA8E;AAE9E,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,YAAY,EAAE,CAAC;SACZ,MAAM,EAAE;SACR,IAAI,EAAE;SACN,QAAQ,CAAC,gBAAgB,CAAC;CAC9B,CAAA;AAOD,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,IAAe;IACzC,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,qBAAqB,EAAE;QACpD,MAAM,EAAE,QAAQ;QAChB,YAAY,EAAE,IAAI,CAAC,YAAY;KAChC,CAAC,CAAA;IAEF,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,WAAW,CAAC,MAAM,CAAC,CAAA;IAC1C,OAAO,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;AAC9B,CAAC;AAED,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,IAAI,EAAE;SACN,QAAQ,CAAC,cAAc,CAAC;IAC3B,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,CAAC,iBAAiB,CAAC;IAC9B,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,GAAG,CAAC,KAAK,CAAC;SACV,QAAQ,EAAE;SACV,QAAQ,CAAC,2BAA2B,CAAC;IACxC,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,GAAG,CAAC,GAAG,CAAC;SACR,OAAO,CAAC,SAAS,CAAC;SAClB,QAAQ,CAAC,yDAAyD,CAAC;IACtE,QAAQ,EAAE,CAAC;SACR,IAAI,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;SAC/B,OAAO,CAAC,QAAQ,CAAC;SACjB,QAAQ,CAAC,oBAAoB,CAAC;IACjC,OAAO,EAAE,CAAC;SACP,OAAO,EAAE;SACT,OAAO,CAAC,IAAI,CAAC;SACb,QAAQ,CAAC,kCAAkC,CAAC;CAChD,CAAA;AAYD,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,IAAkB;IAC/C,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,qBAAqB,EAAE;QACpD,MAAM,EAAE,WAAW;QACnB,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,SAAS;QACpC,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,QAAQ;QACnC,OAAO,EAAE,IAAI,CAAC,OAAO,KAAK,KAAK;KAChC,CAAC,CAAA;IAEF,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,WAAW,CAAC,MAAM,CAAC,CAAA;IAC1C,OAAO,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;AAC9B,CAAC;AAED,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,YAAY,EAAE,CAAC;SACZ,MAAM,EAAE;SACR,IAAI,EAAE;SACN,QAAQ,CAAC,gBAAgB,CAAC;IAC7B,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,eAAe,CAAC;IAC5B,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,GAAG,CAAC,KAAK,CAAC;SACV,QAAQ,EAAE;SACV,QAAQ,CAAC,yBAAyB,CAAC;IACtC,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,kBAAkB,CAAC;IAC/B,QAAQ,EAAE,CAAC;SACR,IAAI,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;SAC/B,QAAQ,EAAE;SACV,QAAQ,CAAC,kBAAkB,CAAC;IAC/B,OAAO,EAAE,CAAC;SACP,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CAAC,uBAAuB,CAAC;CACrC,CAAA;AAYD,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,IAAkB;IAC/C,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,qBAAqB,EAAE;QACpD,MAAM,EAAE,WAAW;QACnB,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,OAAO,EAAE,IAAI,CAAC,OAAO;KACtB,CAAC,CAAA;IAEF,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,WAAW,CAAC,MAAM,CAAC,CAAA;IAC1C,OAAO,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;AAC9B,CAAC;AAED,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,YAAY,EAAE,CAAC;SACZ,MAAM,EAAE;SACR,IAAI,EAAE;SACN,QAAQ,CAAC,0BAA0B,CAAC;CACxC,CAAA;AAOD,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,IAAkB;IAC/C,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,qBAAqB,EAAE;QACpD,MAAM,EAAE,WAAW;QACnB,YAAY,EAAE,IAAI,CAAC,YAAY;KAChC,CAAC,CAAA;IAEF,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,WAAW,CAAC,MAAM,CAAC,CAAA;IAC1C,OAAO,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;AAC9B,CAAC;AAED,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,YAAY,EAAE,CAAC;SACZ,MAAM,EAAE;SACR,IAAI,EAAE;SACN,QAAQ,CAAC,0BAA0B,CAAC;IACvC,OAAO,EAAE,CAAC;SACP,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CAAC,iDAAiD,CAAC;CAC/D,CAAA;AAQD,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,IAAkB;IAC/C,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,qBAAqB,EAAE;QACpD,MAAM,EAAE,WAAW;QACnB,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,OAAO,EAAE,IAAI,CAAC,OAAO;KACtB,CAAC,CAAA;IAEF,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,WAAW,CAAC,MAAM,CAAC,CAAA;IAC1C,OAAO,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;AAC9B,CAAC;AAED,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,IAAI,EAAE;SACN,QAAQ,CAAC,cAAc,CAAC;CAC5B,CAAA;AAOD,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAyB;IAC7D,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,qBAAqB,EAAE;QACpD,MAAM,EAAE,kBAAkB;QAC1B,UAAU,EAAE,IAAI,CAAC,UAAU;KAC5B,CAAC,CAAA;IAEF,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,WAAW,CAAC,MAAM,CAAC,CAAA;IAC1C,OAAO,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;AAC9B,CAAC"}

package/dist/tools/reviews.d.ts

@@ -86,11 +86,11 @@ export declare const rvDecideSchema: {
     review_id: z.ZodString;
     transition: z.ZodEnum<{
         accept: "accept";
+        archive: "archive";
         submit: "submit";
         reject: "reject";
         request_revision: "request_revision";
         resubmit: "resubmit";
-        archive: "archive";
     }>;
     rationale: z.ZodOptional<z.ZodString>;
 };

package/dist/tools/update-document.d.ts

@@ -0,0 +1,38 @@
+/**
+ * doc_update -- Layer 2 Coordination
+ *
+ * Update title, body, or source_url of an ingest item.
+ * Supports full body replacement or append mode.
+ * Delegates to POST /api/mcp/documents (action: doc_update).
+ */
+import { z } from 'zod';
+export declare const updateDocumentSchema: {
+    document_id: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    body: z.ZodOptional<z.ZodString>;
+    source_url: z.ZodOptional<z.ZodString>;
+    append_body: z.ZodOptional<z.ZodString>;
+};
+type UpdateDocumentArgs = {
+    document_id: string;
+    title?: string;
+    body?: string;
+    source_url?: string;
+    append_body?: string;
+    user_id: string;
+};
+export declare function updateDocument(args: UpdateDocumentArgs): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+}>;
+export {};
+//# sourceMappingURL=update-document.d.ts.map

package/dist/tools/update-document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-document.d.ts","sourceRoot":"","sources":["../../src/tools/update-document.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,eAAO,MAAM,oBAAoB;;;;;;CAgBhC,CAAA;AAED,KAAK,kBAAkB,GAAG;IACxB,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,kBAAkB;;;;;;;;;;;;GA2B5D"}

package/dist/tools/update-document.js

@@ -0,0 +1,51 @@
+/**
+ * doc_update -- Layer 2 Coordination
+ *
+ * Update title, body, or source_url of an ingest item.
+ * Supports full body replacement or append mode.
+ * Delegates to POST /api/mcp/documents (action: doc_update).
+ */
+import { z } from 'zod';
+import { nexusPost } from '../nexus-api.js';
+export const updateDocumentSchema = {
+    document_id: z.string().uuid().describe('Document UUID to update'),
+    title: z.string().max(500).optional().describe('New document title'),
+    body: z
+        .string()
+        .max(100_000)
+        .optional()
+        .describe('New document body (replaces existing content)'),
+    source_url: z.string().url().optional().describe('Updated source URL'),
+    append_body: z
+        .string()
+        .max(100_000)
+        .optional()
+        .describe('Content to append to existing body (ignored if body is also provided)'),
+};
+export async function updateDocument(args) {
+    const result = await nexusPost('/api/mcp/documents', {
+        action: 'doc_update',
+        document_id: args.document_id,
+        title: args.title,
+        body: args.body,
+        source_url: args.source_url,
+        append_body: args.append_body,
+    });
+    if (!result.ok) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({ error: result.error }, null, 2),
+                },
+            ],
+            isError: true,
+        };
+    }
+    return {
+        content: [
+            { type: 'text', text: JSON.stringify(result.data, null, 2) },
+        ],
+    };
+}
+//# sourceMappingURL=update-document.js.map

package/dist/tools/update-document.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-document.js","sourceRoot":"","sources":["../../src/tools/update-document.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAE3C,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;IAClE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC;IACpE,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,GAAG,CAAC,OAAO,CAAC;SACZ,QAAQ,EAAE;SACV,QAAQ,CAAC,+CAA+C,CAAC;IAC5D,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC;IACtE,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;SACR,GAAG,CAAC,OAAO,CAAC;SACZ,QAAQ,EAAE;SACV,QAAQ,CACP,uEAAuE,CACxE;CACJ,CAAA;AAWD,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAwB;IAC3D,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,oBAAoB,EAAE;QACnD,MAAM,EAAE,YAAY;QACpB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,WAAW,EAAE,IAAI,CAAC,WAAW;KAC9B,CAAC,CAAA;IAEF,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;iBACvD;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAA;IACH,CAAC;IAED,OAAO;QACL,OAAO,EAAE;YACP,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE;SACtE;KACF,CAAA;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gwdn/nexus-mcp",
-  "version": "0.7.0",
+  "version": "0.8.1",
   "description": "MCP server for the Nexus platform",
   "type": "module",
   "main": "dist/server.js",

package/src/__tests__/server.test.ts

@@ -78,9 +78,9 @@ describe('MCP Server: withIdentity wrapper', () => {
 })
 
 describe('MCP Server: Schema exports', () => {
-  const EXPECTED_TOOL_COUNT = 38
+  const EXPECTED_TOOL_COUNT = 48
 
-  it('should register exactly 38 tools in server.ts', () => {
+  it('should register exactly 48 tools in server.ts', () => {
     // Static analysis: count server.tool( calls in server.ts as a regression guard.
     // If you add or remove a tool, update EXPECTED_TOOL_COUNT above.
     const serverSource = readFileSync(

package/src/server.ts

@@ -38,6 +38,13 @@
  *   - sk_assign: Assign a skill to a project
  *   - sk_unassign: Remove a skill assignment from a project
  *   - sk_export: Export all skill assignments for a project
+ *   - pd_list: List project directives
+ *   - pd_get: Get a specific directive
+ *   - pd_create: Create a new directive
+ *   - pd_update: Update an existing directive
+ *   - pd_delete: Delete a directive
+ *   - pd_toggle: Toggle directive enabled/disabled
+ *   - directive_export: Export enabled directives (CLI format)
  *   - doc_ingest: Push text/markdown content into project knowledge base
  *   - doc_list: List ingested documents for a project
  *   - session_append: Append to a session (write-isolated)
@@ -102,6 +109,18 @@ import {
   ingestDocument,
   ingestDocumentSchema,
 } from './tools/ingest-document.js'
+import {
+  classifyDocument,
+  classifyDocumentSchema,
+} from './tools/classify-document.js'
+import {
+  updateDocument,
+  updateDocumentSchema,
+} from './tools/update-document.js'
+import {
+  deleteDocument,
+  deleteDocumentSchema,
+} from './tools/delete-document.js'
 import {
   acknowledgeLetter,
   acknowledgeLetterSchema,
@@ -149,6 +168,22 @@ import {
   skUnassign,
   skUnassignSchema,
 } from './tools/skill-assign.js'
+import {
+  pdList,
+  pdListSchema,
+  pdGet,
+  pdGetSchema,
+  pdCreate,
+  pdCreateSchema,
+  pdUpdate,
+  pdUpdateSchema,
+  pdDelete,
+  pdDeleteSchema,
+  pdToggle,
+  pdToggleSchema,
+  directiveExport,
+  directiveExportSchema,
+} from './tools/directives.js'
 import {
   updateTaskStatus,
   updateTaskStatusSchema,
@@ -202,7 +237,7 @@ function withIdentity(handler: (args: any) => Promise<any>) {
 const server = new McpServer(
   {
     name: 'nexus-mcp',
-    version: '0.6.1',
+    version: '0.8.0',
   },
   {
     capabilities: {
@@ -331,6 +366,27 @@ server.tool(
   withIdentity(listDocuments),
 )
 
+server.tool(
+  'doc_classify',
+  'Update the classification of an ingest item. Valid classifications: unclassified, research_note, planning_item, decision_input, reference, archive.',
+  classifyDocumentSchema,
+  withIdentity(classifyDocument),
+)
+
+server.tool(
+  'doc_update',
+  'Update title, body, or source_url of an ingest item. Supports full body replacement or append mode via append_body. At least one field must be provided.',
+  updateDocumentSchema,
+  withIdentity(updateDocument),
+)
+
+server.tool(
+  'doc_delete',
+  'Delete an ingest item from a project knowledge base. This action is irreversible.',
+  deleteDocumentSchema,
+  withIdentity(deleteDocument),
+)
+
 server.tool(
   'session_append',
   'Append an entry to an existing session. Enforces session write isolation: only the session creator can append entries.',
@@ -437,6 +493,59 @@ server.tool(
   withIdentity(skExport),
 )
 
+// ---------------------------------------------------------------------------
+// Layer 2 (continued): Project Directives tools
+// ---------------------------------------------------------------------------
+
+server.tool(
+  'pd_list',
+  'List project directives with optional enabled filter. Returns directives ordered by priority and creation date.',
+  pdListSchema,
+  withIdentity(pdList),
+)
+
+server.tool(
+  'pd_get',
+  'Get a specific project directive by UUID. Returns full directive details.',
+  pdGetSchema,
+  withIdentity(pdGet),
+)
+
+server.tool(
+  'pd_create',
+  'Create a new project directive. Directives are project-scoped rules/policies that guide agent behavior.',
+  pdCreateSchema,
+  withIdentity(pdCreate),
+)
+
+server.tool(
+  'pd_update',
+  'Update an existing project directive. Supports partial updates for title, body, category, priority, and enabled state.',
+  pdUpdateSchema,
+  withIdentity(pdUpdate),
+)
+
+server.tool(
+  'pd_delete',
+  'Delete a project directive by UUID.',
+  pdDeleteSchema,
+  withIdentity(pdDelete),
+)
+
+server.tool(
+  'pd_toggle',
+  'Toggle a project directive enabled/disabled. Omit enabled parameter to invert current state.',
+  pdToggleSchema,
+  withIdentity(pdToggle),
+)
+
+server.tool(
+  'directive_export',
+  'Export all enabled directives for a project in CLI-compatible format.',
+  directiveExportSchema,
+  withIdentity(directiveExport),
+)
+
 // ---------------------------------------------------------------------------
 // Layer 3: Governance tools
 // ---------------------------------------------------------------------------

package/src/tools/classify-document.ts

@@ -0,0 +1,55 @@
+/**
+ * doc_classify -- Layer 2 Coordination
+ *
+ * Update the classification of an ingest item.
+ * Delegates to POST /api/mcp/documents (action: doc_classify).
+ */
+
+import { z } from 'zod'
+import { nexusPost } from '../nexus-api.js'
+
+export const classifyDocumentSchema = {
+  document_id: z.string().uuid().describe('Document UUID to classify'),
+  classification: z
+    .enum([
+      'unclassified',
+      'research_note',
+      'planning_item',
+      'decision_input',
+      'reference',
+      'archive',
+    ])
+    .describe('New classification for the document'),
+}
+
+type ClassifyDocumentArgs = {
+  document_id: string
+  classification: string
+  user_id: string
+}
+
+export async function classifyDocument(args: ClassifyDocumentArgs) {
+  const result = await nexusPost('/api/mcp/documents', {
+    action: 'doc_classify',
+    document_id: args.document_id,
+    classification: args.classification,
+  })
+
+  if (!result.ok) {
+    return {
+      content: [
+        {
+          type: 'text' as const,
+          text: JSON.stringify({ error: result.error }, null, 2),
+        },
+      ],
+      isError: true,
+    }
+  }
+
+  return {
+    content: [
+      { type: 'text' as const, text: JSON.stringify(result.data, null, 2) },
+    ],
+  }
+}

package/src/tools/delete-document.ts

@@ -0,0 +1,43 @@
+/**
+ * doc_delete -- Layer 2 Coordination
+ *
+ * Delete an ingest item from a project's knowledge base.
+ * Delegates to POST /api/mcp/documents (action: doc_delete).
+ */
+
+import { z } from 'zod'
+import { nexusPost } from '../nexus-api.js'
+
+export const deleteDocumentSchema = {
+  document_id: z.string().uuid().describe('Document UUID to delete'),
+}
+
+type DeleteDocumentArgs = {
+  document_id: string
+  user_id: string
+}
+
+export async function deleteDocument(args: DeleteDocumentArgs) {
+  const result = await nexusPost('/api/mcp/documents', {
+    action: 'doc_delete',
+    document_id: args.document_id,
+  })
+
+  if (!result.ok) {
+    return {
+      content: [
+        {
+          type: 'text' as const,
+          text: JSON.stringify({ error: result.error }, null, 2),
+        },
+      ],
+      isError: true,
+    }
+  }
+
+  return {
+    content: [
+      { type: 'text' as const, text: JSON.stringify(result.data, null, 2) },
+    ],
+  }
+}

package/src/tools/directives.ts

@@ -0,0 +1,303 @@
+/**
+ * pd_list + pd_get + pd_create + pd_update + pd_delete + pd_toggle + directive_export
+ *
+ * Project Directives management tools for the Nexus platform.
+ * Directives are project-scoped rules/policies that guide agent behavior.
+ * Delegates to POST /api/mcp/directives.
+ */
+
+import { z } from 'zod'
+import { nexusPost } from '../nexus-api.js'
+
+// ---------------------------------------------------------------------------
+// Shared helpers
+// ---------------------------------------------------------------------------
+
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function errorResult(result: { error: string | null }) {
+  return {
+    content: [
+      {
+        type: 'text' as const,
+        text: JSON.stringify({ error: result.error }, null, 2),
+      },
+    ],
+    isError: true,
+  }
+}
+
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function okResult(data: any) {
+  return {
+    content: [
+      { type: 'text' as const, text: JSON.stringify(data, null, 2) },
+    ],
+  }
+}
+
+// ---------------------------------------------------------------------------
+// pd_list
+// ---------------------------------------------------------------------------
+
+export const pdListSchema = {
+  project_id: z
+    .string()
+    .uuid()
+    .describe('Project UUID'),
+  enabled: z
+    .boolean()
+    .optional()
+    .describe('Filter by enabled status'),
+  limit: z
+    .number()
+    .min(1)
+    .max(100)
+    .default(50)
+    .describe('Maximum results to return'),
+}
+
+type PdListArgs = {
+  project_id: string
+  enabled?: boolean
+  limit?: number
+  user_id: string
+}
+
+export async function pdList(args: PdListArgs) {
+  const result = await nexusPost('/api/mcp/directives', {
+    action: 'pd_list',
+    project_id: args.project_id,
+    enabled: args.enabled,
+    limit: args.limit ?? 50,
+  })
+
+  if (!result.ok) return errorResult(result)
+  return okResult(result.data)
+}
+
+// ---------------------------------------------------------------------------
+// pd_get
+// ---------------------------------------------------------------------------
+
+export const pdGetSchema = {
+  directive_id: z
+    .string()
+    .uuid()
+    .describe('Directive UUID'),
+}
+
+type PdGetArgs = {
+  directive_id: string
+  user_id: string
+}
+
+export async function pdGet(args: PdGetArgs) {
+  const result = await nexusPost('/api/mcp/directives', {
+    action: 'pd_get',
+    directive_id: args.directive_id,
+  })
+
+  if (!result.ok) return errorResult(result)
+  return okResult(result.data)
+}
+
+// ---------------------------------------------------------------------------
+// pd_create
+// ---------------------------------------------------------------------------
+
+export const pdCreateSchema = {
+  project_id: z
+    .string()
+    .uuid()
+    .describe('Project UUID'),
+  title: z
+    .string()
+    .max(500)
+    .describe('Directive title'),
+  body: z
+    .string()
+    .max(10000)
+    .optional()
+    .describe('Directive body (markdown)'),
+  category: z
+    .string()
+    .max(100)
+    .default('general')
+    .describe('Directive category (e.g. general, security, deployment)'),
+  priority: z
+    .enum(['low', 'medium', 'high'])
+    .default('medium')
+    .describe('Directive priority'),
+  enabled: z
+    .boolean()
+    .default(true)
+    .describe('Whether the directive is enabled'),
+}
+
+type PdCreateArgs = {
+  project_id: string
+  title: string
+  body?: string
+  category?: string
+  priority?: string
+  enabled?: boolean
+  user_id: string
+}
+
+export async function pdCreate(args: PdCreateArgs) {
+  const result = await nexusPost('/api/mcp/directives', {
+    action: 'pd_create',
+    project_id: args.project_id,
+    title: args.title,
+    body: args.body,
+    category: args.category ?? 'general',
+    priority: args.priority ?? 'medium',
+    enabled: args.enabled !== false,
+  })
+
+  if (!result.ok) return errorResult(result)
+  return okResult(result.data)
+}
+
+// ---------------------------------------------------------------------------
+// pd_update
+// ---------------------------------------------------------------------------
+
+export const pdUpdateSchema = {
+  directive_id: z
+    .string()
+    .uuid()
+    .describe('Directive UUID'),
+  title: z
+    .string()
+    .max(500)
+    .optional()
+    .describe('Updated title'),
+  body: z
+    .string()
+    .max(10000)
+    .optional()
+    .describe('Updated body (markdown)'),
+  category: z
+    .string()
+    .max(100)
+    .optional()
+    .describe('Updated category'),
+  priority: z
+    .enum(['low', 'medium', 'high'])
+    .optional()
+    .describe('Updated priority'),
+  enabled: z
+    .boolean()
+    .optional()
+    .describe('Updated enabled state'),
+}
+
+type PdUpdateArgs = {
+  directive_id: string
+  title?: string
+  body?: string
+  category?: string
+  priority?: string
+  enabled?: boolean
+  user_id: string
+}
+
+export async function pdUpdate(args: PdUpdateArgs) {
+  const result = await nexusPost('/api/mcp/directives', {
+    action: 'pd_update',
+    directive_id: args.directive_id,
+    title: args.title,
+    body: args.body,
+    category: args.category,
+    priority: args.priority,
+    enabled: args.enabled,
+  })
+
+  if (!result.ok) return errorResult(result)
+  return okResult(result.data)
+}
+
+// ---------------------------------------------------------------------------
+// pd_delete
+// ---------------------------------------------------------------------------
+
+export const pdDeleteSchema = {
+  directive_id: z
+    .string()
+    .uuid()
+    .describe('Directive UUID to delete'),
+}
+
+type PdDeleteArgs = {
+  directive_id: string
+  user_id: string
+}
+
+export async function pdDelete(args: PdDeleteArgs) {
+  const result = await nexusPost('/api/mcp/directives', {
+    action: 'pd_delete',
+    directive_id: args.directive_id,
+  })
+
+  if (!result.ok) return errorResult(result)
+  return okResult(result.data)
+}
+
+// ---------------------------------------------------------------------------
+// pd_toggle
+// ---------------------------------------------------------------------------
+
+export const pdToggleSchema = {
+  directive_id: z
+    .string()
+    .uuid()
+    .describe('Directive UUID to toggle'),
+  enabled: z
+    .boolean()
+    .optional()
+    .describe('Explicit enabled state (omit to invert current)'),
+}
+
+type PdToggleArgs = {
+  directive_id: string
+  enabled?: boolean
+  user_id: string
+}
+
+export async function pdToggle(args: PdToggleArgs) {
+  const result = await nexusPost('/api/mcp/directives', {
+    action: 'pd_toggle',
+    directive_id: args.directive_id,
+    enabled: args.enabled,
+  })
+
+  if (!result.ok) return errorResult(result)
+  return okResult(result.data)
+}
+
+// ---------------------------------------------------------------------------
+// directive_export
+// ---------------------------------------------------------------------------
+
+export const directiveExportSchema = {
+  project_id: z
+    .string()
+    .uuid()
+    .describe('Project UUID'),
+}
+
+type DirectiveExportArgs = {
+  project_id: string
+  user_id: string
+}
+
+export async function directiveExport(args: DirectiveExportArgs) {
+  const result = await nexusPost('/api/mcp/directives', {
+    action: 'directive_export',
+    project_id: args.project_id,
+  })
+
+  if (!result.ok) return errorResult(result)
+  return okResult(result.data)
+}