codiedev 0.5.3 → 0.5.5

package/dist/mcp.js

@@ -117,11 +117,13 @@ const TOOLS = [
     },
     {
         name: "codiedev_pull",
-        description: "Fetch an artifact (spec, review, decision, proposal, bugfix, or " +
-            "note) from the team's CodieDev artifact layer. Use when the user " +
-            "asks to pull, grab, fetch, or resume work on a named artifact, or " +
-            "when they want to see what a teammate pushed. Returns the full " +
-            "markdown content.",
+        description: "Fetch any artifact (doc or skill) from the team's CodieDev artifact " +
+            "layer. Works for specs, decisions, proposals, bugfixes, reviews, " +
+            "notes, AND skills (SKILL.md frontmatter files surfaced as slash " +
+            "commands). Use when the user asks to pull, grab, fetch, or resume " +
+            "work on a named artifact, when they want to load a skill into " +
+            "their session (e.g. 'pull the writing-emails skill'), or when they " +
+            "want to see what a teammate pushed. Returns the full markdown.",
         inputSchema: {
             type: "object",
             properties: {
@@ -394,10 +396,13 @@ const TOOLS = [
     },
     {
         name: "codiedev_get_library",
-        description: "List artifacts in the team library, scoped to what the current " +
-            "user authored, what's been shared with them, or everything in the " +
-            "company. Use when the user asks 'show me my artifacts', 'what did " +
-            "I push?', 'what has Greg shared with me?', or 'browse the library'.",
+        description: "List artifacts in the team library — both docs (spec / decision / " +
+            "proposal / bugfix / review / note) and skills (SKILL.md frontmatter " +
+            "files surfaced as slash commands). Each row reports its `kind` " +
+            "(doc | skill) and `tags`. Use when the user asks 'show me my " +
+            "artifacts', 'what skills do we have?', 'what did I push?', 'what " +
+            "has Greg shared with me?', or 'browse the library'. Filter by " +
+            "`kind` to narrow to docs-only or skills-only.",
         inputSchema: {
             type: "object",
             properties: {
@@ -407,10 +412,24 @@ const TOOLS = [
                     description: "'mine' = artifacts I authored (default). 'shared' = artifacts " +
                         "explicitly shared with me. 'all' = everything in the company.",
                 },
+                kind: {
+                    type: "string",
+                    enum: ["doc", "skill"],
+                    description: "Filter to one kind. `skill` = files with SKILL.md frontmatter " +
+                        "(slash commands). `doc` = everything else (specs, decisions, " +
+                        "etc.). Omit to return both.",
+                },
+                tag: {
+                    type: "string",
+                    description: "Filter to one tag (e.g. 'spec', 'decision', 'auth'). The " +
+                        "legacy doc-shape (spec/decision/...) is automatically " +
+                        "available as a tag, plus anything the author added.",
+                },
                 type: {
                     type: "string",
                     enum: ["spec", "bugfix", "decision", "proposal", "review", "note"],
-                    description: "Filter to one artifact type.",
+                    description: "Legacy doc-shape filter — kept for back-compat. Prefer `kind` " +
+                        "or `tag` for new code.",
                 },
                 folderPath: { type: "string", description: "Filter to one folder path." },
                 limit: { type: "integer", description: "Max rows. Default 50." },
@@ -602,8 +621,15 @@ async function handlePull(args, config) {
         throw new Error("key required");
     const res = await (0, shared_1.apiRequest)("GET", "/api/cli/pull", { config, query: { key, version } });
     const a = res.artifact;
+    // Lead with the new-vocab kind. Legacy doc-shape (spec/decision/...) is
+    // surfaced as a tag list after, so callers still see it but it's no
+    // longer the primary label. Falls back to "doc" if the row pre-dates the
+    // kind field.
+    const kindLabel = a.kind ?? "doc";
+    const tagList = (a.tags ?? []).filter((t) => t).join(", ");
+    const tagSuffix = tagList ? ` · tags: ${tagList}` : "";
     const header = `# ${a.title}\n\n` +
-        `**${a.type}** · v${a.version ?? 1} · ${a.lifecycle ?? "draft"} · ` +
+        `**${kindLabel}** · v${a.version ?? 1} · ${a.lifecycle ?? "draft"}${tagSuffix} · ` +
         `updated ${(0, shared_1.timeAgo)(a.updatedAt ?? a.createdAt)}\n\n---\n\n`;
     return {
         content: [{ type: "text", text: header + a.markdown }],
@@ -775,16 +801,48 @@ async function handleShareWith(args, config) {
             config,
             body: { filename, to, role },
         });
-        const verb = res.action === "added"
-            ? "Shared"
-            : res.action === "updated"
-                ? "Updated share for"
-                : "Already shared with";
+        const target = `${res.recipient.name} <${res.recipient.email}>`;
+        if (res.added) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `✓ Shared ${target} on ${filename} (role=${role ?? "read"}).`,
+                    },
+                ],
+            };
+        }
+        if (res.updated) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `✓ Updated share for ${target} on ${filename} (role=${role ?? "read"}).`,
+                    },
+                ],
+            };
+        }
+        // noop / duplicate path — surface where the existing grant came from so
+        // the user knows whether to expect it next time.
+        const e = res.existing;
+        let why = "";
+        if (e) {
+            const when = e.grantedAt ? ` ${(0, shared_1.timeAgo)(e.grantedAt)}` : "";
+            if (e.source === "self") {
+                why = ` — you already shared it with them${when} (role=${e.role}).`;
+            }
+            else if (e.source === "auto") {
+                why = ` — granted automatically${when} (role=${e.role}). No action needed next time.`;
+            }
+            else {
+                why = ` — ${e.granterLabel} shared it${when} (role=${e.role}).`;
+            }
+        }
         return {
             content: [
                 {
                     type: "text",
-                    text: `✓ ${verb} ${res.recipient.name} <${res.recipient.email}> on ${filename} (role=${role ?? "read"}).`,
+                    text: `✓ Already shared with ${target} on ${filename}${why}`,
                 },
             ],
         };
@@ -867,6 +925,8 @@ async function handleSearch(args, config) {
 async function handleGetLibrary(args, config) {
     const scope = asStringOrUndefined(args.scope);
     const type = asStringOrUndefined(args.type);
+    const kind = asStringOrUndefined(args.kind);
+    const tag = asStringOrUndefined(args.tag);
     const folderPath = asStringOrUndefined(args.folderPath);
     const limit = asIntOrUndefined(args.limit);
     const res = await (0, shared_1.apiRequest)("GET", "/api/cli/library", {
@@ -874,6 +934,8 @@ async function handleGetLibrary(args, config) {
         query: {
             scope,
             type,
+            kind,
+            tag,
             folderPath,
             limit: limit?.toString(),
         },
@@ -889,7 +951,7 @@ async function handleGetLibrary(args, config) {
         };
     }
     const lines = [
-        `Library · scope=${scope ?? "mine"} · ${res.artifacts.length} item${res.artifacts.length === 1 ? "" : "s"}`,
+        `Library · scope=${scope ?? "mine"}${kind ? ` · kind=${kind}` : ""} · ${res.artifacts.length} item${res.artifacts.length === 1 ? "" : "s"}`,
         "",
     ];
     for (const a of res.artifacts) {
@@ -897,7 +959,12 @@ async function handleGetLibrary(args, config) {
         const v = a.version ? ` v${a.version}` : "";
         const life = a.lifecycle ? ` · ${a.lifecycle}` : "";
         const when = a.updatedAt ? ` · ${(0, shared_1.timeAgo)(a.updatedAt)}` : "";
-        lines.push(`[${a.type}] ${loc}${a.key ?? a.title}${v}${life}${when}`);
+        // Lead with the canonical kind (doc | skill). Tags carry the legacy
+        // doc-shape (spec/decision/...) plus any author-added labels — surface
+        // them after the kind so the row is self-describing.
+        const k = a.kind ?? (a.type === "note" ? "doc" : "doc");
+        const tagList = (a.tags ?? []).length > 0 ? ` [${a.tags.join(", ")}]` : "";
+        lines.push(`[${k}]${tagList} ${loc}${a.key ?? a.title}${v}${life}${when}`);
         lines.push(`    ${a.title}`);
         lines.push("");
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codiedev",
-  "version": "0.5.3",
+  "version": "0.5.5",
   "description": "Connect Claude Code or Codex to CodieDev for org-wide session capture and artifact collaboration",
   "bin": {
     "codiedev": "./dist/cli.js",