drafted 1.2.4 → 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']).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)'),
@@ -1791,6 +1791,14 @@ tool('wiki', 'Per-org wiki. Markdown pages with paths as hierarchy. You and othe
   from: z.string().optional().describe('[mv] source path'),
   to: z.string().optional().describe('[mv] destination path'),
   dryRun: z.boolean().optional().describe('[mv|rm] preview impact without applying changes'),
+  file_path: z.string().optional().describe('[source-register] absolute path to a local file. Server hashes it and registers the source. stdio MCP only.'),
+  contentHash: z.string().optional().describe('[source-register|source-list] hex-encoded SHA-256 (64 chars). Use when the client already hashed the bytes (HTTP MCP).'),
+  filename: z.string().optional().describe('[source-register] original filename for the source (informational)'),
+  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;
@@ -1807,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']);
+    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);
@@ -2043,6 +2051,95 @@ 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
+      // with `isNew: false` and the pages already derived from it. This is
+      // the dedup boundary — if isNew=false and derivedPages is non-empty,
+      // the agent should extend those pages, not create new ones.
+      case 'source-register': {
+        const { file_path: srcFile, contentHash, filename, contentType, size } = args;
+        if (!srcFile && !contentHash) throw new Error('file_path or contentHash required for action=source-register');
+        const body = {};
+        if (contentHash) body.contentHash = contentHash;
+        if (filename) body.filename = filename;
+        if (contentType) body.contentType = contentType;
+        if (size !== undefined) body.size = size;
+        if (srcFile && !contentHash) {
+          // Hash locally — server may not be able to read this client's filesystem.
+          if (!existsSync(srcFile)) throw new Error(`file not found: ${srcFile}`);
+          const buf = readFileSync(srcFile);
+          body.contentHash = createHash('sha256').update(buf).digest('hex');
+          body.size = body.size ?? buf.byteLength;
+          body.filename = body.filename ?? basename(srcFile);
+        }
+        const result = await api('POST', '/api/wiki/sources', body);
+        return ok(withOrg(result));
+      }
+
+      // ── source-list ────────────────────────────────────────────
+      case 'source-list': {
+        const { contentHash, limit: srcLimit = 50 } = args;
+        if (contentHash) {
+          try {
+            const result = await api('GET', `/api/wiki/sources?hash=${encodeURIComponent(contentHash)}`);
+            return ok({ sources: [result] });
+          } catch (e) {
+            if (/Not found/.test(e.message)) return ok({ sources: [] });
+            throw e;
+          }
+        }
+        const result = await api('GET', `/api/wiki/sources?limit=${srcLimit}`);
+        return ok(result);
+      }
+
+      // ── source-get ─────────────────────────────────────────────
+      case 'source-get': {
+        const { sourceId } = args;
+        if (!sourceId) throw new Error('sourceId required for action=source-get');
+        const result = await api('GET', `/api/wiki/sources/${encodeURIComponent(sourceId)}`);
+        return ok(result);
+      }
+
       default:
         throw new Error(`Unknown wiki action: ${action}`);
     }

package/package.json

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