forge-workflow 0.0.9 → 0.0.10

package/lib/commands/recommend.js

@@ -116,4 +116,25 @@ function handleRecommend(flags, projectPath) {
   return { budgetMode, recommendations };
 }
 
-module.exports = { formatRecommendations, handleRecommend };
+async function handler(_args = [], flags = {}, projectRoot) {
+  const result = handleRecommend(flags, projectRoot);
+  if (result.error) {
+    return { success: false, error: result.error };
+  }
+
+  const output = [
+    '',
+    `🔧 Forge Tool Recommendations (Budget: ${result.budgetMode})`,
+    formatRecommendations(result.recommendations),
+  ].join('\n');
+
+  return { success: true, output };
+}
+
+module.exports = {
+  name: 'recommend',
+  description: 'Show tool recommendations for the current project',
+  handler,
+  formatRecommendations,
+  handleRecommend
+};

package/lib/commands/setup.js

@@ -36,7 +36,7 @@ const { createSymlinkOrCopy: libCreateSymlinkOrCopy } = require(path.join(packag
 const beadsSetupLib = require(path.join(packageDir, 'lib', 'beads-setup'));
 const { beadsHealthCheck } = require(path.join(packageDir, 'lib', 'beads-health-check'));
 const { setupPAT } = require(path.join(packageDir, 'lib', 'pat-setup'));
-const { detectDefaultBranch, detectBeadsVersion, templateWorkflows, scaffoldBeadsSync } = require(path.join(packageDir, 'lib', 'beads-sync-scaffold'));
+const { DEFAULT_BEADS_VERSION, detectDefaultBranch, templateWorkflows, scaffoldBeadsSync } = require(path.join(packageDir, 'lib', 'beads-sync-scaffold'));
 
 // Load incremental setup modules
 const { detectEnvironment } = require('../detect-agent');
@@ -2734,13 +2734,15 @@ function installGitHooks() { // NOSONAR — Extracted as-is from bin/forge.js; c
         execFileSync('lefthook', ['install'], { stdio: 'inherit', cwd: projectRoot });
         console.log('  ✓ Lefthook hooks installed (global)');
       }
-    } catch (err) {
-      console.warn('Lefthook installation failed:', err.message);
-      console.log('  ℹ Lefthook not found. Install it:');
-      console.log('    bun add -d lefthook  (recommended)');
-      console.log('    OR: bun add -g lefthook  (global)');
-      console.log('    Then run: bunx lefthook install');
-    }
+  } catch (err) {
+    console.warn('Lefthook installation failed:', err.message);
+    console.warn('  ⚠ Lefthook hooks were not installed; raw git push remains unsafe in this worktree.');
+    console.log('  ℹ Lefthook not found. Install it:');
+    console.log('    bun add -d lefthook  (recommended)');
+    console.log('    OR: bun add -g lefthook  (global)');
+    console.log('    Then run: bunx lefthook install');
+    console.log(`  Run ${PKG_MANAGER} install in this worktree, then rerun setup.`);
+  }
 
     console.log('');
 
@@ -2785,7 +2787,9 @@ function repairDeclaredLefthookDependency(selectedAgents) {
     return { attempted: true, repaired: true };
   } catch (err) {
     console.warn('Lefthook install failed:', err.message);
+    console.warn('  ⚠ Lefthook repair failed; raw git push remains unsafe in this worktree.');
     console.log(`  ⚠ ${status.message}`);
+    console.log(`  Run ${PKG_MANAGER} install in this worktree, then rerun setup.`);
     console.log('');
     return { attempted: true, repaired: false, error: err };
   }
@@ -3314,7 +3318,9 @@ function autoInstallLefthook() { // NOSONAR — Extracted as-is from bin/forge.j
       console.log('  ✓ Lefthook binary restored');
     } catch (err) {
       console.warn('Lefthook install failed:', err.message);
+      console.warn('  ⚠ Lefthook repair failed; raw git push remains unsafe in this worktree.');
       console.log(`  ⚠ ${status.message}`);
+      console.log(`  Run ${PKG_MANAGER} install in this worktree, then rerun setup.`);
     }
     console.log('');
     return;
@@ -4087,9 +4093,9 @@ async function handleSyncScaffold() {
       console.log(`  Skipped: ${f} (already exists)`);
     }
 
-    // Detect default branch and Beads version, then template workflows
+    // Detect default branch and pin forge-managed workflows to the repo baseline Beads version.
     const branch = detectDefaultBranch(projectRoot);
-    const beadsVersion = detectBeadsVersion();
+    const beadsVersion = DEFAULT_BEADS_VERSION;
     const workflowDir = path.join(projectRoot, '.github', 'workflows');
     templateWorkflows(workflowDir, branch, beadsVersion, result.filesCreated || []);
     console.log(`  Branch: ${branch}, Beads version: ${beadsVersion}`);

package/lib/commands/status.js

@@ -8,11 +8,15 @@ const {
 	getAllowedTransitionsForWorkflowState,
 } = require('../workflow/state');
 const { STAGE_IDS } = require('../workflow/stages');
+const { detectWorktree } = require('../detect-worktree');
+const { readBeadsSnapshot } = require('../status/beads-snapshot');
+const { formatZeroArgStatus } = require('../status/presenter');
 const {
 	loadState,
 	extractWorkflowStateFromComments,
 	readWorkflowStateFromBeads,
 } = require('../workflow/state-manager');
+const { secureExecFileSync } = require('../shell-utils.js');
 
 const WORKFLOW_STAGES = {
 	1: { name: 'Fresh Start', nextCommand: 'research' },
@@ -346,6 +350,138 @@ function parseStatusInputs(args = [], flags = {}) {
 	};
 }
 
+function runGitCommand(projectRoot, args) {
+	if (!projectRoot) {
+		return '';
+	}
+
+	try {
+		return secureExecFileSync('git', args, {
+			encoding: 'utf8',
+			cwd: projectRoot,
+			stdio: ['pipe', 'pipe', 'pipe'],
+		}).trim();
+	} catch (_error) {
+		return '';
+	}
+}
+
+function detectRepoContext(projectRoot = process.cwd()) {
+	const worktree = detectWorktree(projectRoot);
+	const branch = worktree.branch || runGitCommand(projectRoot, ['branch', '--show-current']) || 'unknown';
+	const statusOutput = runGitCommand(projectRoot, ['status', '--short']);
+	const changedEntries = statusOutput ? statusOutput.split(/\r?\n/).filter(Boolean) : [];
+	const clean = changedEntries.length === 0;
+	const summary = clean ? 'clean' : `${changedEntries.length} uncommitted change${changedEntries.length === 1 ? '' : 's'}`;
+
+	return {
+		branch,
+		inWorktree: worktree.inWorktree === true,
+		worktreePath: worktree.currentWorktree || projectRoot,
+		mainWorktree: worktree.mainWorktree || projectRoot,
+		workingTree: {
+			clean,
+			summary,
+		},
+	};
+}
+
+function readIssueDetails(issueId, projectRoot = process.cwd()) {
+	if (!issueId) {
+		return null;
+	}
+
+	try {
+		const raw = secureExecFileSync('bd', ['show', issueId, '--json'], {
+			encoding: 'utf8',
+			cwd: projectRoot,
+			stdio: ['pipe', 'pipe', 'pipe'],
+		}).trim();
+		if (!raw) {
+			return null;
+		}
+
+		const parsed = JSON.parse(raw);
+		return Array.isArray(parsed) ? parsed[0] || null : parsed;
+	} catch (_error) {
+		return null;
+	}
+}
+
+function extractDesignSlugs(design) {
+	if (typeof design !== 'string' || design.trim() === '') {
+		return [];
+	}
+
+	const slugs = new Set();
+	const pattern = /docs[\\/]+plans[\\/]+\d{4}-\d{2}-\d{2}-([a-z0-9-]+?)-(?:design|tasks|decisions)\.md/g;
+	let match = pattern.exec(design);
+	while (match) {
+		slugs.add(match[1]);
+		match = pattern.exec(design);
+	}
+
+	return [...slugs];
+}
+
+function designMatchesFeatureSlug(issue, featureSlug) {
+	if (!issue || !featureSlug) {
+		return false;
+	}
+
+	return extractDesignSlugs(issue.design).includes(featureSlug);
+}
+
+function discoverCurrentIssue(snapshot, context, projectRoot = process.cwd()) {
+	const activeAssigned = snapshot.activeAssigned || [];
+	if (activeAssigned.length === 0) {
+		return null;
+	}
+
+	const branchInfo = analyzeBranch(context.branch || 'master');
+	const hydratedIssues = new Map();
+
+	function hydrateIssue(issue) {
+		if (!issue || !issue.id) {
+			return issue;
+		}
+
+		if (hydratedIssues.has(issue.id)) {
+			return hydratedIssues.get(issue.id);
+		}
+
+		const details = issue.design && issue.comments ? issue : readIssueDetails(issue.id, projectRoot);
+		const hydratedIssue = details ? { ...issue, ...details } : issue;
+		hydratedIssues.set(issue.id, hydratedIssue);
+		return hydratedIssue;
+	}
+
+	if (branchInfo.featureSlug) {
+		const slugMatches = [];
+
+		for (const issue of activeAssigned) {
+			const candidate = issue.design ? issue : hydrateIssue(issue);
+			if (designMatchesFeatureSlug(candidate, branchInfo.featureSlug)) {
+				slugMatches.push(candidate);
+			}
+		}
+
+		if (slugMatches.length === 1) {
+			return hydrateIssue(slugMatches[0]);
+		}
+
+		if (slugMatches.length > 1) {
+			return null;
+		}
+	}
+
+	if (activeAssigned.length === 1) {
+		return hydrateIssue(activeAssigned[0]);
+	}
+
+	return null;
+}
+
 function resolveWorkflowState(inputs) {
 	try {
 		if (inputs.workflowState) {
@@ -354,7 +490,9 @@ function resolveWorkflowState(inputs) {
 
 		const { state } = loadState(inputs.projectRoot, {
 			issueId: inputs.issueId,
+			issue: inputs.issue,
 			comments: inputs.bdComments,
+			preferBeads: inputs.preferBeads,
 		});
 
 		return { workflowState: state, fallbackReason: null };
@@ -498,11 +636,51 @@ module.exports = {
 	description: 'Intelligent stage detection with confidence scoring',
 	handler: async (args, flags, projectRoot) => {
 		const inputs = parseStatusInputs(args, flags);
+		const isZeroArgStatus = !inputs.issueId && !inputs.workflowState && !inputs.bdComments;
+		inputs.preferBeads = !isZeroArgStatus && Boolean(inputs.issueId || inputs.bdComments);
 		if (!inputs.projectRoot && projectRoot) {
 			inputs.projectRoot = projectRoot;
 		}
+		const effectiveProjectRoot = inputs.projectRoot || process.cwd();
+		let context = null;
+		let snapshot = null;
+
+		if (isZeroArgStatus) {
+			context = detectRepoContext(effectiveProjectRoot);
+			snapshot = readBeadsSnapshot(effectiveProjectRoot);
+			const discoveredIssue = discoverCurrentIssue(snapshot, context, effectiveProjectRoot);
+			if (discoveredIssue) {
+				inputs.issueId = discoveredIssue.id;
+				inputs.issue = discoveredIssue;
+			}
+		}
+
 		const { workflowState, fallbackReason } = resolveWorkflowState(inputs);
 
+		if (isZeroArgStatus) {
+			if (workflowState) {
+				const result = buildAuthoritativeStatus(workflowState);
+				return {
+					success: true,
+					context,
+					snapshot,
+					issueId: inputs.issueId,
+					output: formatZeroArgStatus({ context, snapshot, workflowResult: result }),
+					...result,
+				};
+			}
+
+			return {
+				success: true,
+				context,
+				snapshot,
+				issueId: inputs.issueId,
+				missingWorkflowState: true,
+				output: formatZeroArgStatus({ context, snapshot }),
+				...(fallbackReason ? { fallbackReason } : {}),
+			};
+		}
+
 		if (workflowState) {
 			const result = buildAuthoritativeStatus(workflowState);
 			return { success: true, output: formatStatus(result), ...result };
@@ -521,6 +699,8 @@ module.exports = {
 	parseStatusInputs,
 	readWorkflowStateFromBeads,
 	detectStage,
+	detectRepoContext,
+	discoverCurrentIssue,
 	analyzeBranch,
 	analyzeFiles,
 	analyzePR,
@@ -528,4 +708,5 @@ module.exports = {
 	analyzeBeads,
 	calculateConfidence,
 	formatStatus,
+	extractDesignSlugs,
 };

package/lib/commands/team.js

@@ -34,4 +34,14 @@ function handleTeam(args) {
   }
 }
 
-module.exports = { handleTeam };
+async function handler(args = []) {
+  handleTeam(args);
+  return { success: true };
+}
+
+module.exports = {
+  name: 'team',
+  description: 'Team coordination workflows and sync utilities',
+  handler,
+  handleTeam
+};

package/lib/commands/test.js

@@ -152,6 +152,18 @@ function getAffectedTestFiles(projectRoot, execFileSync, fs = defaultFs, options
 function getTestCandidatesForChangedFile(file) {
 	if (!file) return [];
 
+	if (file === 'lib/lefthook-check.js') {
+		return ['test/lefthook-check.test.js', 'test/runtime-health.test.js'];
+	}
+
+	if (file === 'lib/runtime-health.js') {
+		return ['test/runtime-health.test.js'];
+	}
+
+	if (file === 'scripts/test.js') {
+		return ['test/scripts/test-runner.test.js'];
+	}
+
 	if (file.startsWith('test/') && file.endsWith('.test.js')) {
 		return [file];
 	}
@@ -161,8 +173,8 @@ function getTestCandidatesForChangedFile(file) {
 		return [`test/${relative.replace(/\.js$/, '.test.js')}`];
 	}
 
-	if (file.startsWith('scripts/') && file.endsWith('.js')) {
-		const relative = file.slice('scripts/'.length).replace(/\.js$/, '.test.js');
+	if (file.startsWith('scripts/') && (file.endsWith('.js') || file.endsWith('.sh'))) {
+		const relative = file.slice('scripts/'.length).replace(/\.(js|sh)$/, '.test.js');
 		return [
 			`test/scripts/${relative}`,
 			`test/${relative}`,
@@ -177,6 +189,13 @@ function getTestCandidatesForChangedFile(file) {
 		];
 	}
 
+	if (file.startsWith('.github/agentic-workflows/') || file === '.github/behavioral-test-scores.json') {
+		return [
+			'test/scripts/behavioral-judge.test.js',
+			'test/structural/agentic-workflow-sync.test.js',
+		];
+	}
+
 	if (file.startsWith('.claude/commands/') && file.endsWith('.md')) {
 		return [
 			'test/command-sync-check.test.js',
@@ -184,6 +203,22 @@ function getTestCandidatesForChangedFile(file) {
 		];
 	}
 
+	if (file.startsWith('.forge/')
+		|| file.startsWith('.cursor/')
+		|| file.startsWith('.cline/')
+		|| file.startsWith('.roo/')
+		|| file.startsWith('.kilocode/')
+		|| file.startsWith('.opencode/')
+		|| file.startsWith('.codex/skills/')
+		|| file.startsWith('.github/prompts/')) {
+		return [
+			'test/agent-gaps.test.js',
+			'test/command-sync-check.test.js',
+			'test/scripts/check-agents.test.js',
+			'test/structural/command-sync.test.js',
+		];
+	}
+
 	return [];
 }
 

package/lib/commands/validate.js

@@ -46,6 +46,12 @@ const CONFLICT_START_PATTERN = /^<<<<<<<(?: .*)?$/;
 const CONFLICT_DIVIDER_PATTERN = /^=======$/;
 const CONFLICT_END_PATTERN = /^>>>>>>>.*$/;
 const GIT_CONFLICT_SCAN_MAX_BUFFER = 16 * 1024 * 1024;
+const VALIDATION_COMMAND_TIMEOUT_MS = 600000;
+const VALIDATION_COMMAND_TIMEOUT_MINUTES = Math.round(VALIDATION_COMMAND_TIMEOUT_MS / 60000);
+
+function validationTimeoutMessage(label) {
+	return `${label} timed out after ${VALIDATION_COMMAND_TIMEOUT_MINUTES} minutes`;
+}
 
 function listConflictScanFiles(rootDir) {
 	try {
@@ -78,7 +84,7 @@ function shouldSkipConflictScanPath(relativePath) {
 }
 
 function getExecOptions() {
-	return { encoding: 'utf8', cwd: process.cwd(), timeout: 120000 };
+	return { encoding: 'utf8', cwd: process.cwd(), timeout: VALIDATION_COMMAND_TIMEOUT_MS };
 }
 
 const ERROR_PATTERNS = {
@@ -308,7 +314,7 @@ async function runTypeCheck() {
 			return {
 				success: false,
 				duration: Date.now() - startTime,
-				message: 'Type check timed out after 2 minutes',
+				message: validationTimeoutMessage('Type check'),
 			};
 		}
 
@@ -365,7 +371,7 @@ async function runLint() {
 			return {
 				success: false,
 				duration: Date.now() - startTime,
-				message: 'Lint check timed out after 2 minutes',
+				message: validationTimeoutMessage('Lint check'),
 			};
 		}
 
@@ -437,7 +443,7 @@ async function runSecurityScan() { // NOSONAR S3776
 			return {
 				success: false,
 				duration: Date.now() - startTime,
-				message: 'Security audit timed out after 2 minutes',
+				message: validationTimeoutMessage('Security audit'),
 			};
 		}
 		// bun audit exits non-zero when vulnerabilities are found; stdout still contains the data
@@ -466,7 +472,7 @@ async function runSecurityScan() { // NOSONAR S3776
 					return {
 						success: false,
 						duration: Date.now() - startTime,
-						message: 'Security audit timed out after 2 minutes',
+						message: validationTimeoutMessage('Security audit'),
 					};
 				}
 				// npm audit exits non-zero when it finds any vulnerability - stdout still has JSON
@@ -521,7 +527,7 @@ async function runSecurityScan() { // NOSONAR S3776
 				return {
 					success: false,
 					duration: Date.now() - startTime,
-					message: 'Security audit timed out after 2 minutes',
+					message: validationTimeoutMessage('Security audit'),
 				};
 			}
 
@@ -564,7 +570,7 @@ async function runAllTests() {
 	const startTime = Date.now();
 
 	try {
-		const result = execFileSync('bun', ['test'], getExecOptions());  // NOSONAR S4036 - hardcoded CLI command, no user input, developer tool context
+		const result = execFileSync('bun', ['test', '--timeout', '30000'], getExecOptions());  // NOSONAR S4036 - hardcoded CLI command, no user input, developer tool context
 
 		// Parse bun test output
 		const passed = parseNumber(/(\d+) pass/.exec(result));  // NOSONAR S5852 - bounded \d+ pattern
@@ -591,7 +597,7 @@ async function runAllTests() {
 				passed: 0,
 				failed: 0,
 				total: 0,
-				message: 'Test execution timed out after 2 minutes',
+				message: validationTimeoutMessage('Test execution'),
 			};
 		}
 

package/lib/commands/worktree.js

@@ -3,6 +3,7 @@
 const { execFileSync, spawnSync } = require('node:child_process');
 const fs = require('node:fs');
 const path = require('node:path');
+const { bootstrapBeads } = require('../beads-bootstrap');
 
 /**
  * Forge Worktree Command
@@ -10,8 +11,8 @@ const path = require('node:path');
  * Uses execFileSync (not execSync) to prevent command injection (OWASP A03).
  *
  * Subcommands:
- *   create <slug> — Create worktree at .worktrees/<slug> with branch + beads + install
- *   remove <slug> — Remove worktree via git worktree remove
+ *   create <slug> - Create worktree at .worktrees/<slug> with branch + beads + install
+ *   remove <slug> - Remove worktree via git worktree remove
  *
  * @module commands/worktree
  */
@@ -31,25 +32,10 @@ function detectPackageManager(projectRoot, fsApi) {
   return null;
 }
 
-/**
- * Copy .beads/ directory excluding daemon.lock.
- * @param {string} source - Source .beads path
- * @param {string} dest - Destination .beads path
- * @param {object} fsApi - fs module (for DI)
- */
-function copyBeadsDir(source, dest, fsApi) {
-  fsApi.mkdirSync(dest, { recursive: true });
-  const entries = fsApi.readdirSync(source);
-  for (const entry of entries) {
-    if (entry === 'daemon.lock') continue;
-    fsApi.cpSync(path.join(source, entry), path.join(dest, entry), { recursive: true });
-  }
-}
-
 /**
  * Stop a Dolt server running in a worktree to release file locks.
  * Tries graceful `bd dolt stop` first, then falls back to PID-based kill
- * from lock files. Never kills ALL Dolt processes — only the specific PID.
+ * from lock files. Never kills ALL Dolt processes - only the specific PID.
  *
  * @param {string} worktreePath - Absolute path to the worktree
  * @param {object} [opts] - Options for dependency injection
@@ -106,46 +92,29 @@ function branchExists(branchName, runFile) {
   }
 }
 
-/**
- * Set up Beads integration for a new worktree (symlink/junction/copy).
- * @param {string} worktreePath - Absolute path to the new worktree
- * @param {string} projectRoot - Absolute path to the project root
- * @param {string} platform - OS platform string (e.g. 'win32')
- * @param {object} fsApi - fs module (for DI)
- * @param {Function} exec - execFileSync-compatible function
- * @returns {string|null} Warning message if beads setup had issues, null otherwise
- */
-function setupBeads(worktreePath, projectRoot, platform, fsApi, exec) {
-  const beadsSource = path.resolve(projectRoot, '.beads');
-  const beadsDest = path.resolve(worktreePath, '.beads');
-
-  if (!fsApi.existsSync(beadsSource)) {
-    return 'Beads not installed — skipping .beads setup';
+function setupBeadsWithBootstrap(worktreePath, projectRoot, platform, fsApi, exec, options = {}) {
+  if (!fsApi.existsSync(path.resolve(projectRoot, '.beads'))) {
+    return 'Beads not installed - skipping .beads setup';
   }
 
-  // Try symlink first
-  try {
-    if (platform === 'win32') {
-      fsApi.symlinkSync(beadsSource, beadsDest, 'junction');
-    } else {
-      fsApi.symlinkSync(beadsSource, beadsDest);
-    }
-  } catch (symlinkErr) {
-    if (symlinkErr.code === 'EPERM') {
-      copyBeadsDir(beadsSource, beadsDest, fsApi);
-    } else {
-      throw symlinkErr;
-    }
-  }
+  const bootstrapResult = bootstrapBeads(worktreePath, {
+    _exec: exec,
+    _fs: fsApi,
+    _platform: platform,
+    mainProjectRoot: projectRoot,
+    _safeBeadsInit: options._safeBeadsInit,
+  });
 
-  // Verify beads accessible (warn if fails, don't block)
   try {
     exec('bd', ['--version'], { cwd: worktreePath, timeout: 5000, stdio: 'pipe' });
   } catch (_bdErr) { /* intentional: bd may not be on PATH */ // NOSONAR S2486
-    return 'Beads verification failed — .beads linked but bd may not work';
+    if (bootstrapResult.success === false && bootstrapResult.warning) {
+      return bootstrapResult.warning;
+    }
+    return 'Beads verification failed - .beads linked but bd may not work';
   }
 
-  return null;
+  return bootstrapResult.warning;
 }
 
 /**
@@ -179,13 +148,17 @@ async function handleCreate(slug, flags, projectRoot, opts) {
   const branchName = flags['--branch'] || flags.branch || `feat/${slug}`;
   const worktreesDir = path.resolve(projectRoot, '.worktrees');
 
-  // Guard: Detect bare repo state — worktrees created from bare repos produce broken branches
+  // Guard: Detect bare repo state - worktrees created from bare repos produce broken branches
   // git rev-parse --show-toplevel throws in a bare repo (no working tree)
   try {
     runFile('git', ['-C', projectRoot, 'rev-parse', '--show-toplevel'], { encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] });
-  } catch (_e) { // NOSONAR S2486
+  } catch (error) {
     /* intentional: show-toplevel fails in bare repos */
-    return { success: false, error: 'Main repo is in bare state (no working tree). Clone fresh instead: git clone <url> /tmp/forge-<slug>' };
+    const errMsg = String(error?.stderr || error?.message || '').trim();
+    if (/must be run in a work tree|this operation must be run in a work tree/i.test(errMsg)) {
+      return { success: false, error: 'bare repo detected' };
+    }
+    return { success: false, error: errMsg || 'git rev-parse --show-toplevel failed' };
   }
 
   // Security: Validate slug doesn't contain path traversal (OWASP A01/A03)
@@ -217,7 +190,7 @@ async function handleCreate(slug, flags, projectRoot, opts) {
   }
 
   // Step 3: Beads integration
-  const beadsWarning = setupBeads(worktreePath, projectRoot, platform, fsApi, runFile);
+  const beadsWarning = setupBeadsWithBootstrap(worktreePath, projectRoot, platform, fsApi, runFile, opts);
 
   // Step 4: Run package install
   runInstall(worktreePath, projectRoot, runSpawn, fsApi);