ai-spec-dev 0.58.0 → 0.60.0

package/README.md

@@ -12,7 +12,7 @@
 <p align="center">
   <a href="https://github.com/hzhongzhong/ai-spec"><img src="https://img.shields.io/badge/GitHub-ai--spec-181717?logo=github" alt="GitHub" /></a>
   <a href="https://www.npmjs.com/package/ai-spec-dev"><img src="https://img.shields.io/npm/v/ai-spec-dev?color=cb3837&logo=npm" alt="npm" /></a>
-  <img src="https://img.shields.io/badge/version-0.58.0-blue" alt="version" />
+  <img src="https://img.shields.io/badge/version-0.60.0-blue" alt="version" />
   <img src="https://img.shields.io/badge/tests-913%20passed-brightgreen" alt="tests" />
   <img src="https://img.shields.io/badge/providers-9-orange" alt="providers" />
   <img src="https://img.shields.io/badge/license-MIT-green" alt="license" />

package/cli/pipeline/single-repo.ts

@@ -159,7 +159,7 @@ export async function runSingleRepoPipeline(
   runLogger.setPromptHash(promptHash);
 
   // ── Step 1: Context ─────────────────────────────────────────────────────
-  console.log(chalk.blue("[1/6] Loading project context..."));
+  console.log(chalk.bold("[1/10] Loading project context..."));
   runLogger.stageStart("context_load");
   const loader = new ContextLoader(currentDir);
   const context = await loader.loadProjectContext();
@@ -211,7 +211,7 @@ export async function runSingleRepoPipeline(
   }
 
   // ── Step 2: Spec + Tasks Generation (single AI call) ───────────────────
-  console.log(chalk.blue(`\n[2/6] Generating spec with ${specProviderName}/${specModelName}...`));
+  console.log(chalk.bold(`\n[2/10] Generating spec with ${specProviderName}/${specModelName}...`));
   let specProvider: AIProvider = vcrReplayProvider ?? createProvider(specProviderName, specApiKey, specModelName);
   if (!vcrReplayProvider && opts.vcrRecord) {
     specVcrRecorder = new VcrRecordingProvider(specProvider);
@@ -251,10 +251,10 @@ export async function runSingleRepoPipeline(
   // ── Step 3: Interactive Refinement ──────────────────────────────────────
   let finalSpec: string;
   if (opts.fast) {
-    console.log(chalk.gray("\n[3/6] Skipping refinement (--fast)."));
+    console.log(chalk.gray("\n[3/10] Skipping refinement (--fast)."));
     finalSpec = initialSpec;
   } else {
-    console.log(chalk.blue("\n[3/6] Interactive spec refinement..."));
+    console.log(chalk.bold("\n[3/10] Interactive spec refinement..."));
     runLogger.stageStart("spec_refine");
     const refiner = new SpecRefiner(specProvider);
     finalSpec = await refiner.refineLoop(initialSpec);
@@ -269,7 +269,7 @@ export async function runSingleRepoPipeline(
 
   if (shouldRunAssessment) {
     if (!opts.auto) {
-      console.log(chalk.blue("\n[3.4/6] Spec quality assessment..."));
+      console.log(chalk.bold("\n[3.4/10] Spec quality assessment..."));
     }
     runLogger.stageStart("spec_assess");
     const assessSpinner = startStage("spec_assess", "Evaluating spec quality...");
@@ -304,7 +304,7 @@ export async function runSingleRepoPipeline(
 
   // ── Step 3.5: Approval Gate ─────────────────────────────────────────────
   if (!opts.auto) {
-    console.log(chalk.blue("\n[3.5/6] Approval Gate — review before code generation"));
+    console.log(chalk.bold("\n[Gate] Approval Gate — review before code generation"));
 
     const specLines = finalSpec.split("\n").length;
     const specWords = finalSpec.split(/\s+/).length;
@@ -366,7 +366,7 @@ export async function runSingleRepoPipeline(
 
     console.log(chalk.green("  ✔ Approved — continuing to code generation."));
   } else {
-    console.log(chalk.gray("[3.5/6] Approval Gate: skipped (--auto)."));
+    console.log(chalk.gray("[Gate] Approval Gate: skipped (--auto)."));
   }
 
   // ── Step 3.8: DSL Extraction + Validation ──────────────────────────────
@@ -375,7 +375,7 @@ export async function runSingleRepoPipeline(
   if (opts.skipDsl) {
     console.log(chalk.gray("\n[DSL] Skipped (--skip-dsl)."));
   } else {
-    console.log(chalk.blue("\n[DSL] Extracting structured DSL from spec..."));
+    console.log(chalk.bold("\n[DSL] Extracting structured DSL from spec..."));
     console.log(chalk.gray(`  Provider: ${specProviderName}/${specModelName}`));
     runLogger.stageStart("dsl_extract");
     const dslSpinner = startStage("dsl_extract", "Extracting DSL from spec...");
@@ -480,7 +480,7 @@ export async function runSingleRepoPipeline(
 
   let workingDir = currentDir;
   if (!skipWorktree) {
-    console.log(chalk.blue("\n[4/6] Setting up git worktree..."));
+    console.log(chalk.bold("\n[Git] Setting up git worktree..."));
     const worktreeManager = new GitWorktreeManager(currentDir);
     const worktreePath = await worktreeManager.createWorktree(idea);
     if (worktreePath) workingDir = worktreePath;
@@ -490,7 +490,7 @@ export async function runSingleRepoPipeline(
       : isFrontendProject
       ? " (frontend project — use --worktree to override)"
       : " (--skip-worktree)";
-    console.log(chalk.gray(`[4/6] Skipping worktree${reason}.`));
+    console.log(chalk.gray(`[Git] Skipping worktree${reason}.`));
   }
 
   // ── Step 5: Save Spec (versioned) + Generate Tasks ──────────────────────
@@ -499,7 +499,7 @@ export async function runSingleRepoPipeline(
 
   const { filePath: specFile, version: specVersion } = await nextVersionPath(specsDir, featureSlug);
   await fs.writeFile(specFile, finalSpec, "utf-8");
-  console.log(chalk.green(`\n[5/6] ✔ Spec saved: ${specFile}`) + chalk.gray(` (v${specVersion})`));
+  console.log(chalk.green(`\n  ✔ Spec saved: ${specFile}`) + chalk.gray(` (v${specVersion})`));
 
   let savedDslFile: string | null = null;
   if (extractedDsl) {
@@ -550,7 +550,7 @@ export async function runSingleRepoPipeline(
   }
 
   // ── Step 6: Code Generation ─────────────────────────────────────────────
-  console.log(chalk.blue(`\n[6/6] Code generation (mode: ${codegenMode})...`));
+  console.log(chalk.bold(`\n[6/10] Code generation (mode: ${codegenMode})...`));
   const rawCodegenProvider: AIProvider =
     codegenProviderName === specProviderName && codegenApiKey === specApiKey
       ? specProvider
@@ -646,13 +646,13 @@ export async function runSingleRepoPipeline(
 
   // ── Step 7: Test Skeleton Generation ───────────────────────────────────
   if (opts.tdd) {
-    console.log(chalk.gray("\n[7/9] TDD mode — test files already written pre-implementation."));
+    console.log(chalk.gray("\n[7/10] TDD mode — test files already written pre-implementation."));
   } else if (opts.skipTests) {
-    console.log(chalk.gray("\n[7/9] Skipping test generation (--skip-tests)."));
+    console.log(chalk.gray("\n[7/10] Skipping test generation (--skip-tests)."));
   } else if (!extractedDsl) {
-    console.log(chalk.gray("\n[7/9] Skipping test generation (no DSL available)."));
+    console.log(chalk.gray("\n[7/10] Skipping test generation (no DSL available)."));
   } else {
-    console.log(chalk.blue(`\n[7/9] Test skeleton generation...`));
+    console.log(chalk.bold(`\n[7/10] Test skeleton generation...`));
     runLogger.stageStart("test_gen");
     const testGen = new TestGenerator(codegenProvider);
     generatedTestFiles = await testGen.generate(extractedDsl, workingDir);
@@ -662,11 +662,11 @@ export async function runSingleRepoPipeline(
   // ── Step 8: Error Feedback Loop ─────────────────────────────────────────
   let compilePassed = false;
   if (opts.skipErrorFeedback) {
-    console.log(chalk.gray("[8/9] Skipping error feedback (--skip-error-feedback)."));
+    console.log(chalk.gray("[8/10] Skipping error feedback (--skip-error-feedback)."));
     compilePassed = true;
   } else {
     if (opts.tdd) {
-      console.log(chalk.cyan("[8/9] TDD mode — error feedback loop driving implementation to pass tests..."));
+      console.log(chalk.cyan("[8/10] TDD mode — error feedback loop driving implementation to pass tests..."));
     }
     runLogger.stageStart("error_feedback");
     const defaultCycles = opts.tdd ? 3 : 2;
@@ -682,7 +682,7 @@ export async function runSingleRepoPipeline(
   let reviewResult = "";
   let accumulatePromise: Promise<void> | undefined;
   if (!opts.skipReview) {
-    console.log(chalk.blue("\n[9/9] Automated code review (3-pass: architecture + implementation + impact/complexity)..."));
+    console.log(chalk.bold("\n[9/10] Automated code review (3-pass: architecture + implementation + impact/complexity)..."));
     runLogger.stageStart("review");
     const reviewSpinner = startStage("review", "Running 3-pass code review...");
     const reviewer = new CodeReviewer(specProvider, workingDir);
@@ -789,6 +789,7 @@ export async function runSingleRepoPipeline(
   }
 
   // ── Step 10: Harness Self-Evaluation ────────────────────────────────────
+  console.log(chalk.bold("\n[10/10] Harness Self-Evaluation..."));
   runLogger.stageStart("self_eval");
   const selfEvalResult = runSelfEval({
     dsl: extractedDsl,

package/demo/demo.tape

@@ -10,43 +10,34 @@ Set Padding 24
 Set FontFamily "JetBrains Mono"
 Set PlaybackSpeed 1.0
 
-# ── Opening ────────────────────────────────────────────────────────────────────
+# ── Scene 1: help ──────────────────────────────────────────────────────────────
 Sleep 500ms
 Type "ai-spec --help"
-Sleep 300ms
 Enter
-Sleep 3s
+Sleep 5s
 
 # ── Scene 2: single-repo create pipeline ──────────────────────────────────────
-Sleep 800ms
-Type "ai-spec create 'Add task management feature to Vue admin'"
-Sleep 300ms
-Enter
-Sleep 300ms
+Sleep 500ms
 Type "bash demo.sh create"
 Enter
-Sleep 40s
+Sleep 50s
 
 # ── Scene 3: multi-repo workspace ─────────────────────────────────────────────
-Sleep 800ms
-Type "ai-spec create 'Add user profile sync' --workspace"
-Sleep 300ms
-Enter
-Sleep 300ms
+Sleep 500ms
 Type "bash demo.sh multirepo"
 Enter
-Sleep 14s
+Sleep 20s
 
 # ── Scene 4: DSL artifacts ─────────────────────────────────────────────────────
-Sleep 800ms
+Sleep 500ms
 Type "bash demo.sh artifacts"
 Enter
-Sleep 10s
+Sleep 16s
 
 # ── Scene 5: observability ─────────────────────────────────────────────────────
-Sleep 800ms
+Sleep 500ms
 Type "bash demo.sh observability"
 Enter
-Sleep 8s
+Sleep 12s
 
 Sleep 2s

package/dist/cli/index.js

@@ -715,7 +715,7 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "ai-spec-dev",
-      version: "0.56.0",
+      version: "0.59.0",
       description: "AI-driven Development Orchestrator SDK & CLI",
       main: "dist/index.js",
       types: "dist/index.d.ts",
@@ -13527,7 +13527,7 @@ async function runSingleRepoPipeline(idea, opts, currentDir, config2) {
   setActiveLogger(runLogger);
   const promptHash = computePromptHash();
   runLogger.setPromptHash(promptHash);
-  console.log(import_chalk28.default.blue("[1/6] Loading project context..."));
+  console.log(import_chalk28.default.bold("[1/10] Loading project context..."));
   runLogger.stageStart("context_load");
   const loader = new ContextLoader(currentDir);
   const context = await loader.loadProjectContext();
@@ -13575,8 +13575,8 @@ async function runSingleRepoPipeline(idea, opts, currentDir, config2) {
       approach: choice.selectedApproach?.slice(0, 80)
     });
   }
-  console.log(import_chalk28.default.blue(`
-[2/6] Generating spec with ${specProviderName}/${specModelName}...`));
+  console.log(import_chalk28.default.bold(`
+[2/10] Generating spec with ${specProviderName}/${specModelName}...`));
   let specProvider = vcrReplayProvider ?? createProvider(specProviderName, specApiKey, specModelName);
   if (!vcrReplayProvider && opts.vcrRecord) {
     specVcrRecorder = new VcrRecordingProvider(specProvider);
@@ -13612,10 +13612,10 @@ async function runSingleRepoPipeline(idea, opts, currentDir, config2) {
   }
   let finalSpec;
   if (opts.fast) {
-    console.log(import_chalk28.default.gray("\n[3/6] Skipping refinement (--fast)."));
+    console.log(import_chalk28.default.gray("\n[3/10] Skipping refinement (--fast)."));
     finalSpec = initialSpec;
   } else {
-    console.log(import_chalk28.default.blue("\n[3/6] Interactive spec refinement..."));
+    console.log(import_chalk28.default.bold("\n[3/10] Interactive spec refinement..."));
     runLogger.stageStart("spec_refine");
     const refiner = new SpecRefiner(specProvider);
     finalSpec = await refiner.refineLoop(initialSpec);
@@ -13626,7 +13626,7 @@ async function runSingleRepoPipeline(idea, opts, currentDir, config2) {
   const shouldRunAssessment = !opts.skipAssessment && (!opts.auto || minScore > 0);
   if (shouldRunAssessment) {
     if (!opts.auto) {
-      console.log(import_chalk28.default.blue("\n[3.4/6] Spec quality assessment..."));
+      console.log(import_chalk28.default.bold("\n[3.4/10] Spec quality assessment..."));
     }
     runLogger.stageStart("spec_assess");
     const assessSpinner = startStage("spec_assess", "Evaluating spec quality...");
@@ -13660,7 +13660,7 @@ async function runSingleRepoPipeline(idea, opts, currentDir, config2) {
     }
   }
   if (!opts.auto) {
-    console.log(import_chalk28.default.blue("\n[3.5/6] Approval Gate \u2014 review before code generation"));
+    console.log(import_chalk28.default.bold("\n[Gate] Approval Gate \u2014 review before code generation"));
     const specLines = finalSpec.split("\n").length;
     const specWords = finalSpec.split(/\s+/).length;
     const taskCountHint = initialTasks.length > 0 ? `  Tasks generated : ${initialTasks.length}` : "";
@@ -13714,13 +13714,13 @@ async function runSingleRepoPipeline(idea, opts, currentDir, config2) {
     }
     console.log(import_chalk28.default.green("  \u2714 Approved \u2014 continuing to code generation."));
   } else {
-    console.log(import_chalk28.default.gray("[3.5/6] Approval Gate: skipped (--auto)."));
+    console.log(import_chalk28.default.gray("[Gate] Approval Gate: skipped (--auto)."));
   }
   let extractedDsl = null;
   if (opts.skipDsl) {
     console.log(import_chalk28.default.gray("\n[DSL] Skipped (--skip-dsl)."));
   } else {
-    console.log(import_chalk28.default.blue("\n[DSL] Extracting structured DSL from spec..."));
+    console.log(import_chalk28.default.bold("\n[DSL] Extracting structured DSL from spec..."));
     console.log(import_chalk28.default.gray(`  Provider: ${specProviderName}/${specModelName}`));
     runLogger.stageStart("dsl_extract");
     const dslSpinner = startStage("dsl_extract", "Extracting DSL from spec...");
@@ -13812,20 +13812,20 @@ async function runSingleRepoPipeline(idea, opts, currentDir, config2) {
   const skipWorktree = opts.worktree ? false : opts.skipWorktree || isFrontendProject2;
   let workingDir = currentDir;
   if (!skipWorktree) {
-    console.log(import_chalk28.default.blue("\n[4/6] Setting up git worktree..."));
+    console.log(import_chalk28.default.bold("\n[Git] Setting up git worktree..."));
     const worktreeManager = new GitWorktreeManager(currentDir);
     const worktreePath = await worktreeManager.createWorktree(idea);
     if (worktreePath) workingDir = worktreePath;
   } else {
     const reason = opts.worktree ? "" : isFrontendProject2 ? " (frontend project \u2014 use --worktree to override)" : " (--skip-worktree)";
-    console.log(import_chalk28.default.gray(`[4/6] Skipping worktree${reason}.`));
+    console.log(import_chalk28.default.gray(`[Git] Skipping worktree${reason}.`));
   }
   const specsDir = path30.join(workingDir, "specs");
   await fs31.ensureDir(specsDir);
   const { filePath: specFile, version: specVersion } = await nextVersionPath(specsDir, featureSlug);
   await fs31.writeFile(specFile, finalSpec, "utf-8");
   console.log(import_chalk28.default.green(`
-[5/6] \u2714 Spec saved: ${specFile}`) + import_chalk28.default.gray(` (v${specVersion})`));
+  \u2714 Spec saved: ${specFile}`) + import_chalk28.default.gray(` (v${specVersion})`));
   let savedDslFile = null;
   if (extractedDsl) {
     const dslExtractor = new DslExtractor(specProvider);
@@ -13869,8 +13869,8 @@ async function runSingleRepoPipeline(idea, opts, currentDir, config2) {
       console.log(import_chalk28.default.yellow("  \u26A0 No tasks generated \u2014 code generation will use fallback file planning."));
     }
   }
-  console.log(import_chalk28.default.blue(`
-[6/6] Code generation (mode: ${codegenMode})...`));
+  console.log(import_chalk28.default.bold(`
+[6/10] Code generation (mode: ${codegenMode})...`));
   const rawCodegenProvider = codegenProviderName === specProviderName && codegenApiKey === specApiKey ? specProvider : createProvider(codegenProviderName, codegenApiKey, codegenModelName);
   let codegenProvider;
   if (!vcrReplayProvider && opts.vcrRecord && !(rawCodegenProvider instanceof VcrRecordingProvider)) {
@@ -13946,14 +13946,14 @@ async function runSingleRepoPipeline(idea, opts, currentDir, config2) {
     }
   }
   if (opts.tdd) {
-    console.log(import_chalk28.default.gray("\n[7/9] TDD mode \u2014 test files already written pre-implementation."));
+    console.log(import_chalk28.default.gray("\n[7/10] TDD mode \u2014 test files already written pre-implementation."));
   } else if (opts.skipTests) {
-    console.log(import_chalk28.default.gray("\n[7/9] Skipping test generation (--skip-tests)."));
+    console.log(import_chalk28.default.gray("\n[7/10] Skipping test generation (--skip-tests)."));
   } else if (!extractedDsl) {
-    console.log(import_chalk28.default.gray("\n[7/9] Skipping test generation (no DSL available)."));
+    console.log(import_chalk28.default.gray("\n[7/10] Skipping test generation (no DSL available)."));
   } else {
-    console.log(import_chalk28.default.blue(`
-[7/9] Test skeleton generation...`));
+    console.log(import_chalk28.default.bold(`
+[7/10] Test skeleton generation...`));
     runLogger.stageStart("test_gen");
     const testGen = new TestGenerator(codegenProvider);
     generatedTestFiles = await testGen.generate(extractedDsl, workingDir);
@@ -13961,11 +13961,11 @@ async function runSingleRepoPipeline(idea, opts, currentDir, config2) {
   }
   let compilePassed = false;
   if (opts.skipErrorFeedback) {
-    console.log(import_chalk28.default.gray("[8/9] Skipping error feedback (--skip-error-feedback)."));
+    console.log(import_chalk28.default.gray("[8/10] Skipping error feedback (--skip-error-feedback)."));
     compilePassed = true;
   } else {
     if (opts.tdd) {
-      console.log(import_chalk28.default.cyan("[8/9] TDD mode \u2014 error feedback loop driving implementation to pass tests..."));
+      console.log(import_chalk28.default.cyan("[8/10] TDD mode \u2014 error feedback loop driving implementation to pass tests..."));
     }
     runLogger.stageStart("error_feedback");
     const defaultCycles = opts.tdd ? 3 : 2;
@@ -13979,7 +13979,7 @@ async function runSingleRepoPipeline(idea, opts, currentDir, config2) {
   let reviewResult = "";
   let accumulatePromise;
   if (!opts.skipReview) {
-    console.log(import_chalk28.default.blue("\n[9/9] Automated code review (3-pass: architecture + implementation + impact/complexity)..."));
+    console.log(import_chalk28.default.bold("\n[9/10] Automated code review (3-pass: architecture + implementation + impact/complexity)..."));
     runLogger.stageStart("review");
     const reviewSpinner = startStage("review", "Running 3-pass code review...");
     const reviewer = new CodeReviewer(specProvider, workingDir);
@@ -14065,6 +14065,7 @@ async function runSingleRepoPipeline(idea, opts, currentDir, config2) {
       }
     }
   }
+  console.log(import_chalk28.default.bold("\n[10/10] Harness Self-Evaluation..."));
   runLogger.stageStart("self_eval");
   const selfEvalResult = runSelfEval({
     dsl: extractedDsl,