codiedev 0.5.1 → 0.5.3

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/commands/push.js

@@ -45,9 +45,13 @@ const VALID_TYPES = new Set([
     "review",
     "note",
 ]);
+const VALID_KINDS = new Set(["doc", "skill"]);
 function parseArgs(args) {
     let file;
     let type;
+    let kind;
+    let force = false;
+    const tags = [];
     for (let i = 0; i < args.length; i++) {
         const a = args[i];
         if (a === "--type" && i + 1 < args.length) {
@@ -56,22 +60,41 @@ function parseArgs(args) {
         else if (a.startsWith("--type=")) {
             type = a.slice("--type=".length);
         }
+        else if (a === "--kind" && i + 1 < args.length) {
+            kind = args[++i];
+        }
+        else if (a.startsWith("--kind=")) {
+            kind = a.slice("--kind=".length);
+        }
+        else if (a === "--tag" && i + 1 < args.length) {
+            tags.push(args[++i]);
+        }
+        else if (a.startsWith("--tag=")) {
+            tags.push(a.slice("--tag=".length));
+        }
+        else if (a === "--force") {
+            force = true;
+        }
         else if (!a.startsWith("--") && !file) {
             file = a;
         }
     }
     if (!file) {
-        console.error("Usage: codiedev push <file.md> [--type spec|bugfix|decision|proposal|review|note]");
+        console.error("Usage: codiedev push <file.md> [--kind doc|skill] [--tag <name>] [--force]");
         process.exit(1);
     }
     if (type && !VALID_TYPES.has(type)) {
         console.error(`Invalid --type. Valid types: ${[...VALID_TYPES].join(", ")}`);
         process.exit(1);
     }
-    return { file, type };
+    if (kind && !VALID_KINDS.has(kind)) {
+        console.error(`Invalid --kind. Valid kinds: ${[...VALID_KINDS].join(", ")}`);
+        process.exit(1);
+    }
+    return { file, type, kind, tags, force };
 }
 async function runPush(args) {
-    const { file, type } = parseArgs(args);
+    const { file, type, kind, tags, force } = parseArgs(args);
     const config = (0, shared_1.requireConfig)();
     let absolute = file;
     if (!path.isAbsolute(absolute)) {
@@ -90,12 +113,19 @@ async function runPush(args) {
     try {
         const res = await (0, shared_1.apiRequest)("POST", "/api/cli/push", {
             config,
-            body: { filename, markdown, type },
+            body: {
+                filename,
+                markdown,
+                type,
+                kind,
+                tags: tags.length > 0 ? tags : undefined,
+                force,
+            },
         });
-        console.log(`✓ Pushed ${filename}`);
-        console.log(`  type:    ${res.type}`);
-        console.log(`  version: v${res.version}`);
-        console.log(`  id:      ${res.artifactId}`);
+        const tagSummary = res.tags && res.tags.length > 0 ? ` tags=[${res.tags.join(", ")}]` : "";
+        console.log(`✓ Pushed ${filename} (kind=${res.kind}${tagSummary}).`);
+        console.log(`  Visible under: ${res.destination}`);
+        console.log(`  Pull with: codiedev pull ${filename}`);
     }
     catch (err) {
         console.error(`Push failed: ${err.message}`);

package/dist/mcp.js

@@ -60,31 +60,56 @@ const PKG_VERSION = "0.5.0";
 const TOOLS = [
     {
         name: "codiedev_push",
-        description: "Push a spec, review, decision, proposal, bugfix, or note to the " +
-            "team's CodieDev artifact layer so teammates can see and discuss it. " +
-            "Use when the user asks to share, push, save, or publish something " +
-            "(e.g., 'push this spec', 'share the review with the team', 'save as " +
-            "a decision'). Prefer passing the filename of a recently-edited local " +
-            "file — provide its current contents as `markdown`. Filename should " +
-            "end in .md and start with the artifact type (spec-, review-, " +
-            "decision-, proposal-, bugfix-, or note-).",
+        description: "Push any markdown artifact (doc or skill) to the team's CodieDev " +
+            "artifact layer so teammates can see, discuss, and run it. Works for " +
+            "specs, decisions, proposals, bugfixes, reviews, notes, AND " +
+            "Claude Code / Codex skills (files with SKILL.md frontmatter — " +
+            "`name:` and `description:` keys). Just pass the filename + markdown " +
+            "— `kind` is auto-detected from the content (skill if frontmatter, " +
+            "otherwise doc). Use when the user asks to share, push, save, or " +
+            "publish something (e.g., 'push this spec', 'save as a skill', " +
+            "'share the review'). The response says where the artifact will " +
+            "appear so you can confirm to the user.",
         inputSchema: {
             type: "object",
             properties: {
                 filename: {
                     type: "string",
-                    description: "Basename of the artifact file, e.g. 'spec-214.md'. Becomes the " +
-                        "artifact's key for pulling and pinging.",
+                    description: "Basename of the artifact file, e.g. 'spec-214.md' or " +
+                        "'writing-emails.md'. Becomes the artifact's key for pulling " +
+                        "and pinging.",
                 },
                 markdown: {
                     type: "string",
                     description: "Full markdown content of the artifact.",
                 },
+                kind: {
+                    type: "string",
+                    enum: ["doc", "skill"],
+                    description: "Top-level kind. Auto-detected from frontmatter — leave unset " +
+                        "in the common case. Pass `skill` for files with SKILL.md " +
+                        "frontmatter, `doc` for everything else. If you pass a value " +
+                        "that disagrees with the detected kind the push fails unless " +
+                        "`force: true` is also set.",
+                },
+                tags: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Optional free-form tags (e.g., ['spec', 'auth']). The legacy " +
+                        "type prefix from the filename is added automatically — you " +
+                        "don't need to repeat it.",
+                },
+                force: {
+                    type: "boolean",
+                    description: "Override the kind-mismatch guard. Only pass when the user " +
+                        "explicitly wants to ignore the detected kind.",
+                },
                 type: {
                     type: "string",
                     enum: ["spec", "bugfix", "decision", "proposal", "review", "note"],
-                    description: "Override the inferred type. Usually leave unset — type is " +
-                        "inferred from filename prefix.",
+                    description: "Legacy override for the doc-shape tag. Optional — inferred " +
+                        "from the filename prefix when omitted. Prefer `tags` for new " +
+                        "code.",
                 },
             },
             required: ["filename", "markdown"],
@@ -112,6 +137,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 " +
@@ -489,6 +534,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":
@@ -522,20 +569,28 @@ async function handlePush(args, config) {
     const filename = asString(args.filename);
     const markdown = asString(args.markdown);
     const type = asStringOrUndefined(args.type);
+    const kind = asStringOrUndefined(args.kind);
+    const tags = asStringArrayOrUndefined(args.tags);
+    const force = asBoolOrUndefined(args.force);
     if (!filename)
         throw new Error("filename required");
     if (!markdown)
         throw new Error("markdown required");
+    if (kind && kind !== "doc" && kind !== "skill") {
+        throw new Error("kind must be 'doc' or 'skill' if provided");
+    }
     const res = await (0, shared_1.apiRequest)("POST", "/api/cli/push", {
         config,
-        body: { filename, markdown, type },
+        body: { filename, markdown, type, kind, tags, force },
     });
+    const tagSummary = res.tags && res.tags.length > 0 ? `, tags=[${res.tags.join(", ")}]` : "";
     return {
         content: [
             {
                 type: "text",
-                text: `✓ Pushed ${filename} (type=${res.type}, version=v${res.version}, id=${res.artifactId}).\n` +
-                    `Teammates can now pull it with \`codiedev pull ${filename}\`.`,
+                text: `✓ Pushed ${filename} (kind=${res.kind}${tagSummary}, version=v${res.version}, id=${res.artifactId}).\n` +
+                    `  Visible under: ${res.destination}\n` +
+                    `  Pull with: \`codiedev pull ${filename}\``,
             },
         ],
     };
@@ -554,6 +609,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);
@@ -998,6 +1080,14 @@ function asStringOrUndefined(v) {
 function asIntOrUndefined(v) {
     return typeof v === "number" && Number.isInteger(v) ? v : undefined;
 }
+function asBoolOrUndefined(v) {
+    return typeof v === "boolean" ? v : undefined;
+}
+function asStringArrayOrUndefined(v) {
+    if (!Array.isArray(v))
+        return undefined;
+    return v.filter((x) => typeof x === "string");
+}
 // ─────────────────────────────────────────────────────────────────────────────
 // Main
 // ─────────────────────────────────────────────────────────────────────────────

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>\` |
@@ -220,13 +221,22 @@ thought, use the \`codiedev\` CLI via Bash:**
 | "show my library" / "what artifacts exist?" | MCP tool \`codiedev_get_library\` |
 | "react 🛠 to that post" / "mark as used" | MCP tool \`codiedev_react\` |
 
-**Filename conventions (set artifact type automatically):**
-- \`spec-*.md\` → spec
-- \`review-*.md\` → review
-- \`decision-*.md\` → decision
-- \`proposal-*.md\` → proposal
-- \`bugfix-*.md\` → bugfix
-- anything else → note
+**Just push the file — we'll figure out where it goes.** Every artifact
+is classified into one of two kinds at upload time:
+
+- **skill** — the file has SKILL.md frontmatter (\`name:\` + \`description:\`
+  inside a \`---\` block). Lands under \`Artifacts → Skills tab\` and is
+  invokable as a slash command (\`/<name>\`).
+- **doc** — everything else. Lands under \`Artifacts → My artifacts\`.
+
+Detection is content-based, not filename-based. The filename prefix
+(\`spec-\` / \`decision-\` / \`proposal-\` / \`bugfix-\` / \`review-\` /
+\`note-\`) is preserved as a *tag* you can filter by, but it never gates
+visibility. A SKILL-frontmatter file named \`note-foo.md\` still becomes
+a skill.
+
+The \`codiedev push\` response always says where the artifact landed —
+read it back to the user so they can confirm.
 
 **Resolving "the spec we just worked on":**
 - If a file was recently edited in this session matching the conventions

package/package.json

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