@hyperdrive.bot/bmad-workflow 1.0.26 → 1.0.28

package/dist/commands/lock/release.js

@@ -0,0 +1,134 @@
+/**
+ * Lock Release Command
+ *
+ * Releases an existing lock on a story file by deleting the `.lock` file,
+ * committing the removal, and pushing to remote.
+ *
+ * Flow: git pull → validate lock exists → delete .lock → git add+commit+push
+ *
+ * @example
+ * ```bash
+ * bmad-workflow lock release --story docs/qa/stories/X.md
+ * ```
+ */
+import { Command, Flags } from '@oclif/core';
+import fs from 'fs-extra';
+import { FileManager } from '../../services/file-system/file-manager.js';
+import { GlobMatcher } from '../../services/file-system/glob-matcher.js';
+import { GitOps } from '../../services/git/git-ops.js';
+import { LockService } from '../../services/lock/lock-service.js';
+import { createLogger } from '../../utils/logger.js';
+export default class LockReleaseCommand extends Command {
+    static description = 'Release a lock on a story file';
+    static examples = [
+        {
+            command: '<%= config.bin %> lock release --story docs/qa/stories/X.md',
+            description: 'Release the lock on a story file',
+        },
+    ];
+    static flags = {
+        json: Flags.boolean({ description: 'Output as JSON' }),
+        story: Flags.string({ description: 'Path to story file', required: true }),
+    };
+    gitOps;
+    lockService;
+    logger;
+    async run() {
+        this.initServices();
+        const { flags } = await this.parse(LockReleaseCommand);
+        const cwd = process.cwd();
+        const lockFilePath = flags.story + '.lock';
+        // Check lock existence BEFORE pull (needed to detect AC 4 race case)
+        const lockedBeforePull = await this.lockService.isLocked(flags.story);
+        // AC 2: Pull latest to ensure fresh state
+        try {
+            this.gitOps.pull(cwd);
+        }
+        catch {
+            this.logger.warn('git pull failed — proceeding with local state');
+        }
+        // Check lock existence AFTER pull
+        const lockedAfterPull = await this.lockService.isLocked(flags.story);
+        if (!lockedAfterPull) {
+            // AC 4: Lock existed before pull but gone after → another agent released it
+            if (lockedBeforePull) {
+                return this.succeedAlreadyReleased(flags);
+            }
+            // AC 3: Neither story file nor lock exists
+            const storyExists = await fs.pathExists(flags.story);
+            if (!storyExists) {
+                return this.fail(flags, 'Story file not found: ' + flags.story);
+            }
+            // AC 2: Story exists but no lock file
+            return this.fail(flags, 'No lock found for: ' + flags.story);
+        }
+        // AC 1: Delete the lock file
+        await this.lockService.release(flags.story);
+        // AC 1, 5: Stage deletion, commit, and push
+        this.gitOps.add(lockFilePath, cwd);
+        this.gitOps.commit('release: ' + flags.story, cwd);
+        const pushResult = this.gitOps.push(cwd);
+        if (!pushResult.success) {
+            // AC 5: Retry once after pull
+            try {
+                this.gitOps.pull(cwd);
+                const retryResult = this.gitOps.push(cwd);
+                if (!retryResult.success) {
+                    return this.fail(flags, 'Failed to push lock release — manual intervention required');
+                }
+            }
+            catch {
+                return this.fail(flags, 'Failed to push lock release — manual intervention required');
+            }
+        }
+        // AC 6, 7: Success output
+        this.succeed(flags);
+    }
+    /**
+     * Output failure message in JSON or human-readable format, then exit 1
+     */
+    fail(flags, message) {
+        if (flags.json) {
+            this.log(JSON.stringify({ error: message, story: flags.story, success: false }));
+            this.exit(1);
+        }
+        this.error(message, { exit: 1 });
+    }
+    initServices() {
+        this.logger = createLogger({ namespace: 'commands:lock:release' });
+        const fileManager = new FileManager(this.logger);
+        const globMatcher = new GlobMatcher(fileManager, this.logger);
+        this.lockService = new LockService(fileManager, globMatcher, this.logger);
+        this.gitOps = new GitOps();
+    }
+    /**
+     * Output idempotent success when lock was already released by another agent (AC 4)
+     */
+    succeedAlreadyReleased(flags) {
+        if (flags.json) {
+            this.log(JSON.stringify({
+                story: flags.story,
+                success: true,
+                timestamp: new Date().toISOString(),
+            }));
+        }
+        else {
+            this.log('Lock already released for: ' + flags.story);
+        }
+    }
+    /**
+     * Output success message in JSON or human-readable format
+     */
+    succeed(flags) {
+        if (flags.json) {
+            this.log(JSON.stringify({
+                story: flags.story,
+                success: true,
+                timestamp: new Date().toISOString(),
+            }));
+        }
+        else {
+            this.log('✓ Lock released: ' + flags.story);
+        }
+    }
+}

package/dist/commands/lock/status.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Lock Status Command
+ *
+ * Queries the lock state for a specific story file.
+ * Returns one of three states: unlocked, locked, or stale.
+ *
+ * Exit codes:
+ * - 0: unlocked
+ * - 1: locked (active, non-stale)
+ * - 2: stale lock
+ *
+ * @example
+ * ```bash
+ * bmad-workflow lock status --story docs/stories/X.md
+ * bmad-workflow lock status --story docs/stories/X.md --json
+ * bmad-workflow lock status --story docs/stories/X.md; echo $?
+ * ```
+ */
+import { Command } from '@oclif/core';
+export default class LockStatusCommand extends Command {
+    static description: string;
+    static examples: {
+        command: string;
+        description: string;
+    }[];
+    static flags: {
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        story: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    private lockService;
+    private logger;
+    run(): Promise<void>;
+    private initServices;
+}

package/dist/commands/lock/status.js

@@ -0,0 +1,109 @@
+/**
+ * Lock Status Command
+ *
+ * Queries the lock state for a specific story file.
+ * Returns one of three states: unlocked, locked, or stale.
+ *
+ * Exit codes:
+ * - 0: unlocked
+ * - 1: locked (active, non-stale)
+ * - 2: stale lock
+ *
+ * @example
+ * ```bash
+ * bmad-workflow lock status --story docs/stories/X.md
+ * bmad-workflow lock status --story docs/stories/X.md --json
+ * bmad-workflow lock status --story docs/stories/X.md; echo $?
+ * ```
+ */
+import { execSync } from 'node:child_process';
+import { Command, Flags } from '@oclif/core';
+import fs from 'fs-extra';
+import { FileManager } from '../../services/file-system/file-manager.js';
+import { GlobMatcher } from '../../services/file-system/glob-matcher.js';
+import { LockService } from '../../services/lock/lock-service.js';
+import { createLogger } from '../../utils/logger.js';
+export default class LockStatusCommand extends Command {
+    static description = 'Check lock status for a story file';
+    static examples = [
+        {
+            command: '<%= config.bin %> lock status --story docs/stories/X.md',
+            description: 'Check lock status (human-readable)',
+        },
+        {
+            command: '<%= config.bin %> lock status --story docs/stories/X.md --json',
+            description: 'Check lock status as JSON',
+        },
+        {
+            command: '<%= config.bin %> lock status --story docs/stories/X.md; echo $?',
+            description: 'Use exit code for scripted checks (0=unlocked, 1=locked, 2=stale)',
+        },
+    ];
+    static flags = {
+        json: Flags.boolean({ description: 'Output as JSON' }),
+        story: Flags.string({ description: 'Path to the story file', required: true }),
+    };
+    lockService;
+    logger;
+    async run() {
+        this.initServices();
+        const { flags } = await this.parse(LockStatusCommand);
+        // AC 4: Validate story file exists
+        const storyExists = await fs.pathExists(flags.story);
+        if (!storyExists) {
+            if (flags.json) {
+                this.log(JSON.stringify({ error: 'Story file not found: ' + flags.story, state: 'error', story: flags.story }));
+            }
+            else {
+                this.error('Story file not found: ' + flags.story, { exit: 1 });
+            }
+            this.exit(1);
+        }
+        // AC 9: Pull latest before reading lock state
+        try {
+            execSync('git pull --ff-only', { cwd: process.cwd(), stdio: 'pipe' });
+        }
+        catch {
+            this.logger.warn('git pull failed — proceeding with local state');
+        }
+        // Query lock state
+        const lockInfo = await this.lockService.getLockInfo(flags.story);
+        if (lockInfo === null) {
+            // Unlocked
+            if (flags.json) {
+                this.log(JSON.stringify({ state: 'unlocked', story: flags.story }, null, 2));
+            }
+            else {
+                this.log('unlocked');
+            }
+            this.exit(0);
+        }
+        // Lock exists — check staleness
+        const stale = await this.lockService.isStale(flags.story);
+        const state = stale ? 'stale' : 'locked';
+        const exitCode = stale ? 2 : 1;
+        if (flags.json) {
+            this.log(JSON.stringify({
+                agent: lockInfo.agent_name,
+                branch: lockInfo.branch,
+                session: lockInfo.agent_session_id,
+                started_at: lockInfo.started_at,
+                state,
+                story: flags.story,
+            }, null, 2));
+        }
+        else if (stale) {
+            this.log(`stale lock by ${lockInfo.agent_name} since ${lockInfo.started_at} (session: ${lockInfo.agent_session_id}, branch: ${lockInfo.branch})`);
+        }
+        else {
+            this.log(`locked by ${lockInfo.agent_name} since ${lockInfo.started_at} (session: ${lockInfo.agent_session_id}, branch: ${lockInfo.branch})`);
+        }
+        this.exit(exitCode);
+    }
+    initServices() {
+        this.logger = createLogger({ namespace: 'commands:lock:status' });
+        const fileManager = new FileManager(this.logger);
+        const globMatcher = new GlobMatcher(fileManager, this.logger);
+        this.lockService = new LockService(fileManager, globMatcher, this.logger);
+    }
+}

package/dist/commands/stories/create.d.ts

@@ -33,6 +33,7 @@ export default class StoriesCreateCommand extends Command {
         prefix: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         reference: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
         start: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        stream: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         agent: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         cwd: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         model: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;

package/dist/commands/stories/develop.d.ts

@@ -31,10 +31,13 @@ export default class StoriesDevelopCommand extends Command {
     }[];
     static flags: {
         interval: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        'skip-locking': import("@oclif/core/interfaces").BooleanFlag<boolean>;
         qa: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'qa-prompt': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'qa-retries': import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
         reference: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'session-name': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        stream: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         agent: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         cwd: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         model: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
@@ -48,6 +51,7 @@ export default class StoriesDevelopCommand extends Command {
     private agentRunner;
     private fileManager;
     private globMatcher;
+    private lockService;
     private logger;
     private pathResolver;
     private storyParserFactory;

package/dist/commands/stories/develop.js

@@ -20,6 +20,10 @@ import { createAgentRunner } from '../../services/agents/agent-runner-factory.js
 import { FileManager } from '../../services/file-system/file-manager.js';
 import { GlobMatcher } from '../../services/file-system/glob-matcher.js';
 import { PathResolver } from '../../services/file-system/path-resolver.js';
+import { GitOps } from '../../services/git/git-ops.js';
+import { PushConflictHandler } from '../../services/git/push-conflict-handler.js';
+import { GitBackedLockService } from '../../services/lock/git-backed-lock-service.js';
+import { LockService } from '../../services/lock/lock-service.js';
 import { StoryTypeDetector } from '../../services/orchestration/story-type-detector.js';
 import { StoryParserFactory } from '../../services/parsers/story-parser-factory.js';
 import * as colors from '../../utils/colors.js';
@@ -73,6 +77,11 @@ export default class StoriesDevelopCommand extends Command {
             default: 30,
             description: 'Seconds to wait between stories',
         }),
+        'skip-locking': Flags.boolean({
+            allowNo: true,
+            default: true,
+            description: 'Disable story locking (for single-agent runs)',
+        }),
         qa: Flags.boolean({
             default: false,
             description: 'Run QA workflow after development completes',
@@ -91,11 +100,17 @@ export default class StoriesDevelopCommand extends Command {
             description: 'Additional context files for dev agents',
             multiple: true,
         }),
+        'session-name': Flags.string({
+            char: 'n',
+            description: 'Session display name template. Supports {story} placeholder. ' +
+                'Defaults to "dev-{story}" if not provided.',
+        }),
     };
     // Service instances
     agentRunner;
     fileManager;
     globMatcher;
+    lockService = null;
     logger;
     pathResolver;
     storyParserFactory;
@@ -107,9 +122,10 @@ export default class StoriesDevelopCommand extends Command {
         const { args, flags } = await this.parse(StoriesDevelopCommand);
         const startTime = Date.now();
         const correlationId = generateCorrelationId();
-        // Initialize services with selected provider
+        // Initialize services with selected provider and locking
         const provider = (flags.provider || 'claude');
-        this.initializeServices(provider);
+        const lockingEnabled = !flags['skip-locking'];
+        this.initializeServices(provider, lockingEnabled);
         this.logger.info({
             correlationId,
             flags,
@@ -244,12 +260,32 @@ export default class StoriesDevelopCommand extends Command {
             // Develop story
             const devSpinner = createSpinner('Running dev agent...');
             devSpinner.start();
+            // Resolve session name with {story} placeholder
+            const storyIdentifier = isEpicStory(storyMetadata) ? storyMetadata.number : storyMetadata.id;
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any -- oclif type inference limit with spread flags
+            const sessionNameTemplate = flags['session-name'];
+            const resolvedSessionName = sessionNameTemplate
+                ? sessionNameTemplate.replace(/\{story\}/g, storyIdentifier)
+                : `dev-${storyIdentifier}`;
+            // When --stream is set, stop the spinner and pipe raw output to stdout
+            const isStreaming = flags.stream === true;
+            if (isStreaming) {
+                devSpinner.stop();
+                this.log(colors.dim(`── [dev ${storyIdentifier}] streaming ──`));
+            }
             const result = await this.developStory({
                 agent: flags.agent,
                 cwd: flags.cwd,
                 maxRetries: flags['max-retries'],
+                onStream: isStreaming ? undefined : (summary) => {
+                    devSpinner.text = `[dev ${storyIdentifier}] ${summary}`;
+                },
+                onStreamVerbose: isStreaming ? (text) => {
+                    process.stdout.write(text + '\n');
+                } : undefined,
                 references: flags.reference,
                 retryBackoff: flags['retry-backoff'],
+                sessionName: resolvedSessionName,
                 storyMetadata,
                 storyPath,
                 task: flags.task,
@@ -274,7 +310,7 @@ export default class StoriesDevelopCommand extends Command {
      * Develop a single story
      */
     async developStory(options) {
-        const { agent, cwd, maxRetries, references, retryBackoff, storyMetadata, storyPath, task, timeout } = options;
+        const { agent, cwd, maxRetries, onStream, onStreamVerbose, references, retryBackoff, sessionName, storyMetadata, storyPath, task, timeout } = options;
         const storyNumber = isEpicStory(storyMetadata) ? storyMetadata.number : storyMetadata.id;
         this.logger.info({ storyNumber, storyPath }, 'Starting story development');
         try {
@@ -309,6 +345,9 @@ export default class StoriesDevelopCommand extends Command {
             const result = await runAgentWithRetry(this.agentRunner, prompt, {
                 agentType: 'dev',
                 cwd,
+                onStream,
+                onStreamVerbose,
+                sessionName,
                 timeout: timeout ?? 2_700_000,
             }, {
                 backoffMs: retryBackoff,
@@ -391,7 +430,7 @@ export default class StoriesDevelopCommand extends Command {
     /**
      * Initialize service dependencies
      */
-    initializeServices(provider = 'claude') {
+    initializeServices(provider = 'claude', lockingEnabled = false) {
         this.logger = createLogger({ namespace: 'commands:stories:develop' });
         this.logger.info({ provider }, 'Initializing services with AI provider');
         this.fileManager = new FileManager(this.logger);
@@ -400,7 +439,18 @@ export default class StoriesDevelopCommand extends Command {
         this.storyParserFactory = new StoryParserFactory(this.fileManager, this.logger);
         this.storyTypeDetector = new StoryTypeDetector(this.logger);
         this.agentRunner = createAgentRunner(provider, this.logger);
-        this.logger.debug({ provider }, 'Services initialized successfully');
+        // Conditionally instantiate lock service for multi-session coordination
+        if (lockingEnabled) {
+            const gitOps = new GitOps();
+            const conflictHandler = new PushConflictHandler(gitOps);
+            const lockSvc = new LockService(this.fileManager, this.globMatcher, this.logger);
+            this.lockService = new GitBackedLockService(lockSvc, gitOps, conflictHandler);
+            this.logger.info('GitBackedLockService instantiated for multi-session coordination');
+        }
+        else {
+            this.lockService = null;
+        }
+        this.logger.debug({ lockingEnabled, provider }, 'Services initialized successfully');
     }
     /**
      * Match story files using glob pattern

package/dist/commands/stories/qa.d.ts

@@ -40,6 +40,7 @@ export default class StoriesQaCommand extends Command {
         timeout: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
         'agent-retries': import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
         'retry-backoff': import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        stream: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     private agentRunner;
     private fileManager;

package/dist/commands/stories/qa.js

@@ -106,6 +106,11 @@ export default class StoriesQaCommand extends Command {
             description: 'Backoff delay between retries in milliseconds',
             helpGroup: 'Resilience',
         }),
+        stream: Flags.boolean({
+            default: false,
+            description: 'Stream full Claude output to stdout in real-time (verbose passthrough)',
+            helpGroup: 'Output',
+        }),
     };
     // Service instances
     agentRunner;
@@ -397,6 +402,7 @@ ${result.finalGate === 'PASS' ? '3. [x] Final QA Validation - PASSED' : result.f
                 'max-retries': flags['max-retries'],
                 'qa-prompt': flags['qa-prompt'],
                 reference: flags.reference,
+                stream: flags.stream,
             });
             results.push(result);
             // Log result
@@ -423,10 +429,25 @@ ${result.finalGate === 'PASS' ? '3. [x] Final QA Validation - PASSED' : result.f
             const agentTimeout = flags.timeout ?? 2_700_000;
             const agentRetries = flags['agent-retries'];
             const retryBackoff = flags['retry-backoff'];
+            const isStreaming = flags.stream === true;
+            // Stream callbacks
+            const qaStreamLabel = `qa ${storyNumber}`;
+            const devStreamLabel = `dev-fix ${storyNumber}`;
+            const logStream = (label) => (summary) => {
+                this.logger.info({ phase: label }, summary);
+            };
+            const verboseStream = isStreaming ? (text) => {
+                process.stdout.write(text + '\n');
+            } : undefined;
+            if (isStreaming) {
+                this.log(colors.dim(`── [qa ${storyNumber}] Phase 1: QA Deep Dive ──`));
+            }
             const qaPrompt = this.buildQaPrompt(storyPath, flags['qa-prompt'], flags.reference);
             const qaResult = await runAgentWithRetry(this.agentRunner, qaPrompt, {
                 agentType: 'tea',
                 cwd: flags.cwd,
+                onStream: isStreaming ? undefined : logStream(qaStreamLabel),
+                onStreamVerbose: verboseStream,
                 timeout: agentTimeout,
             }, {
                 backoffMs: retryBackoff,
@@ -445,11 +466,16 @@ ${result.finalGate === 'PASS' ? '3. [x] Final QA Validation - PASSED' : result.f
                 retriesUsed++;
                 this.logger.info({ retry: retriesUsed, maxRetries: flags['max-retries'] }, 'Phase 2: Dev Fix-Forward');
                 // Run Dev agent to fix issues (sequential retry loop by design)
+                if (isStreaming) {
+                    this.log(colors.dim(`── [dev-fix ${storyNumber}] Retry ${retriesUsed} ──`));
+                }
                 const devPrompt = this.buildDevFixPrompt(storyPath, flags['dev-prompt'], flags.reference);
                 // eslint-disable-next-line no-await-in-loop
                 const devResult = await runAgentWithRetry(this.agentRunner, devPrompt, {
                     agentType: 'dev',
                     cwd: flags.cwd,
+                    onStream: isStreaming ? undefined : logStream(devStreamLabel),
+                    onStreamVerbose: verboseStream,
                     timeout: agentTimeout,
                 }, {
                     backoffMs: retryBackoff,
@@ -462,10 +488,15 @@ ${result.finalGate === 'PASS' ? '3. [x] Final QA Validation - PASSED' : result.f
                 }
                 // Phase 3: Re-run QA to validate fixes
                 this.logger.info({ retry: retriesUsed }, 'Phase 3: QA Re-validation');
+                if (isStreaming) {
+                    this.log(colors.dim(`── [qa ${storyNumber}] Re-validation after retry ${retriesUsed} ──`));
+                }
                 // eslint-disable-next-line no-await-in-loop
                 const reQaResult = await runAgentWithRetry(this.agentRunner, qaPrompt, {
                     agentType: 'tea',
                     cwd: flags.cwd,
+                    onStream: isStreaming ? undefined : logStream(qaStreamLabel),
+                    onStreamVerbose: verboseStream,
                     timeout: agentTimeout,
                 }, {
                     backoffMs: retryBackoff,

package/dist/commands/stories/review.d.ts

@@ -60,6 +60,7 @@ export default class StoriesReviewCommand extends Command {
         json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'max-fix': import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
         scanners: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        stream: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         agent: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         cwd: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         model: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;

package/dist/commands/workflow.d.ts

@@ -37,6 +37,7 @@ export default class Workflow extends Command {
         pipeline: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'prd-interval': import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
         model: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'session-name': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         prefix: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         'session-prefix': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         provider: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
@@ -53,12 +54,15 @@ export default class Workflow extends Command {
         reference: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'skip-dev': import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'skip-epics': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'skip-locking': import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'skip-stories': import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'story-interval': import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
         timeout: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'review-timeout': import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'max-retries': import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
         'retry-backoff': import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        'use-channels': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        stream: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     private cancelled;
@@ -192,4 +196,11 @@ export default class Workflow extends Command {
      * @private
      */
     private registerSignalHandlers;
+    /**
+     * Validate that all requested gut entities exist before attempting worktree creation.
+     * Reads .gut/config.json directly for fast validation without subprocess overhead.
+     * Fails fast with clear error message listing valid entities and fuzzy suggestions.
+     */
+    private validateGutEntities;
+    private showEntityError;
 }