perchai-cli 2.4.40 → 2.4.41

package/dist/perch.mjs

@@ -75917,6 +75917,7 @@ 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.";
   }
 });
@@ -92807,6 +92808,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",
@@ -92996,6 +93031,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 +93199,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 +93261,8 @@ var init_skillSelector = __esm({
       "browser_navigate"
     ]);
     CORE_PRIORITY = [
+      "wait-operator",
+      "github",
       "data-quality",
       "presentations",
       "spreadsheets",
@@ -93218,6 +93298,14 @@ 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
+      ],
+      "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 +217076,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 +218040,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 +218304,7 @@ var init_toolBatchExecutor = __esm({
     "use strict";
     init_modelRegistry();
     init_toolExecutor();
+    init_fileDiff();
     init_toolNames();
     init_localCommandPolicy();
     init_toolArgHardening();
@@ -287199,6 +287340,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 +287400,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 +288015,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 +288088,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 +288412,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 +288446,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 +289519,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 +289536,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 +289754,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 +290243,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.41",
   "description": "Perch AI command-line interface",
   "bin": {
     "perch": "bin/perch"