popeye-cli 1.9.5 → 2.0.0

package/CHANGELOG.md

@@ -2,6 +2,65 @@
 
 All notable changes to Popeye CLI are documented in this file.
 
+## [2.0.0] - 2026-02-20
+
+### Breaking Changes
+- **Full Autonomy Pipeline Engine** — Popeye now ships a complete 14-phase deterministic pipeline that replaces the ad-hoc plan-then-execute workflow with a gate-driven state machine. This is a fundamental architectural shift: every phase must produce typed artifacts, pass gate checks, and survive consensus review before the pipeline advances. The pipeline manages its own recovery, drift detection, and rewind logic without human intervention.
+- `PipelineState` is now the authoritative runtime state for autonomous execution (distinct from the existing `ProjectState` used by the interactive CLI).
+- New `src/pipeline/` module tree (33 source files) is a peer to the existing `src/workflow/` module.
+
+### Added — Pipeline Core (Autonomy Hardening v1.0)
+
+- **14-Phase State Machine** — `INTAKE` -> `CONSENSUS_MASTER_PLAN` -> `ARCHITECTURE` -> `CONSENSUS_ARCHITECTURE` -> `ROLE_PLANNING` -> `CONSENSUS_ROLE_PLANS` -> `IMPLEMENTATION` -> `QA_VALIDATION` -> `REVIEW` -> `AUDIT` -> `PRODUCTION_GATE` -> `DONE` (or `RECOVERY_LOOP` / `STUCK` on failure). Each phase has a dedicated handler in `src/pipeline/phases/`.
+- **Gate Engine** (`gate-engine.ts`) — Pure deterministic evaluator. Each phase has a `GateDefinition` specifying required artifacts, required checks, consensus thresholds, allowed transitions, and fail transition. No side effects; reads state only.
+- **Orchestrator** (`orchestrator.ts`) — Main loop that drives the pipeline from any phase to completion. Handles phase dispatch, gate evaluation, recovery routing, resume from saved state, and terminal state handling.
+- **Type-Safe Artifact System** (`artifact-manager.ts`, `type-defs/artifacts.ts`) — 18 artifact types (`master_plan`, `architecture`, `role_plan`, `consensus`, `repo_snapshot`, `rca_report`, `audit_report`, `qa_validation`, `review_decision`, `production_readiness`, `constitution`, `change_request`, `release_notes`, `journalist_update`, `dependency_graph`, `implementation_log`, `recovery_log`, `skill_definition`). Each artifact has id, type, phase, version, path, sha256, timestamp, immutability flag, content_type, and group_id.
+- **Consensus System** (`consensus/consensus-runner.ts`, `packets/consensus-packet-builder.ts`) — Multi-reviewer consensus with confidence-weighted scoring. `APPROVE` = 1.0, `CONDITIONAL` = 0.5, `REJECT` = 0.0, weighted by voter confidence. Any vote with `blocking_issues` forces `weighted_score` to 0. Three consensus phases (master plan, architecture, role plans) each produce `ConsensusPacket` artifacts.
+- **Skill Loader** (`skill-loader.ts`, `skills/defaults.ts`) — 16 pipeline roles (`DISPATCHER`, `FRONTEND_PROGRAMMER`, `BACKEND_PROGRAMMER`, `DATABASE_SPECIALIST`, `DEVOPS_ENGINEER`, `QA_ENGINEER`, `UX_DESIGNER`, `TECHNICAL_WRITER`, `REVIEWER`, `AUDITOR`, `JOURNALIST`, `SECURITY_ANALYST`, `PERFORMANCE_ENGINEER`, `INTEGRATION_SPECIALIST`, `ARCHITECT`, `PROJECT_MANAGER`). Each role has a system prompt, constraints, output contract, and required sections.
+- **Constitution System** (`constitution.ts`) — SHA-256 hash verification of `POPEYE_CONSTITUTION.md`. Created during INTAKE, verified before every gate evaluation. Hash mismatch blocks pipeline progression.
+- **Repo Snapshot & Drift Detection** (`repo-snapshot.ts`) — File/line counting, language detection, config file inventory, port scanning, test framework and build tool detection. Snapshot diffing for drift detection between approved plans and implementation.
+- **Check Runner** (`check-runner.ts`) — Deterministic command execution for `build`, `test`, `lint`, `typecheck`, `start`, and `env_check` gates. Captures exit code, stdout/stderr, duration.
+- **Command Resolver** (`command-resolver.ts`) — Auto-detects `build`, `test`, `lint`, `typecheck`, and `start` commands from `package.json` scripts, `Makefile`, and common patterns.
+- **Artifact Validators** (`artifact-validators.ts`) — Deterministic regex/structural checks before LLM review: `master_plan` (Goals, Milestones, Success Criteria sections, 200+ chars), `architecture` (Components, Data Flow, Tech Stack, file path references), `role_plan` (Tasks, Dependencies, Acceptance Criteria), `qa_validation` (Test Results, Coverage), `audit_report` (JSON with findings array, overall_status, system_risk_score).
+- **Change Request System** (`change-request.ts`) — Structured drift tracking: `scope` -> `CONSENSUS_MASTER_PLAN`, `architecture` -> `CONSENSUS_ARCHITECTURE`, `dependency` -> `CONSENSUS_ROLE_PLANS`, `config` -> `QA_VALIDATION`, `requirement` -> `CONSENSUS_MASTER_PLAN`. CRs include origin phase, requester, impact analysis (affected artifacts, phases, risk level).
+- **Role Execution Adapter** (`role-execution-adapter.ts`) — Bridges pipeline roles to execution. Builds role-specific system prompts from skill + role plan, defines allowed paths and forbidden patterns, injects context into `ClaudeExecuteOptions`.
+- **RCA & Recovery** (`packets/rca-packet-builder.ts`, `phases/recovery-loop.ts`) — Root Cause Analysis packets with `requires_phase_rewind_to` for targeted recovery. Recovery loop reads RCA artifacts from disk to determine rewind targets.
+- **Packet Builders** — `plan-packet-builder.ts` (PlanPacket with milestones, constraints, deliverables), `consensus-packet-builder.ts` (ConsensusPacket with votes, scores, conditions), `rca-packet-builder.ts` (RCAPacket with root cause, evidence, rewind target), `audit-report-builder.ts` (AuditReport with findings, risk score, status).
+- **Migration System** (`migration.ts`) — Version-aware pipeline state migration for forward compatibility.
+- **Pipeline Index** (`index.ts`) — Public API: `runPipeline()`, `resumePipeline()`, `createDefaultPipelineState()`, `createGateEngine()`, plus all type exports.
+
+### Added — Autonomy Hardening v1.1 (Gap Fixes)
+
+- **Deterministic CR Routing** — After REVIEW and AUDIT phases pass their gates, the orchestrator checks `pipeline.pendingChangeRequests` for proposed CRs. First proposed CR is marked `approved` and the pipeline transitions to its `target_phase` (a consensus phase). This is a real state machine transition, not advisory.
+- **Constitution Verification in Orchestrator** — `verifyConstitution(pipeline, projectDir)` is called before every `evaluateGate()`. Result is passed as `{ constitutionValid, constitutionReason }` options. Gate engine adds constitution failure as a blocker.
+- **Gate Result Merge** — `mergeGateResult()` preserves `score`/`consensusScore` stored by consensus phase handlers while updating `pass`/`blockers` from the gate engine. Prevents consensus scoring data loss on re-evaluation.
+- **RCA Rewind from Disk** — `getLatestRCA()` reads the latest `rca_report` JSON artifact from the filesystem and parses `requires_phase_rewind_to`. Recovery loop uses this to rewind to the correct phase instead of always returning to the failed phase.
+- `score?: number` on `GateResult` in `gate-engine.ts` (was present in type-defs but missing from the runtime interface).
+- `pendingChangeRequests` array on `PipelineState` for CR lifecycle tracking (`proposed` -> `approved` -> routing).
+
+### Added — Type System
+
+- **Split `types.ts` into `type-defs/` directory** (8 files) — `enums.ts` (PipelinePhase, PipelineRole), `artifacts.ts` (18 artifact types, ArtifactEntry, ArtifactRef, DependencyEdge), `packets.ts` (PlanPacket, ConsensusPacket, ReviewerVote, RCAPacket, ChangeRequest, Constraint), `audit.ts` (AuditFinding, AuditReport), `snapshot.ts` (RepoSnapshot, ConfigFileEntry, PortEntry, SnapshotDiff), `checks.ts` (GateCheckType, GateCheckResult, ResolvedCommands), `state.ts` (PipelineState, GateResult, GateDefinition, SkillDefinition, PhaseResult, PhaseContext), `index.ts` (barrel re-export). All existing `from '../pipeline/types.js'` imports work unchanged.
+
+### Added — Tests
+
+- **59 new test files** covering the entire pipeline module with **1210 total tests** (up from 828):
+  - `orchestrator.test.ts` (25 tests) — Happy path, recovery loop, resume, gate integration, v1.1 gap fixes (CR routing, constitution, merge, RCA rewind)
+  - `gate-engine.test.ts` — Gate definitions, evaluations, transitions, consensus thresholds
+  - `consensus-scoring.test.ts` — Weighted scoring, CONDITIONAL=0.5, blocking issues, confidence weights
+  - `constitution.test.ts` — Artifact creation, hash computation, tamper detection
+  - `artifact-validators.test.ts` — Each type: valid pass, missing sections, empty content, edge cases
+  - `change-request.test.ts` — CR building, routing per change type, impact analysis
+  - `role-execution-adapter.test.ts` — Role context, prompt injection, forbidden patterns
+  - `start-env-checks.test.ts` — Start check (alive/crash/timeout), env check (complete/missing/empty)
+  - `check-runner.test.ts`, `command-resolver.test.ts`, `consensus-runner.test.ts`, `repo-snapshot.test.ts`, `skill-loader.test.ts`, `artifact-manager.test.ts`, `migration.test.ts`, `types.test.ts`, `packets/builders.test.ts`
+
+### Changed
+- Orchestrator main loop now has 3 new behaviors between phase execution and transition: (1) constitution verification before gate eval, (2) gate result merging after gate eval, (3) CR routing check after REVIEW/AUDIT gate pass.
+- REVIEW phase creates CRs for config drift and scope drift, registers them in `pipeline.pendingChangeRequests`.
+- AUDIT phase creates CRs for blocking architectural and security findings, registers them in `pipeline.pendingChangeRequests`.
+- `src/workflow/index.ts` — Added pipeline exports for integration with existing workflow system.
+
 ## [1.6.0] - 2026-02-17
 
 ### Added

package/CONTRIBUTING.md

@@ -185,8 +185,14 @@ src/
 ├── cli/           # CLI commands and interface
 ├── config/        # Configuration management
 ├── generators/    # Project scaffolding
+├── pipeline/      # Full autonomy pipeline engine (14-phase state machine)
+│   ├── orchestrator.ts    # Main loop with CR routing, constitution check, gate merge
+│   ├── gate-engine.ts     # Deterministic gate evaluation
+│   ├── phases/            # Phase handler implementations
+│   └── type-defs/         # Pipeline-specific type definitions
 ├── state/         # State management
 ├── types/         # TypeScript type definitions
+├── upgrade/       # Project type upgrade system
 └── workflow/      # Core workflow logic
     ├── plan-storage.ts      # Consensus docs per-app storage
     └── workspace-manager.ts # Multi-app workspace management
@@ -257,6 +263,14 @@ Understanding the codebase:
                               │
                               ▼
 ┌─────────────────────────────────────────────────────────────┐
+│                    Pipeline Layer                             │
+│  (pipeline/*.ts - 14-phase autonomy engine, gate machine)   │
+│  Orchestrator -> Gate Engine -> Phase Handlers               │
+│  Constitution verification, CR routing, RCA rewind           │
+└─────────────────────────────────────────────────────────────┘
+                              │
+                              ▼
+┌─────────────────────────────────────────────────────────────┐
 │                     Workflow Layer                           │
 │  (workflow/*.ts - Plan mode, Execution mode, Consensus)     │
 └─────────────────────────────────────────────────────────────┘
@@ -264,7 +278,7 @@ Understanding the codebase:
                               ▼
 ┌─────────────────────────────────────────────────────────────┐
 │                     Adapter Layer                            │
-│  (adapters/*.ts - Claude, OpenAI, Gemini)                   │
+│  (adapters/*.ts - Claude, OpenAI, Gemini, Grok)             │
 └─────────────────────────────────────────────────────────────┘
                               │
                               ▼

package/README.md

@@ -1606,6 +1606,18 @@ src/
 │   ├── handlers.ts       # Upgrade handlers (4 paths with file scaffolding)
 │   ├── index.ts          # Transactional orchestrator with backup/rollback
 │   └── context.ts        # Builds rich context for post-upgrade planning
+├── pipeline/             # Full autonomy pipeline engine (14 phases)
+│   ├── orchestrator.ts   # Top-level loop: phase dispatch, CR routing, constitution check
+│   ├── gate-engine.ts    # Deterministic state machine: gate definitions, evaluation
+│   ├── constitution.ts   # Constitution hashing and integrity verification (SHA-256)
+│   ├── change-request.ts # CR builder, routing (change_type -> consensus phase)
+│   ├── artifact-manager.ts # Artifact creation, storage, versioning
+│   ├── skill-loader.ts   # Role skill prompt loading from skills/ directory
+│   ├── repo-snapshot.ts  # Repo snapshot generation and diffing
+│   ├── consensus/        # Consensus runner for pipeline phases
+│   ├── phases/           # Phase handlers (intake, review, audit, recovery, etc.)
+│   ├── type-defs/        # Pipeline type definitions (state, enums, artifacts, packets)
+│   └── packets/          # Packet builders (audit report, consensus, RCA)
 ├── workflow/             # Workflow engine
 │   ├── consensus.ts      # Consensus loop (reviewerPersona threading)
 │   ├── plan-mode.ts      # Planning phase (strategy generation, monorepo-aware)
@@ -1645,6 +1657,51 @@ src/
     └── website-strategy.ts # WebsiteStrategyDocument, BrandAssetsContract, DesignTokens
 ```
 
+### Full Autonomy Pipeline Engine
+
+The `src/pipeline/` module implements the 14-phase deterministic pipeline defined in the `POPEYE_FULL_AUTONOMY_PIPELINE.md` spec. The pipeline drives a project from a single idea prompt through to production-ready status.
+
+#### Pipeline Phases
+
+```
+INTAKE -> CONSENSUS_MASTER_PLAN -> ARCHITECTURE -> CONSENSUS_ARCHITECTURE
+  -> ROLE_PLANNING -> CONSENSUS_ROLE_PLANS -> IMPLEMENTATION -> QA_VALIDATION
+  -> REVIEW -> AUDIT -> PRODUCTION_GATE -> DONE
+  (RECOVERY_LOOP on any gate failure, STUCK after max recovery iterations)
+```
+
+Each phase has:
+- **Required artifacts** that must exist before the gate passes
+- **Required checks** (build, test, lint, typecheck for PRODUCTION_GATE)
+- **Consensus threshold** (0.95 for plan phases)
+- **Allowed transitions** (strictly enforced, no phase skipping)
+
+#### Autonomy Hardening (v1.1)
+
+The orchestrator main loop includes three behaviors between phase execution and transition:
+
+1. **Constitution Verification**: Before every `evaluateGate()` call, the orchestrator verifies that `skills/POPEYE_CONSTITUTION.md` has not been modified since pipeline start (SHA-256 hash comparison). If the constitution is invalid, the gate is blocked with a specific reason.
+
+2. **Gate Result Merging**: After gate evaluation, `mergeGateResult()` preserves `score`/`consensusScore` values stored by consensus phase handlers while updating `pass`/`blockers` from the gate engine. This prevents consensus scores from being overwritten.
+
+3. **CR Routing**: After REVIEW and AUDIT phases pass their gates, the orchestrator checks `pipeline.pendingChangeRequests` for any `proposed` Change Requests. If found, the pipeline deterministically routes to the appropriate consensus phase rather than continuing normal progression.
+
+#### Change Request System
+
+| Change Type | Routes To |
+|-------------|-----------|
+| `scope` | `CONSENSUS_MASTER_PLAN` |
+| `architecture` | `CONSENSUS_ARCHITECTURE` |
+| `dependency` | `CONSENSUS_ROLE_PLANS` |
+| `config` | `QA_VALIDATION` |
+| `requirement` | `CONSENSUS_MASTER_PLAN` |
+
+CR Lifecycle: `proposed` (created by REVIEW/AUDIT) -> `approved` (routed by orchestrator) or `rejected`.
+
+#### Recovery and RCA Rewind
+
+When any gate fails, the pipeline enters RECOVERY_LOOP. After successful recovery, the orchestrator reads the latest RCA artifact from disk and checks for a `requires_phase_rewind_to` field. If present, the pipeline rewinds to that specific phase instead of retesting the originally failed phase. This allows root-cause-aware recovery (e.g., an implementation failure caused by an architecture gap can rewind to ARCHITECTURE).
+
 ## Development
 
 ```bash

package/cheatsheet.md

@@ -231,6 +231,32 @@ popeye-cli audit ./my-project --target frontend
 
 ---
 
+### `popeye-cli debug [projectDir]`
+
+Start an interactive debugging session for a Popeye-generated project. Indexes the project, loads anchor docs (CLAUDE.md, README, config files), then opens a debug sub-REPL where you paste errors for AI-assisted diagnosis and fixes.
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `-l, --language <lang>` | Project language/type | `backend` |
+
+```bash
+popeye-cli debug ./my-project
+popeye-cli debug ./my-project --language fullstack
+```
+
+**How it works:**
+1. Scans the project directory and builds a lightweight file index (paths + metadata)
+2. Loads anchor documents: CLAUDE.md, README, package.json, docker-compose.yml, etc.
+3. Opens a `debug >` sub-REPL -- paste an error or describe a bug
+4. Extracts file paths from stack traces and detects tech context (alembic, vite, fastapi, etc.)
+5. Loads only the relevant source files on-demand (not the entire codebase)
+6. Sends targeted context to Claude for structured diagnosis
+7. Claude responds with: Diagnosis, Evidence, Proposed Fix, Commands to Verify, Ready to Apply
+
+**Permission model:** Same as Claude Code -- asks before making any file edits (no auto-write).
+
+---
+
 ## Interactive Mode Slash Commands
 
 Enter these commands during an interactive session (started via `popeye-cli interactive`).
@@ -317,6 +343,41 @@ Available upgrade paths depend on the current project type:
 | `/doctor` | Run all readiness checks inline |
 | `/review`, `/audit` | Run a post-build audit with findings and optional recovery |
 
+### Debugging
+
+| Command | Description |
+|---------|-------------|
+| `/debug`, `/dbg` | Start interactive debugging session (requires active project) |
+
+Once inside the debug session, the following sub-commands are available:
+
+| Debug Sub-Command | Description |
+|-------------------|-------------|
+| `/back`, `/done` | Return to main Popeye session |
+| `/clear` | Reset conversation history |
+| `/context` | Re-display project summary |
+| `/fix` | Apply last proposed fix via Popeye execution pipeline |
+
+**Debug session input:** Single Enter submits for commands and short messages. Multi-line paste is auto-detected and waits for the full paste to arrive before submitting.
+
+```
+# Start a debug session from the Popeye REPL
+/debug
+
+# Inside debug session, paste an error:
+debug > Traceback (most recent call last):
+  ...   File "/app/src/database/connection.py", line 15
+  ...   ConnectionRefusedError: [Errno 111] Connection refused
+  ...
+  ... (paste auto-detected, submits after 2s pause)
+
+# Apply the proposed fix
+debug > /fix
+
+# Return to main Popeye REPL (use /back, not /exit which would exit Popeye)
+debug > /back
+```
+
 ### Session Control
 
 | Command | Description |
@@ -435,6 +496,10 @@ popeye-cli resume ./taskmaster
 popeye-cli review ./taskmaster
 popeye-cli review ./taskmaster --depth 3 --strict
 
+# Debug a project (paste errors, get AI-assisted fixes)
+popeye-cli debug ./taskmaster
+popeye-cli debug ./taskmaster --language fullstack
+
 # Reset and re-plan
 popeye-cli reset ./taskmaster --phase plan
 ```

package/dist/cli/commands/debug-context.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Debug context helpers
+ * Deterministic functions for error analysis and smart file selection.
+ * Pure functions, easily testable.
+ */
+/**
+ * Entry in the lightweight file index (paths + metadata, no content).
+ */
+export interface FileIndexEntry {
+    relativePath: string;
+    size: number;
+    mtime: number;
+    isConfig: boolean;
+}
+/**
+ * Check if a file path matches a config pattern.
+ *
+ * @param filePath - Relative path to check.
+ * @returns True if the file is a known config file.
+ */
+export declare function isConfigFile(filePath: string): boolean;
+/**
+ * Extract file paths mentioned in stack traces.
+ * Supports Python tracebacks, TypeScript/JS errors, and generic path patterns.
+ *
+ * @param text - Error text or stack trace.
+ * @returns Deduplicated array of file paths found in the text.
+ */
+export declare function extractPathsFromError(text: string): string[];
+/**
+ * Detect framework/tech keywords from error text.
+ *
+ * @param text - Error text or stack trace.
+ * @returns Object with deduplicated tags array.
+ */
+export declare function detectTechFromError(text: string): {
+    tags: string[];
+};
+/**
+ * Select relevant files from the project index based on error paths and tech tags.
+ * Returns file paths sorted by relevance (direct matches first, then config, then nearby).
+ *
+ * @param fileIndex - Lightweight file index.
+ * @param errorPaths - Paths extracted from the error.
+ * @param tags - Tech tags detected from the error.
+ * @returns Array of relative paths to load.
+ */
+export declare function selectRelevantFiles(fileIndex: FileIndexEntry[], errorPaths: string[], tags: string[]): string[];
+/**
+ * Extract image/screenshot file paths from user input text.
+ * Detects both quoted and unquoted absolute/relative paths ending in image extensions.
+ *
+ * @param text - User input text.
+ * @returns Array of image file paths found in the text.
+ */
+export declare function extractImagePaths(text: string): string[];
+/**
+ * Check if a file path points to an image file.
+ *
+ * @param filePath - File path to check.
+ * @returns True if the file has an image extension.
+ */
+export declare function isImageFile(filePath: string): boolean;
+//# sourceMappingURL=debug-context.d.ts.map

package/dist/cli/commands/debug-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-context.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/debug-context.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;CACnB;AAYD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAGtD;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAsC5D;AA2BD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAapE;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,cAAc,EAAE,EAC3B,UAAU,EAAE,MAAM,EAAE,EACpB,IAAI,EAAE,MAAM,EAAE,GACb,MAAM,EAAE,CAkEV;AAKD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAgBxD;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAGrD"}

package/dist/cli/commands/debug-context.js

@@ -0,0 +1,221 @@
+/**
+ * Debug context helpers
+ * Deterministic functions for error analysis and smart file selection.
+ * Pure functions, easily testable.
+ */
+import path from 'node:path';
+/** Config file patterns that are always considered relevant */
+const CONFIG_PATTERNS = [
+    'package.json', 'package-lock.json', 'tsconfig.json', 'vite.config',
+    'pyproject.toml', 'requirements.txt', 'Pipfile',
+    'docker-compose.yml', 'docker-compose.yaml', 'Dockerfile',
+    '.env.example', '.env.local', 'alembic.ini',
+    'next.config', 'tailwind.config', 'postcss.config',
+    'jest.config', 'vitest.config', 'pytest.ini', 'setup.cfg',
+];
+/**
+ * Check if a file path matches a config pattern.
+ *
+ * @param filePath - Relative path to check.
+ * @returns True if the file is a known config file.
+ */
+export function isConfigFile(filePath) {
+    const basename = path.basename(filePath);
+    return CONFIG_PATTERNS.some((p) => basename.startsWith(p));
+}
+/**
+ * Extract file paths mentioned in stack traces.
+ * Supports Python tracebacks, TypeScript/JS errors, and generic path patterns.
+ *
+ * @param text - Error text or stack trace.
+ * @returns Deduplicated array of file paths found in the text.
+ */
+export function extractPathsFromError(text) {
+    const paths = new Set();
+    // Python traceback: File "/app/src/module/file.py", line 42
+    const pyPattern = /File "([^"]+\.py[cw]?)", line \d+/g;
+    for (const match of text.matchAll(pyPattern)) {
+        paths.add(normalizePath(match[1]));
+    }
+    // TS/JS errors: src/components/App.tsx(15,3) or src/components/App.tsx:15:3
+    const tsPattern = /([a-zA-Z0-9_./\\-]+\.(?:ts|tsx|js|jsx|mjs|cjs))[\s:(]/g;
+    for (const match of text.matchAll(tsPattern)) {
+        paths.add(normalizePath(match[1]));
+    }
+    // Docker / generic paths: /app/src/..., ./src/...
+    const genericPattern = /(?:\/app\/|\.\/)((?:src|app|lib|tests?|config)\/[a-zA-Z0-9_./-]+\.\w+)/g;
+    for (const match of text.matchAll(genericPattern)) {
+        paths.add(normalizePath(match[1]));
+    }
+    // Module not found patterns: Cannot find module './foo/bar'
+    const modulePattern = /Cannot find module ['"]([^'"]+)['"]/g;
+    for (const match of text.matchAll(modulePattern)) {
+        const mod = match[1];
+        if (mod.startsWith('.') || mod.startsWith('/')) {
+            paths.add(normalizePath(mod));
+        }
+    }
+    // ModuleNotFoundError: No module named 'src.foo.bar'
+    const pyModulePattern = /No module named ['"]([^'"]+)['"]/g;
+    for (const match of text.matchAll(pyModulePattern)) {
+        const dotPath = match[1].replace(/\./g, '/');
+        paths.add(dotPath);
+    }
+    return Array.from(paths);
+}
+/** Tech keyword map: keyword -> tags */
+const TECH_KEYWORDS = {
+    'alembic': ['alembic', 'database', 'migration'],
+    'sqlalchemy': ['sqlalchemy', 'database', 'orm'],
+    'prisma': ['prisma', 'database', 'orm'],
+    'docker': ['docker', 'container'],
+    'docker-compose': ['docker', 'container', 'compose'],
+    'vite': ['vite', 'bundler', 'frontend'],
+    'webpack': ['webpack', 'bundler', 'frontend'],
+    'next': ['nextjs', 'react', 'frontend'],
+    'fastapi': ['fastapi', 'backend', 'python'],
+    'flask': ['flask', 'backend', 'python'],
+    'express': ['express', 'backend', 'node'],
+    'postgres': ['postgres', 'database'],
+    'redis': ['redis', 'cache'],
+    'tailwind': ['tailwind', 'css', 'frontend'],
+    'pytest': ['pytest', 'testing', 'python'],
+    'jest': ['jest', 'testing', 'node'],
+    'vitest': ['vitest', 'testing', 'node'],
+    'nginx': ['nginx', 'proxy'],
+    'cors': ['cors', 'api'],
+    'migration': ['migration', 'database'],
+    'celery': ['celery', 'queue', 'python'],
+};
+/**
+ * Detect framework/tech keywords from error text.
+ *
+ * @param text - Error text or stack trace.
+ * @returns Object with deduplicated tags array.
+ */
+export function detectTechFromError(text) {
+    const tags = new Set();
+    const lower = text.toLowerCase();
+    for (const [keyword, keywordTags] of Object.entries(TECH_KEYWORDS)) {
+        if (lower.includes(keyword)) {
+            for (const tag of keywordTags) {
+                tags.add(tag);
+            }
+        }
+    }
+    return { tags: Array.from(tags) };
+}
+/**
+ * Select relevant files from the project index based on error paths and tech tags.
+ * Returns file paths sorted by relevance (direct matches first, then config, then nearby).
+ *
+ * @param fileIndex - Lightweight file index.
+ * @param errorPaths - Paths extracted from the error.
+ * @param tags - Tech tags detected from the error.
+ * @returns Array of relative paths to load.
+ */
+export function selectRelevantFiles(fileIndex, errorPaths, tags) {
+    if (fileIndex.length === 0)
+        return [];
+    const selected = new Set();
+    const MAX_FILES = 15;
+    // 1. Direct matches: files mentioned in the error
+    for (const errorPath of errorPaths) {
+        for (const entry of fileIndex) {
+            if (entry.relativePath.endsWith(errorPath) ||
+                entry.relativePath === errorPath ||
+                entry.relativePath.includes(errorPath)) {
+                selected.add(entry.relativePath);
+            }
+        }
+    }
+    // 2. Sibling files: files in the same directory as matches
+    const matchedDirs = new Set();
+    for (const sel of selected) {
+        matchedDirs.add(path.dirname(sel));
+    }
+    for (const dir of matchedDirs) {
+        for (const entry of fileIndex) {
+            if (path.dirname(entry.relativePath) === dir && selected.size < MAX_FILES) {
+                selected.add(entry.relativePath);
+            }
+        }
+    }
+    // 3. Tag-based: config files related to detected tech
+    if (tags.includes('database') || tags.includes('migration')) {
+        for (const entry of fileIndex) {
+            if (entry.relativePath.includes('alembic') ||
+                entry.relativePath.includes('migration') ||
+                entry.relativePath.includes('prisma') ||
+                entry.relativePath.includes('schema.sql')) {
+                if (selected.size < MAX_FILES)
+                    selected.add(entry.relativePath);
+            }
+        }
+    }
+    if (tags.includes('docker') || tags.includes('compose')) {
+        for (const entry of fileIndex) {
+            if (entry.relativePath.includes('docker') ||
+                entry.relativePath.includes('Dockerfile')) {
+                if (selected.size < MAX_FILES)
+                    selected.add(entry.relativePath);
+            }
+        }
+    }
+    // 4. Fallback: always include config files if we have few matches
+    if (selected.size < 5) {
+        for (const entry of fileIndex) {
+            if (entry.isConfig && selected.size < MAX_FILES) {
+                selected.add(entry.relativePath);
+            }
+        }
+    }
+    return Array.from(selected).slice(0, MAX_FILES);
+}
+/** Image file extensions that Claude can read via the Read tool */
+const IMAGE_EXTENSIONS = new Set(['.png', '.jpg', '.jpeg', '.gif', '.webp', '.bmp', '.svg']);
+/**
+ * Extract image/screenshot file paths from user input text.
+ * Detects both quoted and unquoted absolute/relative paths ending in image extensions.
+ *
+ * @param text - User input text.
+ * @returns Array of image file paths found in the text.
+ */
+export function extractImagePaths(text) {
+    const paths = new Set();
+    // Quoted paths: '/path/to/image.png' or "/path/to/image.png"
+    const quotedPattern = /['"]([^'"]+\.(?:png|jpg|jpeg|gif|webp|bmp|svg))['"]/gi;
+    for (const match of text.matchAll(quotedPattern)) {
+        paths.add(match[1]);
+    }
+    // Unquoted absolute paths: /path/to/image.png (no spaces allowed in unquoted)
+    const absolutePattern = /(\/[^\s'"]+\.(?:png|jpg|jpeg|gif|webp|bmp|svg))/gi;
+    for (const match of text.matchAll(absolutePattern)) {
+        paths.add(match[1]);
+    }
+    return Array.from(paths);
+}
+/**
+ * Check if a file path points to an image file.
+ *
+ * @param filePath - File path to check.
+ * @returns True if the file has an image extension.
+ */
+export function isImageFile(filePath) {
+    const ext = path.extname(filePath).toLowerCase();
+    return IMAGE_EXTENSIONS.has(ext);
+}
+/**
+ * Normalize a file path by stripping common prefixes (/app/, ./, etc.).
+ *
+ * @param p - Raw file path from error text.
+ * @returns Normalized relative path.
+ */
+function normalizePath(p) {
+    let normalized = p.replace(/\\/g, '/');
+    // Strip common container prefixes
+    normalized = normalized.replace(/^\/app\//, '');
+    normalized = normalized.replace(/^\.\//, '');
+    return normalized;
+}
+//# sourceMappingURL=debug-context.js.map

package/dist/cli/commands/debug-context.js.map

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

package/dist/cli/commands/debug-prompts.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Debug session prompts
+ * System prompt with strict output contract and conversation history formatting.
+ */
+/**
+ * Message in the debug conversation history.
+ */
+export interface DebugMessage {
+    role: 'user' | 'assistant';
+    content: string;
+}
+/**
+ * Build the system prompt for the debug session.
+ *
+ * @returns The system prompt instructing Claude on debug response format.
+ */
+export declare function getDebugSystemPrompt(): string;
+/**
+ * Format conversation history for inclusion in the prompt.
+ *
+ * @param history - Array of debug messages.
+ * @returns Formatted string of conversation history.
+ */
+export declare function formatConversationHistory(history: DebugMessage[]): string;
+//# sourceMappingURL=debug-prompts.d.ts.map

package/dist/cli/commands/debug-prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-prompts.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/debug-prompts.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAqD7C;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,MAAM,CAWzE"}