@cluesmith/codev 2.0.0-rc.72 → 2.0.0-rc.73

package/dist/agent-farm/commands/spawn-worktree.js

@@ -0,0 +1,305 @@
+/**
+ * Git worktree management, session creation, and pre-spawn utilities.
+ * Spec 0105: Tower Server Decomposition — Phase 7
+ *
+ * Handles worktree creation, dependency checking, porch initialization,
+ * bugfix collision detection, GitHub issue fetching, pre-spawn hooks,
+ * and terminal session creation via the Tower REST API.
+ */
+import { resolve } from 'node:path';
+import { existsSync, writeFileSync, chmodSync, symlinkSync } from 'node:fs';
+import { logger, fatal } from '../utils/logger.js';
+import { run, commandExists } from '../utils/shell.js';
+// Tower port — the single HTTP server since Spec 0090
+export const DEFAULT_TOWER_PORT = 4100;
+// =============================================================================
+// Dependency Checks
+// =============================================================================
+/**
+ * Check for required dependencies
+ */
+export async function checkDependencies() {
+    if (!(await commandExists('git'))) {
+        fatal('git not found');
+    }
+}
+// =============================================================================
+// Git Worktree Management
+// =============================================================================
+/**
+ * Create git branch and worktree
+ */
+export async function createWorktree(config, branchName, worktreePath) {
+    logger.info('Creating branch...');
+    try {
+        await run(`git branch ${branchName}`, { cwd: config.projectRoot });
+    }
+    catch (error) {
+        // Branch might already exist, that's OK
+        logger.debug(`Branch creation: ${error}`);
+    }
+    logger.info('Creating worktree...');
+    try {
+        await run(`git worktree add "${worktreePath}" ${branchName}`, { cwd: config.projectRoot });
+    }
+    catch (error) {
+        fatal(`Failed to create worktree: ${error}`);
+    }
+    // Symlink .env from project root into worktree (if it exists)
+    const rootEnvPath = resolve(config.projectRoot, '.env');
+    const worktreeEnvPath = resolve(worktreePath, '.env');
+    if (existsSync(rootEnvPath) && !existsSync(worktreeEnvPath)) {
+        try {
+            symlinkSync(rootEnvPath, worktreeEnvPath);
+            logger.info('Linked .env from project root');
+        }
+        catch (error) {
+            logger.debug(`Failed to symlink .env: ${error}`);
+        }
+    }
+}
+/**
+ * Pre-initialize porch in a worktree so the builder doesn't need to self-correct.
+ * Non-fatal: logs a warning on failure since the builder can still init manually.
+ */
+export async function initPorchInWorktree(worktreePath, protocol, projectId, projectName) {
+    logger.info('Initializing porch...');
+    try {
+        // Sanitize inputs to prevent shell injection (defense-in-depth;
+        // callers already use slugified names, but be safe)
+        const safeName = projectName.replace(/[^a-z0-9_-]/gi, '-');
+        const safeProto = protocol.replace(/[^a-z0-9_-]/gi, '');
+        const safeId = projectId.replace(/[^a-z0-9_-]/gi, '');
+        await run(`porch init ${safeProto} ${safeId} "${safeName}"`, { cwd: worktreePath });
+        logger.info(`Porch initialized: ${projectId}`);
+    }
+    catch (error) {
+        logger.warn(`Warning: Failed to initialize porch (builder can init manually): ${error}`);
+    }
+}
+/**
+ * Generate a slug from an issue title (max 30 chars, lowercase, alphanumeric + hyphens)
+ */
+export function slugify(title) {
+    return title
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-') // Replace non-alphanumeric with hyphens
+        .replace(/-+/g, '-') // Collapse multiple hyphens
+        .replace(/^-|-$/g, '') // Trim leading/trailing hyphens
+        .slice(0, 30); // Max 30 chars
+}
+/**
+ * Fetch a GitHub issue via gh CLI
+ */
+export async function fetchGitHubIssue(issueNumber) {
+    try {
+        const result = await run(`gh issue view ${issueNumber} --json title,body,state,comments`);
+        return JSON.parse(result.stdout);
+    }
+    catch (error) {
+        fatal(`Failed to fetch issue #${issueNumber}. Ensure 'gh' CLI is installed and authenticated.`);
+        throw error; // TypeScript doesn't know fatal() never returns
+    }
+}
+// =============================================================================
+// Bugfix Collision Detection
+// =============================================================================
+/**
+ * Check for collision conditions before spawning bugfix
+ */
+export async function checkBugfixCollisions(issueNumber, worktreePath, issue, force) {
+    // 1. Check if worktree already exists
+    if (existsSync(worktreePath)) {
+        fatal(`Worktree already exists at ${worktreePath}\nRun: af cleanup --issue ${issueNumber}`);
+    }
+    // 2. Check for recent "On it" comments (< 24h old)
+    const onItComments = issue.comments.filter((c) => c.body.toLowerCase().includes('on it'));
+    if (onItComments.length > 0) {
+        const lastComment = onItComments[onItComments.length - 1];
+        const age = Date.now() - new Date(lastComment.createdAt).getTime();
+        const hoursAgo = Math.round(age / (1000 * 60 * 60));
+        if (hoursAgo < 24) {
+            if (!force) {
+                fatal(`Issue #${issueNumber} has "On it" comment from ${hoursAgo}h ago (by @${lastComment.author.login}).\nSomeone may already be working on this. Use --force to override.`);
+            }
+            logger.warn(`Warning: "On it" comment from ${hoursAgo}h ago - proceeding with --force`);
+        }
+        else {
+            logger.warn(`Warning: Stale "On it" comment (${hoursAgo}h ago). Proceeding.`);
+        }
+    }
+    // 3. Check for open PRs referencing this issue
+    try {
+        const prResult = await run(`gh pr list --search "in:body #${issueNumber}" --json number,title --limit 5`);
+        const openPRs = JSON.parse(prResult.stdout);
+        if (openPRs.length > 0) {
+            if (!force) {
+                const prList = openPRs.map((pr) => `  - PR #${pr.number}: ${pr.title}`).join('\n');
+                fatal(`Found ${openPRs.length} open PR(s) referencing issue #${issueNumber}:\n${prList}\nUse --force to proceed anyway.`);
+            }
+            logger.warn(`Warning: Found ${openPRs.length} open PR(s) referencing issue - proceeding with --force`);
+        }
+    }
+    catch {
+        // Non-fatal: continue if PR check fails
+    }
+    // 4. Warn if issue is already closed
+    if (issue.state === 'CLOSED') {
+        logger.warn(`Warning: Issue #${issueNumber} is already closed`);
+    }
+}
+// =============================================================================
+// Pre-Spawn Hooks
+// =============================================================================
+/**
+ * Execute pre-spawn hooks defined in protocol.json
+ * Hooks are data-driven but reuse existing implementation logic
+ */
+export async function executePreSpawnHooks(protocol, context) {
+    if (!protocol?.hooks?.['pre-spawn'])
+        return;
+    const hooks = protocol.hooks['pre-spawn'];
+    // collision-check: reuses existing checkBugfixCollisions() logic
+    if (hooks['collision-check'] && context.issueNumber && context.issue && context.worktreePath) {
+        await checkBugfixCollisions(context.issueNumber, context.worktreePath, context.issue, !!context.force);
+    }
+    // comment-on-issue: posts comment to GitHub issue
+    if (hooks['comment-on-issue'] && context.issueNumber && !context.noComment) {
+        const message = hooks['comment-on-issue'];
+        logger.info('Commenting on issue...');
+        try {
+            await run(`gh issue comment ${context.issueNumber} --body "${message}"`);
+        }
+        catch {
+            logger.warn('Warning: Failed to comment on issue (continuing anyway)');
+        }
+    }
+}
+// =============================================================================
+// Resume Validation
+// =============================================================================
+/**
+ * Validate that a worktree exists and is valid for resuming
+ */
+export function validateResumeWorktree(worktreePath) {
+    if (!existsSync(worktreePath)) {
+        fatal(`Cannot resume: worktree does not exist at ${worktreePath}`);
+    }
+    if (!existsSync(resolve(worktreePath, '.git'))) {
+        fatal(`Cannot resume: ${worktreePath} is not a valid git worktree`);
+    }
+    logger.info('Resuming existing worktree (skipping creation)');
+}
+// =============================================================================
+// Terminal Session Creation
+// =============================================================================
+/**
+ * Create a terminal session via the Tower REST API.
+ * The Tower server must be running (port 4100).
+ */
+export async function createPtySession(config, command, args, cwd, registration) {
+    const body = { command, args, cwd, cols: 200, rows: 50, persistent: true };
+    if (registration) {
+        body.projectPath = registration.projectPath;
+        body.type = registration.type;
+        body.roleId = registration.roleId;
+    }
+    const response = await fetch(`http://localhost:${DEFAULT_TOWER_PORT}/api/terminals`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify(body),
+    });
+    if (!response.ok) {
+        const text = await response.text();
+        throw new Error(`Failed to create PTY session: ${response.status} ${text}`);
+    }
+    const result = await response.json();
+    return { terminalId: result.id };
+}
+/**
+ * Start a terminal session for a builder
+ */
+export async function startBuilderSession(config, builderId, worktreePath, baseCmd, prompt, roleContent, roleSource) {
+    logger.info('Creating terminal session...');
+    // Write initial prompt to a file for reference
+    const promptFile = resolve(worktreePath, '.builder-prompt.txt');
+    writeFileSync(promptFile, prompt);
+    // Build the start script with role if provided
+    const scriptPath = resolve(worktreePath, '.builder-start.sh');
+    let scriptContent;
+    if (roleContent) {
+        // Write role to a file and use $(cat) to avoid shell escaping issues
+        const roleFile = resolve(worktreePath, '.builder-role.md');
+        // Inject the actual dashboard port into the role prompt
+        const roleWithPort = roleContent.replace(/\{PORT\}/g, String(DEFAULT_TOWER_PORT));
+        writeFileSync(roleFile, roleWithPort);
+        logger.info(`Loaded role (${roleSource})`);
+        scriptContent = `#!/bin/bash
+cd "${worktreePath}"
+while true; do
+  ${baseCmd} --append-system-prompt "$(cat '${roleFile}')" "$(cat '${promptFile}')"
+  echo ""
+  echo "Claude exited. Restarting in 2 seconds... (Ctrl+C to quit)"
+  sleep 2
+done
+`;
+    }
+    else {
+        scriptContent = `#!/bin/bash
+cd "${worktreePath}"
+while true; do
+  ${baseCmd} "$(cat '${promptFile}')"
+  echo ""
+  echo "Claude exited. Restarting in 2 seconds... (Ctrl+C to quit)"
+  sleep 2
+done
+`;
+    }
+    writeFileSync(scriptPath, scriptContent);
+    chmodSync(scriptPath, '755');
+    // Create PTY session via Tower REST API (shepherd for persistence)
+    logger.info('Creating PTY terminal session...');
+    const { terminalId } = await createPtySession(config, '/bin/bash', [scriptPath], worktreePath, { projectPath: config.projectRoot, type: 'builder', roleId: builderId });
+    logger.info(`Terminal session created: ${terminalId}`);
+    return { terminalId };
+}
+/**
+ * Start a shell session (no worktree, just node-pty)
+ */
+export async function startShellSession(config, shellId, baseCmd) {
+    // Create PTY session via REST API
+    logger.info('Creating PTY terminal session for shell...');
+    const { terminalId } = await createPtySession(config, '/bin/bash', ['-c', baseCmd], config.projectRoot, { projectPath: config.projectRoot, type: 'shell', roleId: shellId });
+    logger.info(`Shell terminal session created: ${terminalId}`);
+    return { terminalId };
+}
+/**
+ * Build a launch script for worktree mode (no initial prompt)
+ */
+export function buildWorktreeLaunchScript(worktreePath, baseCmd, role) {
+    if (role) {
+        const roleFile = resolve(worktreePath, '.builder-role.md');
+        const roleWithPort = role.content.replace(/\{PORT\}/g, String(DEFAULT_TOWER_PORT));
+        writeFileSync(roleFile, roleWithPort);
+        logger.info(`Loaded role (${role.source})`);
+        return `#!/bin/bash
+cd "${worktreePath}"
+while true; do
+  ${baseCmd} --append-system-prompt "$(cat '${roleFile}')"
+  echo ""
+  echo "Claude exited. Restarting in 2 seconds... (Ctrl+C to quit)"
+  sleep 2
+done
+`;
+    }
+    return `#!/bin/bash
+cd "${worktreePath}"
+while true; do
+  ${baseCmd}
+  echo ""
+  echo "Claude exited. Restarting in 2 seconds... (Ctrl+C to quit)"
+  sleep 2
+done
+`;
+}
+//# sourceMappingURL=spawn-worktree.js.map

package/dist/agent-farm/commands/spawn-worktree.js.map

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

package/dist/agent-farm/commands/spawn.d.ts

@@ -1,11 +1,15 @@
 /**
- * Spawn command - creates a new builder in various modes
+ * Spawn command — orchestrator module.
+ * Spec 0105: Tower Server Decomposition — Phase 7
  *
  * Modes:
  * - spec:     --project/-p  Spawn for a spec file (existing behavior)
  * - task:     --task        Spawn with an ad-hoc task description
  * - protocol: --protocol    Spawn to run a protocol (cleanup, experiment, etc.)
  * - shell:    --shell       Bare Claude session (no prompt, no worktree)
+ *
+ * Role/prompt logic extracted to spawn-roles.ts.
+ * Worktree/git logic extracted to spawn-worktree.ts.
  */
 import type { SpawnOptions } from '../types.js';
 /**

package/dist/agent-farm/commands/spawn.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spawn.d.ts","sourceRoot":"","sources":["../../../src/agent-farm/commands/spawn.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAoD,MAAM,aAAa,CAAC;AAozClG;;GAEG;AACH,wBAAsB,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAwDhE"}
+{"version":3,"file":"spawn.d.ts","sourceRoot":"","sources":["../../../src/agent-farm/commands/spawn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAgC,MAAM,aAAa,CAAC;AAyf9E;;GAEG;AACH,wBAAsB,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CA6ChE"}