perchai-cli 2.4.41 → 2.4.42

package/dist/perch.mjs

@@ -75566,6 +75566,7 @@ var init_payroll = __esm({
 // lib/perchBusinessTools/index.ts
 var init_perchBusinessTools = __esm({
   "lib/perchBusinessTools/index.ts"() {
+    "use strict";
     init_generateAPAuditPacket();
     init_inventoryFolder();
     init_loadBusinessTables();
@@ -75917,7 +75918,6 @@ function isTurnAbortedError(error) {
 var TURN_STOPPED_BY_USER_MESSAGE;
 var init_turnAbort = __esm({
   "features/perchTerminal/runtime/turnAbort.ts"() {
-    "use strict";
     TURN_STOPPED_BY_USER_MESSAGE = "Turn stopped by user.";
   }
 });
@@ -76218,6 +76218,7 @@ function getToolDisplayName(toolName) {
 var NON_MODULE_TOOL_OWNERS, TOOL_RISK, TOOL_DISPLAY_NAMES;
 var init_catalog = __esm({
   "features/perchTerminal/runtime/toolSystem/catalog.ts"() {
+    "use strict";
     init_toolNames();
     NON_MODULE_TOOL_OWNERS = {
       [TOOL_NAMES.listSources]: "lane",
@@ -92918,6 +92919,39 @@ var init_agentSkillRegistry = __esm({
           "readLocalFile"
         ]
       },
+      {
+        "id": "release",
+        "name": "release",
+        "description": "Prepare and ship a Perch release \u2014 bump, build, pack, commit, tag, and push the CLI up to the publish handoff, or trigger the desktop release workflow, with strict permission gates.",
+        "path": "features/perchTerminal/agentPlatform/skills/release/SKILL.md",
+        "body": "\n# release\n\nUse this skill when the user asks Perch to cut a release: ship a new `perchai-cli` version, repackage the CLI, bump the version, or trigger a desktop build. This runs on any surface with a local shell (the field CLI and the desktop app); a hosted-only surface cannot release.\n\n## CLI release\n\nThe CLI release is a single audited command \u2014 do not improvise raw `git`/`npm` sequences. Use `npm run cli:release`.\n\n1. Always start with a dry run: `npm run cli:release` (or `npm run cli:release -- --minor` / `-- --set X.Y.Z`). It prints the ordered plan and runs read-only preflight (clean tree, unused tag, test gate) without changing anything.\n2. Show the user the planned version, tag, and steps. Get an explicit yes before mutating.\n3. Execute with `npm run cli:release -- --execute`. It bumps `packages/cli/package.json`, rebuilds the bundle, packs the tarball, commits, tags `cli-vX.Y.Z`, and pushes \u2014 then STOPS.\n4. It never publishes. Hand the publish back to the user verbatim: `cd packages/cli && npm publish`, run with their own npm token. State the prepared version, the commit, the tag, and the tarball path.\n\nUse `-- --no-push` to keep the commit and tag local; `-- --skip-tests` only when the user explicitly accepts skipping the gate.\n\n## Desktop release\n\nThe desktop installers build in CI, not locally. Use `npm run desktop:release` (optionally with a version and channel). It triggers the desktop release workflow through the GitHub CLI, which builds the macOS and Windows installers and publishes them to the configured download bucket. This requires the GitHub CLI to be installed and authenticated; if it is missing, say so and stop rather than guessing.\n\nPair this with `wait-operator` when the user wants to watch the workflow to completion: poll bounded status, read the failing job logs when available, and report the final result with the run URL.\n\n## Permission and verification\n\n- Protect unrelated work. The CLI release refuses to run with a dirty tree on purpose, so only the bump, bundle, and tarball land in the release commit. Never stage or sweep unrelated changes to satisfy it \u2014 commit or stash those first.\n- Treat push and publish as irreversible. Confirm before push; never publish on the user's behalf.\n- Before finishing, report the resolved version, commit SHA, tag, push target, tarball path, the exact publish command left for the user, and any workflow or run URL when a desktop release was triggered.",
+        "surface": {
+          "gui": "supported",
+          "cli": "supported"
+        },
+        "triggerHints": [
+          "release the cli",
+          "ship the cli",
+          "publish the cli",
+          "cut a release",
+          "bump version",
+          "package the cli",
+          "desktop release",
+          "tag and push"
+        ],
+        "companionSkills": [
+          "github",
+          "wait-operator",
+          "workspace"
+        ],
+        "preferredTools": [
+          "bash",
+          "runBashTerminalCommand",
+          "grep",
+          "readLocalFile",
+          "writeLocalFile"
+        ]
+      },
       {
         "id": "research",
         "name": "research",
@@ -93262,6 +93296,7 @@ var init_skillSelector = __esm({
     ]);
     CORE_PRIORITY = [
       "wait-operator",
+      "release",
       "github",
       "data-quality",
       "presentations",
@@ -93302,6 +93337,10 @@ var init_skillSelector = __esm({
         /\b(github|git\s+(?:status|diff|log|show|commit|push|pull|branch)|commit\s+(?:these|changes|and\s+push)|push\s+(?:this|the|branch)|pull\s+request|pr\s+#?\d*|review\s+commits?|github\s+checks?|ci\s+(?:failure|checks?|run)|release\s+branch)\b/i,
         /\b(stage|commit|push)\b.{0,56}\b(changes?|branch|repo|github)\b/i
       ],
+      release: [
+        /\b(release|ship|publish|repackage)\b.{0,32}\b(cli|perch|desktop|app|version|build|package|installer)\b/i,
+        /\b(cut\s+a\s+release|bump\s+(?:the\s+)?version|tag\s+and\s+push|new\s+(?:cli\s+)?version)\b/i
+      ],
       "wait-operator": [
         /\b(wait\s+(?:for|until)|watch\s+(?:the|this)?|poll\s+(?:status|until|for)|keep\s+checking|check\s+(?:until|back|again)|monitor\s+(?:progress|status|deploy)|long[-\s]?running\s+task|deployment\s+status|wake\s+when\s+done)\b/i,
         /\b(vercel|deploy(?:ment)?|github\s+actions?|ci|checks?|background\s+job|server|localhost)\b.{0,64}\b(ready|done|finish(?:ed)?|complete|succeed(?:ed)?|fail(?:ed)?|status)\b/i

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "perchai-cli",
-  "version": "2.4.41",
+  "version": "2.4.42",
   "description": "Perch AI command-line interface",
   "bin": {
     "perch": "bin/perch"