@cluesmith/codev 1.1.0

package/dist/agent-farm/tutorial/steps/planning.js

@@ -0,0 +1,143 @@
+/**
+ * Tutorial Step 4: Planning Phase
+ * Shows how to create an implementation plan from a spec
+ */
+import { existsSync } from 'node:fs';
+import { readFile, writeFile } from 'node:fs/promises';
+import { resolve } from 'node:path';
+import * as prompts from '../prompts.js';
+function generatePlan(title) {
+    return `# Plan: ${title}
+
+## Metadata
+
+- **Spec**: codev/specs/tutorial-example.md
+- **Protocol**: TICK
+- **Created**: ${new Date().toISOString().split('T')[0]}
+
+## Overview
+
+Implementation approach for "${title}".
+
+## Implementation Steps
+
+### Step 1: [First task]
+
+**Files to modify**:
+- \`path/to/file.ts\`
+
+**Changes**:
+- [Describe what to do]
+
+### Step 2: [Second task]
+
+**Files to modify**:
+- \`path/to/another-file.ts\`
+
+**Changes**:
+- [Describe what to do]
+
+### Step 3: Testing
+
+- [ ] Write unit tests
+- [ ] Manual testing
+- [ ] Update documentation
+
+## Risks
+
+| Risk | Mitigation |
+|------|------------|
+| [Risk 1] | [How to handle it] |
+
+## Testing Checklist
+
+- [ ] Feature works as specified
+- [ ] Edge cases handled
+- [ ] No regressions
+
+---
+
+*Created via Agent Farm tutorial*
+`;
+}
+export const planningStep = {
+    id: 'planning',
+    title: 'Create an Implementation Plan',
+    async run(ctx) {
+        prompts.content('Now let\'s create a plan for your spec!\n');
+        prompts.content('A plan describes HOW you\'ll implement the spec.');
+        prompts.content('It breaks the work into concrete, actionable steps.\n');
+        prompts.content('Good plans include:');
+        prompts.bullet('Specific files to create or modify');
+        prompts.bullet('Step-by-step implementation order');
+        prompts.bullet('Testing strategy');
+        prompts.bullet('Potential risks and mitigations');
+        console.log();
+        // Check if spec exists
+        const specPath = resolve(ctx.projectPath, 'codev', 'specs', 'tutorial-example.md');
+        let specTitle = ctx.state.userResponses.specTitle || 'Tutorial Task';
+        if (existsSync(specPath)) {
+            try {
+                const specContent = await readFile(specPath, 'utf-8');
+                const titleMatch = specContent.match(/^#\s+Specification:\s+(.+)$/m);
+                if (titleMatch) {
+                    specTitle = titleMatch[1];
+                }
+                prompts.success(`Found your spec: "${specTitle}"`);
+            }
+            catch {
+                // Use default
+            }
+        }
+        else {
+            prompts.info('No spec found at codev/specs/tutorial-example.md');
+            prompts.content('We\'ll create an example plan anyway.\n');
+        }
+        // Explain TICK vs SPIDER
+        prompts.content('\nChoosing a Protocol:\n');
+        prompts.content('TICK (fast protocol):');
+        prompts.bullet('For small, well-defined tasks');
+        prompts.bullet('< 300 lines of code');
+        prompts.bullet('Straightforward implementation');
+        console.log();
+        prompts.content('SPIDER (full protocol):');
+        prompts.bullet('For complex features');
+        prompts.bullet('Multiple phases with reviews');
+        prompts.bullet('Multi-agent consultation');
+        console.log();
+        prompts.info(`For "${specTitle}", TICK is probably the right choice.`);
+        console.log();
+        // Generate and show plan
+        const planContent = generatePlan(specTitle);
+        prompts.content('Here\'s a plan template:\n');
+        prompts.code(planContent.slice(0, 600) + '...');
+        console.log();
+        const shouldSave = await prompts.confirm('Save this plan to codev/plans/tutorial-example.md?');
+        if (shouldSave) {
+            const plansDir = resolve(ctx.projectPath, 'codev', 'plans');
+            const planPath = resolve(plansDir, 'tutorial-example.md');
+            try {
+                if (!existsSync(plansDir)) {
+                    const { mkdirSync } = await import('node:fs');
+                    mkdirSync(plansDir, { recursive: true });
+                }
+                await writeFile(planPath, planContent);
+                prompts.success(`Saved to codev/plans/tutorial-example.md`);
+            }
+            catch (error) {
+                prompts.warn(`Failed to save: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        }
+        console.log();
+        prompts.content('Multi-Agent Consultation:\n');
+        prompts.content('For complex features, SPIDER protocol includes multi-agent review.');
+        prompts.content('This means getting input from multiple AI models (e.g., Claude, Gemini, GPT)');
+        prompts.content('to catch blind spots and consider alternatives.');
+        console.log();
+        prompts.info('See codev/protocols/ for details on consultation workflows.');
+        console.log();
+        await prompts.pressEnter();
+        return { status: 'completed' };
+    },
+};
+//# sourceMappingURL=planning.js.map

package/dist/agent-farm/tutorial/steps/planning.js.map

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

package/dist/agent-farm/tutorial/steps/review.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Tutorial Step 6: Review & Next Steps
+ * Covers the review process and points to further resources
+ */
+import type { Step } from '../runner.js';
+export declare const reviewStep: Step;
+//# sourceMappingURL=review.d.ts.map

package/dist/agent-farm/tutorial/steps/review.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review.d.ts","sourceRoot":"","sources":["../../../../src/agent-farm/tutorial/steps/review.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,IAAI,EAA2B,MAAM,cAAc,CAAC;AAGlE,eAAO,MAAM,UAAU,EAAE,IAkFxB,CAAC"}

package/dist/agent-farm/tutorial/steps/review.js

@@ -0,0 +1,78 @@
+/**
+ * Tutorial Step 6: Review & Next Steps
+ * Covers the review process and points to further resources
+ */
+import * as prompts from '../prompts.js';
+export const reviewStep = {
+    id: 'review',
+    title: 'Review & Next Steps',
+    async run(ctx) {
+        prompts.content('The final step in any project is the review!\n');
+        prompts.content('A review documents what you learned and what could be improved.\n');
+        prompts.content('Review documents typically include:');
+        prompts.bullet('What went well');
+        prompts.bullet('What could be improved');
+        prompts.bullet('Lessons learned for future work');
+        prompts.bullet('Updates to make to protocols or documentation');
+        console.log();
+        // Annotation viewer
+        prompts.content('The Annotation Viewer\n');
+        prompts.content('Agent Farm includes an annotation viewer for reviewing code:\n');
+        prompts.code(`# Open a file for annotation
+af open src/path/to/file.ts
+
+# This opens a web viewer where you can:
+# - See the code with syntax highlighting
+# - Add review comments to specific lines
+# - Edit the file directly`);
+        console.log();
+        prompts.content('Review comments are stored in the files:');
+        prompts.code(`// REVIEW(@architect): Consider error handling here
+// REVIEW(@builder): Fixed - added try/catch`);
+        console.log();
+        // Project tracking
+        prompts.content('Project Tracking\n');
+        prompts.content('Keep track of your projects in codev/projectlist.md:');
+        prompts.bullet('Lists all specs with their status');
+        prompts.bullet('Shows dependencies between projects');
+        prompts.bullet('Tracks what\'s in progress vs completed');
+        console.log();
+        // Resources
+        prompts.content('Where to Learn More\n');
+        prompts.bullet('CLAUDE.md / AGENTS.md - Project-specific AI instructions');
+        prompts.bullet('codev/protocols/ - Full protocol documentation');
+        prompts.bullet('codev/resources/arch.md - Architecture documentation');
+        prompts.bullet('`af --help` - All available CLI commands');
+        console.log();
+        // Quick reference
+        prompts.content('Quick Reference:\n');
+        prompts.code(`# Essential commands
+af start              # Start architect dashboard
+af spawn -p 0001      # Spawn builder for spec
+af status             # Check agent status
+af open <file>        # Open annotation viewer
+af tutorial --status  # Check tutorial progress
+af tutorial --reset   # Reset tutorial
+
+# Workflow
+1. Write spec in codev/specs/
+2. Create plan in codev/plans/
+3. Implement (TICK or Builder)
+4. Review and document lessons
+5. Update projectlist.md`);
+        console.log();
+        await prompts.pressEnter();
+        // Final message
+        prompts.content('\nYou\'ve completed the Agent Farm tutorial!\n');
+        prompts.content('Remember:');
+        prompts.bullet('Start small - use TICK for simple tasks');
+        prompts.bullet('Document as you go - specs and plans save time');
+        prompts.bullet('Review your work - lessons learned improve future work');
+        prompts.bullet('Use the dashboard - it makes managing builders easier');
+        console.log();
+        prompts.success('Happy building!');
+        console.log();
+        return { status: 'completed' };
+    },
+};
+//# sourceMappingURL=review.js.map

package/dist/agent-farm/tutorial/steps/review.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"review.js","sourceRoot":"","sources":["../../../../src/agent-farm/tutorial/steps/review.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,OAAO,MAAM,eAAe,CAAC;AAEzC,MAAM,CAAC,MAAM,UAAU,GAAS;IAC9B,EAAE,EAAE,QAAQ;IACZ,KAAK,EAAE,qBAAqB;IAE5B,KAAK,CAAC,GAAG,CAAC,GAAgB;QACxB,OAAO,CAAC,OAAO,CAAC,gDAAgD,CAAC,CAAC;QAClE,OAAO,CAAC,OAAO,CAAC,mEAAmE,CAAC,CAAC;QAErF,OAAO,CAAC,OAAO,CAAC,qCAAqC,CAAC,CAAC;QACvD,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;QACjC,OAAO,CAAC,MAAM,CAAC,wBAAwB,CAAC,CAAC;QACzC,OAAO,CAAC,MAAM,CAAC,iCAAiC,CAAC,CAAC;QAClD,OAAO,CAAC,MAAM,CAAC,+CAA+C,CAAC,CAAC;QAChE,OAAO,CAAC,GAAG,EAAE,CAAC;QAEd,oBAAoB;QACpB,OAAO,CAAC,OAAO,CAAC,yBAAyB,CAAC,CAAC;QAC3C,OAAO,CAAC,OAAO,CAAC,gEAAgE,CAAC,CAAC;QAClF,OAAO,CAAC,IAAI,CAAC;;;;;;2BAMU,CAAC,CAAC;QACzB,OAAO,CAAC,GAAG,EAAE,CAAC;QAEd,OAAO,CAAC,OAAO,CAAC,0CAA0C,CAAC,CAAC;QAC5D,OAAO,CAAC,IAAI,CAAC;6CAC4B,CAAC,CAAC;QAC3C,OAAO,CAAC,GAAG,EAAE,CAAC;QAEd,mBAAmB;QACnB,OAAO,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC;QACtC,OAAO,CAAC,OAAO,CAAC,sDAAsD,CAAC,CAAC;QACxE,OAAO,CAAC,MAAM,CAAC,mCAAmC,CAAC,CAAC;QACpD,OAAO,CAAC,MAAM,CAAC,qCAAqC,CAAC,CAAC;QACtD,OAAO,CAAC,MAAM,CAAC,yCAAyC,CAAC,CAAC;QAC1D,OAAO,CAAC,GAAG,EAAE,CAAC;QAEd,YAAY;QACZ,OAAO,CAAC,OAAO,CAAC,uBAAuB,CAAC,CAAC;QACzC,OAAO,CAAC,MAAM,CAAC,0DAA0D,CAAC,CAAC;QAC3E,OAAO,CAAC,MAAM,CAAC,gDAAgD,CAAC,CAAC;QACjE,OAAO,CAAC,MAAM,CAAC,sDAAsD,CAAC,CAAC;QACvE,OAAO,CAAC,MAAM,CAAC,0CAA0C,CAAC,CAAC;QAC3D,OAAO,CAAC,GAAG,EAAE,CAAC;QAEd,kBAAkB;QAClB,OAAO,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC;QACtC,OAAO,CAAC,IAAI,CAAC;;;;;;;;;;;;;yBAaQ,CAAC,CAAC;QACvB,OAAO,CAAC,GAAG,EAAE,CAAC;QAEd,MAAM,OAAO,CAAC,UAAU,EAAE,CAAC;QAE3B,gBAAgB;QAChB,OAAO,CAAC,OAAO,CAAC,gDAAgD,CAAC,CAAC;QAClE,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAC7B,OAAO,CAAC,MAAM,CAAC,yCAAyC,CAAC,CAAC;QAC1D,OAAO,CAAC,MAAM,CAAC,gDAAgD,CAAC,CAAC;QACjE,OAAO,CAAC,MAAM,CAAC,wDAAwD,CAAC,CAAC;QACzE,OAAO,CAAC,MAAM,CAAC,uDAAuD,CAAC,CAAC;QACxE,OAAO,CAAC,GAAG,EAAE,CAAC;QAEd,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;QACnC,OAAO,CAAC,GAAG,EAAE,CAAC;QAEd,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;IACjC,CAAC;CACF,CAAC"}

package/dist/agent-farm/tutorial/steps/setup.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Tutorial Step 2: Setup Phase
+ * Creates codev directory structure and explains it
+ */
+import type { Step } from '../runner.js';
+export declare const setupStep: Step;
+//# sourceMappingURL=setup.d.ts.map

package/dist/agent-farm/tutorial/steps/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../../../src/agent-farm/tutorial/steps/setup.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,IAAI,EAA2B,MAAM,cAAc,CAAC;AA8ClE,eAAO,MAAM,SAAS,EAAE,IAyFvB,CAAC"}

package/dist/agent-farm/tutorial/steps/setup.js

@@ -0,0 +1,126 @@
+/**
+ * Tutorial Step 2: Setup Phase
+ * Creates codev directory structure and explains it
+ */
+import { existsSync, mkdirSync } from 'node:fs';
+import { writeFile } from 'node:fs/promises';
+import { resolve } from 'node:path';
+import * as prompts from '../prompts.js';
+const AGENTS_MD_TEMPLATE = `# AI Agent Instructions
+
+This file provides instructions to AI coding assistants working on this project.
+
+## Project Overview
+
+[Describe your project here]
+
+## Development Workflow
+
+This project uses Codev for structured AI-assisted development:
+
+- **Specifications** (codev/specs/): What to build
+- **Plans** (codev/plans/): How to build it
+- **Reviews** (codev/reviews/): Lessons learned
+
+## Available Protocols
+
+- **TICK**: Fast protocol for small, well-defined tasks
+- **SPIDER**: Full protocol with consultation for complex features
+
+## Getting Started
+
+1. Check \`codev/projectlist.md\` for current project status
+2. Run \`af tutorial\` if you're new to the project
+3. See \`codev/protocols/\` for detailed protocol documentation
+`;
+const PROJECTLIST_TEMPLATE = `# Project List
+
+Track all projects and their status here.
+
+## Active Projects
+
+\`\`\`yaml
+projects: []
+\`\`\`
+
+## Next Available Number
+
+**0001** - Reserve this number for your next project
+`;
+export const setupStep = {
+    id: 'setup',
+    title: 'Project Setup',
+    async run(ctx) {
+        if (ctx.hasCodev) {
+            prompts.success('Codev is already set up in this project!');
+            console.log();
+            prompts.content('Your codev directory structure:');
+            prompts.bullet('codev/specs/ - Feature specifications');
+            prompts.bullet('codev/plans/ - Implementation plans');
+            prompts.bullet('codev/reviews/ - Post-implementation reviews');
+            prompts.bullet('codev/protocols/ - Development protocols');
+            prompts.bullet('codev/projectlist.md - Project tracking');
+            console.log();
+            await prompts.pressEnter();
+            return { status: 'completed' };
+        }
+        prompts.content('Let\'s set up the Codev directory structure.\n');
+        prompts.content('This will create:');
+        prompts.bullet('codev/specs/ - Where you\'ll write feature specifications');
+        prompts.bullet('codev/plans/ - Where implementation plans go');
+        prompts.bullet('codev/reviews/ - Where you\'ll document lessons learned');
+        prompts.bullet('codev/projectlist.md - Master project tracking file');
+        console.log();
+        const shouldCreate = await prompts.confirm('Create these directories?');
+        if (!shouldCreate) {
+            prompts.info('You can manually create the codev/ directory later.');
+            return { status: 'skipped' };
+        }
+        // Create directories
+        const codevDir = resolve(ctx.projectPath, 'codev');
+        const dirs = ['specs', 'plans', 'reviews', 'protocols', 'resources'];
+        try {
+            if (!existsSync(codevDir)) {
+                mkdirSync(codevDir, { recursive: true });
+            }
+            for (const dir of dirs) {
+                const dirPath = resolve(codevDir, dir);
+                if (!existsSync(dirPath)) {
+                    mkdirSync(dirPath, { recursive: true });
+                }
+            }
+            // Create projectlist.md
+            const projectlistPath = resolve(codevDir, 'projectlist.md');
+            if (!existsSync(projectlistPath)) {
+                await writeFile(projectlistPath, PROJECTLIST_TEMPLATE);
+            }
+            // Create CLAUDE.md / AGENTS.md if they don't exist
+            const claudeMdPath = resolve(ctx.projectPath, 'CLAUDE.md');
+            const agentsMdPath = resolve(ctx.projectPath, 'AGENTS.md');
+            if (!existsSync(claudeMdPath) && !existsSync(agentsMdPath)) {
+                await writeFile(agentsMdPath, AGENTS_MD_TEMPLATE);
+                prompts.success('Created AGENTS.md with project instructions');
+            }
+            prompts.success('Created codev/ directory structure');
+            console.log();
+            prompts.content('Directory structure:');
+            prompts.code(`codev/
+├── specs/       # Feature specifications
+├── plans/       # Implementation plans
+├── reviews/     # Post-implementation reviews
+├── protocols/   # Development protocols
+├── resources/   # Reference materials
+└── projectlist.md`);
+        }
+        catch (error) {
+            prompts.warn(`Failed to create directories: ${error instanceof Error ? error.message : String(error)}`);
+            return { status: 'aborted' };
+        }
+        console.log();
+        prompts.info('Tip: Add AGENTS.md to version control so AI assistants can read it.');
+        console.log();
+        await prompts.pressEnter();
+        return { status: 'completed' };
+    },
+};
+//# sourceMappingURL=setup.js.map

package/dist/agent-farm/tutorial/steps/setup.js.map

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

package/dist/agent-farm/tutorial/steps/welcome.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Tutorial Step 1: Welcome & Project Detection
+ * Introduces Codev/Agent Farm and detects the project environment
+ */
+import type { Step } from '../runner.js';
+export declare const welcomeStep: Step;
+//# sourceMappingURL=welcome.d.ts.map

package/dist/agent-farm/tutorial/steps/welcome.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"welcome.d.ts","sourceRoot":"","sources":["../../../../src/agent-farm/tutorial/steps/welcome.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,IAAI,EAA2B,MAAM,cAAc,CAAC;AAGlE,eAAO,MAAM,WAAW,EAAE,IAkDzB,CAAC"}

package/dist/agent-farm/tutorial/steps/welcome.js

@@ -0,0 +1,50 @@
+/**
+ * Tutorial Step 1: Welcome & Project Detection
+ * Introduces Codev/Agent Farm and detects the project environment
+ */
+import * as prompts from '../prompts.js';
+export const welcomeStep = {
+    id: 'welcome',
+    title: 'Welcome & Project Detection',
+    async run(ctx) {
+        prompts.content('Welcome to Agent Farm! This tutorial will help you get started');
+        prompts.content('with structured AI-assisted development.\n');
+        // Show what we detected
+        prompts.content('About your project:');
+        prompts.bullet(`Project: ${ctx.projectName}`);
+        prompts.bullet(`Type: ${ctx.projectType === 'other' ? 'Unknown' : ctx.projectType}`);
+        prompts.bullet(`Git repository: ${ctx.hasGit ? 'Yes' : 'No'}`);
+        prompts.bullet(`Codev initialized: ${ctx.hasCodev ? 'Yes' : 'No'}`);
+        console.log();
+        // Warn if not in a git repo
+        if (!ctx.hasGit) {
+            prompts.warn('This directory is not a git repository.');
+            prompts.content('Codev works best with git for version control and worktrees.');
+            console.log();
+            const shouldContinue = await prompts.confirm('Continue anyway?');
+            if (!shouldContinue) {
+                prompts.info('Run `git init` to initialize a repository, then run `af tutorial` again.');
+                return { status: 'aborted' };
+            }
+        }
+        // Explain what Codev/Agent Farm is
+        prompts.content('\nWhat is Agent Farm?\n');
+        prompts.content('Agent Farm helps you work with AI coding assistants more effectively by:');
+        prompts.bullet('Organizing work into specs, plans, and reviews');
+        prompts.bullet('Using structured protocols (SPIDER, TICK) for development');
+        prompts.bullet('Enabling the Architect/Builder pattern for parallel work');
+        prompts.bullet('Maintaining project context and documentation');
+        console.log();
+        prompts.content('Key concepts:');
+        prompts.bullet('Spec: What you want to build (the goal)');
+        prompts.bullet('Plan: How you\'ll build it (the approach)');
+        prompts.bullet('Review: What you learned (lessons and improvements)');
+        console.log();
+        const ready = await prompts.confirm('Ready to set up Codev in your project?');
+        if (!ready) {
+            return { status: 'aborted' };
+        }
+        return { status: 'completed' };
+    },
+};
+//# sourceMappingURL=welcome.js.map

package/dist/agent-farm/tutorial/steps/welcome.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"welcome.js","sourceRoot":"","sources":["../../../../src/agent-farm/tutorial/steps/welcome.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,OAAO,MAAM,eAAe,CAAC;AAEzC,MAAM,CAAC,MAAM,WAAW,GAAS;IAC/B,EAAE,EAAE,SAAS;IACb,KAAK,EAAE,6BAA6B;IAEpC,KAAK,CAAC,GAAG,CAAC,GAAgB;QACxB,OAAO,CAAC,OAAO,CAAC,gEAAgE,CAAC,CAAC;QAClF,OAAO,CAAC,OAAO,CAAC,4CAA4C,CAAC,CAAC;QAE9D,wBAAwB;QACxB,OAAO,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC;QACvC,OAAO,CAAC,MAAM,CAAC,YAAY,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;QAC9C,OAAO,CAAC,MAAM,CAAC,SAAS,GAAG,CAAC,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;QACrF,OAAO,CAAC,MAAM,CAAC,mBAAmB,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAC/D,OAAO,CAAC,MAAM,CAAC,sBAAsB,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACpE,OAAO,CAAC,GAAG,EAAE,CAAC;QAEd,4BAA4B;QAC5B,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;YAChB,OAAO,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC;YACxD,OAAO,CAAC,OAAO,CAAC,8DAA8D,CAAC,CAAC;YAChF,OAAO,CAAC,GAAG,EAAE,CAAC;YACd,MAAM,cAAc,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;YACjE,IAAI,CAAC,cAAc,EAAE,CAAC;gBACpB,OAAO,CAAC,IAAI,CAAC,0EAA0E,CAAC,CAAC;gBACzF,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;YAC/B,CAAC;QACH,CAAC;QAED,mCAAmC;QACnC,OAAO,CAAC,OAAO,CAAC,yBAAyB,CAAC,CAAC;QAC3C,OAAO,CAAC,OAAO,CAAC,0EAA0E,CAAC,CAAC;QAC5F,OAAO,CAAC,MAAM,CAAC,gDAAgD,CAAC,CAAC;QACjE,OAAO,CAAC,MAAM,CAAC,2DAA2D,CAAC,CAAC;QAC5E,OAAO,CAAC,MAAM,CAAC,0DAA0D,CAAC,CAAC;QAC3E,OAAO,CAAC,MAAM,CAAC,+CAA+C,CAAC,CAAC;QAChE,OAAO,CAAC,GAAG,EAAE,CAAC;QAEd,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;QACjC,OAAO,CAAC,MAAM,CAAC,yCAAyC,CAAC,CAAC;QAC1D,OAAO,CAAC,MAAM,CAAC,2CAA2C,CAAC,CAAC;QAC5D,OAAO,CAAC,MAAM,CAAC,qDAAqD,CAAC,CAAC;QACtE,OAAO,CAAC,GAAG,EAAE,CAAC;QAEd,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,wCAAwC,CAAC,CAAC;QAC9E,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;QAC/B,CAAC;QAED,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;IACjC,CAAC;CACF,CAAC"}

package/dist/agent-farm/types.d.ts

@@ -0,0 +1,131 @@
+/**
+ * Core types for Agent Farm
+ */
+export type BuilderType = 'spec' | 'task' | 'protocol' | 'shell' | 'worktree';
+export interface Builder {
+    id: string;
+    name: string;
+    port: number;
+    pid: number;
+    status: 'spawning' | 'implementing' | 'blocked' | 'pr-ready' | 'complete';
+    phase: string;
+    worktree: string;
+    branch: string;
+    tmuxSession?: string;
+    type: BuilderType;
+    taskText?: string;
+    protocolName?: string;
+}
+export interface UtilTerminal {
+    id: string;
+    name: string;
+    port: number;
+    pid: number;
+    tmuxSession?: string;
+}
+export interface Annotation {
+    id: string;
+    file: string;
+    port: number;
+    pid: number;
+    parent: {
+        type: 'architect' | 'builder' | 'util';
+        id?: string;
+    };
+}
+export interface ArchitectState {
+    port: number;
+    pid: number;
+    cmd: string;
+    startedAt: string;
+    tmuxSession?: string;
+}
+export interface DashboardState {
+    architect: ArchitectState | null;
+    builders: Builder[];
+    utils: UtilTerminal[];
+    annotations: Annotation[];
+}
+export interface Config {
+    projectRoot: string;
+    codevDir: string;
+    buildersDir: string;
+    stateDir: string;
+    templatesDir: string;
+    serversDir: string;
+    bundledRolesDir: string;
+    dashboardPort: number;
+    architectPort: number;
+    builderPortRange: [number, number];
+    utilPortRange: [number, number];
+    annotatePortRange: [number, number];
+}
+export interface TmuxSession {
+    name: string;
+    pid: number;
+}
+export interface StartOptions {
+    cmd?: string;
+    port?: number;
+    noRole?: boolean;
+}
+export interface SpawnOptions {
+    project?: string;
+    task?: string;
+    protocol?: string;
+    shell?: boolean;
+    worktree?: boolean;
+    files?: string[];
+    noRole?: boolean;
+    instruction?: string;
+}
+export interface SendOptions {
+    builder?: string;
+    message?: string;
+    all?: boolean;
+    file?: string;
+    interrupt?: boolean;
+    raw?: boolean;
+    noEnter?: boolean;
+}
+/**
+ * User-facing config.json structure
+ */
+export interface UserConfig {
+    shell?: {
+        architect?: string | string[];
+        builder?: string | string[];
+        shell?: string | string[];
+    };
+    templates?: {
+        dir?: string;
+    };
+    roles?: {
+        dir?: string;
+    };
+}
+/**
+ * Resolved shell commands (after processing config hierarchy)
+ */
+export interface ResolvedCommands {
+    architect: string;
+    builder: string;
+    shell: string;
+}
+/**
+ * Tutorial state for interactive onboarding
+ */
+export interface TutorialState {
+    projectPath: string;
+    currentStep: string;
+    completedSteps: string[];
+    userResponses: Record<string, string>;
+    startedAt: string;
+    lastActiveAt: string;
+}
+export interface TutorialOptions {
+    reset?: boolean;
+    skip?: boolean;
+    status?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/agent-farm/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/agent-farm/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,OAAO,GAAG,UAAU,CAAC;AAE9E,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,UAAU,GAAG,cAAc,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,CAAC;IAC1E,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,WAAW,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE;QACN,IAAI,EAAE,WAAW,GAAG,SAAS,GAAG,MAAM,CAAC;QACvC,EAAE,CAAC,EAAE,MAAM,CAAC;KACb,CAAC;CACH;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,cAAc,GAAG,IAAI,CAAC;IACjC,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,WAAW,EAAE,UAAU,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,MAAM;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,aAAa,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,iBAAiB,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC;AAGD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAE3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IAGnB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IAGjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,EAAE;QACN,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;QAC9B,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;QAC5B,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;KAC3B,CAAC;IACF,SAAS,CAAC,EAAE;QACV,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,CAAC;IACF,KAAK,CAAC,EAAE;QACN,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB"}

package/dist/agent-farm/types.js

@@ -0,0 +1,5 @@
+/**
+ * Core types for Agent Farm
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/agent-farm/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/agent-farm/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/agent-farm/utils/config.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Configuration management for Agent Farm
+ */
+import type { Config, ResolvedCommands } from '../types.js';
+/**
+ * Set CLI overrides for commands
+ * These take highest priority in the hierarchy
+ */
+export declare function setCliOverrides(overrides: Partial<ResolvedCommands>): void;
+/**
+ * Get resolved commands following hierarchy: CLI > config.json > defaults
+ */
+export declare function getResolvedCommands(projectRoot?: string): ResolvedCommands;
+/**
+ * Initialize port allocation (must be called once at startup)
+ */
+export declare function initializePorts(): void;
+/**
+ * Build configuration for the current project
+ * Note: initializePorts() must be called before using this function
+ */
+export declare function getConfig(): Config;
+/**
+ * Ensure required directories exist
+ */
+export declare function ensureDirectories(config: Config): Promise<void>;
+//# sourceMappingURL=config.d.ts.map

package/dist/agent-farm/utils/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/agent-farm/utils/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,KAAK,EAAE,MAAM,EAAc,gBAAgB,EAAE,MAAM,aAAa,CAAC;AA+KxE;;;GAGG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAE1E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAY1E;AAWD;;GAEG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAUtC;AAED;;;GAGG;AACH,wBAAgB,SAAS,IAAI,MAAM,CA6BlC;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAWrE"}