@pasko70/pibo 1.9.13 → 1.10.1

package/package.json

@@ -1,95 +1,99 @@
-{
-  "name": "@pasko70/pibo",
-  "version": "1.9.13",
-  "type": "module",
-  "imports": {
-    "vscode": "./src/apps/chat-vscode/extension/src/vscode-shim.js"
-  },
-  "description": "Minimal TypeScript wrapper around Pi Coding Agent.",
-  "files": [
-    "dist",
-    "context",
-    "skills/builtin/**",
-    "docs/ops/**",
-    "README.md",
-    "src/mcp/LICENSE.mcp-cli"
-  ],
-  "bin": {
-    "pibo": "dist/bin/pibo.js",
-    "rg": "dist/bin/rg.js"
-  },
-  "engines": {
-    "node": ">=24"
-  },
-  "scripts": {
-    "dev": "tsx src/bin/pibo.ts",
-    "profile": "tsx src/bin/pibo.ts profile",
-    "tui": "tsx src/bin/pibo.ts tui",
-    "tui:routed": "tsx src/bin/pibo.ts tui:routed",
-    "tui:gateway": "tsx src/bin/pibo.ts tui gateway-producer",
-    "gateway": "tsx src/bin/pibo.ts gateway",
-    "gateway:web": "npm run web-ui:build && tsx src/bin/pibo.ts gateway:web",
-    "client": "tsx src/bin/pibo.ts client",
-    "chat-ui:build": "vite build --config src/apps/chat-ui/vite.config.ts",
-    "chat-ui:typecheck": "tsc -p src/apps/chat-ui/tsconfig.json --noEmit",
-    "context-files-ui:build": "vite build --config src/apps/context-files-ui/vite.config.ts",
-    "context-files-ui:typecheck": "tsc -p src/apps/context-files-ui/tsconfig.json --noEmit",
-    "web-ui:build": "npm run chat-ui:build && npm run context-files-ui:build",
-    "vscode:typecheck": "tsc -p src/apps/chat-vscode/extension/tsconfig.json --noEmit && tsc -p src/apps/chat-vscode/extension/webview/tsconfig.json --noEmit",
-    "vscode:webview:build": "vite build --config src/apps/chat-vscode/extension/webview/vite.config.ts",
-    "vscode:extension:build": "esbuild src/apps/chat-vscode/extension/src/extension.ts --bundle --platform=node --target=node24 --format=cjs --outfile=src/apps/chat-vscode/dist/extension/extension.cjs --external:vscode --sourcemap=inline",
-    "vscode:package": "node scripts/vscode-package.mjs",
-    "release": "node scripts/release.mjs",
-    "release:github": "node scripts/create-github-release.mjs",
-    "build": "tsc -p tsconfig.json && npm run web-ui:build && npm run vscode:webview:build && node scripts/ensure-bin-executable.mjs",
-    "start": "node dist/bin/pibo.js",
-    "test": "npm run build && node --test test/*.test.mjs test/chat-vscode/*.test.mjs",
-    "check:product-vocab": "node scripts/legacy-product-vocabulary-gate.mjs",
-    "validate:ink-web-derived": "node scripts/ink-cli-web-derived-parity-validate.mjs",
-    "compute:limited-worker-smoke": "node scripts/compute-limited-worker-smoke.mjs",
-    "typecheck": "tsc -p tsconfig.json --noEmit && npm run chat-ui:typecheck && npm run context-files-ui:typecheck && npm run vscode:typecheck",
-    "clean": "node -e \"fs.rmSync('dist', { recursive: true, force: true })\"",
-    "prepack": "npm run build"
-  },
-  "dependencies": {
-    "@earendil-works/pi-agent-core": "0.80.6",
-    "@earendil-works/pi-ai": "0.80.6",
-    "@earendil-works/pi-coding-agent": "0.80.6",
-    "@earendil-works/pi-tui": "0.80.6",
-    "@mdxeditor/editor": "^3.55.0",
-    "@modelcontextprotocol/sdk": "^1.29.0",
-    "@tailwindcss/vite": "^4.2.4",
-    "@tanstack/react-query": "^5.100.7",
-    "@tanstack/react-router": "^1.168.25",
-    "@tanstack/react-start": "^1.167.50",
-    "@uiw/react-json-view": "^2.0.0-alpha.41",
-    "@vscode/ripgrep": "^1.18.0",
-    "@xyflow/react": "12.10.2",
-    "better-auth": "^1.6.9",
-    "commander": "^14.0.3",
-    "ink": "^7.0.3",
-    "lexical": "^0.35.0",
-    "lucide-react": "^0.545.0",
-    "prismjs": "^1.30.0",
-    "react": "^19.2.5",
-    "react-dom": "^19.2.5",
-    "react-markdown": "^10.1.0",
-    "react-virtuoso": "^4.18.6",
-    "remark-gfm": "^4.0.1",
-    "tailwindcss": "^4.2.4"
-  },
-  "devDependencies": {
-    "@tanstack/router-plugin": "^1.167.28",
-    "@types/node": "^25.6.0",
-    "@types/prismjs": "^1.26.6",
-    "@types/react": "^19.2.14",
-    "@types/react-dom": "^19.2.3",
-    "@vitejs/plugin-react": "^6.0.1",
-    "@vscode/vsce": "^3.6.0",
-    "esbuild": "^0.27.7",
-    "tsx": "^4.21.0",
-    "typescript": "^6.0.3",
-    "vite": "^8.0.10",
-    "vite-tsconfig-paths": "^5.1.4"
-  }
-}
+{
+  "name": "@pasko70/pibo",
+  "version": "1.10.1",
+  "type": "module",
+  "imports": {
+    "vscode": "./src/apps/chat-vscode/extension/src/vscode-shim.js"
+  },
+  "description": "Minimal TypeScript wrapper around Pi Coding Agent.",
+  "files": [
+    "dist",
+    "context",
+    "skills/builtin/**",
+    "docs/ops/**",
+    "README.md",
+    "src/mcp/LICENSE.mcp-cli"
+  ],
+  "bin": {
+    "pibo": "dist/bin/pibo.js",
+    "rg": "dist/bin/rg.js"
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "scripts": {
+    "dev": "tsx src/bin/pibo.ts",
+    "profile": "tsx src/bin/pibo.ts profile",
+    "tui": "tsx src/bin/pibo.ts tui",
+    "tui:routed": "tsx src/bin/pibo.ts tui:routed",
+    "tui:gateway": "tsx src/bin/pibo.ts tui gateway-producer",
+    "gateway": "tsx src/bin/pibo.ts gateway",
+    "gateway:web": "npm run web-ui:build && tsx src/bin/pibo.ts gateway:web",
+    "client": "tsx src/bin/pibo.ts client",
+    "chat-ui:build": "vite build --config src/apps/chat-ui/vite.config.ts",
+    "chat-ui:typecheck": "tsc -p src/apps/chat-ui/tsconfig.json --noEmit",
+    "context-files-ui:build": "vite build --config src/apps/context-files-ui/vite.config.ts",
+    "context-files-ui:typecheck": "tsc -p src/apps/context-files-ui/tsconfig.json --noEmit",
+    "web-ui:build": "npm run chat-ui:build && npm run context-files-ui:build",
+    "vscode:typecheck": "tsc -p src/apps/chat-vscode/extension/tsconfig.json --noEmit && tsc -p src/apps/chat-vscode/extension/webview/tsconfig.json --noEmit",
+    "vscode:webview:build": "vite build --config src/apps/chat-vscode/extension/webview/vite.config.ts",
+    "vscode:extension:build": "esbuild src/apps/chat-vscode/extension/src/extension.ts --bundle --platform=node --target=node24 --format=cjs --outfile=src/apps/chat-vscode/dist/extension/extension.cjs --external:vscode --sourcemap=inline",
+    "vscode:package": "node scripts/vscode-package.mjs",
+    "release": "node scripts/release.mjs",
+    "release:github": "node scripts/create-github-release.mjs",
+    "build": "tsc -p tsconfig.json && npm run web-ui:build && npm run vscode:webview:build && node scripts/ensure-bin-executable.mjs",
+    "start": "node dist/bin/pibo.js",
+    "test": "npm run build && node --test test/*.test.mjs test/chat-vscode/*.test.mjs",
+    "check:product-vocab": "node scripts/legacy-product-vocabulary-gate.mjs",
+    "validate:ink-web-derived": "node scripts/ink-cli-web-derived-parity-validate.mjs",
+    "compute:limited-worker-smoke": "node scripts/compute-limited-worker-smoke.mjs",
+    "validate:goal-endurance": "node scripts/goal-endurance-check.mjs",
+    "typecheck": "tsc -p tsconfig.json --noEmit && npm run chat-ui:typecheck && npm run context-files-ui:typecheck && npm run vscode:typecheck",
+    "clean": "node -e \"fs.rmSync('dist', { recursive: true, force: true })\"",
+    "prepack": "npm run build"
+  },
+  "dependencies": {
+    "@earendil-works/pi-agent-core": "0.80.6",
+    "@earendil-works/pi-ai": "0.80.6",
+    "@earendil-works/pi-coding-agent": "0.80.6",
+    "@earendil-works/pi-tui": "0.80.6",
+    "@langchain/core": "^1.2.3",
+    "@langchain/langgraph": "^1.4.8",
+    "@mdxeditor/editor": "^3.55.0",
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "@tailwindcss/vite": "^4.2.4",
+    "@tanstack/react-query": "^5.100.7",
+    "@tanstack/react-router": "^1.168.25",
+    "@tanstack/react-start": "^1.167.50",
+    "@uiw/react-json-view": "^2.0.0-alpha.41",
+    "@vscode/ripgrep": "^1.18.0",
+    "@xyflow/react": "12.10.2",
+    "better-auth": "^1.6.9",
+    "commander": "^14.0.3",
+    "ink": "^7.0.3",
+    "lexical": "^0.35.0",
+    "lucide-react": "^0.545.0",
+    "prismjs": "^1.30.0",
+    "react": "^19.2.5",
+    "react-dom": "^19.2.5",
+    "react-markdown": "^10.1.0",
+    "react-virtuoso": "^4.18.6",
+    "remark-gfm": "^4.0.1",
+    "tailwindcss": "^4.2.4",
+    "zod": "4.4.1"
+  },
+  "devDependencies": {
+    "@tanstack/router-plugin": "^1.167.28",
+    "@types/node": "^25.6.0",
+    "@types/prismjs": "^1.26.6",
+    "@types/react": "^19.2.14",
+    "@types/react-dom": "^19.2.3",
+    "@vitejs/plugin-react": "^6.0.1",
+    "@vscode/vsce": "^3.6.0",
+    "esbuild": "^0.27.7",
+    "tsx": "^4.21.0",
+    "typescript": "^6.0.3",
+    "vite": "^8.0.10",
+    "vite-tsconfig-paths": "^5.1.4"
+  }
+}

package/skills/builtin/graphify/SKILL.md

@@ -1,52 +1,52 @@
----
-name: graphify
-description: Use this skill when a user asks to graph, map, or visualize a codebase/workspace with Graphify and inspect the generated graphify-out/graph.html, graphify-out/graph.json, or graphify-out/GRAPH_REPORT.md artifacts.
----
-
-# Graphify Codebase Visualization
-
-Use Graphify to turn a workspace folder into an interactive knowledge graph and report. Prefer this skill for requests like "graph this repo", "visualize this codebase", "map the workspace", or "show me the project structure as a graph".
-
-## Prerequisites
-
-Graphify is exposed as a curated Pibo CLI tool:
-
-```bash
-pibo tools show graphify
-pibo tools install graphify
-eval "$(pibo tools env graphify)"
-```
-
-Inside the Pibo source repo while testing local changes, use:
-
-```bash
-npm run --silent dev -- tools show graphify
-npm run --silent dev -- tools install graphify
-eval "$(npm run --silent dev -- tools env graphify)"
-```
-
-The Pibo installer uses the PyPI package `graphifyy` and runs `graphify install --platform pi` after installing the CLI.
-
-## Workflow
-
-1. Identify the workspace path from the active Pibo Room/session context or from the user's request.
-2. Confirm the path is inside the intended workspace boundary before graphing.
-3. Prefer an ignored artifact directory for generated files when possible. If you generate in the repo root, check `git status --short` before and after.
-4. Run Graphify on the selected folder. With `graphifyy==0.9.x`, `graphify .` writes extraction output under `graphify-out/`.
-5. If you need an HTML graph and markdown report from a code-only extraction without an LLM key, run `graphify cluster-only . --no-label` after `graphify .`.
-6. Read `graphify-out/GRAPH_REPORT.md` first for the summary, then open `graphify-out/graph.html` when the user wants an interactive view.
-
-```bash
-cd /path/to/workspace
-graphify .
-graphify cluster-only . --no-label
-ls graphify-out/graph.html graphify-out/graph.json graphify-out/GRAPH_REPORT.md
-```
-
-## Operating rules
-
-- Treat `graphify-out/graph.html`, `graphify-out/graph.json`, and `graphify-out/GRAPH_REPORT.md` as derived artifacts unless the user explicitly wants them committed.
-- Code-only extraction can run without an LLM API key. Including docs, README files, papers, images, or semantic-labeling steps may require a configured Graphify backend/API key; if no key is available, graph a code-only subdirectory or skip semantic labels with `cluster-only . --no-label`.
-- For large monorepos, start with a focused subdirectory such as `src/`, a code package, or a docs folder only when the needed LLM backend is configured.
-- Re-run Graphify on demand after branch or workspace changes; do not assume an old graph is current.
-- If Graphify is unavailable, report the missing install and suggest `pibo tools install graphify` rather than hand-writing a replacement graph.
+---
+name: graphify
+description: Use this skill when a user asks to graph, map, or visualize a codebase/workspace with Graphify and inspect the generated graphify-out/graph.html, graphify-out/graph.json, or graphify-out/GRAPH_REPORT.md artifacts.
+---
+
+# Graphify Codebase Visualization
+
+Use Graphify to turn a workspace folder into an interactive knowledge graph and report. Prefer this skill for requests like "graph this repo", "visualize this codebase", "map the workspace", or "show me the project structure as a graph".
+
+## Prerequisites
+
+Graphify is exposed as a curated Pibo CLI tool:
+
+```bash
+pibo tools show graphify
+pibo tools install graphify
+eval "$(pibo tools env graphify)"
+```
+
+Inside the Pibo source repo while testing local changes, use:
+
+```bash
+npm run --silent dev -- tools show graphify
+npm run --silent dev -- tools install graphify
+eval "$(npm run --silent dev -- tools env graphify)"
+```
+
+The Pibo installer uses the PyPI package `graphifyy` and runs `graphify install --platform pi` after installing the CLI.
+
+## Workflow
+
+1. Identify the workspace path from the active Pibo Room/session context or from the user's request.
+2. Confirm the path is inside the intended workspace boundary before graphing.
+3. Prefer an ignored artifact directory for generated files when possible. If you generate in the repo root, check `git status --short` before and after.
+4. Run Graphify on the selected folder. With `graphifyy==0.9.x`, `graphify .` writes extraction output under `graphify-out/`.
+5. If you need an HTML graph and markdown report from a code-only extraction without an LLM key, run `graphify cluster-only . --no-label` after `graphify .`.
+6. Read `graphify-out/GRAPH_REPORT.md` first for the summary, then open `graphify-out/graph.html` when the user wants an interactive view.
+
+```bash
+cd /path/to/workspace
+graphify .
+graphify cluster-only . --no-label
+ls graphify-out/graph.html graphify-out/graph.json graphify-out/GRAPH_REPORT.md
+```
+
+## Operating rules
+
+- Treat `graphify-out/graph.html`, `graphify-out/graph.json`, and `graphify-out/GRAPH_REPORT.md` as derived artifacts unless the user explicitly wants them committed.
+- Code-only extraction can run without an LLM API key. Including docs, README files, papers, images, or semantic-labeling steps may require a configured Graphify backend/API key; if no key is available, graph a code-only subdirectory or skip semantic labels with `cluster-only . --no-label`.
+- For large monorepos, start with a focused subdirectory such as `src/`, a code package, or a docs folder only when the needed LLM backend is configured.
+- Re-run Graphify on demand after branch or workspace changes; do not assume an old graph is current.
+- If Graphify is unavailable, report the missing install and suggest `pibo tools install graphify` rather than hand-writing a replacement graph.

package/skills/builtin/loop/SKILL.md

@@ -0,0 +1,78 @@
+---
+name: loop
+description: Plan, create, run, monitor, resume, and review Pibo Goal Loops and legacy Ralph loops. Use whenever the user asks for a persistent goal, continuous loop, autonomous multi-turn objective, token-budgeted goal, Loop job, Goal status, blocked Goal, or the pibo loop CLI.
+---
+
+# Pibo Loop Workflow
+
+Use Goal mode for persistent objectives that should continue in the same Pibo Session. Use legacy Ralph mode only when each run should start with fresh session context.
+
+Discover the live CLI progressively:
+
+```bash
+pibo loop --help
+pibo loop add --help
+pibo loop templates --json
+pibo loop conditions
+```
+
+## Goal lifecycle
+
+Goal-capable profiles expose native tools:
+
+- `get_goal`: inspect authoritative status, soft-budget risk, tokens used, remaining tokens, active agent time, and elapsed wall-clock time.
+- `create_goal`: create a persistent Goal only when the user or system explicitly requests one.
+- `update_goal`: mark the current Goal `complete` after a strict completion audit, or `blocked` after the same impasse repeats for at least three consecutive Goal turns.
+
+These are native Pibo tools, not MCP tools. Agent Designer exposes them as the default-enabled `pibo-goal-control` package. If that package is disabled, the agent cannot change Goal lifecycle status itself.
+
+## CLI creation
+
+```bash
+pibo loop add \
+  --room <room-id> \
+  --profile <profile> \
+  --prompt "<complete objective>" \
+  --token-budget <optional-positive-token-count> \
+  --token-reserve <optional-pre-turn-minimum> \
+  --max-iterations <optional-run-fallback> \
+  --start
+```
+
+Prefer creating the job stopped when its prompt, target, profile, or safety boundaries still need review.
+
+## Completion and blocked rules
+
+- Treat completion as unproven until current evidence covers every explicit requirement and deliverable.
+- Do not use `complete` for partial progress, a plausible result, budget exhaustion, or because the current turn is ending.
+- Do not use `blocked` on the first blocker occurrence.
+- Use `blocked` only after the same condition repeats for at least three consecutive Goal turns and meaningful progress requires user input or an external-state change.
+- Resuming a blocked Goal begins a fresh blocked audit.
+
+## Token budgets
+
+Goal token budgets are soft: Pibo accumulates usage reported after model responses, so the final turn can overshoot. Each Goal run records tokens used before the turn, remaining tokens before the turn, turn usage, and overshoot.
+
+Set `--token-reserve <n>` to require more than `n` tokens to remain before Pibo starts another turn. Increase or clear the budget, or lower the reserve, before resuming a budget-limited Goal.
+
+## Time accounting
+
+`activeAgentTimeSeconds` accumulates time spent executing Goal runs. `elapsedWallClockSeconds` starts when the Goal is first activated, includes waiting and paused periods, and freezes when the Goal enters a terminal state. A Goal created paused reports zero wall-clock elapsed time until first activation.
+
+## Managed browser leases
+
+When a Goal owns `resources.browserLeaseIds`, Pibo renews those leases before each turn and while the turn is active. The same lease is retained across non-terminal Goal turns, including gateway service restart, and is released only when the Goal stops or reaches a terminal state. If the browser process disappeared, Pibo attempts to restart Chromium from the persisted managed profile. Failure to restore authenticated access marks the Goal blocked with an operator-facing resource reason.
+
+## Operations
+
+```bash
+pibo loop list --all --json
+pibo loop runs --job <job-id> --json
+pibo loop start <job-id>
+pibo loop stop <job-id>
+pibo loop cancel <job-id>
+```
+
+Use `stop` for graceful pause after the current session. Use `cancel` only when the active session must be aborted.
+
+For implementation work involving Docker workers, worktrees, browser checks, or pull requests, also use `pibo-docker-system` and `github-server-flow`.