specweave 0.32.2 → 0.32.3

package/dist/src/adapters/codex/adapter.js

@@ -279,7 +279,7 @@ COMPARISON:
 | **Skills** | Native | Via AGENTS.md |
 | **Agents** | Native | Via AGENTS.md |
 | **Access** | CLI only | CLI + Web + IDE + GitHub + iOS |
-| **Model** | Sonnet 4.5 | GPT-5-Codex |
+| **Model** | Opus 4.5 | GPT-5-Codex |
 | **Task Isolation** | No | Yes (isolated environments) |
 
 LIMITATIONS:

package/dist/src/cli/commands/archive.d.ts

@@ -4,6 +4,8 @@
  * Archives increments to .specweave/increments/_archive/ and automatically
  * archives corresponding features in:
  * - .specweave/docs/internal/specs/{project}/_archive/
+ *
+ * v0.33.0: Added --external flag for archiving external living docs (FS-XXXE)
  */
 export declare function archiveCommand(incrementIds: string[], options: any): Promise<void>;
 //# sourceMappingURL=archive.d.ts.map

package/dist/src/cli/commands/archive.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"archive.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/archive.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,wBAAsB,cAAc,CAAC,YAAY,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAuExF"}
+{"version":3,"file":"archive.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/archive.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,wBAAsB,cAAc,CAAC,YAAY,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CA6GxF"}

package/dist/src/cli/commands/archive.js

@@ -4,11 +4,44 @@
  * Archives increments to .specweave/increments/_archive/ and automatically
  * archives corresponding features in:
  * - .specweave/docs/internal/specs/{project}/_archive/
+ *
+ * v0.33.0: Added --external flag for archiving external living docs (FS-XXXE)
  */
 import chalk from 'chalk';
 import { IncrementArchiver } from '../../core/increment/increment-archiver.js';
+import { FeatureArchiver } from '../../core/living-docs/feature-archiver.js';
 export async function archiveCommand(incrementIds, options) {
     try {
+        // ================================================================
+        // EXTERNAL MODE: Archive external living docs (FS-XXXE features)
+        // ================================================================
+        if (options.external) {
+            console.log(chalk.blue('📦 External living docs archive mode\n'));
+            const featureArchiver = new FeatureArchiver(process.cwd());
+            // Filter feature IDs (FS-*E pattern only)
+            const featureIds = incrementIds.filter(id => /^FS-\d+E$/.test(id));
+            const externalOptions = {
+                featureIds: featureIds.length > 0 ? featureIds : undefined,
+                olderThanDays: options.olderThan ? parseInt(options.olderThan) : undefined,
+                keepLast: options.keepLast ? parseInt(options.keepLast) : undefined,
+                dryRun: options.dryRun,
+                updateLinks: true
+            };
+            const result = await featureArchiver.archiveExternalFeatures(externalOptions);
+            console.log(chalk.green(`\n✅ External archive complete:`));
+            console.log(`   Archived: ${result.archivedFeatures.length} features`);
+            if (result.archivedFeatures.length > 0) {
+                result.archivedFeatures.forEach(f => console.log(`   - ${f}`));
+            }
+            if (result.errors.length > 0) {
+                console.log(chalk.red(`   Errors: ${result.errors.length}`));
+                result.errors.forEach(e => console.log(`   - ${e}`));
+            }
+            return;
+        }
+        // ================================================================
+        // INCREMENT MODE: Archive completed increments (default)
+        // ================================================================
         console.log(chalk.blue('📦 Archiving increments...\n'));
         const archiver = new IncrementArchiver(process.cwd());
         // Parse options

package/dist/src/cli/commands/archive.js.map

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

package/dist/src/cli/commands/context.d.ts

@@ -0,0 +1,92 @@
+/**
+ * CLI Context Command
+ *
+ * Provides project/board context for increment planning.
+ * Used by Claude Code agents to get valid project/board values
+ * before generating spec.md files.
+ *
+ * @module cli/commands/context
+ */
+import { StructureLevelConfig, ProjectInfo, BoardInfo } from '../../utils/structure-level-detector.js';
+/**
+ * Output format for projects subcommand
+ */
+interface ProjectsOutput {
+    /** Structure level (1 or 2) */
+    level: 1 | 2;
+    /** Available projects */
+    projects: ProjectInfo[];
+    /** Available boards organized by project (only for 2-level) */
+    boardsByProject?: Record<string, BoardInfo[]>;
+    /** Detection reason for debugging */
+    detectionReason: string;
+    /** Source of configuration */
+    source: string;
+}
+/**
+ * Output format for boards subcommand
+ */
+interface BoardsOutput {
+    /** Project ID that boards belong to */
+    project: string;
+    /** Available boards for the project */
+    boards: BoardInfo[];
+    /** Warning if 1-level structure (no boards) */
+    warning?: string;
+}
+/**
+ * Output format for select subcommand
+ */
+interface SelectOutput {
+    /** Selected project and board */
+    selected: {
+        project: string;
+        board?: string;
+    };
+    /** Whether selection was automatic (single option) */
+    autoSelected: boolean;
+    /** Structure level */
+    level: 1 | 2;
+}
+/**
+ * Get all available projects and structure level
+ * Used by Claude before generating spec.md
+ *
+ * @param projectRoot - Path to project root
+ * @returns JSON-serializable projects context
+ */
+export declare function getProjectsContext(projectRoot?: string): ProjectsOutput;
+/**
+ * Get boards for a specific project
+ *
+ * @param projectId - Project ID to get boards for
+ * @param projectRoot - Path to project root
+ * @returns JSON-serializable boards context
+ */
+export declare function getBoardsContext(projectId: string, projectRoot?: string): BoardsOutput;
+/**
+ * Auto-select or prompt for project/board selection
+ *
+ * @param config - Structure level config
+ * @returns Selection result with auto-select flag
+ */
+export declare function autoSelectProjectBoard(config: StructureLevelConfig): SelectOutput;
+/**
+ * CLI handler for 'specweave context projects' command
+ */
+export declare function contextProjectsCommand(): Promise<void>;
+/**
+ * CLI handler for 'specweave context boards' command
+ *
+ * @param options - Command options with project ID
+ */
+export declare function contextBoardsCommand(options: {
+    project?: string;
+}): Promise<void>;
+/**
+ * CLI handler for 'specweave context select' command
+ * Returns auto-selected values or prompts interactively
+ */
+export declare function contextSelectCommand(): Promise<void>;
+export {};
+//# sourceMappingURL=context.d.ts.map

package/dist/src/cli/commands/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/context.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAEL,oBAAoB,EACpB,WAAW,EACX,SAAS,EACV,MAAM,yCAAyC,CAAC;AAEjD;;GAEG;AACH,UAAU,cAAc;IACtB,+BAA+B;IAC/B,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC;IACb,yBAAyB;IACzB,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,+DAA+D;IAC/D,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;IAC9C,qCAAqC;IACrC,eAAe,EAAE,MAAM,CAAC;IACxB,8BAA8B;IAC9B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,UAAU,YAAY;IACpB,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,UAAU,YAAY;IACpB,iCAAiC;IACjC,QAAQ,EAAE;QACR,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,sDAAsD;IACtD,YAAY,EAAE,OAAO,CAAC;IACtB,sBAAsB;IACtB,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC;CACd;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,GAAE,MAAsB,GAAG,cAAc,CAgBtF;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,EACjB,WAAW,GAAE,MAAsB,GAClC,YAAY,CA8Bd;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,oBAAoB,GAC3B,YAAY,CAoDd;AAED;;GAEG;AACH,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC,CAG5D;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAqBvF;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CA2D1D"}

package/dist/src/cli/commands/context.js

@@ -0,0 +1,205 @@
+/**
+ * CLI Context Command
+ *
+ * Provides project/board context for increment planning.
+ * Used by Claude Code agents to get valid project/board values
+ * before generating spec.md files.
+ *
+ * @module cli/commands/context
+ */
+import { detectStructureLevel } from '../../utils/structure-level-detector.js';
+/**
+ * Get all available projects and structure level
+ * Used by Claude before generating spec.md
+ *
+ * @param projectRoot - Path to project root
+ * @returns JSON-serializable projects context
+ */
+export function getProjectsContext(projectRoot = process.cwd()) {
+    const config = detectStructureLevel(projectRoot);
+    const output = {
+        level: config.level,
+        projects: config.projects,
+        detectionReason: config.detectionReason,
+        source: config.source
+    };
+    // Include boards only for 2-level structures
+    if (config.level === 2 && config.boardsByProject) {
+        output.boardsByProject = config.boardsByProject;
+    }
+    return output;
+}
+/**
+ * Get boards for a specific project
+ *
+ * @param projectId - Project ID to get boards for
+ * @param projectRoot - Path to project root
+ * @returns JSON-serializable boards context
+ */
+export function getBoardsContext(projectId, projectRoot = process.cwd()) {
+    const config = detectStructureLevel(projectRoot);
+    // 1-level structure has no boards
+    if (config.level === 1) {
+        return {
+            project: projectId,
+            boards: [],
+            warning: '1-level structure detected - boards are not applicable'
+        };
+    }
+    // Normalize project ID for lookup
+    const normalizedId = projectId.toLowerCase().replace(/\s+/g, '-');
+    // Find boards for the project
+    const boards = config.boardsByProject?.[normalizedId] || [];
+    // Try original ID if normalized doesn't match
+    if (boards.length === 0 && config.boardsByProject?.[projectId]) {
+        return {
+            project: projectId,
+            boards: config.boardsByProject[projectId]
+        };
+    }
+    return {
+        project: projectId,
+        boards
+    };
+}
+/**
+ * Auto-select or prompt for project/board selection
+ *
+ * @param config - Structure level config
+ * @returns Selection result with auto-select flag
+ */
+export function autoSelectProjectBoard(config) {
+    // Single project in 1-level = auto-select
+    if (config.level === 1 && config.projects.length === 1) {
+        return {
+            selected: {
+                project: config.projects[0].id
+            },
+            autoSelected: true,
+            level: 1
+        };
+    }
+    // Single project + single board in 2-level = auto-select
+    if (config.level === 2 && config.projects.length === 1 && config.boardsByProject) {
+        const projectId = config.projects[0].id;
+        const boards = config.boardsByProject[projectId] || [];
+        if (boards.length === 1) {
+            return {
+                selected: {
+                    project: projectId,
+                    board: boards[0].id
+                },
+                autoSelected: true,
+                level: 2
+            };
+        }
+    }
+    // Multiple options - cannot auto-select
+    // Return first project as default (caller should prompt user)
+    if (config.level === 2 && config.projects.length > 0 && config.boardsByProject) {
+        const projectId = config.projects[0].id;
+        const boards = config.boardsByProject[projectId] || [];
+        return {
+            selected: {
+                project: projectId,
+                board: boards.length > 0 ? boards[0].id : undefined
+            },
+            autoSelected: false,
+            level: 2
+        };
+    }
+    return {
+        selected: {
+            project: config.projects.length > 0 ? config.projects[0].id : 'default'
+        },
+        autoSelected: false,
+        level: config.level
+    };
+}
+/**
+ * CLI handler for 'specweave context projects' command
+ */
+export async function contextProjectsCommand() {
+    const output = getProjectsContext(process.cwd());
+    console.log(JSON.stringify(output, null, 2));
+}
+/**
+ * CLI handler for 'specweave context boards' command
+ *
+ * @param options - Command options with project ID
+ */
+export async function contextBoardsCommand(options) {
+    if (!options.project) {
+        // If no project specified, show all boards for all projects
+        const config = detectStructureLevel(process.cwd());
+        if (config.level === 1) {
+            console.log(JSON.stringify({
+                warning: '1-level structure detected - boards are not applicable',
+                boards: []
+            }, null, 2));
+            return;
+        }
+        console.log(JSON.stringify({
+            boardsByProject: config.boardsByProject || {}
+        }, null, 2));
+        return;
+    }
+    const output = getBoardsContext(options.project, process.cwd());
+    console.log(JSON.stringify(output, null, 2));
+}
+/**
+ * CLI handler for 'specweave context select' command
+ * Returns auto-selected values or prompts interactively
+ */
+export async function contextSelectCommand() {
+    const config = detectStructureLevel(process.cwd());
+    const output = autoSelectProjectBoard(config);
+    // If auto-selected, just output
+    if (output.autoSelected) {
+        console.log(JSON.stringify(output, null, 2));
+        return;
+    }
+    // Multiple options - need to prompt interactively
+    // Use @inquirer/prompts for interactive selection
+    try {
+        const { select } = await import('@inquirer/prompts');
+        // Prompt for project
+        const projectChoices = config.projects.map(p => ({
+            name: p.name || p.id,
+            value: p.id
+        }));
+        const selectedProject = await select({
+            message: 'Select project:',
+            choices: projectChoices
+        });
+        let selectedBoard;
+        // Prompt for board if 2-level
+        if (config.level === 2 && config.boardsByProject) {
+            const boards = config.boardsByProject[selectedProject] || [];
+            if (boards.length > 0) {
+                const boardChoices = boards.map(b => ({
+                    name: b.name || b.id,
+                    value: b.id
+                }));
+                selectedBoard = await select({
+                    message: 'Select board:',
+                    choices: boardChoices
+                });
+            }
+        }
+        const result = {
+            selected: {
+                project: selectedProject,
+                board: selectedBoard
+            },
+            autoSelected: false,
+            level: config.level
+        };
+        console.log(JSON.stringify(result, null, 2));
+    }
+    catch {
+        // Fallback if prompts fail (non-interactive mode)
+        console.log(JSON.stringify(output, null, 2));
+    }
+}
+//# sourceMappingURL=context.js.map

package/dist/src/cli/commands/context.js.map

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

package/dist/src/cli/commands/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAoBH,OAAO,EACL,KAAK,WAAW,EAuBjB,MAAM,0BAA0B,CAAC;AAWlC,YAAY,EAAE,WAAW,EAAE,CAAC;AAgJ5B;;GAEG;AACH,wBAAsB,WAAW,CAC/B,WAAW,CAAC,EAAE,MAAM,EACpB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,IAAI,CAAC,CAqbf"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAoBH,OAAO,EACL,KAAK,WAAW,EAyBjB,MAAM,0BAA0B,CAAC;AAWlC,YAAY,EAAE,WAAW,EAAE,CAAC;AAgJ5B;;GAEG;AACH,wBAAsB,WAAW,CAC/B,WAAW,CAAC,EAAE,MAAM,EACpB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,IAAI,CAAC,CAyef"}

package/dist/src/cli/commands/init.js

@@ -24,7 +24,7 @@ import { getLocaleManager } from '../../core/i18n/locale-manager.js';
 import { StatusLineUpdater } from '../../core/status-line/status-line-updater.js';
 import { readEnvFile, parseEnvFile } from '../../utils/env-file.js';
 // Import helpers
-import { findSourceDir, findPackageRoot, detectNestedSpecweave, detectGitHubRemote, promptSmartReinit, installAllPlugins, setupRepositoryHosting, promptTestingConfig, updateConfigWithTesting, promptLanguageSelection, getDefaultLanguageSelection, promptTranslationConfig, updateConfigWithTranslation, getDefaultTranslationConfig, promptAndRunExternalImport, createDirectoryStructure, copyTemplates, createConfigFile, showNextSteps, generateInitialIncrement, } from '../helpers/init/index.js';
+import { findSourceDir, findPackageRoot, detectNestedSpecweave, detectGitHubRemote, promptSmartReinit, installAllPlugins, setupRepositoryHosting, promptTestingConfig, updateConfigWithTesting, promptLanguageSelection, getDefaultLanguageSelection, promptTranslationConfig, updateConfigWithTranslation, getDefaultTranslationConfig, promptAndRunExternalImport, createDirectoryStructure, copyTemplates, createConfigFile, showNextSteps, generateInitialIncrement, WIZARD_BACK, logGoingBack, } from '../helpers/init/index.js';
 import { triggerAdoRepoCloning } from '../helpers/init/ado-repo-cloning.js';
 import { collectLivingDocsInputs, displayJobScheduled, } from '../helpers/init/living-docs-preflight.js';
 import { launchLivingDocsJob } from '../../core/background/job-launcher.js';
@@ -429,84 +429,126 @@ export async function initCommand(projectName, options = {}) {
             await setupIssueTrackerWrapper(targetDir, language, isFrameworkRepo, repoResult.hosting, isCI, repoResult.adoProjectSelection);
             // Multi-project folders
             await createMultiProjectFolders(targetDir);
-            // External import
-            if (!continueExisting) {
-                try {
-                    const importResult = await promptAndRunExternalImport(targetDir, isCI, language);
-                    // Handle both sync and async import results
-                    if ('isBackground' in importResult && importResult.isBackground) {
-                        // Background import started - job will complete asynchronously
-                        console.log(chalk.cyan('\n🚀 Import running in background'));
-                        console.log(chalk.gray(`   Check progress: /specweave:jobs`));
-                        // Track job ID for living docs dependencies
-                        if ('jobId' in importResult && importResult.jobId) {
-                            pendingJobIds.push(importResult.jobId);
+            let wizardStep = continueExisting ? 'living-docs' : 'external-import';
+            while (wizardStep !== 'done') {
+                // STEP: External Import
+                if (wizardStep === 'external-import') {
+                    try {
+                        const importResult = await promptAndRunExternalImport(targetDir, isCI, language);
+                        // Handle "go back" signal
+                        if ('goBack' in importResult && importResult.goBack === WIZARD_BACK) {
+                            // Can't go back from first step - stay here
+                            logGoingBack(language);
+                            continue;
+                        }
+                        // Handle both sync and async import results
+                        if ('isBackground' in importResult && importResult.isBackground) {
+                            // Background import started - job will complete asynchronously
+                            console.log(chalk.cyan('\n🚀 Import running in background'));
+                            console.log(chalk.gray(`   Check progress: /specweave:jobs`));
+                            // Track job ID for living docs dependencies
+                            if ('jobId' in importResult && importResult.jobId) {
+                                pendingJobIds.push(importResult.jobId);
+                            }
+                            // Skip default increment - user is importing real work items
+                            skipInitialIncrement = true;
+                        }
+                        else if ('totalCount' in importResult && importResult.totalCount > 0) {
+                            // Sync import completed
+                            console.log(chalk.green('\n✅ Imported ' + importResult.totalCount + ' items from ' + importResult.platforms.join(', ')));
+                            // Skip default increment - user has imported real work items
+                            skipInitialIncrement = true;
                         }
-                        // Skip default increment - user is importing real work items
-                        skipInitialIncrement = true;
                     }
-                    else if ('totalCount' in importResult && importResult.totalCount > 0) {
-                        // Sync import completed
-                        console.log(chalk.green('\n✅ Imported ' + importResult.totalCount + ' items from ' + importResult.platforms.join(', ')));
-                        // Skip default increment - user has imported real work items
-                        skipInitialIncrement = true;
+                    catch (importError) {
+                        // Show actual error (was swallowed before) - helps debugging
+                        const errorMsg = importError instanceof Error ? importError.message : String(importError);
+                        console.log(chalk.yellow(`\n⚠️  External tool import failed: ${errorMsg}`));
+                        console.log(chalk.gray('   → You can run /specweave-github:sync later to retry'));
                     }
+                    wizardStep = 'living-docs';
+                    continue;
                 }
-                catch (importError) {
-                    // Show actual error (was swallowed before) - helps debugging
-                    const errorMsg = importError instanceof Error ? importError.message : String(importError);
-                    console.log(chalk.yellow(`\n⚠️  External tool import failed: ${errorMsg}`));
-                    console.log(chalk.gray('   → You can run /specweave-github:sync later to retry'));
+                // STEP: Living Docs
+                if (wizardStep === 'living-docs') {
+                    // Living Docs Builder - ALWAYS ask (both brownfield and greenfield)
+                    if (!options.noLivingDocs) {
+                        try {
+                            const preflightResult = await collectLivingDocsInputs({
+                                projectPath: targetDir,
+                                language,
+                                isCi: isCI,
+                                skipLivingDocs: options.noLivingDocs,
+                                pendingJobIds, // Pass pending job IDs to treat as "will be brownfield"
+                            });
+                            // Handle "go back" signal
+                            if (preflightResult?.goBack === WIZARD_BACK) {
+                                logGoingBack(language);
+                                wizardStep = continueExisting ? 'living-docs' : 'external-import';
+                                continue;
+                            }
+                            // Only launch background job for brownfield projects that want it
+                            if (preflightResult?.shouldLaunch && preflightResult.isBrownfield) {
+                                // Use collected job IDs as dependencies - living docs will wait for them
+                                const launchResult = await launchLivingDocsJob({
+                                    projectPath: targetDir,
+                                    userInputs: preflightResult.userInputs,
+                                    dependsOn: pendingJobIds, // Living docs waits for clone/import to complete
+                                });
+                                displayJobScheduled(launchResult.job.id, preflightResult.estimatedDuration, language);
+                            }
+                            // Greenfield projects: living docs structure already set up, no background job needed
+                            // The collectLivingDocsInputs function displays the success message
+                        }
+                        catch (livingDocsError) {
+                            const errorMsg = livingDocsError instanceof Error ? livingDocsError.message : String(livingDocsError);
+                            console.log(chalk.yellow(`\n⚠️  Living Docs setup failed: ${errorMsg}`));
+                            console.log(chalk.gray('   → You can run /specweave:jobs later to check status'));
+                        }
+                    }
+                    wizardStep = 'testing';
+                    continue;
                 }
-            }
-            // Living Docs Builder - ALWAYS ask (both brownfield and greenfield)
-            if (!options.noLivingDocs) {
-                try {
-                    const preflightResult = await collectLivingDocsInputs({
-                        projectPath: targetDir,
-                        language,
-                        isCi: isCI,
-                        skipLivingDocs: options.noLivingDocs,
-                        pendingJobIds, // Pass pending job IDs to treat as "will be brownfield"
-                    });
-                    // Only launch background job for brownfield projects that want it
-                    if (preflightResult?.shouldLaunch && preflightResult.isBrownfield) {
-                        // Use collected job IDs as dependencies - living docs will wait for them
-                        const launchResult = await launchLivingDocsJob({
-                            projectPath: targetDir,
-                            userInputs: preflightResult.userInputs,
-                            dependsOn: pendingJobIds, // Living docs waits for clone/import to complete
-                        });
-                        displayJobScheduled(launchResult.job.id, preflightResult.estimatedDuration, language);
+                // STEP: Testing Configuration
+                if (wizardStep === 'testing') {
+                    if (!isCI && !continueExisting) {
+                        const testingResult = await promptTestingConfig(language);
+                        // Handle "go back" signal
+                        if (testingResult.goBack === WIZARD_BACK) {
+                            logGoingBack(language);
+                            wizardStep = 'living-docs';
+                            continue;
+                        }
+                        updateConfigWithTesting(targetDir, testingResult.testMode, testingResult.coverageTarget, language);
                     }
-                    // Greenfield projects: living docs structure already set up, no background job needed
-                    // The collectLivingDocsInputs function displays the success message
+                    wizardStep = 'translation';
+                    continue;
                 }
-                catch (livingDocsError) {
-                    const errorMsg = livingDocsError instanceof Error ? livingDocsError.message : String(livingDocsError);
-                    console.log(chalk.yellow(`\n⚠️  Living Docs setup failed: ${errorMsg}`));
-                    console.log(chalk.gray('   → You can run /specweave:jobs later to check status'));
+                // STEP: Translation Configuration
+                if (wizardStep === 'translation') {
+                    // Translation configuration (CRITICAL: Must ask user - cost implications!)
+                    // Language already selected in step 1, now ask about auto-translation scope
+                    if (!isCI && !continueExisting && language !== 'en') {
+                        // Only ask about translation if non-English language selected
+                        const translationResult = await promptTranslationConfig(languageResult);
+                        // Handle "go back" signal
+                        if ('goBack' in translationResult && translationResult.goBack === WIZARD_BACK) {
+                            logGoingBack(language);
+                            wizardStep = 'testing';
+                            continue;
+                        }
+                        updateConfigWithTranslation(targetDir, translationResult);
+                    }
+                    else {
+                        // English or CI mode: Use defaults (no auto-translation needed)
+                        const defaultTranslation = getDefaultTranslationConfig(language);
+                        defaultTranslation.keepEnglishOriginals = languageResult.keepEnglishOriginals;
+                        updateConfigWithTranslation(targetDir, defaultTranslation);
+                    }
+                    wizardStep = 'done';
                 }
             }
         }
-        // Testing configuration
-        if (!isCI && !continueExisting) {
-            const testingResult = await promptTestingConfig(language);
-            updateConfigWithTesting(targetDir, testingResult.testMode, testingResult.coverageTarget, language);
-        }
-        // Translation configuration (CRITICAL: Must ask user - cost implications!)
-        // Language already selected in step 1, now ask about auto-translation scope
-        if (!isCI && !continueExisting && language !== 'en') {
-            // Only ask about translation if non-English language selected
-            const translationResult = await promptTranslationConfig(languageResult);
-            updateConfigWithTranslation(targetDir, translationResult);
-        }
-        else {
-            // English or CI mode: Use defaults (no auto-translation needed)
-            const defaultTranslation = getDefaultTranslationConfig(language);
-            defaultTranslation.keepEnglishOriginals = languageResult.keepEnglishOriginals;
-            updateConfigWithTranslation(targetDir, defaultTranslation);
-        }
         // Initial increment - skip for brownfield projects importing external work items
         const incrementsDir = path.join(targetDir, '.specweave', 'increments');
         const existingIncrements = fs.existsSync(incrementsDir)