@zhuan-ai/zhuanspec 2.15.6 → 2.15.7

package/dist/cli/index.js

@@ -272,7 +272,7 @@ progressCmd
 // Progress set-phase subcommand
 progressCmd
     .command('set-phase <change-id> <phase>')
-    .description('Set phase for a change (e.g., propose, apply, review, archive)')
+    .description('Set phase for a change (idle, techDesign, propose, apply, review, archive). Workflow-entry phases (idle/techDesign/propose) auto-create the change directory if missing.')
     .action(async (changeId, phase) => {
     try {
         const progressCommand = new ProgressCommand();

package/dist/commands/progress.d.ts

@@ -32,6 +32,10 @@ export declare class ProgressCommand {
     /**
      * Set phase for a change
      * Usage: zhuanspec progress set-phase <change-id> <phase>
+     *
+     * Workflow-entry phases (idle/techDesign/propose) auto-create the change
+     * directory if it does not exist; later phases (apply/review/archive)
+     * require the directory to already exist to avoid typo-creating ghost dirs.
      */
     setPhase(changeId: string, phase: string): Promise<void>;
     /**

package/dist/commands/progress.js

@@ -350,19 +350,30 @@ export class ProgressCommand {
     /**
      * Set phase for a change
      * Usage: zhuanspec progress set-phase <change-id> <phase>
+     *
+     * Workflow-entry phases (idle/techDesign/propose) auto-create the change
+     * directory if it does not exist; later phases (apply/review/archive)
+     * require the directory to already exist to avoid typo-creating ghost dirs.
      */
     async setPhase(changeId, phase) {
+        // Validate phase first (fail fast on user typos so we don't surface
+        // misleading "Change not found" errors when the real issue is the phase name).
+        // Match case-insensitively but keep the canonical casing from PHASE_ORDER
+        // (e.g. user input 'techdesign' / 'TECHDESIGN' / 'techDesign' all map to 'techDesign').
+        const normalizedPhase = PHASE_ORDER.find(p => p.toLowerCase() === phase.toLowerCase());
+        if (!normalizedPhase) {
+            throw new Error(`Invalid phase: ${phase}. Valid phases: ${PHASE_ORDER.join(', ')}`);
+        }
         const cwd = resolveZhuanSpecRoot();
         const changeDir = path.join(cwd, 'zhuanspec', 'changes', changeId);
-        if (!await FileSystemUtils.directoryExists(changeDir)) {
+        const dirExists = await FileSystemUtils.directoryExists(changeDir);
+        // Workflow-entry phases may create the change directory; later phases must not.
+        const ENTRY_PHASES = ['idle', 'techDesign', 'propose'];
+        if (!dirExists && !ENTRY_PHASES.includes(normalizedPhase)) {
             throw new Error(`Change '${changeId}' not found`);
         }
-        // Validate phase
-        const normalizedPhase = phase.toLowerCase();
-        if (!PHASE_ORDER.includes(normalizedPhase)) {
-            throw new Error(`Invalid phase: ${phase}. Valid phases: ${PHASE_ORDER.join(', ')}`);
-        }
-        // Update progress.json
+        // Update progress.json (initializeProgress creates metrics/ recursively,
+        // which also creates the change directory itself when missing).
         await initializeProgress(changeId, normalizedPhase);
         // Read and display result
         const progressPath = path.join(changeDir, 'metrics', 'progress.json');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhuan-ai/zhuanspec",
-  "version": "2.15.6",
+  "version": "2.15.7",
   "description": "AI-native system for spec-driven development",
   "keywords": [
     "zhuanspec",