drafted 1.10.2 → 1.11.0

package/mcp/server.mjs

@@ -2679,9 +2679,9 @@ function collectSkillTreeForPush(dir) {
   return out;
 }
 
-tool('skill', 'Manage the Drafted skill library. Skills are reusable prompts/guidelines agents can load and follow. Dispatch by `action`: search/load/list for discovery; add/update/remove for org skills; fork/push for source-only skills; attach/detach for project binding; favorite/unfavorite for personal pins; read_file/update_file for supporting files inside a skill directory.', {
+tool('skill', 'Manage the Drafted skill library. Skills are reusable prompts/guidelines agents can load and follow. Dispatch by `action`: search/load/list for discovery; history for a skill\'s version git-log; add/update/remove for org skills; fork/push for source-only skills; attach/detach for project binding; favorite/unfavorite for personal pins; read_file/update_file for supporting files inside a skill directory.', {
   action: z.enum([
-    'search', 'load', 'list',
+    'search', 'load', 'list', 'history',
     'add', 'update', 'remove',
     'fork', 'push',
     'attach', 'detach',
@@ -2694,7 +2694,8 @@ tool('skill', 'Manage the Drafted skill library. Skills are reusable prompts/gui
   limit: z.number().optional().describe('[search|list] max results per page (default 25, max 100)'),
   offset: z.number().optional().describe('[search|list] skip N results for pagination (default 0). Response reports totalAvailable/returned/truncated.'),
   compact: z.boolean().optional().describe('[search|list] return only {slug,name,tags} per skill instead of full summaries — for browsing large catalogs within token budget'),
-  skill: z.string().optional().describe('[load] skill ID (UUID) or slug'),
+  skill: z.string().optional().describe('[load|history] skill ID (UUID) or slug'),
+  version: z.number().optional().describe('[history] fetch this version number\'s full snapshot (content included); omit for the reverse-chron version list'),
   skillId: z.string().optional().describe('[update|remove|attach|detach|favorite|unfavorite|read_file|update_file] skill ID'),
   projectId: z.string().optional().describe('[list] project to list skills for (defaults to active project; falls back to org-attached skills if no project)'),
   name: z.string().optional().describe('[add|update] skill name'),
@@ -2732,6 +2733,17 @@ tool('skill', 'Manage the Drafted skill library. Skills are reusable prompts/gui
         if (result?.id) getSessionState().loadedSkillIds.add(result.id);
         return ok(result);
       }
+      case 'history': {
+        // Skill version git-log. Omit `version` for the list; pass it for a
+        // single version's full snapshot (content for view/diff).
+        const { skillId, skill: slugArg, version, org } = args;
+        const extra = org ? { 'X-Drafted-Org': org } : {};
+        let id = skillId;
+        if (!id && slugArg) { const s = await api('GET', `/api/skills/slug/${slugArg}`, undefined, extra); id = s.id; }
+        if (!id) throw new Error('skillId or skill (slug) required for action=history');
+        if (version != null) return ok(await api('GET', `/api/skills/${id}/versions/${version}`, undefined, extra));
+        return ok(await api('GET', `/api/skills/${id}/versions`, undefined, extra));
+      }
       case 'list': {
         if (args.scope || args.tags?.length) {
           const params = new URLSearchParams();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "drafted",
-  "version": "1.10.2",
+  "version": "1.11.0",
   "description": "Drafted — visual thinking surface for humans and AI agents. Renders HTML, markdown, images, and code as frames on a zoomable canvas, with MCP tools for AI agents and real-time sync for humans.",
   "type": "module",
   "files": [