@promptwheel/mcp 0.6.0

package/README.md

@@ -0,0 +1,178 @@
+# @promptwheel/mcp — MCP Server
+
+Stateful MCP server that powers PromptWheel's improvement loop. Exposes tools for session management, scouting, execution, and git operations.
+
+## Quick Start
+
+```bash
+# As stdio MCP server (for Claude Code plugin)
+npx @promptwheel/mcp
+
+# Or via the DirectClient API (for any LLM)
+import { DirectClient } from '@promptwheel/mcp/direct-client';
+
+const client = await DirectClient.create({ projectPath: '.' });
+client.startSession({ scope: 'src/**', formula: 'security-audit' });
+
+while (true) {
+  const resp = await client.advance();
+  if (resp.next_action === 'STOP') break;
+  // ... call your LLM with resp.prompt ...
+  await client.ingestEvent('SCOUT_OUTPUT', { proposals: [...] });
+}
+
+client.endSession();
+await client.close();
+```
+
+## MCP Tool Reference
+
+### Session Management
+
+| Tool | Description | Parameters |
+|------|-------------|------------|
+| `promptwheel_start_session` | Initialize a session | `hours?`, `formula?`, `deep?`, `scope?`, `categories?`, `min_confidence?`, `max_prs?`, `step_budget?`, `ticket_step_budget?`, `draft_prs?` |
+| `promptwheel_advance` | Get next action (main loop driver) | — |
+| `promptwheel_ingest_event` | Report event, trigger state transitions | `type`, `payload` |
+| `promptwheel_session_status` | Current session state | — |
+| `promptwheel_end_session` | Finalize session | — |
+| `promptwheel_nudge` | Add hint for next scout cycle | `hint` |
+| `promptwheel_list_formulas` | List available formulas | — |
+| `promptwheel_get_scope_policy` | Get scope policy for current ticket | `file_path?` |
+
+### Execution
+
+| Tool | Description | Parameters |
+|------|-------------|------------|
+| `promptwheel_next_ticket` | Get next ticket to work on | — |
+| `promptwheel_validate_scope` | Check changed files against scope | `ticketId`, `changedFiles[]` |
+| `promptwheel_complete_ticket` | Mark ticket done, run QA | `ticketId`, `runId`, `summary?` |
+| `promptwheel_fail_ticket` | Mark ticket failed | `ticketId`, `runId`, `reason` |
+
+### Git
+
+| Tool | Description | Parameters |
+|------|-------------|------------|
+| `promptwheel_git_setup` | Create/checkout branch for ticket | `ticketId`, `baseBranch?` |
+
+## Canonical Loop Protocol
+
+The core protocol is adapter-agnostic. Any client repeats:
+
+```
+advance() → get prompt + constraints
+         → execute prompt (any LLM)
+         → ingest_event(type, payload)
+         → repeat until STOP
+```
+
+### Event Types
+
+| Event | When | Payload |
+|-------|------|---------|
+| `SCOUT_OUTPUT` | After scouting | `{ proposals: [...] }` |
+| `PLAN_SUBMITTED` | After planning | `{ ticket_id, files_to_touch, estimated_lines, risk_level }` |
+| `TICKET_RESULT` | After execution | `{ status, changed_files, lines_added, lines_removed }` |
+| `QA_COMMAND_RESULT` | Per QA command | `{ command, success, output }` |
+| `QA_PASSED` | All QA passes | `{ summary }` |
+| `QA_FAILED` | QA fails | `{ error }` |
+| `PR_CREATED` | PR created | `{ url, branch }` |
+| `USER_OVERRIDE` | Hint or cancel | `{ hint }` or `{ cancel: true }` |
+
+### Phase State Machine
+
+```
+SCOUT → NEXT_TICKET → PLAN → EXECUTE → QA → PR → NEXT_TICKET → DONE
+
+Terminal states: DONE, BLOCKED_NEEDS_HUMAN, FAILED_BUDGET, FAILED_VALIDATION, FAILED_SPINDLE
+```
+
+## Formulas
+
+Built-in formulas customize scout behavior:
+
+| Formula | Description | Categories |
+|---------|-------------|------------|
+| `security-audit` | OWASP vulnerabilities | security |
+| `test-coverage` | Missing unit tests | test |
+| `type-safety` | Remove any/unknown | types |
+| `cleanup` | Dead code, unused imports | refactor |
+| `deep` | Architecture review | refactor, perf, security |
+| `docs` | Missing JSDoc | docs |
+
+### Custom Formulas
+
+Create `.promptwheel/formulas/<name>.yaml`:
+
+```yaml
+description: Find and fix error handling issues
+categories: [refactor, security]
+min_confidence: 75  # hint only — does not filter proposals
+risk_tolerance: medium
+prompt: |
+  Find functions with missing error handling.
+  Look for uncaught promises, empty catch blocks,
+  and functions that silently swallow errors.
+tags: [quality]
+```
+
+## Run Folder Anatomy
+
+Each session creates a run folder at `.promptwheel/runs/<run_id>/`:
+
+```
+.promptwheel/runs/run_abc123/
+├── state.json          # Current RunState (overwritten each step)
+├── events.ndjson       # Append-only event log (one JSON per line)
+├── diffs/              # Patch files per step
+│   └── 5-tkt_xyz.patch
+└── artifacts/          # QA logs, scout proposals, etc.
+    ├── 1-scout-proposals.json
+    ├── 3-ticket-result.json
+    ├── 4-qa-npm-test-pass.log
+    └── 5-pr-created.json
+```
+
+### Debugging a Failed Run
+
+1. **Check phase**: `cat .promptwheel/runs/<id>/state.json | jq .phase`
+2. **Read events**: `cat .promptwheel/runs/<id>/events.ndjson | jq .`
+3. **Find the failure**: `grep FAILED .promptwheel/runs/<id>/events.ndjson`
+4. **Check spindle**: `cat .promptwheel/runs/<id>/state.json | jq .spindle`
+5. **Read QA logs**: `cat .promptwheel/runs/<id>/artifacts/*qa*`
+
+### state.json Fields
+
+| Field | Description |
+|-------|-------------|
+| `phase` | Current state machine phase |
+| `step_count` / `step_budget` | Progress tracking |
+| `tickets_completed` / `tickets_failed` | Work summary |
+| `spindle` | Loop detection state (output_hashes, diff_hashes, iterations_since_change) |
+| `current_ticket_id` | Active ticket being worked on |
+| `plan_approved` | Whether commit plan was approved |
+| `hints` | Pending hints from nudge |
+
+## Architecture
+
+```
+Claude Code / Any LLM
+  └─ MCP: @promptwheel/mcp (stdio)
+       ├─ advance()          — deterministic state machine
+       ├─ processEvent()     — event-driven transitions
+       ├─ checkSpindle()     — loop detection
+       ├─ deriveScopePolicy()— scope enforcement
+       ├─ loadFormula()      — formula system
+       ├─ loadGuidelines()   — CLAUDE.md context injection
+       └─ SQLite state       — tickets, runs, proposals
+```
+
+## Project Guidelines Context
+
+The advance engine automatically loads project guidelines and prepends them to scout and execute prompts. This ensures agents follow project conventions without any configuration.
+
+- **Claude runs** search for `CLAUDE.md` first, then fall back to `AGENTS.md`
+- **Codex runs** search for `AGENTS.md` first, then fall back to `CLAUDE.md`
+- Loaded fresh on every `advance()` call (MCP sessions are stateless between calls)
+- Wrapped in `<project-guidelines>` XML tags
+- Full file content injected (no truncation)

package/dist/advance-helpers.d.ts

@@ -0,0 +1,27 @@
+import { RunManager } from './run-manager.js';
+import type { AdaptiveRiskAssessment } from '@promptwheel/core/learnings/shared';
+import { type Trajectory, type TrajectoryState } from '@promptwheel/core/trajectory/shared';
+import type { SectorState } from '@promptwheel/core/sectors/shared';
+export declare const DEFAULT_LEARNINGS_BUDGET = 2000;
+/** Load trajectory state from project root — returns null if missing/invalid. */
+export declare function loadTrajectoryData(rootPath: string): {
+    trajectory: Trajectory;
+    state: TrajectoryState;
+} | null;
+/** Load sectors.json from project root — returns null if missing/invalid. */
+export declare function loadSectorsState(rootPath: string): SectorState | null;
+/**
+ * Build a learnings block for prompt injection. Tracks injected IDs in state.
+ * Uses cached learnings from RunState (loaded at session start) to avoid redundant file I/O.
+ */
+export declare function buildLearningsBlock(run: RunManager, contextPaths: string[], contextCommands: string[]): string;
+/**
+ * Build a risk context block for prompts when adaptive trust detects elevated/high risk.
+ * Returns empty string for low/normal risk.
+ */
+export declare function buildRiskContextBlock(riskAssessment: AdaptiveRiskAssessment | undefined): string;
+export declare function getScoutAutoApprove(): string[];
+export declare function getExecuteAutoApprove(category: string | null): string[];
+export declare function getQaAutoApprove(): string[];
+export declare function getPrAutoApprove(): string[];
+//# sourceMappingURL=advance-helpers.d.ts.map

package/dist/advance-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"advance-helpers.d.ts","sourceRoot":"","sources":["../src/advance-helpers.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAO9C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AACjF,OAAO,EACL,KAAK,UAAU,EACf,KAAK,eAAe,EAIrB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAEpE,eAAO,MAAM,wBAAwB,OAAO,CAAC;AAE7C,iFAAiF;AACjF,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG;IAAE,UAAU,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,eAAe,CAAA;CAAE,GAAG,IAAI,CAwB9G;AAED,6EAA6E;AAC7E,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAarE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,UAAU,EACf,YAAY,EAAE,MAAM,EAAE,EACtB,eAAe,EAAE,MAAM,EAAE,GACxB,MAAM,CA4BR;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,cAAc,EAAE,sBAAsB,GAAG,SAAS,GAAG,MAAM,CA6BhG;AAED,wBAAgB,mBAAmB,IAAI,MAAM,EAAE,CAE9C;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,EAAE,CAEvE;AAED,wBAAgB,gBAAgB,IAAI,MAAM,EAAE,CAE3C;AAED,wBAAgB,gBAAgB,IAAI,MAAM,EAAE,CAE3C"}

package/dist/advance-helpers.js

@@ -0,0 +1,127 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { getRegistry } from './tool-registry.js';
+import { selectRelevant, formatLearningsForPrompt, recordAccess, } from './learnings.js';
+import { parseTrajectoryYaml, } from '@promptwheel/core/trajectory/shared';
+export const DEFAULT_LEARNINGS_BUDGET = 2000;
+/** Load trajectory state from project root — returns null if missing/invalid. */
+export function loadTrajectoryData(rootPath) {
+    try {
+        const statePath = path.join(rootPath, '.promptwheel', 'trajectory-state.json');
+        if (!fs.existsSync(statePath))
+            return null;
+        const trajState = JSON.parse(fs.readFileSync(statePath, 'utf8'));
+        if (trajState.paused)
+            return null;
+        const trajDir = path.join(rootPath, '.promptwheel', 'trajectories');
+        if (!fs.existsSync(trajDir))
+            return null;
+        const files = fs.readdirSync(trajDir).filter(f => f.endsWith('.yaml') || f.endsWith('.yml'));
+        for (const file of files) {
+            const content = fs.readFileSync(path.join(trajDir, file), 'utf8');
+            const traj = parseTrajectoryYaml(content);
+            if (traj.name === trajState.trajectoryName && traj.steps.length > 0) {
+                return { trajectory: traj, state: trajState };
+            }
+        }
+    }
+    catch (err) {
+        if (err instanceof Error && !('code' in err && err.code === 'ENOENT')) {
+            console.warn(`[promptwheel] Failed to load trajectory data: ${err.message}`);
+        }
+    }
+    return null;
+}
+/** Load sectors.json from project root — returns null if missing/invalid. */
+export function loadSectorsState(rootPath) {
+    try {
+        const filePath = path.join(rootPath, '.promptwheel', 'sectors.json');
+        if (!fs.existsSync(filePath))
+            return null;
+        const data = JSON.parse(fs.readFileSync(filePath, 'utf8'));
+        if (data?.version !== 2 || !Array.isArray(data.sectors))
+            return null;
+        return data;
+    }
+    catch (err) {
+        if (err instanceof Error && !('code' in err && err.code === 'ENOENT')) {
+            console.warn(`[promptwheel] Failed to load sectors.json: ${err.message}`);
+        }
+        return null;
+    }
+}
+/**
+ * Build a learnings block for prompt injection. Tracks injected IDs in state.
+ * Uses cached learnings from RunState (loaded at session start) to avoid redundant file I/O.
+ */
+export function buildLearningsBlock(run, contextPaths, contextCommands) {
+    const s = run.require();
+    if (!s.learnings_enabled)
+        return '';
+    // Lazy-load learnings from disk on first use
+    run.ensureLearningsLoaded();
+    const projectPath = run.rootPath;
+    const allLearnings = s.cached_learnings;
+    if (allLearnings.length === 0)
+        return '';
+    const relevant = selectRelevant(allLearnings, { paths: contextPaths, commands: contextCommands });
+    const budget = DEFAULT_LEARNINGS_BUDGET;
+    const block = formatLearningsForPrompt(relevant, budget);
+    if (!block)
+        return '';
+    // Track which learnings were injected
+    const injectedIds = relevant
+        .filter(l => block.includes(l.text))
+        .map(l => l.id);
+    s.injected_learning_ids = [...new Set([...s.injected_learning_ids, ...injectedIds])];
+    // Record access
+    if (injectedIds.length > 0) {
+        recordAccess(projectPath, injectedIds);
+    }
+    return block + '\n\n';
+}
+/**
+ * Build a risk context block for prompts when adaptive trust detects elevated/high risk.
+ * Returns empty string for low/normal risk.
+ */
+export function buildRiskContextBlock(riskAssessment) {
+    if (!riskAssessment)
+        return '';
+    if (riskAssessment.level === 'low' || riskAssessment.level === 'normal')
+        return '';
+    const lines = [
+        '<risk-context>',
+        `## Adaptive Risk: ${riskAssessment.level.toUpperCase()} (score: ${riskAssessment.score})`,
+        '',
+    ];
+    if (riskAssessment.fragile_paths.length > 0) {
+        lines.push('### Known Fragile Paths');
+        for (const fp of riskAssessment.fragile_paths.slice(0, 5)) {
+            lines.push(`- \`${fp}\``);
+        }
+        lines.push('');
+    }
+    if (riskAssessment.known_issues.length > 0) {
+        lines.push('### Known Issues in These Files');
+        for (const issue of riskAssessment.known_issues) {
+            lines.push(`- ${issue}`);
+        }
+        lines.push('');
+    }
+    lines.push('**Be extra careful** — these files have a history of failures. Consider smaller changes and more thorough testing.');
+    lines.push('</risk-context>');
+    return lines.join('\n') + '\n\n';
+}
+export function getScoutAutoApprove() {
+    return getRegistry().getAutoApprovePatterns({ phase: 'SCOUT', category: null });
+}
+export function getExecuteAutoApprove(category) {
+    return getRegistry().getAutoApprovePatterns({ phase: 'EXECUTE', category });
+}
+export function getQaAutoApprove() {
+    return getRegistry().getAutoApprovePatterns({ phase: 'QA', category: null });
+}
+export function getPrAutoApprove() {
+    return getRegistry().getAutoApprovePatterns({ phase: 'PR', category: null });
+}
+//# sourceMappingURL=advance-helpers.js.map

package/dist/advance-helpers.js.map

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

package/dist/advance-prompts.d.ts

@@ -0,0 +1,48 @@
+import type { AdvanceConstraints } from './types.js';
+import type { Formula } from './formulas.js';
+import type { CodebaseIndex } from './codebase-index.js';
+export declare function buildScoutEscalation(retryCount: number, explorationLog: string[], scoutedDirs: string[], codebaseIndex: CodebaseIndex | null): string;
+export declare function buildScoutPrompt(scope: string, categories: string[], minConfidence: number, maxProposals: number, dedupContext: string[], formula: Formula | null, hints: string[], eco: boolean, minImpactScore?: number, scoutedDirs?: string[], excludeDirs?: string[], coverageContext?: {
+    scannedSectors: number;
+    totalSectors: number;
+    percent: number;
+    sectorPercent?: number;
+    sectorSummary?: string;
+}): string;
+export declare function buildPlanPrompt(ticket: {
+    title: string;
+    description: string | null;
+    allowedPaths: string[];
+    verificationCommands: string[];
+    category?: string | null;
+}): string;
+export declare function buildExecutePrompt(ticket: {
+    title: string;
+    description: string | null;
+    allowedPaths: string[];
+    verificationCommands: string[];
+    category?: string | null;
+}, plan: unknown): string;
+export declare function buildQaPrompt(ticket: {
+    title: string;
+    verificationCommands: string[];
+}): string;
+export declare function buildPlanningPreamble(ticket: {
+    metadata?: Record<string, unknown> | null;
+}): string;
+/** Escape a string for use inside double-quoted shell arguments */
+export declare function shellEscape(s: string): string;
+export declare function buildInlineTicketPrompt(ticket: {
+    id: string;
+    title: string;
+    description: string | null;
+    allowedPaths: string[];
+    verificationCommands: string[];
+    metadata?: Record<string, unknown> | null;
+    category?: string | null;
+}, constraints: AdvanceConstraints, guidelinesBlock: string, metadataBlock: string, createPrs: boolean, draft: boolean, direct: boolean, setupCommand?: string, baselineFailures?: string[]): string;
+export declare function buildPrPrompt(ticket: {
+    title: string;
+    description: string | null;
+} | null, draftPr: boolean): string;
+//# sourceMappingURL=advance-prompts.d.ts.map

package/dist/advance-prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"advance-prompts.d.ts","sourceRoot":"","sources":["../src/advance-prompts.ts"],"names":[],"mappings":"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"}