perchai-cli 2.4.40 → 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();
@@ -76217,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",
@@ -92807,6 +92809,40 @@ var init_agentSkillRegistry = __esm({
           "visionInspect"
         ]
       },
+      {
+        "id": "github",
+        "name": "github",
+        "description": "Inspect GitHub and git repository state, review commits and pull requests, debug checks, and publish local changes with clear permission boundaries.",
+        "path": "features/perchTerminal/agentPlatform/skills/github/SKILL.md",
+        "body": "\n# github\n\nUse this skill when the user asks Perch to inspect git state, review commits, prepare a commit, push a branch, understand GitHub checks, triage a pull request, or coordinate repo release work.\n\n## Operating Rules\n\n- Start with repository state before changing anything: current branch, status, recent commits, and relevant diff.\n- Protect unrelated work. Do not stage, discard, rewrite, or overwrite changes that are not part of the requested task.\n- For reviews, lead with concrete risks tied to file paths, diffs, commits, checks, or PR comments.\n- For commits, stage intentionally and write a concise message that matches the actual diff. Commit and push only when the user explicitly asks or has already authorized that action.\n- For CI or deployment checks, pair this with `wait-operator`: poll bounded status, read failing logs when available, and report final state rather than guessing.\n- For PR work, prefer existing authenticated GitHub routes or local `gh` when available; otherwise use git history, diff, and visible URLs as evidence.\n- Keep product language clean. Say GitHub, git, branch, commit, push, PR, checks, and deploy; avoid internal runtime labels unless debugging requires them.\n\n## Verification\n\nBefore finishing, report the branch, files changed, commit SHA when created, push target when pushed, PR/check/deploy URL when available, and any uncommitted files intentionally left alone.",
+        "surface": {
+          "gui": "supported",
+          "cli": "supported"
+        },
+        "triggerHints": [
+          "github",
+          "git status",
+          "git diff",
+          "commit changes",
+          "push branch",
+          "pull request",
+          "review commits",
+          "github checks",
+          "ci failure",
+          "release branch"
+        ],
+        "companionSkills": [
+          "workspace",
+          "wait-operator"
+        ],
+        "preferredTools": [
+          "bash",
+          "runBashTerminalCommand",
+          "grep",
+          "readLocalFile",
+          "writeLocalFile"
+        ]
+      },
       {
         "id": "pdf",
         "name": "pdf",
@@ -92883,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",
@@ -92996,6 +93065,41 @@ var init_agentSkillRegistry = __esm({
           "readLocalFile"
         ]
       },
+      {
+        "id": "wait-operator",
+        "name": "wait-operator",
+        "description": "Watch bounded external or local conditions, poll deployment and job status, wait through short-running tasks, and resume with verified state instead of guessing.",
+        "path": "features/perchTerminal/agentPlatform/skills/wait-operator/SKILL.md",
+        "body": "\n# wait-operator\n\nUse this skill when the user asks Perch to wait, watch, poll, monitor, check back, or keep an eye on a deployment, CI run, background job, file creation, local server, browser page, or other condition.\n\n## Operating Rules\n\n- Treat waiting as an active bounded loop: define the condition, timeout, interval, and failure states before polling.\n- Never sleep indefinitely. Use short intervals and a clear maximum wait unless the user explicitly asks for a longer watch.\n- Prefer read-only checks: status commands, existing logs, HTTP status endpoints, browser observe/wait, or file existence checks.\n- For deployments and CI, distinguish pending, ready/success, failed, canceled, timed out, and unknown. Do not call a run ready from elapsed time alone.\n- Report the last observed state if the wait times out or credentials/session state blocks verification.\n- Avoid noisy transcript spam. Group repeated polling into a short progress summary unless the user asks to see every check.\n- If the user asks for a real follow-up after this turn rather than an in-turn wait, create or suggest the appropriate automation instead of pretending the current turn can run forever.\n\n## Verification\n\nFinish only after the watched condition is directly verified or a blocker is named. Include the evidence source: command status, page state, URL, log line, file path, or timestamped last check.",
+        "surface": {
+          "gui": "supported",
+          "cli": "supported"
+        },
+        "triggerHints": [
+          "wait for deploy",
+          "watch deployment",
+          "poll status",
+          "check until ready",
+          "wait until done",
+          "keep checking",
+          "monitor progress",
+          "long running task",
+          "deployment status",
+          "wake when done"
+        ],
+        "companionSkills": [
+          "github",
+          "workspace",
+          "browser-operator"
+        ],
+        "preferredTools": [
+          "bash",
+          "runBashTerminalCommand",
+          "webFetch",
+          "browser_observe",
+          "browser_wait"
+        ]
+      },
       {
         "id": "workspace",
         "name": "workspace",
@@ -93129,6 +93233,14 @@ function selectAgentSkills(input) {
   if (/\b(ap|accounts?\s+payable)\b/i.test(text)) {
     explicit.add("data-quality");
   }
+  if (/\b(vercel|deploy(?:ment)?|github\s+actions?|ci|checks?)\b/i.test(text)) {
+    if (/\b(wait|watch|poll|monitor|keep\s+checking|check\s+until|status)\b/i.test(text)) {
+      explicit.add("wait-operator");
+    }
+  }
+  if (/\b(github|git\b|pull\s+request|pr\b|commit|push|branch|ci|checks?)\b/i.test(text)) {
+    explicit.add("github");
+  }
   if (isMarketDeskSignalTask(text, availableToolNames)) {
     explicit.delete("research");
     omitted.push({
@@ -93183,6 +93295,9 @@ var init_skillSelector = __esm({
       "browser_navigate"
     ]);
     CORE_PRIORITY = [
+      "wait-operator",
+      "release",
+      "github",
       "data-quality",
       "presentations",
       "spreadsheets",
@@ -93218,6 +93333,18 @@ var init_skillSelector = __esm({
         /\b(research|credible\s+sources?|current\s+source|citations?|source\s+comparison|scholarly|public\s+web|fact[-\s]?check|latest|recent|filing)\b/i,
         /\b(find|gather|compare|verify)\b.{0,48}\b(sources?|evidence|filings?)\b/i
       ],
+      github: [
+        /\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
+      ],
       diagrams: [
         /\b(diagram|mermaid|drawio|workflow\s+graph|org\s+chart|entity\s+network|control\s+graph|architecture\s+map|vendor[-\s]?risk\s+graph|nodes?\s+and\s+edges?)\b/i,
         /\b(graph|map)\b.{0,32}\b(risk|workflow|architecture|network|relationship)\b/i
@@ -216988,6 +217115,53 @@ var init_toolExecutor = __esm({
   }
 });
 
+// features/perchTerminal/runtime/transcript/fileDiff.ts
+function lineDiff(oldText, newText) {
+  const a = oldText.length ? oldText.split("\n") : [];
+  const b2 = newText.length ? newText.split("\n") : [];
+  const m = a.length;
+  const n = b2.length;
+  const dp = Array.from({ length: m + 1 }, () => new Array(n + 1).fill(0));
+  for (let i2 = m - 1; i2 >= 0; i2--) {
+    for (let j2 = n - 1; j2 >= 0; j2--) {
+      dp[i2][j2] = a[i2] === b2[j2] ? dp[i2 + 1][j2 + 1] + 1 : Math.max(dp[i2 + 1][j2], dp[i2][j2 + 1]);
+    }
+  }
+  const rows = [];
+  let i = 0;
+  let j = 0;
+  while (i < m && j < n) {
+    if (a[i] === b2[j]) {
+      rows.push({ t: "ctx", text: a[i] });
+      i++;
+      j++;
+    } else if (dp[i + 1][j] >= dp[i][j + 1]) {
+      rows.push({ t: "del", text: a[i] });
+      i++;
+    } else {
+      rows.push({ t: "add", text: b2[j] });
+      j++;
+    }
+  }
+  while (i < m) rows.push({ t: "del", text: a[i++] });
+  while (j < n) rows.push({ t: "add", text: b2[j++] });
+  return rows;
+}
+function lineDiffCounts(oldText, newText) {
+  let added = 0;
+  let removed = 0;
+  for (const row of lineDiff(oldText, newText)) {
+    if (row.t === "add") added++;
+    else if (row.t === "del") removed++;
+  }
+  return { added, removed };
+}
+var init_fileDiff = __esm({
+  "features/perchTerminal/runtime/transcript/fileDiff.ts"() {
+    "use strict";
+  }
+});
+
 // features/perchTerminal/runtime/toolLoop/autoRouterTurnPolicy.ts
 function addAutoRouterAvoidFromProviderError(error, lane, avoid) {
   const match = error.match(/^([a-z0-9_]+)\s+returned\b/i);
@@ -217905,13 +218079,18 @@ async function executeToolBatch(toolCalls, ctx) {
         const filePath = typeof out?.relativePath === "string" ? out.relativePath : null;
         if (filePath) {
           const isWrite = toolCall.name === "writeLocalFile";
-          const overwrite = toolCall.arguments?.overwrite === true;
+          const args = toolCall.arguments ?? {};
+          const overwrite = args.overwrite === true;
+          const { added, removed } = isWrite ? lineDiffCounts("", typeof args.content === "string" ? args.content : "") : lineDiffCounts(
+            typeof args.oldText === "string" ? args.oldText : "",
+            typeof args.newText === "string" ? args.newText : ""
+          );
           ctx.onEvent({
             type: "file_change_summary",
             filePath,
             changeKind: isWrite && !overwrite ? "created" : "modified",
-            linesAdded: null,
-            linesRemoved: null,
+            linesAdded: added,
+            linesRemoved: removed,
             toolCallId: toolCall.id,
             ts: now6()
           });
@@ -218164,6 +218343,7 @@ var init_toolBatchExecutor = __esm({
     "use strict";
     init_modelRegistry();
     init_toolExecutor();
+    init_fileDiff();
     init_toolNames();
     init_localCommandPolicy();
     init_toolArgHardening();
@@ -287199,6 +287379,8 @@ __export(perch_cli_exports, {
   HELP_TEXT: () => HELP_TEXT,
   INTERACTIVE_HELP_TEXT: () => INTERACTIVE_HELP_TEXT,
   PERCH_SPLASH_COMMANDS: () => PERCH_SPLASH_COMMANDS,
+  cliWorkerActivityVerb: () => cliWorkerActivityVerb,
+  composeWorkerActivityRowText: () => composeWorkerActivityRowText,
   flockEventToCliRow: () => flockEventToCliRow,
   flockNicknameAccentColor: () => flockNicknameAccentColor,
   parseInteractiveSlashCommand: () => parseInteractiveSlashCommand,
@@ -287257,6 +287439,19 @@ function workerEventToCliRow(event) {
       return null;
   }
 }
+function composeWorkerActivityRowText(base, activity) {
+  const parts = [base.displayName];
+  if (base.nickname) parts.push(base.nickname);
+  const callCount = activity && activity.calls > 0 ? `${activity.calls} ${activity.calls === 1 ? "call" : "calls"}` : null;
+  if (!base.done && activity && activity.calls > 0) {
+    parts.push(cliWorkerActivityVerb(activity.lastTool));
+    if (callCount) parts.push(callCount);
+  } else {
+    parts.push(FLOCK_STATUS_LABELS[base.status] ?? base.status);
+    if (base.done && callCount) parts.push(callCount);
+  }
+  return parts.join(" \xB7 ");
+}
 async function runPerchCli(argv, writer = defaultWriter(), deps = {}) {
   const parsed = parsePerchCli(argv);
   if (!parsed.ok) {
@@ -287859,6 +288054,14 @@ async function runInkInteractivePerchCli(writer, deps, options) {
           const toolNamesById = /* @__PURE__ */ new Map();
           const flockWorkerNames = /* @__PURE__ */ new Map();
           const workerTitles = /* @__PURE__ */ new Map();
+          const workerRowState = /* @__PURE__ */ new Map();
+          const workerActivity = /* @__PURE__ */ new Map();
+          const renderWorkerActivityRow = (workerId) => {
+            const base = workerRowState.get(workerId);
+            if (!base) return;
+            const text = composeWorkerActivityRowText(base, workerActivity.get(workerId));
+            updateToolItem(base.rowId, { label: base.label, text, tone: base.tone });
+          };
           const flockLimitMeta = /* @__PURE__ */ new Map();
           const aggregateToolIds = /* @__PURE__ */ new Map();
           const aggregateToolMeta = /* @__PURE__ */ new Map();
@@ -287924,7 +288127,15 @@ async function runInkInteractivePerchCli(writer, deps, options) {
                     setWorkingText("recovering route");
                     break;
                   case "tool_call_started": {
-                    if (event.workerId) break;
+                    if (event.workerId) {
+                      const act = workerActivity.get(event.workerId) ?? { calls: 0, lastTool: event.toolName };
+                      act.calls += 1;
+                      act.lastTool = event.toolName;
+                      workerActivity.set(event.workerId, act);
+                      renderWorkerActivityRow(event.workerId);
+                      setWorkingText(cliWorkerActivityVerb(event.toolName));
+                      break;
+                    }
                     if (event.toolName === "spawn_worker") break;
                     const toolId = event.toolCallId ?? `${event.toolName}-${Date.now()}`;
                     const name = humanizeCliToolName(event.toolName);
@@ -288240,7 +288451,17 @@ async function runInkInteractivePerchCli(writer, deps, options) {
                     const row = workerEventToCliRow(event);
                     if (!row) break;
                     if (row.id) {
-                      updateToolItem(row.id, { label: "worker", text: row.text, tone: row.tone });
+                      const done = event.type === "worker_run_completed";
+                      const status = done ? event.ok ? event.usabilityStatus === "needs_user_input" ? "blocked" : "done" : "failed" : "running";
+                      workerRowState.set(event.workerId, {
+                        rowId: row.id,
+                        label: "worker",
+                        displayName: event.title,
+                        status,
+                        tone: row.tone,
+                        done
+                      });
+                      renderWorkerActivityRow(event.workerId);
                     } else {
                       addItem({ label: "worker", text: row.text, tone: row.tone });
                     }
@@ -288264,7 +288485,19 @@ async function runInkInteractivePerchCli(writer, deps, options) {
                     }
                     const row = flockEventToCliRow(event);
                     if (!row) break;
-                    if (row.id) {
+                    if (event.type === "flock_worker_update" && row.id) {
+                      const done = !(event.status === "queued" || event.status === "waiting" || event.status === "running");
+                      workerRowState.set(event.workerId, {
+                        rowId: row.id,
+                        label: "flock",
+                        displayName: event.displayName,
+                        nickname: event.nickname,
+                        status: event.status,
+                        tone: row.tone,
+                        done
+                      });
+                      renderWorkerActivityRow(event.workerId);
+                    } else if (row.id) {
                       updateToolItem(row.id, { label: "flock", text: row.text, tone: row.tone });
                     } else {
                       addItem({ label: "flock", text: row.text, tone: row.tone });
@@ -289325,7 +289558,7 @@ function colorForInkDetailTone(tone) {
     case "add":
       return CLI_BRAND.patinaActive;
     case "remove":
-      return CLI_BRAND.bronzeGlint;
+      return CLI_BRAND.brick;
     case "stderr":
       return "#d06b55";
     case "command":
@@ -289342,18 +289575,18 @@ function colorForCliSyntaxTone(tone, lineTone) {
   if (lineTone === "remove") {
     switch (tone) {
       case "comment":
-        return "#8e6a55";
+        return "#9e6a5e";
       case "string":
-        return "#c48656";
+        return "#d98a72";
       case "keyword":
       case "flag":
-        return CLI_BRAND.bronzeGlint;
+        return CLI_BRAND.brickGlint;
       case "number":
-        return "#c77952";
+        return "#d2705a";
       case "operator":
-        return CLI_BRAND.bronzeDeep;
+        return CLI_BRAND.brickDeep;
       default:
-        return CLI_BRAND.bronzeGlint;
+        return CLI_BRAND.brick;
     }
   }
   if (lineTone === "add") {
@@ -289560,6 +289793,19 @@ function cliToolAggregateKind(toolName) {
   if (normalized === "glob" || normalized === "grep" || normalized === "listlocalsources" || normalized === "statpath" || normalized === "validateworkspaceroot") return "search";
   return null;
 }
+function cliWorkerActivityVerb(toolName) {
+  const aggregate = cliToolAggregateKind(toolName);
+  if (aggregate === "read") return "reading";
+  if (aggregate === "search") return "searching";
+  const n = toolName.toLowerCase();
+  if (n.includes("write") && n.includes("file")) return "writing";
+  if (n.includes("edit") && n.includes("file")) return "editing";
+  if (n.includes("patch")) return "patching";
+  if (n === "run_sandbox_code") return "running code";
+  if (n.includes("bash") || n.includes("terminal") || n.includes("shell")) return "running";
+  if (n === "spawn_worker" || n === "dispatch_agent") return "delegating";
+  return "working";
+}
 function getCliToolAggregateMeta(store, kind) {
   const existing = store.get(kind);
   if (existing) return existing;
@@ -290036,6 +290282,11 @@ var init_perch_cli = __esm({
       bronze: "#9A5228",
       bronzeGlint: "#B5632F",
       bronzeDeep: "#6F351D",
+      // Diff "removed" family — warm muted brick red, brand-tuned (not git red),
+      // kept distinct from bronze so deletions don't share the accent/interactive hue.
+      brick: "#CF6A52",
+      brickGlint: "#DC7A60",
+      brickDeep: "#9E4634",
       graphite: "#0F0D0B",
       divider: "#32251E",
       cream: "#FFF8F0",

package/package.json

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