codiedev 0.9.85 → 0.9.86

package/dist/commands/pack.d.ts

@@ -21,6 +21,10 @@ export interface PackArgs {
     out?: string;
     git?: boolean;
     manifest?: boolean;
+    /** publish / apply --publish: which channel (default stable). */
+    channel?: "stable" | "beta" | "alpha";
+    /** apply: publish the draft afterwards. */
+    publish?: boolean;
 }
 export declare function parsePackArgs(args: string[]): PackArgs;
 /** Download a pack's files (SIG-127) into the blob cache, verified by sha256. */
@@ -54,4 +58,13 @@ export declare function runExport(config: CodiedevConfig, args: PackArgs): Promi
     commit?: string;
 }>;
 export declare function runApply(config: CodiedevConfig, args: PackArgs): Promise<Record<string, unknown>>;
-export declare const PACK_HELP = "Usage:\n  codiedev pack list                     Packs assigned to your team\n  codiedev pack install [slug] [--harness claude,codex,copilot,cursor,codie,pi] [--dry-run] [--json] [--quiet]\n                                         Install one pack, or every pack that applies\n  codiedev pack status [--json]          Installed packs and whether they're up to date\n  codiedev pack export <slug> --out <dir> [--git] [--manifest]\n                                         Write the pack as a Claude-format plugin folder plus\n                                         .claude-plugin/marketplace.json (commit it for CI).\n                                         --git inits the folder and commits; --manifest writes\n                                         an editable <slug>.pack.md instead\n  codiedev pack apply <pack.md> [--dry-run]\n                                         Create or update a pack from a pack.md\n\nFiles (scripts, PDFs, a runner folder): list them under \"## Files\" in pack.md,\none \"- <path in pack> <- <local path>\" per line (local paths are relative to\nthe pack.md; \".\" is the pack root):\n\n  ## Files\n\n  - runner <- ~/.claude/runner\n  - skills/healthcare-scan <- ~/.claude/skills/healthcare-scan\n\n`pack apply` uploads them (admins and team managers; 15MB per file, 50MB per\npack; caches, .git and hidden files are skipped). Without a \"## Files\"\nsection the pack's files are left alone. In skills, point at files relative to\nthe skill's folder, or use ${CLAUDE_PLUGIN_ROOT}/runner/...: Codiedev swaps in the\nreal path for Codex, Copilot, Cursor, pi and Codie.\n\nCursor: packs are copied to ~/.cursor/plugins/local/codiedev-<slug>/. A Cursor\nteam admin can disable \"user local plugin imports\"; then Cursor ignores them.\n\nAuto-update: session starts run `codiedev pack install --quiet` in the background\nabout once an hour. Opt out with CODIEDEV_PACK_AUTOSYNC=0.\n\nHooks for specific skills only: codiedev hook-gate --skills a,b --cmd-b64 <base64url of the command>\n(the pack editor writes this; the command runs via /bin/sh, or cmd.exe on Windows)\n\nCI: set CODIEDEV_TOKEN to a pack CI key (cdvci_\u2026, from the pack's page in the portal).\nNo `codiedev connect` or config file is needed. CI mode (a cdvci_ key, or CI=true)\nnever auto-syncs, reports or prunes, installs the one pack the key can see, defaults\n--harness to claude when it's on PATH, and exits non-zero unless every requested tool\ngot the pack. Skills from a pack are /<pack-slug>:<skill> in Claude Code.\n\n  GitLab CI (.gitlab-ci.yml; add CODIEDEV_TOKEN and ANTHROPIC_API_KEY as masked\n  CI/CD variables):\n    pack-scan:\n      image: node:22\n      script:\n        - npm i -g codiedev @anthropic-ai/claude-code\n        - codiedev pack install --harness claude\n        - claude -p \"/platform-starter:healthcare-scan\" --output-format text\n\n  GitHub Actions (repository secrets CODIEDEV_TOKEN and ANTHROPIC_API_KEY):\n    - uses: actions/setup-node@v4\n      with: { node-version: 22 }\n    - run: npm i -g codiedev @anthropic-ai/claude-code\n    - run: codiedev pack install --harness claude\n      env:\n        CODIEDEV_TOKEN: ${{ secrets.CODIEDEV_TOKEN }}\n    - run: claude -p \"/platform-starter:healthcare-scan\" --output-format text\n      env:\n        ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}\n\n  Or vendor the plugin into the repo instead of installing at build time:\n    codiedev pack export <slug> --out .codiedev/packs";
+export interface PublishResult {
+    slug: string;
+    channel: string;
+    version: number;
+    unchanged: boolean;
+}
+/** `codiedev pack publish <slug> [--channel stable|beta|alpha]`: snapshot the
+ * draft onto a channel. Re-running with no changes publishes nothing. */
+export declare function runPublish(config: CodiedevConfig, args: PackArgs): Promise<PublishResult>;
+export declare const PACK_HELP = "Usage:\n  codiedev pack list                     Packs assigned to your team\n  codiedev pack install [slug] [--harness claude,codex,copilot,cursor,codie,pi] [--dry-run] [--json] [--quiet]\n                                         Install one pack, or every pack that applies\n  codiedev pack status [--json]          Installed packs and whether they're up to date\n  codiedev pack export <slug> --out <dir> [--git] [--manifest]\n                                         Write the pack as a Claude-format plugin folder plus\n                                         .claude-plugin/marketplace.json (commit it for CI).\n                                         --git inits the folder and commits; --manifest writes\n                                         an editable <slug>.pack.md instead\n  codiedev pack apply <pack.md> [--publish] [--channel stable|beta|alpha] [--dry-run]\n                                         Create or update a pack from a pack.md\n                                         (--publish then publishes it, see below)\n  codiedev pack publish <slug> [--channel stable|beta|alpha]\n                                         Publish the pack's draft to a channel (default\n                                         stable). Nothing happens when it hasn't changed.\n\nFiles (scripts, PDFs, a runner folder): list them under \"## Files\" in pack.md,\none \"- <path in pack> <- <local path>\" per line (local paths are relative to\nthe pack.md; \".\" is the pack root):\n\n  ## Files\n\n  - runner <- ~/.claude/runner\n  - skills/healthcare-scan <- ~/.claude/skills/healthcare-scan\n\n`pack apply` uploads them (admins and team managers; 15MB per file, 50MB per\npack; caches, .git and hidden files are skipped). Without a \"## Files\"\nsection the pack's files are left alone. In skills, point at files relative to\nthe skill's folder, or use ${CLAUDE_PLUGIN_ROOT}/runner/...: Codiedev swaps in the\nreal path for Codex, Copilot, Cursor, pi and Codie.\n\nCursor: packs are copied to ~/.cursor/plugins/local/codiedev-<slug>/. A Cursor\nteam admin can disable \"user local plugin imports\"; then Cursor ignores them.\n\nAuto-update: session starts run `codiedev pack install --quiet` in the background\nabout once an hour. Opt out with CODIEDEV_PACK_AUTOSYNC=0.\n\nHooks for specific skills only: codiedev hook-gate --skills a,b --cmd-b64 <base64url of the command>\n(the pack editor writes this; the command runs via /bin/sh, or cmd.exe on Windows)\n\nCI: set CODIEDEV_TOKEN to a pack CI key (cdvci_\u2026, from the pack's page in the portal).\nNo `codiedev connect` or config file is needed. CI mode (a cdvci_ key, or CI=true)\nnever auto-syncs, reports or prunes, installs the one pack the key can see, defaults\n--harness to claude when it's on PATH, and exits non-zero unless every requested tool\ngot the pack. Skills from a pack are /<pack-slug>:<skill> in Claude Code.\n\n  GitLab CI (.gitlab-ci.yml; add CODIEDEV_TOKEN and ANTHROPIC_API_KEY as masked\n  CI/CD variables):\n    pack-scan:\n      image: node:22\n      script:\n        - npm i -g codiedev @anthropic-ai/claude-code\n        - codiedev pack install --harness claude\n        - claude -p \"/platform-starter:healthcare-scan\" --output-format text\n\n  GitHub Actions (repository secrets CODIEDEV_TOKEN and ANTHROPIC_API_KEY):\n    - uses: actions/setup-node@v4\n      with: { node-version: 22 }\n    - run: npm i -g codiedev @anthropic-ai/claude-code\n    - run: codiedev pack install --harness claude\n      env:\n        CODIEDEV_TOKEN: ${{ secrets.CODIEDEV_TOKEN }}\n    - run: claude -p \"/platform-starter:healthcare-scan\" --output-format text\n      env:\n        ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}\n\n  Keep a pack up to date from its repo (GitLab; on merges to main). Use a\n  personal Codiedev token of a pack owner (portal \u2192 Integrations \u2192 CLI tokens) as a\n  masked CODIEDEV_TOKEN: pack CI keys can only install, not publish.\n    pack-release:\n      image: node:22\n      rules: [{ if: '$CI_COMMIT_BRANCH == \"main\"' }]\n      script:\n        - npm i -g codiedev\n        - codiedev pack apply packs/platform-starter.pack.md --publish\n  This ships the pack's files, agents, hooks and skill list. Edits to a skill's\n  own SKILL.md still go to the library with `codiedev push`.\n\n  Or vendor the plugin into the repo instead of installing at build time:\n    codiedev pack export <slug> --out .codiedev/packs";

package/dist/commands/pack.js

@@ -46,6 +46,7 @@ exports.commitExport = commitExport;
 exports.exportPluginFolder = exportPluginFolder;
 exports.runExport = runExport;
 exports.runApply = runApply;
+exports.runPublish = runPublish;
 const install_1 = require("../packs/install");
 const harnesses_1 = require("../packs/harnesses");
 const manifest_1 = require("../packs/manifest");
@@ -103,8 +104,12 @@ const USAGE = `Usage:
                                          .claude-plugin/marketplace.json (commit it for CI).
                                          --git inits the folder and commits; --manifest writes
                                          an editable <slug>.pack.md instead
-  codiedev pack apply <pack.md> [--dry-run]
+  codiedev pack apply <pack.md> [--publish] [--channel stable|beta|alpha] [--dry-run]
                                          Create or update a pack from a pack.md
+                                         (--publish then publishes it, see below)
+  codiedev pack publish <slug> [--channel stable|beta|alpha]
+                                         Publish the pack's draft to a channel (default
+                                         stable). Nothing happens when it hasn't changed.
 
 Files (scripts, PDFs, a runner folder): list them under "## Files" in pack.md,
 one "- <path in pack> <- <local path>" per line (local paths are relative to
@@ -156,8 +161,25 @@ got the pack. Skills from a pack are /<pack-slug>:<skill> in Claude Code.
       env:
         ANTHROPIC_API_KEY: \${{ secrets.ANTHROPIC_API_KEY }}
 
+  Keep a pack up to date from its repo (GitLab; on merges to main). Use a
+  personal Codiedev token of a pack owner (portal → Integrations → CLI tokens) as a
+  masked CODIEDEV_TOKEN: pack CI keys can only install, not publish.
+    pack-release:
+      image: node:22
+      rules: [{ if: '$CI_COMMIT_BRANCH == "main"' }]
+      script:
+        - npm i -g codiedev
+        - codiedev pack apply packs/platform-starter.pack.md --publish
+  This ships the pack's files, agents, hooks and skill list. Edits to a skill's
+  own SKILL.md still go to the library with \`codiedev push\`.
+
   Or vendor the plugin into the repo instead of installing at build time:
     codiedev pack export <slug> --out .codiedev/packs`;
+function parseChannel(value) {
+    if (value === "stable" || value === "beta" || value === "alpha")
+        return value;
+    throw new Error(`--channel must be stable, beta or alpha (got ${value})`);
+}
 function parsePackArgs(args) {
     const out = { dryRun: false, json: false };
     const positional = [];
@@ -175,6 +197,15 @@ function parsePackArgs(args) {
             out.git = true;
         else if (a === "--manifest")
             out.manifest = true;
+        else if (a === "--publish")
+            out.publish = true;
+        else if (a === "--channel") {
+            if (i + 1 >= args.length)
+                throw new Error("--channel needs stable, beta or alpha");
+            out.channel = parseChannel(args[++i]);
+        }
+        else if (a.startsWith("--channel="))
+            out.channel = parseChannel(a.slice("--channel=".length));
         else if (a === "--out" || a === "-o") {
             if (i + 1 >= args.length)
                 throw new Error("--out needs a directory");
@@ -456,7 +487,7 @@ async function runPack(args) {
         console.error(USAGE);
         process.exit(1);
     }
-    if (!parsed.sub || !["list", "ls", "install", "status", "export", "apply"].includes(parsed.sub)) {
+    if (!parsed.sub || !["list", "ls", "install", "status", "export", "apply", "publish"].includes(parsed.sub)) {
         console.error(USAGE);
         process.exit(parsed.sub ? 1 : 0);
     }
@@ -476,6 +507,8 @@ async function runPack(args) {
                 await runExport(config, parsed);
             else if (parsed.sub === "apply")
                 await runApply(config, parsed);
+            else if (parsed.sub === "publish")
+                await runPublish(config, parsed);
             else
                 await runStatus(config, parsed.json, {}, { prune: !parsed.noPrune });
         });
@@ -684,8 +717,51 @@ async function runApply(config, args) {
             }
         }
     }
+    if (args.publish && typeof res.slug === "string") {
+        const published = await runPublish(config, { ...args, slug: res.slug, json: false });
+        if (args.json)
+            return { ...res, published };
+    }
     return res;
 }
+/** `codiedev pack publish <slug> [--channel stable|beta|alpha]`: snapshot the
+ * draft onto a channel. Re-running with no changes publishes nothing. */
+async function runPublish(config, args) {
+    if (!args.slug)
+        throw new Error("Usage: codiedev pack publish <slug> [--channel stable|beta|alpha]");
+    if (!(0, manifest_2.isSafeSegment)(args.slug))
+        throw new Error(`Not a pack slug: ${args.slug}`);
+    const channel = args.channel ?? "stable";
+    if (args.dryRun) {
+        console.log(`Dry run — would publish ${args.slug}'s draft to ${channel}.`);
+        return { slug: args.slug, channel, version: 0, unchanged: true };
+    }
+    let res;
+    try {
+        res = await (0, shared_1.apiRequest)("POST", "/api/cli/packs/publish", { config, body: { slug: args.slug, channel } });
+    }
+    catch (error) {
+        const e = error;
+        if (e.status === 404)
+            throw new Error(`Pack not found: ${args.slug}`);
+        if (e.status === 403)
+            throw new Error(`You can't publish ${args.slug} (only its owners and admins can)`);
+        throw new Error(e.message);
+    }
+    const out = {
+        slug: typeof res.slug === "string" ? res.slug : args.slug,
+        channel,
+        version: typeof res.version === "number" ? res.version : 0,
+        unchanged: res.unchanged === true,
+    };
+    if (args.json)
+        console.log(JSON.stringify(out));
+    else if (out.unchanged)
+        console.log(`· ${out.slug} v${out.version} is already on ${channel} (no changes to publish)`);
+    else
+        console.log(`✓ Published ${out.slug} v${out.version} to ${channel}. Teams on ${channel} get it at their next sync.`);
+    return out;
+}
 function formatBytes(n) {
     return n >= 1024 * 1024 ? `${(n / (1024 * 1024)).toFixed(1)}MB` : n >= 1024 ? `${Math.round(n / 1024)}KB` : `${n}B`;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codiedev",
-  "version": "0.9.85",
+  "version": "0.9.86",
   "description": "Connect Claude Code, Codex, Cursor, OpenCode, or VS Code Copilot to Codiedev for team session capture and artifact collaboration — and run the governed Codie harness",
   "bin": {
     "codiedev": "dist/cli.js",