cc-pipeline 0.7.0 → 0.7.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cc-pipeline",
-  "version": "0.7.0",
+  "version": "0.7.2",
   "description": "Autonomous Claude Code pipeline engine. Install into any repo, write a BRIEF.md, and let Claude build your project phase by phase.",
   "type": "module",
   "bin": {

package/src/config.ts

@@ -19,6 +19,7 @@ export interface PipelineConfig {
   name: string;
   version: number;
   phasesDir: string;
+  maxPhases: number;
   steps: StepConfig[];
   usageCheck: { when: string };
   usageLimits: { sessionBudgetUSD: number; weeklyBudgetUSD: number };
@@ -45,6 +46,7 @@ export function loadConfig(projectDir: string): PipelineConfig {
     name: raw.name || 'Unnamed Pipeline',
     version: raw.version || 1,
     phasesDir: raw.phases_dir || 'docs/phases',
+    maxPhases: raw.max_phases ?? 100,
     steps: [],
     usageCheck: raw.usage_check || { when: 'phase_boundary' },
     usageLimits: {

package/src/engine.ts

@@ -10,7 +10,7 @@ import { CodexAgent } from './agents/codex.js';
 import { pipelineEvents } from './events.js';
 import { computeUsagePercentages } from './usage.js';
 
-const MAX_PHASES = 20;
+const DEFAULT_MAX_PHASES = 100;
 
 /**
  * Main pipeline engine loop.
@@ -21,7 +21,7 @@ const MAX_PHASES = 20;
  * - Print banner
  * - Loop through phases, executing steps
  * - Check for PROJECT COMPLETE in reflections
- * - Handle phase limits and MAX_PHASES
+ * - Handle phase limits and maxPhases
  * - Signal handling for clean shutdown
  */
 export async function runEngine(projectDir: string, options: any = {}) {
@@ -40,6 +40,7 @@ export async function runEngine(projectDir: string, options: any = {}) {
 
   // Load config
   const config = loadConfig(projectDir);
+  const maxPhases = config.maxPhases ?? DEFAULT_MAX_PHASES;
 
   // Derive current state
   const state = getCurrentState(logFile);
@@ -110,7 +111,7 @@ export async function runEngine(projectDir: string, options: any = {}) {
 
     const phaseLimit = options.phases || 0;
 
-    while (phase <= MAX_PHASES) {
+    while (phase <= maxPhases) {
       pipelineEvents.emit('phase:start', { phase });
 
       // Execute all steps in phase
@@ -221,7 +222,7 @@ export async function runEngine(projectDir: string, options: any = {}) {
       }
     }
 
-    log(`Hit MAX_PHASES (${MAX_PHASES}). Stopping.`);
+    log(`Hit max phases (${maxPhases}). Stopping.`);
   } finally {
     cleanup();
   }

package/src/state.test.ts

@@ -357,6 +357,46 @@ test('deriveResumePoint: advance to next phase after last step', () => {
   rmSync(tempDir, { recursive: true });
 });
 
+test('getCurrentState: project_complete returns done state (same as phase_complete)', () => {
+  const tempDir = mkdtempSync(join(tmpdir(), 'cc-pipeline-test-'));
+  const logFile = join(tempDir, 'pipeline.jsonl');
+
+  const events = [
+    { event: 'step_start', phase: 34, step: 'groom', ts: '2025-01-01T00:00:00Z' },
+    { event: 'step_done', phase: 34, step: 'groom', status: 'ok', ts: '2025-01-01T00:01:00Z' },
+    { event: 'project_complete', phase: 34, ts: '2025-01-01T00:02:00Z' },
+  ];
+  writeFileSync(logFile, events.map(e => JSON.stringify(e)).join('\n') + '\n', 'utf8');
+
+  const state = getCurrentState(logFile);
+
+  assert.strictEqual(state.phase, 34);
+  assert.strictEqual(state.step, 'done');
+  assert.strictEqual(state.status, 'complete');
+
+  rmSync(tempDir, { recursive: true });
+});
+
+test('deriveResumePoint: project_complete advances to next phase first step', () => {
+  const tempDir = mkdtempSync(join(tmpdir(), 'cc-pipeline-test-'));
+  const logFile = join(tempDir, 'pipeline.jsonl');
+
+  const events = [
+    { event: 'step_start', phase: 34, step: 'spec', ts: '2025-01-01T00:00:00Z' },
+    { event: 'step_done', phase: 34, step: 'spec', status: 'ok', ts: '2025-01-01T00:01:00Z' },
+    { event: 'project_complete', phase: 34, ts: '2025-01-01T00:02:00Z' },
+  ];
+  writeFileSync(logFile, events.map(e => JSON.stringify(e)).join('\n') + '\n', 'utf8');
+
+  const resume = deriveResumePoint(logFile, mockSteps);
+
+  // project_complete is treated as phase_complete — next run starts fresh in the next phase
+  assert.strictEqual(resume.phase, 35);
+  assert.strictEqual(resume.stepName, 'spec');
+
+  rmSync(tempDir, { recursive: true });
+});
+
 test('deriveResumePoint: handles unknown step by starting from beginning', () => {
   const tempDir = mkdtempSync(join(tmpdir(), 'cc-pipeline-test-'));
   const logFile = join(tempDir, 'pipeline.jsonl');

package/src/state.ts

@@ -75,7 +75,7 @@ export function getCurrentState(logFile: string): { phase: number; step: string;
   }
 
   // Find last relevant event
-  const relevantEvents = ['step_start', 'step_done', 'step_skip', 'phase_complete'];
+  const relevantEvents = ['step_start', 'step_done', 'step_skip', 'phase_complete', 'project_complete'];
   const lastEvent = events
     .filter(e => relevantEvents.includes(e.event))
     .pop();
@@ -98,6 +98,11 @@ export function getCurrentState(logFile: string): { phase: number; step: string;
     case 'step_skip':
       return { phase, step, status: 'complete' };
     case 'phase_complete':
+    case 'project_complete':
+      // Treat project_complete the same as phase_complete — resume starts at next phase.
+      // This ensures that if the user adds new Epics after completion and reruns, the
+      // engine advances to the next phase and runs groom fresh rather than resuming
+      // mid-phase after the groom step.
       return { phase, step: 'done', status: 'complete' };
     default:
       return { phase: 1, step: 'pending', status: 'ready' };

package/templates/pipeline/prompts/groom.md

@@ -14,6 +14,12 @@ Current phase: {{PHASE}}
 
 ## Determine Your Mode
 
+> **Always scan `docs/epics/` before deciding.** Read every file there.
+> A "draft" Epic has a Goal + Acceptance Criteria but an empty or missing
+> `## Research & Decisions` section. If ANY draft Epic exists — even if
+> NEXT.md says "Next: none" or is empty — treat this as Mode 2 (Transition).
+> Only write PROJECT COMPLETE when you have confirmed zero draft Epics remain.
+
 ### Mode 1: Bootstrap (Phase 1, no Epics exist)
 
 If `docs/epics/` doesn't exist or is empty: