drafted 1.3.0 → 1.4.0

package/mcp/server.mjs

@@ -1772,7 +1772,7 @@ tool('skill', 'Manage the Drafted skill library. Skills are reusable prompts/gui
 // skill gate; mutations require org-level wiki-maintainer skills loaded.
 
 tool('wiki', 'Per-org wiki. Markdown pages with paths as hierarchy. You and other agents/humans share maintenance — every edit broadcasts live, and edits from others appear in `recent` and on `read`.\n\nBefore mutating: check `recent` and `search` for relevant existing pages. Before mv/rm: check `links` (or pass `dryRun=true`). After completing a logical session of work, append a `log` entry.\n\nThe tool handles bookkeeping you\'d otherwise forget: `mv` rewrites inbound references via the link index, `read` shows who edited last and when. Use `health` to find unlinked pages and broken links.\n\n**Skill gate:** the org may attach a `wiki-maintainer` skill that you MUST load before mutations. If you get a skill-gate error, run skill(action="load", skill="wiki-maintainer") then retry.', {
-  action: z.enum(['ls', 'recent', 'read', 'search', 'links', 'log', 'health', 'write', 'edit', 'mv', 'rm', 'source-register', 'source-list', 'source-get']).describe('Operation to perform.'),
+  action: z.enum(['ls', 'recent', 'read', 'search', 'links', 'log', 'health', 'write', 'edit', 'mv', 'rm', 'source-register', 'source-list', 'source-get', 'bulk-write']).describe('Operation to perform.'),
   path: z.string().optional().describe('[ls|read|links] wiki path. For ls: default / (root). For read: required. For links: required.'),
   recursive: z.boolean().optional().describe('[ls] list recursively with depth indicators'),
   limit: z.number().optional().describe('[recent|search] max results (recent default 10, search default 25)'),
@@ -1797,6 +1797,8 @@ tool('wiki', 'Per-org wiki. Markdown pages with paths as hierarchy. You and othe
   contentType: z.string().optional().describe('[source-register] MIME type (informational)'),
   size: z.number().optional().describe('[source-register] byte size (informational)'),
   sourceId: z.string().optional().describe('[source-get] source ID returned from source-register'),
+  manifest_path: z.string().optional().describe('[bulk-write] absolute path to a JSON file containing {pages: [{path, title, content, type?, frontmatter?}, ...]}. The MCP wrapper reads the file locally and posts the array to the server in a single request — avoids round-tripping every page through tool args.'),
+  pages: z.array(z.any()).optional().describe('[bulk-write] alternative to manifest_path: pass the pages array inline.'),
 }, async (args) => {
   try {
     const { action } = args;
@@ -1813,7 +1815,7 @@ tool('wiki', 'Per-org wiki. Markdown pages with paths as hierarchy. You and othe
     // Ensure the wiki-maintainer skill is attached to this org BEFORE the
     // gate check, so the gate fires reliably on the very first wiki call —
     // not just after the org has visited /wiki in a browser. Idempotent.
-    const MUTATING = new Set(['write', 'edit', 'mv', 'rm', 'log', 'source-register']);
+    const MUTATING = new Set(['write', 'edit', 'mv', 'rm', 'log', 'source-register', 'bulk-write']);
     if (MUTATING.has(action)) {
       try { await api('POST', '/api/wiki/_ensure-skill'); } catch { /* non-fatal */ }
       const skillErr = await checkOrgSkills(orgId, action);
@@ -2049,6 +2051,45 @@ tool('wiki', 'Per-org wiki. Markdown pages with paths as hierarchy. You and othe
         return ok(withOrg({ deleted: true, path: normalized, id: page.id, brokenReferences: broken }));
       }
 
+      // ── bulk-write ──────────────────────────────────────────────
+      // Commit many pages in a single transaction. The MCP wrapper reads
+      // the manifest file locally and posts the pages array inline to
+      // /api/wiki/pages/bulk — avoids paying a tool-call round-trip per
+      // page and keeps the orchestrator's context clean.
+      case 'bulk-write': {
+        const { manifest_path, pages: inlinePages } = args;
+        let pages;
+        if (manifest_path) {
+          if (!existsSync(manifest_path)) throw new Error(`manifest not found: ${manifest_path}`);
+          const text = readFileSync(manifest_path, 'utf8');
+          let parsed;
+          try { parsed = JSON.parse(text); } catch (e) { throw new Error(`invalid JSON in ${manifest_path}: ${e.message}`); }
+          // Accept either {pages: [...]} or a bare array
+          pages = Array.isArray(parsed) ? parsed : parsed.pages;
+        } else if (Array.isArray(inlinePages)) {
+          pages = inlinePages;
+        } else {
+          throw new Error('bulk-write requires either manifest_path or pages array');
+        }
+        if (!Array.isArray(pages) || pages.length === 0) throw new Error('pages array is empty');
+        // Strip surplus fields the server ignores; keep payload tight.
+        const payload = pages.map((p) => ({
+          path: p.path,
+          title: p.title,
+          content: p.content,
+          type: p.type,
+          frontmatter: p.frontmatter,
+        }));
+        const result = await api('POST', '/api/wiki/pages/bulk', { pages: payload });
+        return ok(withOrg({
+          created: result.created?.length ?? 0,
+          updated: result.updated?.length ?? 0,
+          createdPaths: (result.created ?? []).map((r) => r.path),
+          updatedPaths: (result.updated ?? []).map((r) => r.path),
+          errors: result.errors ?? [],
+        }));
+      }
+
       // ── source-register ────────────────────────────────────────
       // Register an external source (paper, article, transcript) by content
       // hash. Idempotent: same hash + same org returns the existing source

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "drafted",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "Drafted CLI - Design preview server for Claude agents",
   "type": "module",
   "files": [