@pasko70/pibo 1.9.13 → 1.10.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (139) hide show
  1. package/README.md +183 -183
  2. package/context/codex-base-prompt.md +148 -148
  3. package/context/compute-worker.md +23 -23
  4. package/context/pibo-compaction-prompt.md +100 -100
  5. package/context/pibo-native-tooling.md +18 -18
  6. package/context/pibo-system-prompt.md +77 -77
  7. package/dist/apps/chat/agent-profiles.js +2 -2
  8. package/dist/apps/chat/agent-store.js +263 -250
  9. package/dist/apps/chat/chat-request-normalizers.js +10 -0
  10. package/dist/apps/chat/data/project-service.js +168 -168
  11. package/dist/apps/chat/data/read-state-service.js +18 -18
  12. package/dist/apps/chat/data/session-query-service.js +25 -25
  13. package/dist/apps/chat/data/timeline-query-service.js +19 -19
  14. package/dist/apps/chat/loop-api.js +176 -0
  15. package/dist/apps/chat/static-assets.js +854 -854
  16. package/dist/apps/chat/web-app.js +6 -6
  17. package/dist/apps/chat/workflow-manual-trigger-runtime.js +149 -46
  18. package/dist/apps/chat/workflow-persistence.js +255 -255
  19. package/dist/apps/chat-ui/assets/{dist-yCYNNb5d.js → dist-BwKObYnX.js} +1 -1
  20. package/dist/apps/chat-ui/assets/{dist-BCB6zezO.js → dist-CKtT8YGm.js} +1 -1
  21. package/dist/apps/chat-ui/assets/{dist-CnVsqwSG.js → dist-CS7wdk0Z.js} +1 -1
  22. package/dist/apps/chat-ui/assets/{dist-HqTN67dc.js → dist-D-cxLQO1.js} +1 -1
  23. package/dist/apps/chat-ui/assets/{dist-BNMu92bb.js → dist-DUlaXAk7.js} +1 -1
  24. package/dist/apps/chat-ui/assets/{dist-CzE6k3F3.js → dist-DlATLa-U.js} +1 -1
  25. package/dist/apps/chat-ui/assets/{dist-Dq4GxJi3.js → dist-GdEM8UW1.js} +1 -1
  26. package/dist/apps/chat-ui/assets/{dist-BZ2eTC4f.js → dist-LHRs1Nhr.js} +1 -1
  27. package/dist/apps/chat-ui/assets/{dist-D811wJeV.js → dist-Y-AA2omI.js} +1 -1
  28. package/dist/apps/chat-ui/assets/{dist-WyXdYl-w.js → dist-nOLTkZrJ.js} +1 -1
  29. package/dist/apps/chat-ui/assets/{dist-BHa-kcGl.js → dist-wE9nop9V.js} +1 -1
  30. package/dist/apps/chat-ui/assets/{index-DwHJfmiF.js → index-8W_yMHQI.js} +6 -6
  31. package/dist/apps/chat-ui/index.html +17 -17
  32. package/dist/apps/chat-ui/manifest.webmanifest +25 -25
  33. package/dist/apps/chat-ui/sw.js +47 -47
  34. package/dist/apps/chat-vscode-web/index.html +12 -12
  35. package/dist/apps/cli-ui/cliSessionsCommand.js +23 -23
  36. package/dist/apps/context-files-ui/index.html +11 -11
  37. package/dist/cli.js +61 -44
  38. package/dist/compute/cli.js +54 -54
  39. package/dist/core/routed-session.js +30 -1
  40. package/dist/core/runtime.js +6 -1
  41. package/dist/core/session-router.js +4 -2
  42. package/dist/cron/cli.js +15 -15
  43. package/dist/cron/store.js +49 -49
  44. package/dist/data/cli.js +23 -23
  45. package/dist/data/event-log.js +23 -23
  46. package/dist/data/message-store.js +27 -27
  47. package/dist/data/navigation-store.js +9 -9
  48. package/dist/data/observation-store.js +4 -4
  49. package/dist/data/payload-store.js +17 -17
  50. package/dist/data/schema.js +433 -433
  51. package/dist/data/session-store.js +4 -4
  52. package/dist/data/telemetry-queries.js +54 -54
  53. package/dist/data/telemetry.js +197 -197
  54. package/dist/debug/events.js +12 -12
  55. package/dist/debug/failures.js +6 -6
  56. package/dist/debug/index.js +227 -227
  57. package/dist/debug/messages.js +6 -6
  58. package/dist/debug/pty.js +124 -124
  59. package/dist/debug/session.js +29 -29
  60. package/dist/debug/tools.js +5 -5
  61. package/dist/debug/web-snapshot-browser-scripts.js +294 -294
  62. package/dist/debug/web-streaming-browser-library.js +925 -925
  63. package/dist/debug/web-streaming-browser-scripts.js +232 -232
  64. package/dist/debug/web-streaming-provider-telemetry.js +4 -4
  65. package/dist/debug/web.js +93 -93
  66. package/dist/gateway/cli.js +19 -19
  67. package/dist/gateway/server.js +4 -2
  68. package/dist/gateway/web.js +2 -2
  69. package/dist/loops/channel.js +8 -0
  70. package/dist/loops/cli.js +208 -0
  71. package/dist/loops/plugin.js +16 -0
  72. package/dist/loops/prompts.js +83 -0
  73. package/dist/loops/service.js +357 -0
  74. package/dist/loops/stopping.js +170 -0
  75. package/dist/loops/store.js +531 -0
  76. package/dist/loops/templates.js +232 -0
  77. package/dist/loops/tools.js +167 -0
  78. package/dist/loops/types.js +1 -0
  79. package/dist/mcp/config-command.js +53 -53
  80. package/dist/mcp/index.js +21 -21
  81. package/dist/mcp/registry.js +11 -11
  82. package/dist/pi-packages/cli.js +11 -11
  83. package/dist/plugins/builtin.js +8 -0
  84. package/dist/plugins/context-files-store.js +110 -110
  85. package/dist/plugins/context-files.js +4 -4
  86. package/dist/plugins/registry.js +23 -12
  87. package/dist/ralph/cli.js +18 -18
  88. package/dist/ralph/templates.js +140 -140
  89. package/dist/reliability/store.js +226 -226
  90. package/dist/sessions/pibo-data-store.js +16 -16
  91. package/dist/sessions/sqlite-store.js +53 -53
  92. package/dist/setup/cli.js +58 -58
  93. package/dist/tools/agent-browser-wrapper.js +80 -80
  94. package/dist/tools/browser-use-cdp.js +12 -12
  95. package/dist/tools/browser-use-wrapper.js +762 -762
  96. package/dist/tools/guides.js +589 -538
  97. package/dist/tools/index.js +122 -99
  98. package/dist/tools/registry.js +21 -3
  99. package/dist/tools/runtime/node-worker-source.js +205 -205
  100. package/dist/tools/runtime/python-worker-source.js +177 -177
  101. package/dist/vscode/cli.js +9 -9
  102. package/dist/web-annotations/cdp.js +900 -900
  103. package/dist/web-annotations/store.js +96 -96
  104. package/docs/README.md +23 -23
  105. package/docs/ops/install-developer-host.md +112 -112
  106. package/docs/ops/install-user-host.md +96 -96
  107. package/docs/ops/upgrade-user-to-developer-host.md +69 -69
  108. package/docs/ops/vscode-extension-release.md +160 -160
  109. package/package.json +98 -95
  110. package/skills/builtin/graphify/SKILL.md +52 -52
  111. package/skills/builtin/loop/SKILL.md +69 -0
  112. package/skills/builtin/pi-agent-harness/SKILL.md +319 -319
  113. package/skills/builtin/pi-agent-harness/agents/openai.yaml +4 -4
  114. package/skills/builtin/pibo-docker-system/SKILL.md +170 -170
  115. package/skills/builtin/pibo-spec-writing/SKILL.md +330 -330
  116. package/skills/builtin/prd/SKILL.md +143 -143
  117. package/skills/builtin/ralph-loop/SKILL.md +361 -359
  118. package/skills/builtin/ralph-prd-json/SKILL.md +123 -123
  119. package/skills/builtin/skill-creator/LICENSE.txt +201 -201
  120. package/skills/builtin/skill-creator/SKILL.md +513 -513
  121. package/skills/builtin/skill-creator/agents/analyzer.md +274 -274
  122. package/skills/builtin/skill-creator/agents/comparator.md +202 -202
  123. package/skills/builtin/skill-creator/agents/grader.md +223 -223
  124. package/skills/builtin/skill-creator/assets/eval_review.html +146 -146
  125. package/skills/builtin/skill-creator/eval-viewer/generate_review.py +471 -471
  126. package/skills/builtin/skill-creator/eval-viewer/viewer.html +1325 -1325
  127. package/skills/builtin/skill-creator/references/schemas.md +430 -430
  128. package/skills/builtin/skill-creator/scripts/aggregate_benchmark.py +401 -401
  129. package/skills/builtin/skill-creator/scripts/generate_report.py +326 -326
  130. package/skills/builtin/skill-creator/scripts/improve_description.py +247 -247
  131. package/skills/builtin/skill-creator/scripts/package_skill.py +136 -136
  132. package/skills/builtin/skill-creator/scripts/quick_validate.py +102 -102
  133. package/skills/builtin/skill-creator/scripts/run_eval.py +310 -310
  134. package/skills/builtin/skill-creator/scripts/run_loop.py +328 -328
  135. package/skills/builtin/skill-creator/scripts/utils.py +47 -47
  136. package/skills/builtin/web-annotations/SKILL.md +93 -93
  137. package/src/mcp/LICENSE.mcp-cli +21 -21
  138. package/dist/apps/vscode-artifacts/latest.vsix +0 -0
  139. package/dist/apps/vscode-artifacts/pibo-vscode-ext-1.9.13.vsix +0 -0
package/dist/apps/chat-ui/index.html CHANGED
@@ -1,20 +1,20 @@
1
- <!doctype html>
2
- <html lang="de" class="dark">
3
- <head>
4
- <meta charset="UTF-8" />
5
- <meta name="viewport" content="width=device-width, initial-scale=1.0, viewport-fit=cover" />
6
- <meta name="theme-color" content="#101d22" />
7
- <meta name="apple-mobile-web-app-capable" content="yes" />
8
- <meta name="apple-mobile-web-app-title" content="Pibo Chat" />
9
- <link rel="manifest" href="/apps/chat/manifest.webmanifest" />
10
- <link rel="apple-touch-icon" href="/apps/chat/assets/pwa-images/ios/180.png" />
11
- <title>Pibo Web Chat</title>
12
- <script type="module" crossorigin src="/apps/chat/assets/index-DwHJfmiF.js"></script>
1
+ <!doctype html>
2
+ <html lang="de" class="dark">
3
+ <head>
4
+ <meta charset="UTF-8" />
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0, viewport-fit=cover" />
6
+ <meta name="theme-color" content="#101d22" />
7
+ <meta name="apple-mobile-web-app-capable" content="yes" />
8
+ <meta name="apple-mobile-web-app-title" content="Pibo Chat" />
9
+ <link rel="manifest" href="/apps/chat/manifest.webmanifest" />
10
+ <link rel="apple-touch-icon" href="/apps/chat/assets/pwa-images/ios/180.png" />
11
+ <title>Pibo Web Chat</title>
12
+ <script type="module" crossorigin src="/apps/chat/assets/index-8W_yMHQI.js"></script>
13
13
  <link rel="modulepreload" crossorigin href="/apps/chat/assets/rolldown-runtime-S-ySWqyJ.js">
14
14
  <link rel="modulepreload" crossorigin href="/apps/chat/assets/dist-SVPsM5Oi.js">
15
15
  <link rel="stylesheet" crossorigin href="/apps/chat/assets/index-C0x9nEcf.css">
16
- </head>
17
- <body>
18
- <div id="root"></div>
19
- </body>
20
- </html>
16
+ </head>
17
+ <body>
18
+ <div id="root"></div>
19
+ </body>
20
+ </html>
package/dist/apps/chat-ui/manifest.webmanifest CHANGED
@@ -1,25 +1,25 @@
1
- {
2
- "name": "Pibo Web Chat",
3
- "short_name": "Pibo Chat",
4
- "description": "Pibo Chat Web App als installierbare Progressive Web App.",
5
- "start_url": "/apps/chat/",
6
- "scope": "/apps/chat/",
7
- "display": "standalone",
8
- "background_color": "#101d22",
9
- "theme_color": "#101d22",
10
- "orientation": "any",
11
- "icons": [
12
- {
13
- "src": "/apps/chat/assets/pwa-images/android/launchericon-192x192.png",
14
- "sizes": "192x192",
15
- "type": "image/png",
16
- "purpose": "any maskable"
17
- },
18
- {
19
- "src": "/apps/chat/assets/pwa-images/android/launchericon-512x512.png",
20
- "sizes": "512x512",
21
- "type": "image/png",
22
- "purpose": "any maskable"
23
- }
24
- ]
25
- }
1
+ {
2
+ "name": "Pibo Web Chat",
3
+ "short_name": "Pibo Chat",
4
+ "description": "Pibo Chat Web App als installierbare Progressive Web App.",
5
+ "start_url": "/apps/chat/",
6
+ "scope": "/apps/chat/",
7
+ "display": "standalone",
8
+ "background_color": "#101d22",
9
+ "theme_color": "#101d22",
10
+ "orientation": "any",
11
+ "icons": [
12
+ {
13
+ "src": "/apps/chat/assets/pwa-images/android/launchericon-192x192.png",
14
+ "sizes": "192x192",
15
+ "type": "image/png",
16
+ "purpose": "any maskable"
17
+ },
18
+ {
19
+ "src": "/apps/chat/assets/pwa-images/android/launchericon-512x512.png",
20
+ "sizes": "512x512",
21
+ "type": "image/png",
22
+ "purpose": "any maskable"
23
+ }
24
+ ]
25
+ }
package/dist/apps/chat-ui/sw.js CHANGED
@@ -1,47 +1,47 @@
1
- const CACHE_NAME = "pibo-chat-v2";
2
- const APP_SHELL_URL = "/apps/chat/";
3
-
4
- self.addEventListener("install", (event) => {
5
- event.waitUntil(
6
- caches.open(CACHE_NAME)
7
- .then((cache) => cache.add(APP_SHELL_URL))
8
- .then(() => self.skipWaiting()),
9
- );
10
- });
11
-
12
- self.addEventListener("activate", (event) => {
13
- event.waitUntil(
14
- caches.keys()
15
- .then((names) => Promise.all(names.filter((name) => name !== CACHE_NAME).map((name) => caches.delete(name))))
16
- .then(() => self.clients.claim()),
17
- );
18
- });
19
-
20
- self.addEventListener("message", (event) => {
21
- if (event.data && event.data.type === "PIBO_CHAT_SKIP_WAITING") {
22
- self.skipWaiting();
23
- }
24
- });
25
-
26
- self.addEventListener("fetch", (event) => {
27
- const request = event.request;
28
- if (request.method !== "GET") return;
29
-
30
- const url = new URL(request.url);
31
- if (url.origin !== self.location.origin || !url.pathname.startsWith("/apps/chat/")) return;
32
-
33
- if (request.mode === "navigate") {
34
- event.respondWith(fetch(request).catch(() => caches.match(APP_SHELL_URL)));
35
- return;
36
- }
37
-
38
- if (url.pathname.startsWith("/apps/chat/assets/")) {
39
- event.respondWith(
40
- caches.match(request).then((cached) => cached ?? fetch(request).then((response) => {
41
- const copy = response.clone();
42
- caches.open(CACHE_NAME).then((cache) => cache.put(request, copy));
43
- return response;
44
- })),
45
- );
46
- }
47
- });
1
+ const CACHE_NAME = "pibo-chat-v2";
2
+ const APP_SHELL_URL = "/apps/chat/";
3
+
4
+ self.addEventListener("install", (event) => {
5
+ event.waitUntil(
6
+ caches.open(CACHE_NAME)
7
+ .then((cache) => cache.add(APP_SHELL_URL))
8
+ .then(() => self.skipWaiting()),
9
+ );
10
+ });
11
+
12
+ self.addEventListener("activate", (event) => {
13
+ event.waitUntil(
14
+ caches.keys()
15
+ .then((names) => Promise.all(names.filter((name) => name !== CACHE_NAME).map((name) => caches.delete(name))))
16
+ .then(() => self.clients.claim()),
17
+ );
18
+ });
19
+
20
+ self.addEventListener("message", (event) => {
21
+ if (event.data && event.data.type === "PIBO_CHAT_SKIP_WAITING") {
22
+ self.skipWaiting();
23
+ }
24
+ });
25
+
26
+ self.addEventListener("fetch", (event) => {
27
+ const request = event.request;
28
+ if (request.method !== "GET") return;
29
+
30
+ const url = new URL(request.url);
31
+ if (url.origin !== self.location.origin || !url.pathname.startsWith("/apps/chat/")) return;
32
+
33
+ if (request.mode === "navigate") {
34
+ event.respondWith(fetch(request).catch(() => caches.match(APP_SHELL_URL)));
35
+ return;
36
+ }
37
+
38
+ if (url.pathname.startsWith("/apps/chat/assets/")) {
39
+ event.respondWith(
40
+ caches.match(request).then((cached) => cached ?? fetch(request).then((response) => {
41
+ const copy = response.clone();
42
+ caches.open(CACHE_NAME).then((cache) => cache.put(request, copy));
43
+ return response;
44
+ })),
45
+ );
46
+ }
47
+ });
package/dist/apps/chat-vscode-web/index.html CHANGED
@@ -1,14 +1,14 @@
1
- <!doctype html>
2
- <html lang="de" class="dark">
3
- <head>
4
- <meta charset="UTF-8" />
5
- <meta name="viewport" content="width=device-width, initial-scale=1.0" />
6
- <meta name="theme-color" content="#101d22" />
7
- <title>Pibo</title>
1
+ <!doctype html>
2
+ <html lang="de" class="dark">
3
+ <head>
4
+ <meta charset="UTF-8" />
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0" />
6
+ <meta name="theme-color" content="#101d22" />
7
+ <title>Pibo</title>
8
8
  <script type="module" crossorigin src="/apps/chat-vscode/assets/index-BAMxIaI_.js"></script>
9
9
  <link rel="stylesheet" crossorigin href="/apps/chat-vscode/assets/index-B5QK07zO.css">
10
- </head>
11
- <body>
12
- <div id="root"></div>
13
- </body>
14
- </html>
10
+ </head>
11
+ <body>
12
+ <div id="root"></div>
13
+ </body>
14
+ </html>
package/dist/apps/cli-ui/cliSessionsCommand.js CHANGED
@@ -205,28 +205,28 @@ export function terminalLineLimitFromColumns(columns) {
205
205
  return Math.max(20, Math.floor(columns) - 4);
206
206
  }
207
207
  export function cliSessionsHelpText() {
208
- return `pibo tui:sessions - reduced Web Chat-derived session UI for terminals
209
-
210
- Usage:
211
- pibo tui:sessions [options]
212
-
213
- Options:
214
- --session <id> Open a specific Pibo session id
215
- --max-rows <count> Limit rendered transcript rows (default: 20)
216
- --demo Use deterministic fake session data for smoke testing
217
- -h, --help Show this help
218
-
219
- V2 commands inside the app:
220
- ${cliCommandSummaryText()}
221
-
222
- Scope:
223
- CLI Sessions is a reduced session/chat UI for SSH, bootstrap, recovery, and quick local work.
224
- It starts only when stdin and stdout are interactive TTYs; pipes fail with a clear error.
225
- Transcript rendering uses a bounded default tail window of 20 rows and truncates narrow terminal lines.
226
- Web Chat remains the full control center for projects, workflows, Cron, Ralph, Agent Designer, settings, and context management.
227
-
228
- Related existing commands:
229
- pibo tui
230
- pibo tui:routed
208
+ return `pibo tui:sessions - reduced Web Chat-derived session UI for terminals
209
+
210
+ Usage:
211
+ pibo tui:sessions [options]
212
+
213
+ Options:
214
+ --session <id> Open a specific Pibo session id
215
+ --max-rows <count> Limit rendered transcript rows (default: 20)
216
+ --demo Use deterministic fake session data for smoke testing
217
+ -h, --help Show this help
218
+
219
+ V2 commands inside the app:
220
+ ${cliCommandSummaryText()}
221
+
222
+ Scope:
223
+ CLI Sessions is a reduced session/chat UI for SSH, bootstrap, recovery, and quick local work.
224
+ It starts only when stdin and stdout are interactive TTYs; pipes fail with a clear error.
225
+ Transcript rendering uses a bounded default tail window of 20 rows and truncates narrow terminal lines.
226
+ Web Chat remains the full control center for projects, workflows, Cron, Ralph, Agent Designer, settings, and context management.
227
+
228
+ Related existing commands:
229
+ pibo tui
230
+ pibo tui:routed
231
231
  `;
232
232
  }
package/dist/apps/context-files-ui/index.html CHANGED
@@ -1,14 +1,14 @@
1
- <!doctype html>
2
- <html lang="en">
3
- <head>
4
- <meta charset="UTF-8" />
5
- <meta name="viewport" content="width=device-width, initial-scale=1.0" />
6
- <title>Pibo Context Files</title>
1
+ <!doctype html>
2
+ <html lang="en">
3
+ <head>
4
+ <meta charset="UTF-8" />
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0" />
6
+ <title>Pibo Context Files</title>
7
7
  <script type="module" crossorigin src="/apps/context-files/assets/index-BhAWD3dv.js"></script>
8
8
  <link rel="modulepreload" crossorigin href="/apps/context-files/assets/dist-D1KyNDg5.js">
9
9
  <link rel="stylesheet" crossorigin href="/apps/context-files/assets/index-B92tL3Pp.css">
10
- </head>
11
- <body>
12
- <div id="root"></div>
13
- </body>
14
- </html>
10
+ </head>
11
+ <body>
12
+ <div id="root"></div>
13
+ </body>
14
+ </html>
package/dist/cli.js CHANGED
@@ -135,9 +135,14 @@ export async function runPiboCli(argv = process.argv) {
135
135
  await runCronCli([argv[0] ?? "node", "pibo cron", ...argv.slice(3)]);
136
136
  return;
137
137
  }
138
+ if (argv[2] === "loop") {
139
+ const { runLoopCli } = await import("./loops/cli.js");
140
+ await runLoopCli([argv[0] ?? "node", "pibo loop", ...argv.slice(3)]);
141
+ return;
142
+ }
138
143
  if (argv[2] === "ralph") {
139
- const { runRalphCli } = await import("./ralph/cli.js");
140
- await runRalphCli([argv[0] ?? "node", "pibo ralph", ...argv.slice(3)]);
144
+ const { runLoopCli } = await import("./loops/cli.js");
145
+ await runLoopCli([argv[0] ?? "node", "pibo ralph", ...argv.slice(3)], { mode: "ralph", commandName: "pibo ralph" });
141
146
  return;
142
147
  }
143
148
  if (argv[2] === "vscode") {
@@ -266,16 +271,27 @@ export async function runPiboCli(argv = process.argv) {
266
271
  const { runCronCli } = await import("./cron/cli.js");
267
272
  await runCronCli([argv[0] ?? "node", "pibo cron", ...args]);
268
273
  });
274
+ program
275
+ .command("loop")
276
+ .description("Manage continuous agent loops")
277
+ .helpOption(false)
278
+ .allowUnknownOption(true)
279
+ .allowExcessArguments(true)
280
+ .argument("[args...]")
281
+ .action(async (args) => {
282
+ const { runLoopCli } = await import("./loops/cli.js");
283
+ await runLoopCli([argv[0] ?? "node", "pibo loop", ...args]);
284
+ });
269
285
  program
270
286
  .command("ralph")
271
- .description("Manage continuous Ralph jobs")
287
+ .description("Legacy alias for Ralph-mode loops")
272
288
  .helpOption(false)
273
289
  .allowUnknownOption(true)
274
290
  .allowExcessArguments(true)
275
291
  .argument("[args...]")
276
292
  .action(async (args) => {
277
- const { runRalphCli } = await import("./ralph/cli.js");
278
- await runRalphCli([argv[0] ?? "node", "pibo ralph", ...args]);
293
+ const { runLoopCli } = await import("./loops/cli.js");
294
+ await runLoopCli([argv[0] ?? "node", "pibo ralph", ...args], { mode: "ralph", commandName: "pibo ralph" });
279
295
  });
280
296
  program
281
297
  .command("vscode")
@@ -445,47 +461,48 @@ function warnIfUnsupportedGatewayNodeVersion() {
445
461
  console.warn(`[pibo] warning: ${message}`);
446
462
  }
447
463
  function printRootDiscoveryText() {
448
- return `pibo - agent-oriented CLI
449
-
450
- Commands:
451
- config Manage local pibo config
452
- mcp Discover and call configured MCP servers
453
- tools Install and inspect curated external CLI tools
454
- pi-packages Register Pi Coding Agent packages
455
- debug Inspect local Pibo data
456
- data Inspect and maintain Pibo data stores
457
- compute Manage Pibo Docker compute workers
458
- resources Inspect and safely reap managed compute and browser resources
459
- setup Plan user-host installs and developer-host upgrades
460
- skills Manage Pibo user skills
461
- cron Manage scheduled Pibo jobs
462
- ralph Manage continuous Ralph jobs
463
- vscode Manage the Pibo VS Code extension
464
- profile Inspect a pibo profile, including active saved Chat custom agents
465
- tui Start the direct Pi TUI
466
- tui:routed Start the local routed Pibo TUI
467
- tui:sessions Start the reduced Web Chat-derived session UI
468
- gateway Inspect and restart host gateways through safe CLI commands
469
- gateway:web Start a web gateway runtime (use --auth=local for loopback-only local auth)
470
-
471
- Options:
472
- --version Print the Pibo CLI version
473
-
474
- Next:
475
- pibo <command> --help
464
+ return `pibo - agent-oriented CLI
465
+
466
+ Commands:
467
+ config Manage local pibo config
468
+ mcp Discover and call configured MCP servers
469
+ tools Install and inspect curated external CLI tools
470
+ pi-packages Register Pi Coding Agent packages
471
+ debug Inspect local Pibo data
472
+ data Inspect and maintain Pibo data stores
473
+ compute Manage Pibo Docker compute workers
474
+ resources Inspect and safely reap managed compute and browser resources
475
+ setup Plan user-host installs and developer-host upgrades
476
+ skills Manage Pibo user skills
477
+ cron Manage scheduled Pibo jobs
478
+ loop Manage continuous agent loops (goal mode by default)
479
+ ralph Legacy alias for Ralph-mode loops
480
+ vscode Manage the Pibo VS Code extension
481
+ profile Inspect a pibo profile, including active saved Chat custom agents
482
+ tui Start the direct Pi TUI
483
+ tui:routed Start the local routed Pibo TUI
484
+ tui:sessions Start the reduced Web Chat-derived session UI
485
+ gateway Inspect and restart host gateways through safe CLI commands
486
+ gateway:web Start a web gateway runtime (use --auth=local for loopback-only local auth)
487
+
488
+ Options:
489
+ --version Print the Pibo CLI version
490
+
491
+ Next:
492
+ pibo <command> --help
476
493
  `;
477
494
  }
478
495
  function printConfigDiscoveryText() {
479
- return `pibo config - local config at ${getDefaultPiboConfigPath()}
480
-
481
- Commands:
482
- keys List supported config keys
483
- show Print redacted config JSON
484
- get <key> Print one redacted config value
485
- set <key> <value> Set one config value
486
- del <key> Delete one config value
487
-
488
- Next:
489
- pibo config keys
496
+ return `pibo config - local config at ${getDefaultPiboConfigPath()}
497
+
498
+ Commands:
499
+ keys List supported config keys
500
+ show Print redacted config JSON
501
+ get <key> Print one redacted config value
502
+ set <key> <value> Set one config value
503
+ del <key> Delete one config value
504
+
505
+ Next:
506
+ pibo config keys
490
507
  `;
491
508
  }
package/dist/compute/cli.js CHANGED
@@ -188,16 +188,16 @@ export async function runComputeCli(argv) {
188
188
  .helpOption("-h, --help", "Show help")
189
189
  .showHelpAfterError()
190
190
  .helpCommand("help [command]", "Show help for command")
191
- .addHelpText("after", `
192
- Examples:
193
- $ pibo compute spawn
194
- $ pibo compute dev spawn --worktree my-fix
195
- $ pibo compute list
196
- $ pibo compute release pibo-worker-abc123
197
-
198
- Next:
199
- $ pibo compute spawn --help
200
- $ pibo compute dev --help
191
+ .addHelpText("after", `
192
+ Examples:
193
+ $ pibo compute spawn
194
+ $ pibo compute dev spawn --worktree my-fix
195
+ $ pibo compute list
196
+ $ pibo compute release pibo-worker-abc123
197
+
198
+ Next:
199
+ $ pibo compute spawn --help
200
+ $ pibo compute dev --help
201
201
  `);
202
202
  program
203
203
  .command("spawn")
@@ -208,11 +208,11 @@ Next:
208
208
  .option("--idle-seconds <n>", "Tag the worker idle retention in seconds")
209
209
  .option("--ralph-job-id <id>", "Tag the Ralph job id when this worker is Ralph-owned")
210
210
  .option("--ralph-run-id <id>", "Tag the Ralph run id when this worker is Ralph-owned")
211
- .addHelpText("after", `
212
- Creates a worker container and starts the gateway. Prints JSON with the container id and mapped ports.
213
-
214
- Use this for quick isolated checks. For code changes, prefer:
215
- $ pibo compute dev spawn --worktree my-fix
211
+ .addHelpText("after", `
212
+ Creates a worker container and starts the gateway. Prints JSON with the container id and mapped ports.
213
+
214
+ Use this for quick isolated checks. For code changes, prefer:
215
+ $ pibo compute dev spawn --worktree my-fix
216
216
  `)
217
217
  .action(async (options) => {
218
218
  await mkdir(path.dirname(HASH_FILE), { recursive: true });
@@ -238,11 +238,11 @@ Use this for quick isolated checks. For code changes, prefer:
238
238
  .command("dev")
239
239
  .description("Manage development workers with Git worktrees")
240
240
  .helpCommand("help [command]", "Show help for command")
241
- .addHelpText("after", `
242
- Use dev workers for Pibo code changes. Each worker gets its own Git worktree and port block.
243
-
244
- Next:
245
- $ pibo compute dev spawn --help
241
+ .addHelpText("after", `
242
+ Use dev workers for Pibo code changes. Each worker gets its own Git worktree and port block.
243
+
244
+ Next:
245
+ $ pibo compute dev spawn --help
246
246
  `);
247
247
  devCmd
248
248
  .command("spawn")
@@ -254,11 +254,11 @@ Next:
254
254
  .option("--idle-seconds <n>", "Tag the worker idle retention in seconds")
255
255
  .option("--ralph-job-id <id>", "Tag the Ralph job id when this worker is Ralph-owned")
256
256
  .option("--ralph-run-id <id>", "Tag the Ralph run id when this worker is Ralph-owned")
257
- .addHelpText("after", `
258
- Creates .worktrees/<name>, starts a worker, and prints JSON with ports and the worktree path.
259
-
260
- Example:
261
- $ pibo compute dev spawn --worktree my-fix
257
+ .addHelpText("after", `
258
+ Creates .worktrees/<name>, starts a worker, and prints JSON with ports and the worktree path.
259
+
260
+ Example:
261
+ $ pibo compute dev spawn --worktree my-fix
262
262
  `)
263
263
  .action(async (options) => {
264
264
  await mkdir(path.dirname(DEP_HASH_FILE), { recursive: true });
@@ -293,8 +293,8 @@ Example:
293
293
  program
294
294
  .command("rebuild")
295
295
  .description("Rebuild the pibo:latest Docker image")
296
- .addHelpText("after", `
297
- Rebuilds from the current workspace and refreshes compute image hashes.
296
+ .addHelpText("after", `
297
+ Rebuilds from the current workspace and refreshes compute image hashes.
298
298
  `)
299
299
  .action(async () => {
300
300
  console.error(`Rebuilding ${IMAGE_NAME} from ${WORKSPACE_DIR}...`);
@@ -309,11 +309,11 @@ Rebuilds from the current workspace and refreshes compute image hashes.
309
309
  .option("--all", "Include stopped, exited, dead, and restarting Pibo workers")
310
310
  .option("--json", "Print machine-readable worker metadata")
311
311
  .option("--verbose", "Show full Docker port bindings in text output")
312
- .addHelpText("after", `
313
- Shows each worker's name, role, status, mapped ports, creation time, holder, and Ralph labels when present.
314
-
315
- Next:
316
- $ pibo compute list --all --json
312
+ .addHelpText("after", `
313
+ Shows each worker's name, role, status, mapped ports, creation time, holder, and Ralph labels when present.
314
+
315
+ Next:
316
+ $ pibo compute list --all --json
317
317
  `)
318
318
  .action(async (options) => {
319
319
  const workers = await listWorkers({ all: options.all === true });
@@ -330,14 +330,14 @@ Next:
330
330
  .option("--json", "Print machine-readable resource health")
331
331
  .option("--browser-pool-root <path>", "Browser pool root directory to scan")
332
332
  .option("--browser-use-home <path>", "Browser-use home directory to scan for stale CDP files")
333
- .addHelpText("after", `
334
- Reports browser main-process counts, active browser-pool leases, stale CDP files, dirty/OOM workers, Docker disk pressure, and reaper/timer status.
335
- The command is read-only and never reaps, prunes, stops, or removes resources.
336
-
337
- Next:
338
- $ pibo compute health --json
339
- $ pibo tools browser-use pool reap --json
340
- $ pibo compute reap --dry-run --json
333
+ .addHelpText("after", `
334
+ Reports browser main-process counts, active browser-pool leases, stale CDP files, dirty/OOM workers, Docker disk pressure, and reaper/timer status.
335
+ The command is read-only and never reaps, prunes, stops, or removes resources.
336
+
337
+ Next:
338
+ $ pibo compute health --json
339
+ $ pibo tools browser-use pool reap --json
340
+ $ pibo compute reap --dry-run --json
341
341
  `)
342
342
  .action(async (options) => {
343
343
  const health = await getComputeResourceHealth({ browserPoolRoot: options.browserPoolRoot, browserUseHome: options.browserUseHome });
@@ -352,13 +352,13 @@ Next:
352
352
  .alias("disk")
353
353
  .description("Show read-only Docker disk and build-cache diagnostics")
354
354
  .option("--json", "Print machine-readable disk diagnostics")
355
- .addHelpText("after", `
356
- Reports Docker image, container, local volume, and build-cache usage without pruning anything.
357
- Cleanup suggestions distinguish compute containers, images, build cache, and Git worktrees.
358
-
359
- Next:
360
- $ pibo compute diagnostics --json
361
- $ pibo compute reap --dry-run --json
355
+ .addHelpText("after", `
356
+ Reports Docker image, container, local volume, and build-cache usage without pruning anything.
357
+ Cleanup suggestions distinguish compute containers, images, build cache, and Git worktrees.
358
+
359
+ Next:
360
+ $ pibo compute diagnostics --json
361
+ $ pibo compute reap --dry-run --json
362
362
  `)
363
363
  .action(async (options) => {
364
364
  const diagnostics = await getComputeDiskDiagnostics();
@@ -372,9 +372,9 @@ Next:
372
372
  .command("release")
373
373
  .description("Stop and remove a worker container")
374
374
  .argument("<id>", "Container name or ID")
375
- .addHelpText("after", `
376
- Use the name or id shown by:
377
- $ pibo compute list
375
+ .addHelpText("after", `
376
+ Use the name or id shown by:
377
+ $ pibo compute list
378
378
  `)
379
379
  .action(async (id) => {
380
380
  await releaseWorker(id);
@@ -390,10 +390,10 @@ Use the name or id shown by:
390
390
  .option("--dry-run", "Preview the cleanup plan without removing containers")
391
391
  .option("--apply", "Apply the cleanup plan and remove selected containers")
392
392
  .option("--json", "Print machine-readable cleanup plan/result")
393
- .addHelpText("after", `
394
- Defaults to a dry-run plan for one-time workers. Dev workers require --include-dev.
395
- Stopped, dirty/OOM, and old workers are selected unless disabled by selector flags.
396
- Worktrees are preserved; container cleanup never deletes Git worktrees.
393
+ .addHelpText("after", `
394
+ Defaults to a dry-run plan for one-time workers. Dev workers require --include-dev.
395
+ Stopped, dirty/OOM, and old workers are selected unless disabled by selector flags.
396
+ Worktrees are preserved; container cleanup never deletes Git worktrees.
397
397
  `)
398
398
  .action(async (options) => {
399
399
  const maxAge = Number(options.maxAgeMinutes);