popeye-cli 1.10.0 → 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/dist/pipeline/artifact-manager.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Artifact Manager — manages immutable versioned artifacts under /docs/.
+ * Supports both Markdown and JSON content types (P0-C).
+ * Implements version chains via group_id + previous_id (P1-2).
+ */
+import type { ArtifactType, ArtifactEntry, ArtifactRef, ContentType, PipelinePhase } from './types.js';
+export interface ArtifactManagerOptions {
+    projectDir: string;
+}
+export declare class ArtifactManager {
+    private readonly projectDir;
+    private readonly docsDir;
+    constructor(options: ArtifactManagerOptions);
+    /** Ensure all /docs/ subdirectories exist */
+    ensureDocsStructure(): void;
+    /** Create an artifact from Markdown content */
+    createArtifactText(type: ArtifactType, markdown: string, phase: PipelinePhase, groupId?: string): ArtifactEntry;
+    /** Create an artifact from a JSON-serializable object */
+    createArtifactJson(type: ArtifactType, jsonObject: unknown, phase: PipelinePhase, groupId?: string): ArtifactEntry;
+    /** Core artifact creation logic */
+    private createArtifact;
+    /** Get the file path for a given artifact type and naming components */
+    getArtifactPath(type: ArtifactType, sid: string, version: number, date: string, contentType: ContentType): string;
+    /** List all artifacts, optionally filtered by type */
+    listArtifacts(type?: ArtifactType): ArtifactEntry[];
+    /** Verify an artifact's SHA-256 matches its stored content */
+    verifyArtifact(entry: ArtifactEntry): boolean;
+    /** Get the latest artifact of a given type */
+    getLatestArtifact(type: ArtifactType): ArtifactEntry | null;
+    /** Get next version number for a group across existing artifacts */
+    getNextVersion(groupId: string, existingArtifacts: ArtifactEntry[]): number;
+    /** Convert an ArtifactEntry to an ArtifactRef */
+    toArtifactRef(entry: ArtifactEntry): ArtifactRef;
+    /** Store artifact metadata for later retrieval */
+    storeArtifactMetadata(entry: ArtifactEntry): void;
+    /** Create an artifact and store its metadata in one step */
+    createAndStoreText(type: ArtifactType, markdown: string, phase: PipelinePhase, groupId?: string): ArtifactEntry;
+    /** Create a JSON artifact and store its metadata in one step */
+    createAndStoreJson(type: ArtifactType, jsonObject: unknown, phase: PipelinePhase, groupId?: string): ArtifactEntry;
+    /** Update /docs/INDEX.md with current artifact listing */
+    updateIndex(artifacts: ArtifactEntry[]): void;
+    /** Get the latest artifact entry in a specific group */
+    private getLatestInGroup;
+}
+/** Factory function */
+export declare function createArtifactManager(projectDir: string): ArtifactManager;
+//# sourceMappingURL=artifact-manager.d.ts.map

package/dist/pipeline/artifact-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-manager.d.ts","sourceRoot":"","sources":["../../src/pipeline/artifact-manager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EACb,WAAW,EACX,WAAW,EACX,aAAa,EACd,MAAM,YAAY,CAAC;AAqEpB,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,EAAE,sBAAsB;IAK3C,6CAA6C;IAC7C,mBAAmB,IAAI,IAAI;IAY3B,+CAA+C;IAC/C,kBAAkB,CAChB,IAAI,EAAE,YAAY,EAClB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,aAAa,EACpB,OAAO,CAAC,EAAE,MAAM,GACf,aAAa;IAIhB,yDAAyD;IACzD,kBAAkB,CAChB,IAAI,EAAE,YAAY,EAClB,UAAU,EAAE,OAAO,EACnB,KAAK,EAAE,aAAa,EACpB,OAAO,CAAC,EAAE,MAAM,GACf,aAAa;IAKhB,mCAAmC;IACnC,OAAO,CAAC,cAAc;IAkDtB,wEAAwE;IACxE,eAAe,CACb,IAAI,EAAE,YAAY,EAClB,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,WAAW,GACvB,MAAM;IAMT,sDAAsD;IACtD,aAAa,CAAC,IAAI,CAAC,EAAE,YAAY,GAAG,aAAa,EAAE;IAyBnD,8DAA8D;IAC9D,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO;IAW7C,8CAA8C;IAC9C,iBAAiB,CAAC,IAAI,EAAE,YAAY,GAAG,aAAa,GAAG,IAAI;IAM3D,oEAAoE;IACpE,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,aAAa,EAAE,GAAG,MAAM;IAO3E,iDAAiD;IACjD,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,WAAW;IAUhD,kDAAkD;IAClD,qBAAqB,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAUjD,4DAA4D;IAC5D,kBAAkB,CAChB,IAAI,EAAE,YAAY,EAClB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,aAAa,EACpB,OAAO,CAAC,EAAE,MAAM,GACf,aAAa;IAMhB,gEAAgE;IAChE,kBAAkB,CAChB,IAAI,EAAE,YAAY,EAClB,UAAU,EAAE,OAAO,EACnB,KAAK,EAAE,aAAa,EACpB,OAAO,CAAC,EAAE,MAAM,GACf,aAAa;IAMhB,0DAA0D;IAC1D,WAAW,CAAC,SAAS,EAAE,aAAa,EAAE,GAAG,IAAI;IAyB7C,wDAAwD;IACxD,OAAO,CAAC,gBAAgB;CAUzB;AAED,uBAAuB;AACvB,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,eAAe,CAEzE"}

package/dist/pipeline/artifact-manager.js

@@ -0,0 +1,251 @@
+/**
+ * Artifact Manager — manages immutable versioned artifacts under /docs/.
+ * Supports both Markdown and JSON content types (P0-C).
+ * Implements version chains via group_id + previous_id (P1-2).
+ */
+import { randomUUID } from 'node:crypto';
+import { createHash } from 'node:crypto';
+import { existsSync, mkdirSync, writeFileSync, readFileSync, readdirSync } from 'node:fs';
+import { join, relative } from 'node:path';
+// ─── Constants ───────────────────────────────────────────
+/** Directory mappings: artifact type -> subdirectory under /docs/ */
+const ARTIFACT_DIRS = {
+    master_plan: 'master-plan',
+    architecture: 'architecture',
+    role_plan: 'role-plans',
+    consensus: 'consensus',
+    arbitration: 'arbitration',
+    audit_report: 'audit',
+    rca_report: 'incidents',
+    production_readiness: 'production',
+    release_notes: 'release',
+    deployment: 'release',
+    rollback: 'release',
+    repo_snapshot: 'snapshots',
+    build_check: 'checks',
+    test_check: 'checks',
+    lint_check: 'checks',
+    typecheck_check: 'checks',
+    placeholder_scan: 'checks',
+    qa_validation: 'role-plans',
+    review_decision: 'consensus',
+    stuck_report: 'incidents',
+    journalist_trace: 'journal',
+    resolved_commands: 'checks',
+    constitution: 'governance',
+    change_request: 'governance',
+};
+/** All required subdirectories under /docs/ */
+const DOCS_SUBDIRS = [
+    'master-plan',
+    'architecture',
+    'role-plans',
+    'consensus',
+    'arbitration',
+    'audit',
+    'incidents',
+    'production',
+    'release',
+    'snapshots',
+    'checks',
+    'journal',
+    'governance',
+];
+// ─── Helper Functions ────────────────────────────────────
+function computeSha256(content) {
+    return createHash('sha256').update(content, 'utf-8').digest('hex');
+}
+function shortId() {
+    return randomUUID().split('-')[0];
+}
+function formatDate() {
+    return new Date().toISOString().split('T')[0];
+}
+function getExtension(contentType) {
+    return contentType === 'json' ? '.json' : '.md';
+}
+export class ArtifactManager {
+    projectDir;
+    docsDir;
+    constructor(options) {
+        this.projectDir = options.projectDir;
+        this.docsDir = join(options.projectDir, 'docs');
+    }
+    /** Ensure all /docs/ subdirectories exist */
+    ensureDocsStructure() {
+        if (!existsSync(this.docsDir)) {
+            mkdirSync(this.docsDir, { recursive: true });
+        }
+        for (const subdir of DOCS_SUBDIRS) {
+            const dirPath = join(this.docsDir, subdir);
+            if (!existsSync(dirPath)) {
+                mkdirSync(dirPath, { recursive: true });
+            }
+        }
+    }
+    /** Create an artifact from Markdown content */
+    createArtifactText(type, markdown, phase, groupId) {
+        return this.createArtifact(type, markdown, phase, 'markdown', groupId);
+    }
+    /** Create an artifact from a JSON-serializable object */
+    createArtifactJson(type, jsonObject, phase, groupId) {
+        const content = JSON.stringify(jsonObject, null, 2);
+        return this.createArtifact(type, content, phase, 'json', groupId);
+    }
+    /** Core artifact creation logic */
+    createArtifact(type, content, phase, contentType, groupId) {
+        this.ensureDocsStructure();
+        const resolvedGroupId = groupId ?? randomUUID();
+        const existingArtifacts = this.listArtifacts(type);
+        const version = this.getNextVersion(resolvedGroupId, existingArtifacts);
+        const previousEntry = this.getLatestInGroup(resolvedGroupId, existingArtifacts);
+        const id = randomUUID();
+        const date = formatDate();
+        const sid = shortId();
+        const ext = getExtension(contentType);
+        const filename = `${type}_${sid}_v${version}_${date}${ext}`;
+        const subdir = ARTIFACT_DIRS[type] ?? 'misc';
+        const dirPath = join(this.docsDir, subdir);
+        if (!existsSync(dirPath)) {
+            mkdirSync(dirPath, { recursive: true });
+        }
+        const filePath = join(dirPath, filename);
+        const sha256 = computeSha256(content);
+        writeFileSync(filePath, content, 'utf-8');
+        const relativePath = relative(this.projectDir, filePath);
+        const entry = {
+            id,
+            type,
+            phase,
+            version,
+            path: relativePath,
+            sha256,
+            timestamp: new Date().toISOString(),
+            immutable: true,
+            content_type: contentType,
+            group_id: resolvedGroupId,
+            previous_id: previousEntry?.id,
+        };
+        return entry;
+    }
+    /** Get the file path for a given artifact type and naming components */
+    getArtifactPath(type, sid, version, date, contentType) {
+        const ext = getExtension(contentType);
+        const subdir = ARTIFACT_DIRS[type] ?? 'misc';
+        return join(this.docsDir, subdir, `${type}_${sid}_v${version}_${date}${ext}`);
+    }
+    /** List all artifacts, optionally filtered by type */
+    listArtifacts(type) {
+        // Scan for artifact JSON metadata files in a .artifacts/ dir
+        const metaDir = join(this.docsDir, '.artifacts');
+        if (!existsSync(metaDir)) {
+            return [];
+        }
+        const entries = [];
+        const files = readdirSync(metaDir).filter((f) => f.endsWith('.json'));
+        for (const file of files) {
+            try {
+                const raw = readFileSync(join(metaDir, file), 'utf-8');
+                const parsed = JSON.parse(raw);
+                if (!type || parsed.type === type) {
+                    entries.push(parsed);
+                }
+            }
+            catch {
+                // Skip malformed metadata files
+            }
+        }
+        return entries.sort((a, b) => a.timestamp.localeCompare(b.timestamp));
+    }
+    /** Verify an artifact's SHA-256 matches its stored content */
+    verifyArtifact(entry) {
+        const fullPath = join(this.projectDir, entry.path);
+        if (!existsSync(fullPath)) {
+            return false;
+        }
+        const content = readFileSync(fullPath, 'utf-8');
+        const currentHash = computeSha256(content);
+        return currentHash === entry.sha256;
+    }
+    /** Get the latest artifact of a given type */
+    getLatestArtifact(type) {
+        const all = this.listArtifacts(type);
+        if (all.length === 0)
+            return null;
+        return all[all.length - 1];
+    }
+    /** Get next version number for a group across existing artifacts */
+    getNextVersion(groupId, existingArtifacts) {
+        const groupArtifacts = existingArtifacts.filter((a) => a.group_id === groupId);
+        if (groupArtifacts.length === 0)
+            return 1;
+        const maxVersion = Math.max(...groupArtifacts.map((a) => a.version));
+        return maxVersion + 1;
+    }
+    /** Convert an ArtifactEntry to an ArtifactRef */
+    toArtifactRef(entry) {
+        return {
+            artifact_id: entry.id,
+            path: entry.path,
+            sha256: entry.sha256,
+            version: entry.version,
+            type: entry.type,
+        };
+    }
+    /** Store artifact metadata for later retrieval */
+    storeArtifactMetadata(entry) {
+        const metaDir = join(this.docsDir, '.artifacts');
+        if (!existsSync(metaDir)) {
+            mkdirSync(metaDir, { recursive: true });
+        }
+        const metaPath = join(metaDir, `${entry.id}.json`);
+        writeFileSync(metaPath, JSON.stringify(entry, null, 2), 'utf-8');
+    }
+    /** Create an artifact and store its metadata in one step */
+    createAndStoreText(type, markdown, phase, groupId) {
+        const entry = this.createArtifactText(type, markdown, phase, groupId);
+        this.storeArtifactMetadata(entry);
+        return entry;
+    }
+    /** Create a JSON artifact and store its metadata in one step */
+    createAndStoreJson(type, jsonObject, phase, groupId) {
+        const entry = this.createArtifactJson(type, jsonObject, phase, groupId);
+        this.storeArtifactMetadata(entry);
+        return entry;
+    }
+    /** Update /docs/INDEX.md with current artifact listing */
+    updateIndex(artifacts) {
+        this.ensureDocsStructure();
+        const lines = [
+            '# Documentation Index',
+            '',
+            `> Auto-generated by Popeye Pipeline — ${new Date().toISOString()}`,
+            '',
+            '## Artifacts',
+            '',
+            '| Type | Version | Path | Phase | Timestamp |',
+            '|------|---------|------|-------|-----------|',
+        ];
+        const sorted = [...artifacts].sort((a, b) => a.timestamp.localeCompare(b.timestamp));
+        for (const a of sorted) {
+            lines.push(`| ${a.type} | v${a.version} | ${a.path} | ${a.phase} | ${a.timestamp} |`);
+        }
+        lines.push('');
+        const indexPath = join(this.docsDir, 'INDEX.md');
+        writeFileSync(indexPath, lines.join('\n'), 'utf-8');
+    }
+    /** Get the latest artifact entry in a specific group */
+    getLatestInGroup(groupId, existingArtifacts) {
+        const groupArtifacts = existingArtifacts
+            .filter((a) => a.group_id === groupId)
+            .sort((a, b) => a.version - b.version);
+        if (groupArtifacts.length === 0)
+            return null;
+        return groupArtifacts[groupArtifacts.length - 1];
+    }
+}
+/** Factory function */
+export function createArtifactManager(projectDir) {
+    return new ArtifactManager({ projectDir });
+}
+//# sourceMappingURL=artifact-manager.js.map

package/dist/pipeline/artifact-manager.js.map

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

package/dist/pipeline/artifact-validators.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Artifact Completeness Validators — deterministic structural checks.
+ * Runs BEFORE LLM review in consensus phases to catch obvious issues.
+ * Each validator checks for required sections, minimum content length,
+ * and structural integrity specific to its artifact type.
+ */
+import type { ArtifactType } from './types.js';
+export interface ValidationResult {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+}
+/**
+ * Validate artifact content completeness based on type-specific rules.
+ * Returns a ValidationResult with errors (blocking) and warnings (non-blocking).
+ *
+ * Args:
+ *   type: The artifact type to validate against.
+ *   content: The artifact content string.
+ *
+ * Returns:
+ *   ValidationResult with valid flag, errors, and warnings.
+ */
+export declare function validateArtifactCompleteness(type: ArtifactType, content: string): ValidationResult;
+/**
+ * Get all artifact types that have validators.
+ */
+export declare function getValidatableArtifactTypes(): ArtifactType[];
+//# sourceMappingURL=artifact-validators.d.ts.map

package/dist/pipeline/artifact-validators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-validators.d.ts","sourceRoot":"","sources":["../../src/pipeline/artifact-validators.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAI/C,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AA2KD;;;;;;;;;;GAUG;AACH,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,YAAY,EAClB,OAAO,EAAE,MAAM,GACd,gBAAgB,CAgBlB;AAED;;GAEG;AACH,wBAAgB,2BAA2B,IAAI,YAAY,EAAE,CAE5D"}