@cluesmith/codev 2.0.0-rc.8 → 2.0.0

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

@@ -0,0 +1,278 @@
+/**
+ * Role and prompt template utilities for spawn command.
+ * Spec 0105: Tower Server Decomposition — Phase 7
+ *
+ * Handles template rendering, prompt building, and role loading
+ * for builder sessions.
+ */
+import { resolve } from 'node:path';
+import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import { readdir } from 'node:fs/promises';
+import { logger, fatal } from '../utils/logger.js';
+import { loadRolePrompt } from '../utils/roles.js';
+/**
+ * Get nested value from object using dot notation
+ */
+function getNestedValue(obj, path) {
+    const parts = path.split('.');
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    let current = obj;
+    for (const part of parts) {
+        if (current === null || current === undefined)
+            return undefined;
+        current = current[part];
+    }
+    return current;
+}
+/**
+ * Simple Handlebars-like template renderer
+ * Supports: {{variable}}, {{#if condition}}...{{/if}}, {{object.property}}
+ */
+export function renderTemplate(template, context) {
+    let result = template;
+    // Process {{#if condition}}...{{/if}} blocks
+    // eslint-disable-next-line no-constant-condition
+    while (true) {
+        const ifMatch = result.match(/\{\{#if\s+(\w+)\}\}([\s\S]*?)\{\{\/if\}\}/);
+        if (!ifMatch)
+            break;
+        const [fullMatch, condition, content] = ifMatch;
+        const value = getNestedValue(context, condition);
+        result = result.replace(fullMatch, value ? content : '');
+    }
+    // Process {{variable}} and {{object.property}} substitutions
+    result = result.replace(/\{\{(\w+(?:\.\w+)*)\}\}/g, (_, path) => {
+        const value = getNestedValue(context, path);
+        if (value === undefined || value === null)
+            return '';
+        return String(value);
+    });
+    // Clean up any double newlines left from removed sections
+    result = result.replace(/\n{3,}/g, '\n\n');
+    return result.trim();
+}
+/**
+ * Load builder-prompt.md template for a protocol
+ */
+function loadBuilderPromptTemplate(config, protocolName) {
+    const templatePath = resolve(config.codevDir, 'protocols', protocolName, 'builder-prompt.md');
+    if (existsSync(templatePath)) {
+        return readFileSync(templatePath, 'utf-8');
+    }
+    return null;
+}
+/**
+ * Build a fallback prompt when no template exists
+ */
+function buildFallbackPrompt(protocolName, context) {
+    const modeInstructions = context.mode === 'strict'
+        ? `## Mode: STRICT
+Porch orchestrates your work. Run: \`porch next\` to get your next tasks.`
+        : `## Mode: SOFT
+You follow the protocol yourself. The architect monitors your work and verifies compliance.`;
+    let prompt = `# ${protocolName.toUpperCase()} Builder (${context.mode} mode)
+
+You are implementing ${context.input_description}.
+
+${modeInstructions}
+
+## Protocol
+Follow the ${protocolName.toUpperCase()} protocol: \`codev/protocols/${protocolName}/protocol.md\`
+Read and internalize the protocol before starting any work.
+`;
+    if (context.spec) {
+        prompt += `\n## Spec\nRead the specification at: \`${context.spec.path}\`\n`;
+    }
+    if (context.plan) {
+        prompt += `\n## Plan\nFollow the implementation plan at: \`${context.plan.path}\`\n`;
+    }
+    if (context.issue) {
+        prompt += `\n## Issue #${context.issue.number}
+**Title**: ${context.issue.title}
+
+**Description**:
+${context.issue.body || '(No description provided)'}
+`;
+    }
+    if (context.task_text) {
+        prompt += `\n## Task\n${context.task_text}\n`;
+    }
+    return prompt;
+}
+/**
+ * Build the prompt using protocol template or fallback to inline prompt
+ */
+export function buildPromptFromTemplate(config, protocolName, context) {
+    const template = loadBuilderPromptTemplate(config, protocolName);
+    if (template) {
+        logger.info(`Using template: protocols/${protocolName}/builder-prompt.md`);
+        return renderTemplate(template, context);
+    }
+    // Fallback: no template found, return a basic prompt
+    logger.debug(`No template found for ${protocolName}, using inline prompt`);
+    return buildFallbackPrompt(protocolName, context);
+}
+// =============================================================================
+// Resume Context
+// =============================================================================
+/**
+ * Build a resume notice to prepend to the builder prompt.
+ * Tells the builder this is a resumed session and to check existing porch state.
+ */
+export function buildResumeNotice(_projectId) {
+    return `## RESUME SESSION
+
+This is a **resumed** builder session. A previous session was working in this worktree.
+
+Start by running \`porch next\` to check your current state and get next tasks.
+If porch state exists, continue from where the previous session left off.
+If porch reports "not found", run \`porch init\` to re-initialize.
+`;
+}
+// =============================================================================
+// Role Loading
+// =============================================================================
+/**
+ * Load a protocol-specific role if it exists
+ */
+export function loadProtocolRole(config, protocolName) {
+    const protocolRolePath = resolve(config.codevDir, 'protocols', protocolName, 'role.md');
+    if (existsSync(protocolRolePath)) {
+        return { content: readFileSync(protocolRolePath, 'utf-8'), source: 'protocol' };
+    }
+    // Fall back to builder role
+    return loadRolePrompt(config, 'builder');
+}
+// =============================================================================
+// Protocol Resolution
+// =============================================================================
+/**
+ * Find a spec file by project ID
+ */
+export async function findSpecFile(codevDir, projectId) {
+    const specsDir = resolve(codevDir, 'specs');
+    if (!existsSync(specsDir)) {
+        return null;
+    }
+    const files = await readdir(specsDir);
+    // Try exact match first (e.g., "0001-feature.md")
+    for (const file of files) {
+        if (file.startsWith(projectId) && file.endsWith('.md')) {
+            return resolve(specsDir, file);
+        }
+    }
+    // Try partial match (e.g., just "0001")
+    for (const file of files) {
+        if (file.startsWith(projectId + '-') && file.endsWith('.md')) {
+            return resolve(specsDir, file);
+        }
+    }
+    return null;
+}
+/**
+ * Validate that a protocol exists
+ */
+export function validateProtocol(config, protocolName) {
+    const protocolDir = resolve(config.codevDir, 'protocols', protocolName);
+    const protocolFile = resolve(protocolDir, 'protocol.md');
+    if (!existsSync(protocolDir)) {
+        const protocolsDir = resolve(config.codevDir, 'protocols');
+        let available = '';
+        if (existsSync(protocolsDir)) {
+            const dirs = readdirSync(protocolsDir, { withFileTypes: true })
+                .filter((d) => d.isDirectory())
+                .map((d) => d.name);
+            if (dirs.length > 0) {
+                available = `\n\nAvailable protocols: ${dirs.join(', ')}`;
+            }
+        }
+        fatal(`Protocol not found: ${protocolName}${available}`);
+    }
+    if (!existsSync(protocolFile)) {
+        fatal(`Protocol ${protocolName} exists but has no protocol.md file`);
+    }
+}
+/**
+ * Load and parse a protocol.json file
+ */
+export function loadProtocol(config, protocolName) {
+    const protocolJsonPath = resolve(config.codevDir, 'protocols', protocolName, 'protocol.json');
+    if (!existsSync(protocolJsonPath)) {
+        return null;
+    }
+    try {
+        const content = readFileSync(protocolJsonPath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        logger.warn(`Warning: Failed to parse ${protocolJsonPath}`);
+        return null;
+    }
+}
+/**
+ * Resolve which protocol to use based on precedence:
+ * 1. Explicit --protocol flag when used as override (with other input modes)
+ * 2. Explicit --use-protocol flag (backwards compatibility)
+ * 3. Spec file **Protocol**: header (for --project mode)
+ * 4. Hardcoded defaults (spir for specs, bugfix for issues)
+ */
+export async function resolveProtocol(options, config) {
+    const inputModes = [
+        options.project, options.task, options.shell, options.worktree, options.issue,
+    ].filter(Boolean);
+    const protocolAsOverride = options.protocol && inputModes.length > 0;
+    if (protocolAsOverride) {
+        validateProtocol(config, options.protocol);
+        return options.protocol.toLowerCase();
+    }
+    if (options.useProtocol) {
+        validateProtocol(config, options.useProtocol);
+        return options.useProtocol.toLowerCase();
+    }
+    if (options.project) {
+        const specFile = await findSpecFile(config.codevDir, options.project);
+        if (specFile) {
+            const specContent = readFileSync(specFile, 'utf-8');
+            const match = specContent.match(/\*\*Protocol\*\*:\s*(\w+)/i);
+            if (match) {
+                const protocolFromSpec = match[1].toLowerCase();
+                try {
+                    validateProtocol(config, protocolFromSpec);
+                    return protocolFromSpec;
+                }
+                catch {
+                    logger.warn(`Warning: Protocol "${match[1]}" from spec not found, using default`);
+                }
+            }
+        }
+    }
+    if (options.project)
+        return 'spir';
+    if (options.issue)
+        return 'bugfix';
+    if (options.protocol)
+        return options.protocol.toLowerCase();
+    if (options.task)
+        return 'spir';
+    return 'spir';
+}
+/**
+ * Resolve the builder mode (strict vs soft)
+ * Precedence: explicit flags > protocol defaults > input type defaults
+ */
+export function resolveMode(options, protocol) {
+    if (options.strict && options.soft) {
+        fatal('--strict and --soft are mutually exclusive');
+    }
+    if (options.strict)
+        return 'strict';
+    if (options.soft)
+        return 'soft';
+    if (protocol?.defaults?.mode) {
+        return protocol.defaults.mode;
+    }
+    if (options.project)
+        return 'strict';
+    return 'soft';
+}
+//# sourceMappingURL=spawn-roles.js.map

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

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

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

@@ -0,0 +1,96 @@
+/**
+ * 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 type { Config, ProtocolDefinition } from '../types.js';
+export declare const DEFAULT_TOWER_PORT = 4100;
+/**
+ * Check for required dependencies
+ */
+export declare function checkDependencies(): Promise<void>;
+/**
+ * Create git branch and worktree
+ */
+export declare function createWorktree(config: Config, branchName: string, worktreePath: string): Promise<void>;
+/**
+ * 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 declare function initPorchInWorktree(worktreePath: string, protocol: string, projectId: string, projectName: string): Promise<void>;
+/**
+ * GitHub issue structure from gh issue view --json
+ */
+export interface GitHubIssue {
+    title: string;
+    body: string;
+    state: string;
+    comments: Array<{
+        body: string;
+        createdAt: string;
+        author: {
+            login: string;
+        };
+    }>;
+}
+/**
+ * Generate a slug from an issue title (max 30 chars, lowercase, alphanumeric + hyphens)
+ */
+export declare function slugify(title: string): string;
+/**
+ * Fetch a GitHub issue via gh CLI
+ */
+export declare function fetchGitHubIssue(issueNumber: number): Promise<GitHubIssue>;
+/**
+ * Check for collision conditions before spawning bugfix
+ */
+export declare function checkBugfixCollisions(issueNumber: number, worktreePath: string, issue: GitHubIssue, force: boolean): Promise<void>;
+/**
+ * Execute pre-spawn hooks defined in protocol.json
+ * Hooks are data-driven but reuse existing implementation logic
+ */
+export declare function executePreSpawnHooks(protocol: ProtocolDefinition | null, context: {
+    issueNumber?: number;
+    issue?: GitHubIssue;
+    worktreePath?: string;
+    force?: boolean;
+    noComment?: boolean;
+}): Promise<void>;
+/**
+ * Validate that a worktree exists and is valid for resuming
+ */
+export declare function validateResumeWorktree(worktreePath: string): void;
+/**
+ * Create a terminal session via the Tower REST API.
+ * The Tower server must be running (port 4100).
+ */
+export declare function createPtySession(config: Config, command: string, args: string[], cwd: string, registration?: {
+    projectPath: string;
+    type: 'builder' | 'shell';
+    roleId: string;
+}): Promise<{
+    terminalId: string;
+}>;
+/**
+ * Start a terminal session for a builder
+ */
+export declare function startBuilderSession(config: Config, builderId: string, worktreePath: string, baseCmd: string, prompt: string, roleContent: string | null, roleSource: string | null): Promise<{
+    terminalId: string;
+}>;
+/**
+ * Start a shell session (no worktree, just node-pty)
+ */
+export declare function startShellSession(config: Config, shellId: string, baseCmd: string): Promise<{
+    terminalId: string;
+}>;
+/**
+ * Build a launch script for worktree mode (no initial prompt)
+ */
+export declare function buildWorktreeLaunchScript(worktreePath: string, baseCmd: string, role: {
+    content: string;
+    source: string;
+} | null): string;
+//# sourceMappingURL=spawn-worktree.d.ts.map

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

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