codiedev 0.5.0 → 0.5.2

package/dist/cli.js

@@ -62,15 +62,26 @@ Other:
   codiedev docs                          Print the full usage guide
   codiedev version                       Show version
 
-Filename conventions:
-  spec-*.md      → spec          review-*.md    → review
-  decision-*.md  → decision      proposal-*.md  → proposal
-  bugfix-*.md    → bugfix        anything else  → note
+The 90% workflow:
+  1. Name your file 'spec-<topic>.md' and push.
+  2. Ping a teammate to pull review.
+  3. They edit, push back. Versions stack. Done.
+
+Other artifact types (rare — use the matching prefix):
+  review-*.md → review     decision-*.md → decision
+  proposal-*.md → proposal  bugfix-*.md → bugfix
+  anything else → note
+
+Skills (slash commands):
+  Add 'name:' + 'description:' YAML frontmatter to any pushed file
+  and it shows up as /<name> in Claude Code / Codex. Filename
+  prefix doesn't matter — frontmatter is the signal.
 
 Examples:
-  codiedev push docs/specs/spec-cart-clear.md
+  codiedev push spec-cart-clear.md          # the typical case
+  codiedev push portal-design.md            # with name:/description: → skill
   codiedev pull spec-cart-clear.md
-  codiedev ping maya "thoughts on batch vs parallel?" --with spec-cart-clear.md
+  codiedev ping maya "thoughts?" --with spec-cart-clear.md
   codiedev inbox --unread
   codiedev note "idempotency key is worth a follow-up"
 
@@ -96,17 +107,23 @@ codiedev connect — link your agent CLI to CodieDev
     push: `
 codiedev push — author or update an artifact
 
-  Usage:
-    codiedev push <file.md> [--type spec|review|decision|proposal|bugfix|note]
+  Default path:
+    codiedev push spec-<topic>.md
 
-  The file's basename becomes its key (unique per company). Pushing the
-  same key again creates a new version — full history is preserved.
+  The file's basename becomes its key (unique per company). Pushing
+  the same key again versions it — full history is preserved.
 
-  Type is inferred from the filename prefix unless you override with --type.
+  Other types: rename with the matching prefix (review-*, decision-*,
+  proposal-*, bugfix-*) or pass --type. Anything else lands as 'note'.
+
+  Skills (slash commands): add 'name:' + 'description:' YAML
+  frontmatter to the top of the file. It shows up as /<name> in
+  the Skills tab. Filename prefix doesn't matter for the skill role.
 
   Examples:
-    codiedev push spec-cart-clear.md
-    codiedev push docs/review-auth.md --type review
+    codiedev push spec-cart-clear.md            # the typical case
+    codiedev push portal-design.md              # with name:/description: → skill
+    codiedev push docs/review-auth.md
     codiedev push notes/random.md --type note
 `.trim(),
     pull: `
@@ -244,6 +261,25 @@ Artifacts have a status that auto-advances as PRs reference them:
 Artifacts stay editable at every stage, including after merge —
 lessons-learned and follow-up notes append as new versions.
 
+## Skills
+
+Default path:
+
+    1. Pick a name: e.g. portal-design
+    2. Top the file with frontmatter:
+         ---
+         name: portal-design
+         description: Use when reviewing or building portal UI.
+         ---
+         # body...
+    3. codiedev push portal-design.md
+
+It's now /portal-design in Claude Code / Codex.
+
+Filename prefix is irrelevant for skills — frontmatter is the only
+signal. The stored artifact type still follows the filename rule
+(so a skill in a spec file is both a 'spec' and a callable skill).
+
 ## Portal
 
 Everything you do in the CLI is visible at:

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"],
@@ -522,20 +547,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}\``,
             },
         ],
     };
@@ -998,6 +1031,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

@@ -220,13 +220,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.0",
+  "version": "0.5.2",
   "description": "Connect Claude Code or Codex to CodieDev for org-wide session capture and artifact collaboration",
   "bin": {
     "codiedev": "./dist/cli.js",