@pasko70/pibo 1.9.13 → 1.10.1

package/dist/loops/templates.js

@@ -0,0 +1,232 @@
+const promiseCompletePolicy = {
+    mode: 'any',
+    conditions: [{ id: 'promise-complete', type: 'pibo.loop.promise-complete' }],
+};
+const goalStatusPolicy = {
+    mode: 'any',
+    conditions: [{ id: 'goal-status', type: 'pibo.loop.goal-status' }],
+};
+const singleRunPolicy = {
+    mode: 'any',
+    conditions: [{ id: 'max-iterations', type: 'pibo.loop.max-iterations' }],
+};
+function markdown(strings) {
+    return String.raw(strings).replaceAll('\\`', '`');
+}
+export const BUILT_IN_LOOP_JOB_TEMPLATES = [
+    {
+        id: 'goal-objective',
+        name: 'Goal objective',
+        description: 'Default same-session goal loop: keep pursuing the full objective across turns until completion is proven or another stop condition is satisfied.',
+        category: 'general',
+        job: {
+            mode: 'goal',
+            name: 'Goal loop',
+            description: 'Long-running objective continued in one Pibo Session.',
+            prompt: markdown `# Objective
+
+<Describe the complete requested end state.>
+
+# Success criteria
+
+- <Observable completion criterion>
+- <Required verification>
+- <Behavior that must not regress>
+
+# Constraints
+
+- <Scope, safety, or approval boundary>`,
+            stopPolicy: goalStatusPolicy,
+        },
+    },
+    {
+        id: 'prd-single-story-standard',
+        name: 'PRD single story standard',
+        description: 'Legacy Ralph loop: pick the highest-priority failing PRD user story, implement exactly one story, test, commit, update progress, then stop or continue on the next run.',
+        category: 'prd',
+        job: {
+            mode: 'ralph',
+            name: 'Ralph PRD single story',
+            description: 'One PRD user story per Loop iteration.',
+            prompt: markdown `# Ralph Auftrag: <Project / Change Name>
+
+## Worktree
+
+Work from the host worktree, not from a container copy:
+
+\`\`\`bash
+cd <host-worktree>
+\`\`\`
+
+Branch: \`<branch-name>\`  
+Base: \`<base-branch-or-commit>\`  
+PRDs: \`<path-to-prds>/prd_*.json\`  
+Progress log: \`<path-to-prds>/progress.txt\`
+
+If a container is required for build, gateway, or browser checks, use it only for running commands. Edit files and run git commands in the host worktree. Do not edit \`/app\` inside a container.
+
+## Ralph Agent Instructions
+
+You are an autonomous coding agent working on a software project.
+
+### Your Task
+
+1. Work from the host worktree above.
+2. Read all PRD JSON files matching \`<path-to-prds>/prd_*.json\`.
+3. Read the progress log. If it does not exist, create it.
+4. Read the \`## Codebase Patterns\` section at the top of the progress log if present.
+5. Pick the highest-priority user story where \`passes: false\`.
+6. Implement that single user story only.
+7. Run quality checks:
+   - Always run \`npm run typecheck\`.
+   - Run relevant tests for touched areas.
+   - For UI stories, run browser verification in the configured dev container/browser environment.
+8. If checks pass, update the PRD JSON to set \`passes: true\` for the completed story.
+9. Commit all changes from the host worktree with message:
+   \`feat: [Story ID] - [Story Title]\`
+10. Append your progress to the progress log.
+
+### Progress Report Format
+
+Append to the progress log. Never replace; always append.
+
+\`\`\`md
+## [Date/Time] - [Story ID]
+- What was implemented
+- Files changed
+- Quality checks run
+- Browser verification, if UI changed
+- **Learnings for future iterations:**
+  - Patterns discovered
+  - Gotchas encountered
+  - Useful context
+---
+\`\`\`
+
+### Consolidate Patterns
+
+If you discover a reusable pattern, add it to the \`## Codebase Patterns\` section at the top of the progress log. Only add general reusable patterns, not story-specific notes.
+
+## Quality Requirements
+
+- All commits must pass quality checks.
+- Do not commit broken code.
+- Keep changes focused and minimal.
+- Follow existing code patterns.
+- For UI stories, browser verification is mandatory.
+
+## Stop Condition
+
+After completing one user story, check whether all stories in all PRD JSON files have \`passes: true\`.
+
+If all stories are complete and passing, reply with the XML completion marker on its own line. Compose it from the opening tag \`<promise>\`, the word \`COMPLETE\`, and the closing tag \`</promise>\`.
+
+Do not quote, negate, explain, or mention that literal marker unless all stories are complete and you intend to stop the job. If any story remains with \`passes: false\`, end normally so another iteration can pick up the next story and say only that the completion marker was omitted.`,
+            stopPolicy: promiseCompletePolicy,
+        },
+    },
+    {
+        id: 'prd-batch-stories',
+        name: 'PRD batch stories',
+        description: 'Batch loop: implement several failing PRD user stories in priority order in one Loop run, committing after each completed story.',
+        category: 'prd',
+        job: {
+            mode: 'ralph',
+            name: 'Ralph PRD batch',
+            description: 'Multiple PRD user stories per Loop run.',
+            prompt: markdown `# Ralph Auftrag: <Project / Change Name> Batch
+
+## Worktree
+
+Work from the host worktree:
+
+\`\`\`bash
+cd <host-worktree>
+\`\`\`
+
+PRDs: \`<path-to-prds>/prd_*.json\`  
+Progress log: \`<path-to-prds>/progress.txt\`  
+Batch limit: \`<max-stories-this-run>\`
+
+## Task
+
+1. Read the PRD JSON files and progress log.
+2. Work through failing user stories in priority order.
+3. Complete up to \`<max-stories-this-run>\` stories in this run.
+4. Keep each story isolated:
+   - implement one story;
+   - run relevant checks;
+   - set that story's \`passes\` to \`true\` only after checks pass;
+   - commit with \`feat: [Story ID] - [Story Title]\`;
+   - append a progress-log entry.
+5. Stop early if a story is blocked, ambiguous, or tests fail. Do not continue with later stories after a failed story.
+
+## Quality Requirements
+
+- Always run \`npm run typecheck\` before each story commit unless the repository has a documented narrower check for this batch.
+- Run relevant tests for touched areas.
+- Browser verification is mandatory for UI changes.
+- Keep changes focused; do not bundle unrelated refactors.
+
+## Stop Condition
+
+If all stories in all PRD JSON files are complete and passing, reply with the XML completion marker on its own line. Compose it from the opening tag \`<promise>\`, the word \`COMPLETE\`, and the closing tag \`</promise>\`.
+
+Do not quote, negate, explain, or mention that literal marker unless all stories are complete and you intend to stop the job. Otherwise report the stories completed and the next remaining failing story, and say only that the completion marker was omitted.`,
+            stopPolicy: promiseCompletePolicy,
+        },
+    },
+    {
+        id: 'single-run-objective',
+        name: 'Single-run objective',
+        description: 'Non-PRD template for one focused objective with explicit done criteria. Stops after one completed run attempt by max-iterations.',
+        category: 'general',
+        job: {
+            mode: 'ralph',
+            name: 'Ralph single-run objective',
+            description: 'One focused non-PRD objective.',
+            maxIterations: 1,
+            stopPolicy: singleRunPolicy,
+            prompt: markdown `# Ralph Auftrag: <Objective>
+
+## Worktree
+
+\`\`\`bash
+cd <host-worktree>
+\`\`\`
+
+Branch: \`<branch-name>\`
+
+## Objective
+
+<Describe the concrete outcome.>
+
+## Done Criteria
+
+- <Pass/fail criterion 1>
+- <Pass/fail criterion 2>
+- <Required verification command or manual check>
+
+## Instructions
+
+1. Inspect the relevant code and docs before editing.
+2. State assumptions in code comments or docs only when they matter for maintainers.
+3. Implement the smallest focused change that satisfies the done criteria.
+4. Run \`npm run typecheck\` and relevant tests.
+5. Commit with a concise message if checks pass.
+6. End with a short report listing files changed and verification run.
+
+This is not a PRD loop. Do not edit PRD JSON progress unless the objective explicitly asks for it.`,
+        },
+    },
+];
+export function listLoopJobTemplates() {
+    return BUILT_IN_LOOP_JOB_TEMPLATES.map((template) => cloneTemplate(template));
+}
+export function getLoopJobTemplate(id) {
+    const template = BUILT_IN_LOOP_JOB_TEMPLATES.find((item) => item.id === id);
+    return template ? cloneTemplate(template) : undefined;
+}
+function cloneTemplate(template) {
+    return JSON.parse(JSON.stringify(template));
+}

package/dist/loops/tools.js

@@ -0,0 +1,184 @@
+import { StringEnum, Type } from '@earendil-works/pi-ai';
+import { defineTool } from '@earendil-works/pi-coding-agent';
+import { goalActiveTimeSeconds, goalCanStartNextTurn, goalElapsedWallClockSeconds, goalRemainingTokens } from './accounting.js';
+import { createDefaultPiboLoopStore } from './store.js';
+export const PIBO_GOAL_TOOL_NAMES = ['get_goal', 'create_goal', 'update_goal'];
+let configuredStorePath;
+export function configurePiboGoalToolStorePath(path) {
+    configuredStorePath = path;
+}
+function toolResult(value, isError = false) {
+    return {
+        content: [{ type: 'text', text: JSON.stringify(value, null, 2) }],
+        details: value,
+        ...(isError ? { isError: true } : {}),
+    };
+}
+function errorResult(error) {
+    return toolResult({ ok: false, error: error instanceof Error ? error.message : String(error) }, true);
+}
+function requireSessionContext(context) {
+    const piboSessionId = context.piboSessionId?.trim();
+    if (!piboSessionId)
+        throw new Error('Goal tools require the current Pibo Session ID');
+    return {
+        piboSessionId,
+        piboRoomId: context.piboRoomId?.trim() || undefined,
+        profileName: context.profileName?.trim() || 'base',
+    };
+}
+function positiveInteger(value, field) {
+    if (value === undefined)
+        return undefined;
+    if (!Number.isInteger(value) || value < 1)
+        throw new Error(`${field} must be a positive integer`);
+    return value;
+}
+function nonNegativeInteger(value, field) {
+    if (value === undefined)
+        return undefined;
+    if (!Number.isInteger(value) || value < 0)
+        throw new Error(`${field} must be a non-negative integer`);
+    return value;
+}
+function goalPayload(job) {
+    const tokenBudget = job.tokenBudget;
+    return {
+        goalId: job.id,
+        objective: job.prompt,
+        status: effectiveGoalStatus(job),
+        budgetType: tokenBudget === undefined ? 'unbounded' : 'soft',
+        tokenBudget: tokenBudget ?? null,
+        tokenReserve: job.tokenReserve ?? 0,
+        tokensUsed: job.state.tokensUsed ?? 0,
+        remainingTokens: goalRemainingTokens(job) ?? null,
+        canStartNextTurn: goalCanStartNextTurn(job),
+        activeAgentTimeSeconds: goalActiveTimeSeconds(job),
+        elapsedWallClockSeconds: goalElapsedWallClockSeconds(job),
+        goalStartedAt: job.state.goalStartedAt ?? null,
+        goalEndedAt: job.state.goalEndedAt ?? null,
+        wallClockIncludesPausedTime: true,
+    };
+}
+function effectiveGoalStatus(job) {
+    return job.state.goalStatus ?? (job.enabled ? 'active' : 'paused');
+}
+async function withStore(options, action) {
+    if (options.store)
+        return await action(options.store);
+    const store = createDefaultPiboLoopStore({ path: configuredStorePath });
+    try {
+        return await action(store);
+    }
+    finally {
+        store.close();
+    }
+}
+function createGetGoalTool(context, options) {
+    return defineTool({
+        name: 'get_goal',
+        label: 'Get Goal',
+        description: 'Get the current goal for this Pibo Session, including soft-budget risk, per-turn reserve, active agent time, and wall-clock elapsed time.',
+        promptSnippet: 'Use get_goal when you need the authoritative persisted status or accounting for the current Pibo Session goal.',
+        parameters: Type.Object({}),
+        async execute() {
+            try {
+                const { piboSessionId } = requireSessionContext(context);
+                return await withStore(options, (store) => {
+                    const job = store.getLatestGoalForSession(piboSessionId);
+                    return toolResult({ ok: true, goal: job ? goalPayload(job) : null });
+                });
+            }
+            catch (error) {
+                return errorResult(error);
+            }
+        },
+    });
+}
+function createCreateGoalTool(context, options) {
+    return defineTool({
+        name: 'create_goal',
+        label: 'Create Goal',
+        description: 'Create an active persisted Goal Loop for this Pibo Session only when explicitly requested. Fails while this session already has an unfinished goal.',
+        promptSnippet: 'Call create_goal only when the user or system explicitly requests a persistent goal. Do not infer a goal from an ordinary task.',
+        parameters: Type.Object({
+            objective: Type.String({ description: 'Concrete objective to pursue across automatic continuations.' }),
+            token_budget: Type.Optional(Type.Number({ description: 'Optional soft token budget. Usage arrives after each model response, so the final turn can overshoot.' })),
+            token_reserve: Type.Optional(Type.Number({ description: 'Optional non-negative minimum remaining tokens required before Pibo starts another turn.' })),
+        }),
+        async execute(_toolCallId, params) {
+            try {
+                const session = requireSessionContext(context);
+                const objective = params.objective?.trim();
+                if (!objective)
+                    throw new Error('objective is required');
+                const tokenBudget = positiveInteger(params.token_budget, 'token_budget');
+                const tokenReserve = nonNegativeInteger(params.token_reserve, 'token_reserve');
+                return await withStore(options, (store) => {
+                    const existing = store.getLatestGoalForSession(session.piboSessionId);
+                    if (existing && effectiveGoalStatus(existing) !== 'complete') {
+                        throw new Error('cannot create a new goal because this Pibo Session has an unfinished goal; complete the existing goal first');
+                    }
+                    const job = store.createJob({
+                        mode: 'goal',
+                        enabled: true,
+                        target: session.piboRoomId ? { kind: 'room', roomId: session.piboRoomId } : { kind: 'default-chat' },
+                        profile: session.profileName,
+                        prompt: objective,
+                        tokenBudget,
+                        tokenReserve,
+                        initialPiboSessionId: session.piboSessionId,
+                    });
+                    return toolResult({ ok: true, goal: goalPayload(job) });
+                });
+            }
+            catch (error) {
+                return errorResult(error);
+            }
+        },
+    });
+}
+function createUpdateGoalTool(context, options) {
+    return defineTool({
+        name: 'update_goal',
+        label: 'Update Goal',
+        description: 'Mark the current goal complete or genuinely blocked. Complete requires verified achievement. Blocked requires the same impasse for at least three consecutive goal turns.',
+        promptSnippet: 'Use update_goal only with status complete after a requirement-by-requirement completion audit, or blocked after the strict repeated-blocker audit.',
+        parameters: Type.Object({
+            status: StringEnum(['complete', 'blocked'], { description: 'Terminal status for the current goal.' }),
+        }),
+        async execute(_toolCallId, params) {
+            try {
+                const { piboSessionId } = requireSessionContext(context);
+                if (params.status !== 'complete' && params.status !== 'blocked')
+                    throw new Error('status must be complete or blocked');
+                const status = params.status;
+                return await withStore(options, (store) => {
+                    const existing = store.getLatestGoalForSession(piboSessionId);
+                    if (!existing)
+                        throw new Error('cannot update goal because this Pibo Session has no goal');
+                    const job = store.updateGoalStatus(existing.id, status);
+                    if (!job)
+                        throw new Error('goal no longer exists');
+                    return toolResult({
+                        ok: true,
+                        goal: goalPayload(job),
+                        ...(status === 'complete' && job.tokenBudget !== undefined
+                            ? { completionBudgetReport: `${job.state.tokensUsed ?? 0}/${job.tokenBudget} reported tokens consumed against a soft budget before the current model turn finishes` }
+                            : {}),
+                    });
+                });
+            }
+            catch (error) {
+                return errorResult(error);
+            }
+        },
+    });
+}
+export function createPiboGoalToolDefinitions(context, options = {}) {
+    return [
+        createGetGoalTool(context, options),
+        createCreateGoalTool(context, options),
+        createUpdateGoalTool(context, options),
+    ];
+}

package/dist/loops/types.js

@@ -0,0 +1 @@
+export {};

package/dist/mcp/config-command.js

@@ -14,65 +14,65 @@ const EXAMPLE_CONFIG = {
     },
 };
 export function printConfigHelp() {
-    console.log(`
-MCP server configuration
-
-Commands:
-  pibo mcp config init                         Create mcp_servers.json if missing
-  pibo mcp config path                         Print the config path that will be used
-  pibo mcp config paths                        Show config path lookup order
-  pibo mcp config show                         Print the current config JSON
-  pibo mcp config add <name> <json>            Add or replace one server
-  pibo mcp config describe <name> "<text>"     Add or update an agent-facing description
-  pibo mcp config remove <name>                Remove one server
-  pibo mcp config schema                       Show server JSON schema and examples
-  pibo mcp config help                         Show this help
+    console.log(`
+MCP server configuration
+
+Commands:
+  pibo mcp config init                         Create mcp_servers.json if missing
+  pibo mcp config path                         Print the config path that will be used
+  pibo mcp config paths                        Show config path lookup order
+  pibo mcp config show                         Print the current config JSON
+  pibo mcp config add <name> <json>            Add or replace one server
+  pibo mcp config describe <name> "<text>"     Add or update an agent-facing description
+  pibo mcp config remove <name>                Remove one server
+  pibo mcp config schema                       Show server JSON schema and examples
+  pibo mcp config help                         Show this help
 `);
 }
 export function printConfigPaths() {
-    console.log(`
-MCP config lookup order:
-  1. -c/--config <path>
-  2. MCP_CONFIG_PATH
-  3. ./mcp_servers.json
-  4. ~/.mcp_servers.json
-  5. ~/.config/mcp/mcp_servers.json
+    console.log(`
+MCP config lookup order:
+  1. -c/--config <path>
+  2. MCP_CONFIG_PATH
+  3. ./mcp_servers.json
+  4. ~/.mcp_servers.json
+  5. ~/.config/mcp/mcp_servers.json
 `);
 }
 export function printConfigSchema() {
-    console.log(`
-Server schema:
-  Stdio server:
-    {
-      "command": "npx",
-      "args": ["-y", "@modelcontextprotocol/server-filesystem", "."],
-      "env": { "TOKEN": "\${TOKEN}" },
-      "cwd": ".",
-      "allowedTools": ["read_*"],
-      "disabledTools": ["write_*"],
-      "pibo": {
-        "description": "Access project files through the configured filesystem MCP server.",
-        "descriptionSource": "user"
-      }
-    }
-
-  HTTP server:
-    {
-      "url": "https://example.com/mcp",
-      "headers": { "Authorization": "Bearer \${TOKEN}" },
-      "allowedTools": ["search_*"],
-      "disabledTools": ["dangerous_*"]
-    }
-
-Full example:
-${JSON.stringify(EXAMPLE_CONFIG, null, 2)}
-
-Examples:
-  pibo mcp config init
-  pibo mcp config add filesystem '{"command":"npx","args":["-y","@modelcontextprotocol/server-filesystem","."]}'
-  pibo mcp config add deepwiki '{"url":"https://mcp.deepwiki.com/mcp"}'
-  pibo mcp config describe filesystem "Access project files through the configured filesystem MCP server."
-  pibo mcp config remove filesystem
+    console.log(`
+Server schema:
+  Stdio server:
+    {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-filesystem", "."],
+      "env": { "TOKEN": "\${TOKEN}" },
+      "cwd": ".",
+      "allowedTools": ["read_*"],
+      "disabledTools": ["write_*"],
+      "pibo": {
+        "description": "Access project files through the configured filesystem MCP server.",
+        "descriptionSource": "user"
+      }
+    }
+
+  HTTP server:
+    {
+      "url": "https://example.com/mcp",
+      "headers": { "Authorization": "Bearer \${TOKEN}" },
+      "allowedTools": ["search_*"],
+      "disabledTools": ["dangerous_*"]
+    }
+
+Full example:
+${JSON.stringify(EXAMPLE_CONFIG, null, 2)}
+
+Examples:
+  pibo mcp config init
+  pibo mcp config add filesystem '{"command":"npx","args":["-y","@modelcontextprotocol/server-filesystem","."]}'
+  pibo mcp config add deepwiki '{"url":"https://mcp.deepwiki.com/mcp"}'
+  pibo mcp config describe filesystem "Access project files through the configured filesystem MCP server."
+  pibo mcp config remove filesystem
 `);
 }
 async function readRawConfig(path) {

package/dist/mcp/index.js

@@ -314,27 +314,27 @@ function parseArgs(args) {
  * Print help message
  */
 function printHelp() {
-    console.log(`
-pibo mcp (mcp-cli v${VERSION}) - A lightweight CLI for MCP servers
-
-Commands:
-  pibo mcp                                      List configured servers and tools
-  pibo mcp info <server>                       Show server tools
-  pibo mcp info <server> <tool>                Show one tool schema
-  pibo mcp grep <pattern>                      Search tool names
-  pibo mcp call <server> <tool> [json]         Call one tool
-  pibo mcp config                              Discover config commands
-  pibo mcp registry                            Discover curated server presets
-
-Options:
-  -v, --version            Show version number
-  -d, --with-descriptions  Show full tool descriptions (default: first 100 chars)
-  -c, --config <path>      Path to mcp_servers.json config file
-  --no-setup               Skip registry setup commands during install
-
-Next:
-  pibo mcp config help
-  pibo mcp registry help
+    console.log(`
+pibo mcp (mcp-cli v${VERSION}) - A lightweight CLI for MCP servers
+
+Commands:
+  pibo mcp                                      List configured servers and tools
+  pibo mcp info <server>                       Show server tools
+  pibo mcp info <server> <tool>                Show one tool schema
+  pibo mcp grep <pattern>                      Search tool names
+  pibo mcp call <server> <tool> [json]         Call one tool
+  pibo mcp config                              Discover config commands
+  pibo mcp registry                            Discover curated server presets
+
+Options:
+  -v, --version            Show version number
+  -d, --with-descriptions  Show full tool descriptions (default: first 100 chars)
+  -c, --config <path>      Path to mcp_servers.json config file
+  --no-setup               Skip registry setup commands during install
+
+Next:
+  pibo mcp config help
+  pibo mcp registry help
 `);
 }
 /**

package/dist/mcp/registry.js

@@ -17,17 +17,17 @@ function buildServerConfig(entry) {
     };
 }
 function printRegistryHelp() {
-    console.log(`
-MCP server registry
-
-Commands:
-  pibo mcp registry list                         List built-in MCP server presets
-  pibo mcp registry show <name>                  Show one preset
-  pibo mcp registry doctor <name>                Check runtime prerequisites
-  pibo mcp registry install <name>               Install setup deps and add preset to mcp_servers.json
-  pibo mcp registry install <name> --no-setup    Only add preset to mcp_servers.json
-  pibo mcp registry remove <name>                Remove config and local runtime
-  pibo mcp registry help                         Show this help
+    console.log(`
+MCP server registry
+
+Commands:
+  pibo mcp registry list                         List built-in MCP server presets
+  pibo mcp registry show <name>                  Show one preset
+  pibo mcp registry doctor <name>                Check runtime prerequisites
+  pibo mcp registry install <name>               Install setup deps and add preset to mcp_servers.json
+  pibo mcp registry install <name> --no-setup    Only add preset to mcp_servers.json
+  pibo mcp registry remove <name>                Remove config and local runtime
+  pibo mcp registry help                         Show this help
 `);
 }
 function printEntry(entry) {

package/dist/pi-packages/cli.js

@@ -77,16 +77,16 @@ export async function runPiPackagesCli(argv = process.argv) {
     await program.parseAsync(argv);
 }
 function printPiPackagesDiscovery() {
-    console.log(`pibo pi-packages - registered Pi Coding Agent packages
-
-Commands:
-  list                 List registered packages
-  add <source>         Register a pi.dev URL or local path
-  inspect <name-or-id> Show package metadata
-  remove <name-or-id>  Remove a registration
-  doctor               Check package sources
-
-Next:
-  pibo pi-packages list
+    console.log(`pibo pi-packages - registered Pi Coding Agent packages
+
+Commands:
+  list                 List registered packages
+  add <source>         Register a pi.dev URL or local path
+  inspect <name-or-id> Show package metadata
+  remove <name-or-id>  Remove a registration
+  doctor               Check package sources
+
+Next:
+  pibo pi-packages list
 `);
 }