pi-recurse 0.1.3 → 0.1.5

package/CHANGELOG.md

@@ -5,6 +5,12 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.1.5] - 2026-08-09
+
+### Fixed
+
+- Grey the recurse result summary, child ids, and expanded tree lines (muted) to match pi core's output styling.
+
 ## [0.1.0] - 2025-03-24
 
 ### Added

package/index.ts

@@ -478,7 +478,7 @@ export default function piRecurseExtension(pi: ExtensionAPI) {
       const icon = stats.failed === 0 ? theme.fg('success', '✓') : theme.fg('warning', '⚠');
       const hasChildren = data.results.some((r) => r.children);
 
-      let text = `${icon} ${stats.succeeded}/${stats.total} at depth ${depth}${mode ? ` · ${mode}` : ''}`;
+      let text = `${icon} ${theme.fg('muted', `${stats.succeeded}/${stats.total} at depth ${depth}${mode ? ` · ${mode}` : ''}`)}`;
 
       if (stats.totalCost && stats.totalCost > 0) {
         text += theme.fg('dim', ` · $${stats.totalCost.toFixed(4)}`);
@@ -493,13 +493,13 @@ export default function piRecurseExtension(pi: ExtensionAPI) {
           // Render tree view
           const tree = buildRecurseTree(data, mode);
           const treeLines = renderRecurseTree(tree, 100);
-          text += '\n' + treeLines.join('\n');
+          text += '\n' + treeLines.map((line) => theme.fg('muted', line)).join('\n');
         } else {
           // Simple flat view
           text += '\n';
           for (const r of data.results) {
             const status = r.success ? theme.fg('success', '✓') : theme.fg('error', '✗');
-            text += `  ${status} ${r.id}`;
+            text += `  ${status} ${theme.fg('muted', r.id)}`;
             if (r.children) {
               text += theme.fg('accent', ` → ${r.children.stats.total} children`);
             }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-recurse",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Recursive agent extension for Pi — spawn subagents programmatically with depth guardrails",
   "type": "module",
   "author": "Tom X Nguyen",
@@ -29,12 +29,14 @@
     "*.d.ts",
     "lib/**",
     "tests/**",
+    "skills/**",
     "README.md",
     "CHANGELOG.md"
   ],
   "devDependencies": {
     "@commitlint/cli": "21.0.1",
     "@commitlint/config-conventional": "21.0.1",
+    "@earendil-works/pi-tui": "0.84.1",
     "@types/node": "25.9.1",
     "@vitest/coverage-v8": "4.1.7",
     "knip": "6.14.1",
@@ -43,8 +45,7 @@
     "simple-git-hooks": "2.13.1",
     "standard-version": "9.5.0",
     "typescript": "6.0.3",
-    "vitest": "4.1.7",
-    "@earendil-works/pi-tui": "0.84.0"
+    "vitest": "4.1.7"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": ">=0.74.0",

package/skills/recurse/SKILL.md

@@ -0,0 +1,90 @@
+---
+name: recurse
+description: Use the `recurse` tool for programmatic subagent delegation. Supports single, parallel, and chain modes for large file processing, batch analysis, and sequential pipelines.
+---
+
+# Recurse Skill
+
+Use the `recurse` tool for programmatic subagent delegation.
+
+## When to Use
+
+- **Large files** that exceed context window → chunk and recurse
+- **Batch analysis** of multiple files → parallel mode
+- **Sequential pipelines** where step N depends on step N-1 → chain mode
+- **Divide-and-conquer** refactoring → parallel tasks per file
+
+## Mode Selection Guide
+
+| Situation | Mode | Why |
+|-----------|------|-----|
+| One specific task | `single` | Simplest, direct |
+| 10+ independent file reviews | `parallel` | Concurrent, fastest |
+| Summary → Analysis → Plan | `chain` | Each step needs prior output |
+| Cross-file refactoring | `parallel` with per-file tasks | Divide work, combine results |
+
+## Example Patterns
+
+### Parallel File Analysis
+```typescript
+const files = await findFiles("src/**/*.ts");
+const results = await recurse({
+  mode: "parallel",
+  tasks: files.map(f => ({
+    id: f,
+    prompt: `Review ${f}: identify bugs, suggest improvements. Be concise.`
+  })),
+  concurrency: 4
+});
+
+// Aggregate
+const issues = results.results.filter(r => r.output.includes("BUG"));
+```
+
+### Chain: Summarize → Analyze → Plan
+```typescript
+const plan = await recurse({
+  mode: "chain",
+  chain: [
+    { id: "readme", prompt: "Summarize README.md in 3 bullet points" },
+    { id: "risks", prompt: "Given this summary: {previous}, what are 3 implementation risks?" },
+    { id: "mitigations", prompt: "Given these risks: {previous}, suggest mitigations for each" }
+  ]
+});
+```
+
+### Chunked Large File Processing
+```typescript
+const totalLines = await getLineCount("huge.log");
+const chunkSize = 500;
+const tasks = [];
+
+for (let start = 1; start <= totalLines; start += chunkSize) {
+  const end = Math.min(start + chunkSize - 1, totalLines);
+  tasks.push({
+    id: `lines-${start}-${end}`,
+    prompt: `Extract ERROR entries from lines ${start}-${end}`,
+    context: await readLines("huge.log", start, end)
+  });
+}
+
+const errors = await recurse({ mode: "parallel", tasks });
+```
+
+## Guardrails
+
+The extension automatically enforces limits:
+- Max depth (default: 3)
+- Max total calls (default: 100)
+- Timeout (default: 600s)
+- Budget (optional, via RLM_BUDGET)
+
+At depth ≥ 3, the recurse tool is disabled. Work directly instead.
+
+## Cost Awareness
+
+Check result.stats after recurse calls:
+```typescript
+const result = await recurse({ mode: "parallel", tasks });
+console.log(`Cost: $${result.stats.totalCost?.toFixed(4) || 'unknown'}`);
+```