@proletariat/cli 0.3.105 → 0.3.110

package/dist/lib/orchestrate/llm-agent.js

@@ -0,0 +1,295 @@
+/**
+ * LLM Orchestrator Agent (Tier 2)
+ *
+ * Implements the onLlmDecision callback for the 3-tier supervision tree.
+ * When the daemon encounters a hook with mode=llm, this agent:
+ *
+ * 1. Gathers rich context — PR diff, ticket description, test output
+ * 2. Builds a structured decision prompt
+ * 3. Calls claude -p (print mode) to get a judgment
+ * 4. Parses the response to return approve/deny/escalate
+ *
+ * This is the bridge between the deterministic daemon (tier 1) and
+ * human escalation (tier 3). Without it, tier 2 is a pass-through.
+ */
+import { execSync } from 'node:child_process';
+// =============================================================================
+// Constants
+// =============================================================================
+const DEFAULT_MAX_DIFF_CHARS = 8000;
+const DEFAULT_MAX_TEST_OUTPUT_CHARS = 4000;
+const DEFAULT_LLM_CALL_TIMEOUT_MS = 60_000;
+// =============================================================================
+// Context Gathering (pure functions, individually testable)
+// =============================================================================
+/**
+ * Fetch the PR diff via `gh pr diff`.
+ * Returns undefined if no PR number is available or the command fails.
+ */
+export function fetchPrDiff(prNumber, maxChars) {
+    if (!prNumber)
+        return undefined;
+    try {
+        const diff = execSync(`gh pr diff ${prNumber} --color=never`, {
+            timeout: 15_000,
+            stdio: ['pipe', 'pipe', 'pipe'],
+            encoding: 'utf-8',
+        });
+        if (diff.length > maxChars) {
+            return diff.slice(0, maxChars) + `\n\n... [diff truncated at ${maxChars} chars, ${diff.length} total]`;
+        }
+        return diff || undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Fetch the ticket description via `prlt ticket show`.
+ * Returns undefined if no ticket ID is available or the command fails.
+ */
+export function fetchTicketDescription(ticketId) {
+    if (!ticketId)
+        return undefined;
+    try {
+        const output = execSync(`prlt ticket show ${ticketId} --json`, {
+            timeout: 10_000,
+            stdio: ['pipe', 'pipe', 'pipe'],
+            encoding: 'utf-8',
+        });
+        try {
+            const parsed = JSON.parse(output);
+            const parts = [];
+            if (parsed.result?.title)
+                parts.push(`Title: ${parsed.result.title}`);
+            if (parsed.result?.description)
+                parts.push(`Description: ${parsed.result.description}`);
+            if (parsed.result?.acceptanceCriteria?.length) {
+                parts.push(`Acceptance Criteria:\n${parsed.result.acceptanceCriteria.map((ac) => `  - ${ac}`).join('\n')}`);
+            }
+            return parts.length > 0 ? parts.join('\n') : output;
+        }
+        catch {
+            return output || undefined;
+        }
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Fetch recent CI/test output via `gh pr checks` or `gh run list`.
+ * Returns undefined if unavailable.
+ */
+export function fetchTestOutput(prNumber, maxChars) {
+    if (!prNumber)
+        return undefined;
+    try {
+        const output = execSync(`gh pr checks ${prNumber}`, {
+            timeout: 15_000,
+            stdio: ['pipe', 'pipe', 'pipe'],
+            encoding: 'utf-8',
+        });
+        if (output.length > maxChars) {
+            return output.slice(0, maxChars) + `\n\n... [output truncated at ${maxChars} chars]`;
+        }
+        return output || undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Gather enriched context from all available sources.
+ */
+export function gatherDecisionContext(escalation, options) {
+    const prNumber = escalation.ctx.pr;
+    const ticketId = escalation.ctx.ticket;
+    const branch = escalation.ctx.branch;
+    return {
+        escalation,
+        prDiff: fetchPrDiff(prNumber, options.maxDiffChars),
+        ticketDescription: fetchTicketDescription(ticketId),
+        testOutput: fetchTestOutput(prNumber, options.maxTestOutputChars),
+        branch,
+    };
+}
+// =============================================================================
+// Prompt Construction (pure function, testable)
+// =============================================================================
+/**
+ * Build the decision prompt for the LLM.
+ *
+ * The prompt is structured to get a clear approve/deny/escalate response
+ * with reasoning.
+ */
+export function buildDecisionPrompt(context) {
+    const { escalation, prDiff, ticketDescription, testOutput, branch } = context;
+    const sections = [];
+    sections.push(`# Orchestrator Decision Required
+
+You are an autonomous orchestrator agent making a tier-2 decision in a 3-tier supervision tree.
+Your role: review the context and decide whether to APPROVE, DENY, or ESCALATE this action.
+
+## Decision
+
+- **Hook:** ${escalation.hookName}
+- **Event:** ${escalation.event}
+- **Action:** ${escalation.action}
+${branch ? `- **Branch:** ${branch}` : ''}
+${escalation.config ? `- **Config:** ${JSON.stringify(escalation.config)}` : ''}`);
+    if (ticketDescription) {
+        sections.push(`## Ticket Context
+
+${ticketDescription}`);
+    }
+    if (prDiff) {
+        sections.push(`## PR Diff
+
+\`\`\`diff
+${prDiff}
+\`\`\``);
+    }
+    if (testOutput) {
+        sections.push(`## CI/Test Status
+
+\`\`\`
+${testOutput}
+\`\`\``);
+    }
+    sections.push(`## Decision Guidelines
+
+Consider these factors:
+1. **Safety** — Does the action risk data loss, downtime, or breaking changes?
+2. **Context match** — Does the action align with the event and ticket context?
+3. **CI status** — Are tests passing? Is the diff reasonable?
+4. **Scope** — Is the action proportional to the event?
+
+### When to APPROVE
+- CI is green and the action is a natural next step (e.g., merge after green CI)
+- Agent spawn for a ticket that's ready and has clear requirements
+- Respawn of a died agent with retries remaining
+
+### When to DENY
+- CI is failing and the action would advance the pipeline (e.g., merge a failing PR)
+- The diff contains suspicious changes (secrets, large deletions, unrelated files)
+- The action doesn't match the event context
+
+### When to ESCALATE
+- The situation is ambiguous or high-stakes (production deployments, large refactors)
+- You lack sufficient context to make a confident decision
+- The action involves irreversible operations on shared resources
+
+## Response Format
+
+Respond with EXACTLY one of these words on the first line, followed by your reasoning:
+
+APPROVE
+DENY
+ESCALATE
+
+Then explain your reasoning briefly.`);
+    return sections.join('\n\n');
+}
+// =============================================================================
+// Response Parsing (pure function, testable)
+// =============================================================================
+/**
+ * Parse the LLM response to extract the decision.
+ *
+ * Looks for APPROVE, DENY, or ESCALATE as the first meaningful word.
+ * Falls back to 'escalate' if the response is ambiguous.
+ */
+export function parseDecisionResponse(response) {
+    const trimmed = response.trim();
+    if (!trimmed)
+        return 'escalate';
+    // Check the first non-empty line for the decision keyword
+    const lines = trimmed.split('\n');
+    for (const line of lines) {
+        const cleaned = line.trim().toUpperCase();
+        if (!cleaned)
+            continue;
+        if (cleaned.startsWith('APPROVE'))
+            return 'approve';
+        if (cleaned.startsWith('DENY'))
+            return 'deny';
+        if (cleaned.startsWith('ESCALATE'))
+            return 'escalate';
+        // Only check the first non-empty line
+        break;
+    }
+    // Fallback: scan the full response for keywords (less reliable)
+    const upper = trimmed.toUpperCase();
+    if (upper.includes('APPROVE') && !upper.includes('DENY') && !upper.includes('ESCALATE')) {
+        return 'approve';
+    }
+    if (upper.includes('DENY') && !upper.includes('APPROVE') && !upper.includes('ESCALATE')) {
+        return 'deny';
+    }
+    // When in doubt, escalate to human
+    return 'escalate';
+}
+// =============================================================================
+// LLM Invocation
+// =============================================================================
+/**
+ * Invoke the LLM via `claude -p` (print mode).
+ * Returns the raw response text.
+ */
+export function invokeClaudeLlm(prompt, timeoutMs) {
+    return execSync(`claude -p --output-format text`, {
+        input: prompt,
+        timeout: timeoutMs,
+        stdio: ['pipe', 'pipe', 'pipe'],
+        encoding: 'utf-8',
+        maxBuffer: 10 * 1024 * 1024,
+    });
+}
+// =============================================================================
+// Factory: onLlmDecision callback
+// =============================================================================
+/**
+ * Create an onLlmDecision callback for the OrchestrateEngine.
+ *
+ * This is the main entry point — wire this into the engine to activate tier 2.
+ *
+ * @example
+ * ```ts
+ * const engine = new OrchestrateEngine({
+ *   db,
+ *   onLlmDecision: createLlmDecisionHandler({ log: console.log }),
+ * })
+ * ```
+ */
+export function createLlmDecisionHandler(options = {}) {
+    const log = options.log ?? (() => { });
+    const maxDiffChars = options.maxDiffChars ?? DEFAULT_MAX_DIFF_CHARS;
+    const maxTestOutputChars = options.maxTestOutputChars ?? DEFAULT_MAX_TEST_OUTPUT_CHARS;
+    const llmCallTimeoutMs = options.llmCallTimeoutMs ?? DEFAULT_LLM_CALL_TIMEOUT_MS;
+    const callLlm = options.invokeLlm ?? ((prompt) => invokeClaudeLlm(prompt, llmCallTimeoutMs));
+    return async (context) => {
+        log(`[llm-agent] Decision requested: ${context.hookName} → ${context.action} (event: ${context.event})`);
+        try {
+            // 1. Gather enriched context
+            const enriched = gatherDecisionContext(context, { maxDiffChars, maxTestOutputChars });
+            // 2. Build the prompt
+            const prompt = buildDecisionPrompt(enriched);
+            log(`[llm-agent] Prompt built (${prompt.length} chars)`);
+            // 3. Call the LLM
+            const response = callLlm(prompt);
+            log(`[llm-agent] Response received (${response.length} chars)`);
+            // 4. Parse the decision
+            const decision = parseDecisionResponse(response);
+            log(`[llm-agent] Decision: ${decision} for ${context.hookName} → ${context.action}`);
+            return decision;
+        }
+        catch (err) {
+            // On any error, escalate to human rather than silently approving/denying
+            const errMsg = err instanceof Error ? err.message : String(err);
+            log(`[llm-agent] Error during decision — escalating to human: ${errMsg}`);
+            return 'escalate';
+        }
+    };
+}
+//# sourceMappingURL=llm-agent.js.map

package/dist/lib/orchestrate/llm-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-agent.js","sourceRoot":"","sources":["../../../src/lib/orchestrate/llm-agent.ts"],"names":[],"mappings":"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"}

package/dist/lib/orchestrate/presets.d.ts

@@ -2,10 +2,11 @@
  * Orchestrate Presets
  *
  * Pre-configured hook sets for common automation levels.
+ * Maps to the 3-tier supervision tree:
  *
- * - aggressive: auto-everything — no human needed
- * - conservative: confirm everything — human approves all
- * - supervised: auto for safe ops, confirm for destructive
+ * - aggressive: all auto (Tier 1) — no decision needed
+ * - supervised: safe=auto (Tier 1), destructive=llm (Tier 2)
+ * - conservative: safe=auto (Tier 1), destructive=human (Tier 3)
  */
 import type { HookMode, OrchestrateEvent, PresetName } from './types.js';
 interface PresetHook {

package/dist/lib/orchestrate/presets.js

@@ -2,10 +2,11 @@
  * Orchestrate Presets
  *
  * Pre-configured hook sets for common automation levels.
+ * Maps to the 3-tier supervision tree:
  *
- * - aggressive: auto-everything — no human needed
- * - conservative: confirm everything — human approves all
- * - supervised: auto for safe ops, confirm for destructive
+ * - aggressive: all auto (Tier 1) — no decision needed
+ * - supervised: safe=auto (Tier 1), destructive=llm (Tier 2)
+ * - conservative: safe=auto (Tier 1), destructive=human (Tier 3)
  */
 const SHARED_HOOKS = [
     // PR lifecycle
@@ -25,6 +26,7 @@ const SHARED_HOOKS = [
     { event: 'on_agent_died', action: 'respawn', config: { max_retries: 2 } },
     { event: 'on_agent_died', action: 'notify' },
     { event: 'on_agent_idle', action: 'health-check' },
+    { event: 'on_agent_idle', action: 'gc-sweep' },
     // Review lifecycle
     { event: 'on_review_approved', action: 'notify' },
     { event: 'on_changes_requested', action: 'spawn-fix-agent' },
@@ -32,6 +34,8 @@ const SHARED_HOOKS = [
     // CI lifecycle
     { event: 'on_ci_failed', action: 'notify' },
     { event: 'on_ci_failed', action: 'spawn-fix-agent' },
+    // Periodic cleanup
+    { event: 'on_agent_completed', action: 'gc-sweep' },
 ];
 /**
  * Safe actions that can be auto-executed even in supervised mode.
@@ -50,11 +54,12 @@ const SAFE_ACTIONS = new Set([
     'health-check',
     'rebase-conflicting-prs',
     'spawn-review-agent',
+    'gc-sweep',
 ]);
 export const PRESETS = {
     aggressive: {
         name: 'aggressive',
-        description: 'Auto everything — no human needed',
+        description: 'Auto everything — Tier 1 only, no decisions needed',
         hooks: SHARED_HOOKS.map(h => ({
             ...h,
             mode: 'auto',
@@ -62,18 +67,18 @@ export const PRESETS = {
     },
     conservative: {
         name: 'conservative',
-        description: 'Confirm everything — human approves all actions',
+        description: 'Safe=auto (Tier 1), destructive=human (Tier 3)',
         hooks: SHARED_HOOKS.map(h => ({
             ...h,
-            mode: 'confirm',
+            mode: (SAFE_ACTIONS.has(h.action) ? 'auto' : 'human'),
         })),
     },
     supervised: {
         name: 'supervised',
-        description: 'Auto for safe ops, confirm for destructive actions',
+        description: 'Safe=auto (Tier 1), destructive=llm (Tier 2)',
         hooks: SHARED_HOOKS.map(h => ({
             ...h,
-            mode: (SAFE_ACTIONS.has(h.action) ? 'auto' : 'confirm'),
+            mode: (SAFE_ACTIONS.has(h.action) ? 'auto' : 'llm'),
         })),
     },
 };

package/dist/lib/orchestrate/presets.js.map

@@ -1 +1 @@
-{"version":3,"file":"presets.js","sourceRoot":"","sources":["../../../src/lib/orchestrate/presets.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"presets.js","sourceRoot":"","sources":["../../../src/lib/orchestrate/presets.ts"],"names":[],"mappings":"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"}

package/dist/lib/orchestrate/prompt-chain.d.ts

@@ -0,0 +1,166 @@
+/**
+ * walkPromptChain — drive prlt CLI commands non-interactively by walking JSON prompts.
+ *
+ * Background (PRLT-1268):
+ * Action handlers used to hardcode flag combinations like
+ *   `prlt work start <ticket> --yes --display background`
+ * which broke as soon as a command emitted a JSON prompt that wasn't covered
+ * by those flags (e.g. environment selection). `--yes` does not bypass JSON
+ * prompts.
+ *
+ * The right approach is to walk the JSON prompt chain. Every prlt command in
+ * JSON mode emits one of:
+ *   - { type: 'prompt', prompt: { name, choices: [{ value, command, ... }, ...] } }
+ *   - { type: 'success', ... }
+ *   - { type: 'execution_result', ... }
+ *   - { type: 'error', ... }
+ *
+ * For prompt responses, each choice already carries a fully constructed
+ * follow-up `command` field. The walker:
+ *   1. Runs the current command with --json
+ *   2. If response is type=prompt, picks a default choice by name from the
+ *      defaults map, then runs choice.command
+ *   3. Repeats until success/error/iteration cap
+ *
+ * Per-action default choices live in the action handler and may be overridden
+ * by hook config so users can customize behavior without code changes.
+ */
+/**
+ * Result of executing a single command in the chain.
+ */
+export interface ChainExecutorResult {
+    /** stdout from the command (where prlt writes JSON) */
+    stdout: string;
+    /** stderr from the command (for diagnostics on failure) */
+    stderr: string;
+    /** Exit status — prompts emit with status=2, success with 0 */
+    status: number;
+    /** Spawn error if the process couldn't be started */
+    error?: string;
+}
+/**
+ * Function used to execute a command in the chain.
+ * Default implementation shells out via spawnSync; tests can inject a mock.
+ */
+export type ChainExecutor = (command: string, timeoutMs: number) => ChainExecutorResult;
+/**
+ * Default executor — runs the command via spawnSync with a shell.
+ */
+export declare const defaultChainExecutor: ChainExecutor;
+/**
+ * Options for walkPromptChain.
+ */
+export interface WalkPromptChainOptions {
+    /** The initial prlt command (with or without --json) */
+    baseCommand: string;
+    /**
+     * Map of prompt name → choice value to pick when that prompt is encountered.
+     * The prompt's `name` is the flagName the FlagResolver registered (e.g.,
+     * 'environment', 'display', 'permission-mode').
+     */
+    defaults: Record<string, string>;
+    /** Per-command timeout. Defaults to 180s (matches AGENT_SPAWN_TIMEOUT_MS). */
+    timeoutMs?: number;
+    /** Hard cap on iterations to avoid infinite loops on misconfigured chains. */
+    maxIterations?: number;
+    /** Custom executor — primarily for tests. */
+    executor?: ChainExecutor;
+}
+/**
+ * Result of walking the chain.
+ */
+export interface WalkPromptChainResult {
+    /** Whether the chain reached a success terminal state. */
+    success: boolean;
+    /** Number of commands executed. */
+    iterations: number;
+    /** The final command that produced the terminal response. */
+    finalCommand: string;
+    /** Sequence of commands run, oldest first. Useful for debugging/logging. */
+    commandTrail: string[];
+    /** Error message if walking failed. */
+    error?: string;
+    /** Result body from a terminal success/execution_result envelope. */
+    result?: Record<string, unknown>;
+}
+/**
+ * Walk a JSON prompt chain to completion.
+ *
+ * Each iteration runs the current command, parses its JSON envelope, and:
+ *   - On terminal success/execution_result, returns success.
+ *   - On error, returns failure with the error code/message.
+ *   - On prompt, picks the default for that prompt's name and runs the
+ *     corresponding choice's `command`.
+ *
+ * If a prompt's name has no entry in `defaults`, the walk fails — this is a
+ * configuration bug, not something to silently swallow.
+ */
+export declare function walkPromptChain(opts: WalkPromptChainOptions): WalkPromptChainResult;
+/**
+ * Built-in default choice maps per action. Hook config can shallow-merge
+ * over these to override individual prompt defaults.
+ *
+ * Keys are prompt names (FlagResolver flagName). Values are the choice value
+ * to pick. See `apps/cli/src/commands/work/start.ts` for the prompts a
+ * `prlt work start` chain may emit.
+ */
+export declare const DEFAULT_PROMPT_CHOICES: {
+    readonly 'spawn-agent': {
+        readonly environment: "devcontainer";
+        readonly display: "background";
+        readonly selectedDisplay: "background";
+        readonly 'permission-mode': "danger";
+        readonly tokenAction: "continue";
+        readonly dockerAction: "host";
+        readonly prChoice: "create";
+        readonly saveDefault: "true";
+        readonly authAction: "oauth";
+    };
+    readonly 'spawn-review-agent': {
+        readonly environment: "host";
+        readonly display: "background";
+        readonly selectedDisplay: "background";
+        readonly 'permission-mode': "safe";
+        readonly prChoice: "no-pr";
+        readonly saveDefault: "true";
+    };
+    readonly 'spawn-fix-agent': {
+        readonly environment: "devcontainer";
+        readonly display: "background";
+        readonly selectedDisplay: "background";
+        readonly 'permission-mode': "danger";
+        readonly tokenAction: "continue";
+        readonly dockerAction: "host";
+        readonly prChoice: "create";
+        readonly saveDefault: "true";
+        readonly authAction: "oauth";
+    };
+    readonly 'resolve-conflict': {
+        readonly environment: "devcontainer";
+        readonly display: "background";
+        readonly selectedDisplay: "background";
+        readonly 'permission-mode': "danger";
+        readonly tokenAction: "continue";
+        readonly dockerAction: "host";
+        readonly prChoice: "create";
+        readonly saveDefault: "true";
+        readonly authAction: "oauth";
+    };
+    readonly 'merge-pr': {
+        readonly method: "squash";
+        readonly 'delete-branch': "true";
+    };
+    readonly 'move-ticket': {
+        readonly target: "done";
+    };
+};
+/**
+ * Resolve effective defaults for an action by overlaying hook config on top
+ * of the built-in defaults. Hook config shape:
+ *
+ *   { defaults: { promptName: 'value', ... } }
+ *
+ * Unknown keys in hook config are passed through verbatim — there is no
+ * allow-list because new prlt prompts get added all the time.
+ */
+export declare function resolveActionDefaults(action: keyof typeof DEFAULT_PROMPT_CHOICES, config?: Record<string, unknown>): Record<string, string>;