@pasko70/pibo 1.4.5 → 1.4.6

package/dist/skills/cli.js

@@ -1,4 +1,5 @@
 import { Command } from "commander";
+import { createDefaultPiboPluginRegistry } from "../plugins/builtin.js";
 import { UserSkillManager } from "../user-skills/manager.js";
 import { readFileSync } from "node:fs";
 import { resolve } from "node:path";
@@ -9,7 +10,30 @@ function printJson(value) {
 export async function runSkillsCli(argv) {
     const manager = new UserSkillManager(os.homedir());
     const program = new Command();
-    program.name("pibo skills").description("Manage Pibo user skills (not built-in or plugin skills)");
+    program
+        .name("pibo skills")
+        .description("Manage Pibo user skills and inspect the built-in/plugin skill catalog")
+        .addHelpText("after", "\nBuilt-in/plugin skills are selected by agent profiles. Run `pibo skills catalog` to list them.\n");
+    program
+        .command("catalog")
+        .description("List built-in and plugin skills available to profiles")
+        .option("--json", "Print JSON")
+        .action((options) => {
+        const registry = createDefaultPiboPluginRegistry();
+        const skills = registry.getCapabilityCatalog().skills.filter((skill) => skill.kind !== "user");
+        if (options.json) {
+            printJson(skills);
+            return;
+        }
+        if (skills.length === 0) {
+            console.log("No built-in or plugin skills registered.");
+            return;
+        }
+        console.log("NAME\tKIND\tPATH");
+        for (const skill of skills) {
+            console.log(`${skill.name}\t${skill.kind ?? "plugin"}\t${skill.path}`);
+        }
+    });
     program
         .command("list")
         .description("List user skills managed by this CLI")

package/dist/tools/guides.js

@@ -379,6 +379,77 @@ If \`browser-use --connect\` cannot find Chrome, ask the user whether they want
 14. If Chrome fails to start with a "SingletonLock" error, the wrapper auto-detects and terminates stale Chrome processes holding the lock. Retry your command.
 `,
 };
+export const GRAPHIFY_GUIDE = {
+    name: 'graphify',
+    description: 'Generate codebase knowledge graphs with the Graphify CLI.',
+    content: `---
+name: graphify
+description: Generates interactive codebase knowledge graphs and markdown reports from a workspace folder.
+allowed-tools: Bash(graphify:*)
+---
+
+# Codebase Visualization with Graphify
+
+Graphify turns a folder into derived artifacts under \`graphify-out/\`:
+
+- \`graphify-out/graph.html\` — an interactive clickable graph;
+- \`graphify-out/graph.json\` — machine-readable graph data;
+- \`graphify-out/GRAPH_REPORT.md\` — a markdown summary with key concepts and suggested questions.
+
+Use it when a user asks to graph, map, visualize, or quickly understand a repo/workspace shape.
+
+## Prerequisites
+
+Install and apply the Pibo tool environment:
+
+\`\`\`bash
+pibo tools install graphify
+eval "$(pibo tools env graphify)"
+graphify --help
+\`\`\`
+
+Inside the Pibo source repo, use \`npm run --silent dev -- tools ...\` while testing local changes:
+
+\`\`\`bash
+npm run --silent dev -- tools install graphify
+eval "$(npm run --silent dev -- tools env graphify)"
+\`\`\`
+
+The installer uses the PyPI package \`graphifyy\` and runs \`graphify install --platform pi\` so the CLI is ready for Pi/Pibo workflows.
+
+## Core Workflow
+
+1. Choose the workspace path. Prefer the active Pibo Room or session workspace boundary when known.
+2. Run Graphify from that folder or pass the target path explicitly. With \`graphifyy==0.9.x\`, \`graphify .\` writes extraction output under \`graphify-out/\`.
+3. For a code-only workspace without an LLM key, run \`graphify cluster-only . --no-label\` after extraction to produce the HTML graph and markdown report.
+4. Put generated artifacts in an ignored room/session artifact directory when possible; do not commit them unless the user explicitly asks.
+5. Read \`graphify-out/GRAPH_REPORT.md\` first, then open \`graphify-out/graph.html\` when an interactive view is useful.
+
+\`\`\`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
+\`\`\`
+
+## Pibo Usage Notes
+
+- For Room-bound work, graph the Room workspace rather than the agent harness checkout unless the user asks otherwise.
+- If generating inside a Git repo, check \`git status --short\` before and after so graph artifacts are not accidentally included in unrelated commits.
+- 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 subdirectory such as \`src/\`, a code package, or a docs folder only when the needed LLM backend is configured.
+- Treat graph output as derived data. Recompute on demand when the branch or workspace changes.
+
+## Next Commands
+
+\`\`\`bash
+pibo tools show graphify
+pibo tools guide graphify graphify
+pibo tools path graphify
+pibo tools doctor graphify
+\`\`\`
+`,
+};
 export const REMOTE_BROWSER_GUIDE = {
     name: 'remote-browser',
     description: 'Browser automation workflow for sandboxed or remote agents.',

package/dist/tools/index.js

@@ -166,9 +166,13 @@ function printEnv(name) {
         return;
     }
     const binDir = status.executablePath.replace(/\/[^/]+$/, '');
-    const wrapperPath = entry.name === 'agent-browser' ? ensureAgentBrowserWrapper(status) : ensureBrowserUseWrapper(status);
-    const wrapperBinDir = wrapperPath ? wrapperPath.replace(/\/[^/]+$/, '') : `${status.homeDir}/bin`;
-    console.log(`export PATH="${wrapperBinDir}:${binDir}:$PATH"`);
+    const wrapperPath = entry.name === 'browser-use'
+        ? ensureBrowserUseWrapper(status)
+        : entry.name === 'agent-browser'
+            ? ensureAgentBrowserWrapper(status)
+            : undefined;
+    const envBinDirs = wrapperPath ? `${wrapperPath.replace(/\/[^/]+$/, '')}:${binDir}` : binDir;
+    console.log(`export PATH="${envBinDirs}:$PATH"`);
     if (entry.runtime.homeEnvVar)
         console.log(`export ${entry.runtime.homeEnvVar}="${status.homeDir}"`);
     if (desktop.display)

package/dist/tools/python-runtime.js

@@ -123,8 +123,8 @@ export async function printToolPythonRuntimeDoctor(name, spec) {
     if (name === 'browser-use' && process.platform === 'linux' && !hasDesktopDisplay(detectDesktopEnv())) {
         printLinuxVirtualDisplayHint('  ');
     }
-    if (existsSync(paths.executablePath)) {
-        const doctor = await runBuffered(paths.executablePath, ['doctor'], getToolPythonRuntimeEnv(paths, spec));
+    if (existsSync(paths.executablePath) && spec.doctorArgs?.length) {
+        const doctor = await runBuffered(paths.executablePath, spec.doctorArgs, getToolPythonRuntimeEnv(paths, spec));
         console.log(`  tool doctor: ${doctor.ok ? 'ok' : 'failed'}`);
         if (doctor.output) {
             console.log(doctor.output.split('\n').map((line) => `    ${line}`).join('\n'));

package/dist/tools/registry.js

@@ -1,7 +1,7 @@
 import { existsSync } from 'node:fs';
 import { ensureAgentBrowserWrapper } from './agent-browser-wrapper.js';
 import { detectDesktopEnv, hasDesktopDisplay, printDesktopEnvStatus, printLinuxVirtualDisplayHint } from './desktop-env.js';
-import { AGENT_BROWSER_GUIDE, BROWSER_USE_GUIDE, RALPH_GUIDE, REMOTE_BROWSER_GUIDE } from './guides.js';
+import { AGENT_BROWSER_GUIDE, BROWSER_USE_GUIDE, GRAPHIFY_GUIDE, RALPH_GUIDE, REMOTE_BROWSER_GUIDE } from './guides.js';
 import { ensureLinuxVirtualDisplay } from './linux-virtual-display.js';
 import { getToolNpmRuntimePaths, installToolNpmRuntime, printToolNpmRuntimeDoctor, removeToolNpmRuntime, } from './npm-runtime.js';
 import { getToolPythonRuntimePaths, installToolPythonRuntime, runInheritedCommand, printToolPythonRuntimeDoctor, removeToolPythonRuntime, } from './python-runtime.js';
@@ -16,6 +16,7 @@ const REGISTRY = [
             executableName: 'browser-use',
             pythonVersion: '3.12',
             homeEnvVar: 'BROWSER_USE_HOME',
+            doctorArgs: ['doctor'],
         },
         guides: [BROWSER_USE_GUIDE, REMOTE_BROWSER_GUIDE],
         notes: [
@@ -59,6 +60,29 @@ const REGISTRY = [
             'Discover details with `npm run dev -- tools show agent-browser` and `npm run dev -- tools guide agent-browser agent-browser`.',
         ].join('\n'),
     },
+    {
+        name: 'graphify',
+        description: 'Codebase visualization CLI that generates interactive knowledge graphs and reports.',
+        runtime: {
+            packageName: 'graphifyy',
+            executableName: 'graphify',
+            pythonVersion: '3.12',
+            postInstallArgs: ['install', '--platform', 'pi'],
+        },
+        guides: [GRAPHIFY_GUIDE],
+        notes: [
+            'Installed on demand into an isolated Python virtual environment from the graphifyy package.',
+            'The installer runs graphify install --platform pi after package installation so Graphify is ready for Pi/Pibo workflows.',
+            'Graphify writes generated graph artifacts under graphify-out/; prefer an ignored room/session artifact directory unless the user explicitly wants repo files.',
+            'Guides are available through pibo tools guide and are not loaded into pibo profiles automatically.',
+        ],
+        agentContextSnippet: [
+            'Codebase visualization CLI for graphify-out/graph.html, graph.json, and GRAPH_REPORT.md.',
+            'Start with `eval "$(npm run --silent dev -- tools env graphify)"`.',
+            'No LLM key: run `graphify .` on code, then `graphify cluster-only . --no-label`.',
+            'Guide: `npm run dev -- tools guide graphify graphify`.',
+        ].join('\n'),
+    },
     {
         name: 'ralph',
         description: 'Pibo-native continuous agent job runner for implementation and debugging loops.',

package/package.json

@@ -1,93 +1,93 @@
-{
-  "name": "@pasko70/pibo",
-  "version": "1.4.5",
-  "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": {
-    "@mariozechner/pi-ai": "^0.73.1",
-    "@mariozechner/pi-coding-agent": "^0.73.1",
-    "@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.4.6",
+  "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": {
+    "@mariozechner/pi-ai": "^0.73.1",
+    "@mariozechner/pi-coding-agent": "^0.73.1",
+    "@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"
+  }
+}

package/skills/builtin/graphify/SKILL.md

@@ -0,0 +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.