codiedev 0.5.2 → 0.5.4

package/dist/cli.js

@@ -17,6 +17,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const connect_1 = require("./connect");
 const push_1 = require("./commands/push");
+const delete_1 = require("./commands/delete");
 const pull_1 = require("./commands/pull");
 const ping_1 = require("./commands/ping");
 const inbox_1 = require("./commands/inbox");
@@ -39,6 +40,9 @@ Artifacts:
   codiedev push <file.md>                Author or update an artifact
   codiedev pull <key> [--version N] [--out path]
                                          Fetch an artifact (stdout by default)
+  codiedev delete <key> [-y]             Delete every version of an artifact you
+                                         authored (clean up bad/test pushes).
+                                         Asks for confirmation; -y to skip.
   codiedev promote <artifact-id>         Promote an auto-extracted artifact
                                          to an authored one
   codiedev reverse-ticket [<pr-url>]     Generate a Jira ticket draft.
@@ -363,6 +367,10 @@ async function main() {
             case "push":
                 await (0, push_1.runPush)(rest);
                 return;
+            case "delete":
+            case "rm":
+                await (0, delete_1.runDelete)(rest);
+                return;
             case "pull":
                 await (0, pull_1.runPull)(rest);
                 return;

package/dist/commands/delete.d.ts

@@ -0,0 +1 @@
+export declare function runDelete(args: string[]): Promise<void>;

package/dist/commands/delete.js

@@ -0,0 +1,96 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runDelete = runDelete;
+const readline = __importStar(require("readline"));
+const shared_1 = require("./shared");
+function parseArgs(args) {
+    let key;
+    let yes = false;
+    for (const a of args) {
+        if (a === "-y" || a === "--yes") {
+            yes = true;
+        }
+        else if (!a.startsWith("--") && !key) {
+            key = a;
+        }
+    }
+    if (!key) {
+        console.error("Usage: codiedev delete <key> [-y]");
+        console.error("Example: codiedev delete spec-old.md");
+        process.exit(1);
+    }
+    return { key, yes };
+}
+async function confirm(prompt) {
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    const answer = await new Promise((resolve) => {
+        rl.question(prompt, (ans) => resolve(ans));
+    });
+    rl.close();
+    return /^y(es)?$/i.test(answer.trim());
+}
+async function runDelete(args) {
+    const { key, yes } = parseArgs(args);
+    const config = (0, shared_1.requireConfig)();
+    if (!yes) {
+        const ok = await confirm(`Delete every version of '${key}' (and its replies)? This cannot be undone. [y/N] `);
+        if (!ok) {
+            console.log("Cancelled.");
+            return;
+        }
+    }
+    try {
+        const res = await (0, shared_1.apiRequest)("POST", "/api/cli/delete", {
+            config,
+            body: { key },
+        });
+        if (res.deleted === 0) {
+            console.log(`No artifact found with key '${key}'. Nothing to delete.`);
+            return;
+        }
+        const cascaded = res.cascadedMessages > 0
+            ? ` + ${res.cascadedMessages} reply${res.cascadedMessages === 1 ? "" : "ies"}`
+            : "";
+        console.log(`✓ Deleted ${res.deleted} version${res.deleted === 1 ? "" : "s"}${cascaded} of '${res.key}'.`);
+    }
+    catch (err) {
+        console.error(`Delete failed: ${err.message}`);
+        process.exit(1);
+    }
+}

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: {
@@ -137,6 +139,26 @@ const TOOLS = [
             required: ["key"],
         },
     },
+    {
+        name: "codiedev_delete",
+        description: "Delete every version of an artifact (and its replies) by key. Use " +
+            "when the user asks to delete, remove, undo, throw away, or clean up " +
+            "an artifact (e.g., 'delete that test push', 'remove the duplicate', " +
+            "'rm spec-old'). Authorship is enforced server-side: you can only " +
+            "delete artifacts you authored. Always confirm with the user before " +
+            "calling — deletions cannot be undone.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                key: {
+                    type: "string",
+                    description: "Filename key of the artifact to delete, e.g. 'spec-214.md'. " +
+                        "Every version of this key is removed.",
+                },
+            },
+            required: ["key"],
+        },
+    },
     {
         name: "codiedev_ping",
         description: "Send a message to a teammate on CodieDev, optionally attached to a " +
@@ -374,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: {
@@ -387,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." },
@@ -514,6 +553,8 @@ async function dispatchTool(name, args, config) {
             return await handlePush(args, config);
         case "codiedev_pull":
             return await handlePull(args, config);
+        case "codiedev_delete":
+            return await handleDelete(args, config);
         case "codiedev_ping":
             return await handlePing(args, config);
         case "codiedev_inbox":
@@ -587,6 +628,33 @@ async function handlePull(args, config) {
         content: [{ type: "text", text: header + a.markdown }],
     };
 }
+async function handleDelete(args, config) {
+    const key = asString(args.key);
+    if (!key)
+        throw new Error("key required");
+    const res = await (0, shared_1.apiRequest)("POST", "/api/cli/delete", { config, body: { key } });
+    if (res.deleted === 0) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `No artifact found with key '${key}'. Nothing to delete.`,
+                },
+            ],
+        };
+    }
+    const cascaded = res.cascadedMessages > 0
+        ? ` + ${res.cascadedMessages} reply${res.cascadedMessages === 1 ? "" : "ies"}`
+        : "";
+    return {
+        content: [
+            {
+                type: "text",
+                text: `✓ Deleted ${res.deleted} version${res.deleted === 1 ? "" : "s"}${cascaded} of '${res.key}'.`,
+            },
+        ],
+    };
+}
 async function handlePing(args, config) {
     const to = asString(args.to);
     const body = asString(args.body);
@@ -726,16 +794,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}`,
                 },
             ],
         };
@@ -818,6 +918,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", {
@@ -825,6 +927,8 @@ async function handleGetLibrary(args, config) {
         query: {
             scope,
             type,
+            kind,
+            tag,
             folderPath,
             limit: limit?.toString(),
         },
@@ -840,7 +944,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) {
@@ -848,7 +952,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/dist/utils.js

@@ -208,6 +208,7 @@ thought, use the \`codiedev\` CLI via Bash:**
 |---|---|
 | "push this spec" / "save this as a skill" | \`codiedev push <file.md>\` |
 | "pull X" / "grab the latest spec-X" / "what did Maya push?" | \`codiedev pull <key>\` |
+| "delete X" / "remove that test push" / "rm spec-old" | \`codiedev delete <key>\` (always confirm with the user first) |
 | "ping Nic about this" / "ask Maya for her take" | \`codiedev ping <name> "<msg>" [--with <key>]\` |
 | "any messages?" / "check my inbox" / "what did Nic say?" | \`codiedev inbox\` |
 | "read Nic's reply" / "mark that ping read" | \`codiedev read <ping-id>\` |

package/package.json

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