drafted 1.2.3 → 1.3.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']).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,12 @@ 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'),
 }, async (args) => {
   try {
     const { action } = args;
@@ -1804,8 +1810,12 @@ tool('wiki', 'Per-org wiki. Markdown pages with paths as hierarchy. You and othe
     const withOrg = (result) => ({ ...result, org: orgCtx });
 
     // ── Skill gate: all mutation actions ──────────────────────────
-    const MUTATING = new Set(['write', 'edit', 'mv', 'rm', 'log']);
+    // 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']);
     if (MUTATING.has(action)) {
+      try { await api('POST', '/api/wiki/_ensure-skill'); } catch { /* non-fatal */ }
       const skillErr = await checkOrgSkills(orgId, action);
       if (skillErr) return err(new Error(skillErr));
     }
@@ -2039,6 +2049,56 @@ 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 }));
       }
 
+      // ── 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.3",
+  "version": "1.3.0",
   "description": "Drafted CLI - Design preview server for Claude agents",
   "type": "module",
   "files": [