@cluesmith/codev 1.1.0

package/dist/agent-farm/tutorial/runner.js

@@ -0,0 +1,204 @@
+/**
+ * Tutorial step runner infrastructure
+ * Manages step execution, state, and progress
+ */
+import { existsSync } from 'node:fs';
+import { execSync } from 'node:child_process';
+import { resolve, basename } from 'node:path';
+import { getConfig } from '../utils/index.js';
+import { loadTutorialState, saveTutorialState, getOrCreateTutorialState, completeStep } from './state.js';
+import * as prompts from './prompts.js';
+import { logger } from '../utils/logger.js';
+/**
+ * Detect project type based on files present
+ */
+function detectProjectType(projectPath) {
+    if (existsSync(resolve(projectPath, 'package.json'))) {
+        return 'nodejs';
+    }
+    if (existsSync(resolve(projectPath, 'pyproject.toml')) ||
+        existsSync(resolve(projectPath, 'setup.py')) ||
+        existsSync(resolve(projectPath, 'requirements.txt'))) {
+        return 'python';
+    }
+    return 'other';
+}
+/**
+ * Check if directory is a git repository
+ */
+function hasGitRepo(projectPath) {
+    try {
+        execSync('git rev-parse --git-dir', {
+            cwd: projectPath,
+            stdio: 'ignore',
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Check if codev directory exists
+ */
+function hasCodevDir(projectPath) {
+    return existsSync(resolve(projectPath, 'codev'));
+}
+/**
+ * Build step context from current state
+ */
+async function buildContext(state) {
+    const config = getConfig();
+    return {
+        state,
+        projectPath: config.projectRoot,
+        projectName: basename(config.projectRoot),
+        projectType: detectProjectType(config.projectRoot),
+        hasGit: hasGitRepo(config.projectRoot),
+        hasCodev: hasCodevDir(config.projectRoot),
+    };
+}
+/**
+ * Find the index of the current step
+ */
+function findCurrentStepIndex(steps, currentStepId) {
+    return steps.findIndex((s) => s.id === currentStepId);
+}
+/**
+ * Show tutorial status/progress
+ */
+export async function showStatus(steps) {
+    const state = await loadTutorialState();
+    if (!state) {
+        logger.info('No tutorial in progress. Run `af tutorial` to start.');
+        return;
+    }
+    const currentIndex = findCurrentStepIndex(steps, state.currentStep);
+    logger.header('Tutorial Progress');
+    logger.kv('Started', new Date(state.startedAt).toLocaleDateString());
+    logger.kv('Last active', new Date(state.lastActiveAt).toLocaleDateString());
+    logger.blank();
+    for (let i = 0; i < steps.length; i++) {
+        const step = steps[i];
+        const isCompleted = state.completedSteps.includes(step.id);
+        const isCurrent = i === currentIndex;
+        let prefix = '  ';
+        if (isCompleted) {
+            prefix = '✓ ';
+        }
+        else if (isCurrent) {
+            prefix = '→ ';
+        }
+        const status = isCompleted ? '(completed)' : isCurrent ? '(current)' : '';
+        console.log(`${prefix}${i + 1}. ${step.title} ${status}`);
+    }
+    logger.blank();
+    const completed = state.completedSteps.length;
+    const total = steps.length;
+    logger.info(`Progress: ${completed}/${total} steps completed`);
+}
+/**
+ * Skip to the next step
+ */
+export async function skipCurrentStep(steps) {
+    const state = await loadTutorialState();
+    if (!state) {
+        logger.error('No tutorial in progress. Run `af tutorial` to start.');
+        return;
+    }
+    const currentIndex = findCurrentStepIndex(steps, state.currentStep);
+    if (currentIndex < 0) {
+        logger.error('Current step not found. Try resetting the tutorial.');
+        return;
+    }
+    if (currentIndex >= steps.length - 1) {
+        logger.info('Already at the last step.');
+        return;
+    }
+    const currentStep = steps[currentIndex];
+    const nextStep = steps[currentIndex + 1];
+    await completeStep(state, currentStep.id, nextStep.id);
+    logger.success(`Skipped "${currentStep.title}"`);
+    logger.info(`Now at: "${nextStep.title}"`);
+}
+/**
+ * Run the tutorial from current step
+ */
+export async function runTutorial(steps) {
+    const state = await getOrCreateTutorialState();
+    let ctx = await buildContext(state);
+    let currentIndex = findCurrentStepIndex(steps, state.currentStep);
+    // If current step not found, start from the beginning
+    if (currentIndex < 0) {
+        currentIndex = 0;
+        state.currentStep = steps[0].id;
+        await saveTutorialState(state);
+    }
+    // Show welcome if resuming
+    if (state.completedSteps.length > 0) {
+        prompts.section('Resuming Tutorial');
+        prompts.info(`You're on step ${currentIndex + 1} of ${steps.length}: ${steps[currentIndex].title}`);
+        console.log();
+        const shouldContinue = await prompts.confirm('Continue from where you left off?');
+        if (!shouldContinue) {
+            const restart = await prompts.confirm('Start from the beginning?', false);
+            if (restart) {
+                state.currentStep = steps[0].id;
+                state.completedSteps = [];
+                state.userResponses = {};
+                await saveTutorialState(state);
+                currentIndex = 0;
+                ctx = await buildContext(state);
+            }
+            else {
+                logger.info('Tutorial paused. Run `af tutorial` to resume later.');
+                return;
+            }
+        }
+    }
+    // Run steps sequentially
+    while (currentIndex < steps.length) {
+        const step = steps[currentIndex];
+        prompts.section(`Step ${currentIndex + 1}/${steps.length}: ${step.title}`);
+        try {
+            const result = await step.run(ctx);
+            if (result.status === 'aborted') {
+                // Save current position and exit
+                await saveTutorialState(ctx.state);
+                logger.info('Tutorial paused. Run `af tutorial` to resume.');
+                return;
+            }
+            // Update state with results
+            const nextStepId = currentIndex < steps.length - 1 ? steps[currentIndex + 1].id : null;
+            ctx.state = await completeStep(ctx.state, step.id, nextStepId, result.responses);
+            // Refresh context in case step modified things (like creating codev dir)
+            ctx = await buildContext(ctx.state);
+            currentIndex++;
+        }
+        catch (error) {
+            // Handle Ctrl+C gracefully
+            if (error instanceof Error && error.message.includes('readline was closed')) {
+                console.log();
+                await saveTutorialState(ctx.state);
+                logger.info('Tutorial paused. Run `af tutorial` to resume.');
+                return;
+            }
+            throw error;
+        }
+    }
+    // Tutorial complete!
+    prompts.section('Tutorial Complete!');
+    prompts.success('Congratulations! You\'ve completed the Agent Farm tutorial.');
+    console.log();
+    prompts.content('You now know how to:');
+    prompts.bullet('Set up Codev in your project');
+    prompts.bullet('Create specifications for new features');
+    prompts.bullet('Write implementation plans');
+    prompts.bullet('Use the Architect/Builder pattern');
+    console.log();
+    prompts.content('For more information, check out:');
+    prompts.bullet('CLAUDE.md or AGENTS.md in your project');
+    prompts.bullet('codev/protocols/ for protocol documentation');
+    prompts.bullet('Run `af --help` to see all available commands');
+}
+//# sourceMappingURL=runner.js.map

package/dist/agent-farm/tutorial/runner.js.map

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

package/dist/agent-farm/tutorial/state.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Tutorial state management
+ * Persists tutorial progress to disk
+ */
+import type { TutorialState } from '../types.js';
+/**
+ * Load tutorial state from disk
+ */
+export declare function loadTutorialState(): Promise<TutorialState | null>;
+/**
+ * Save tutorial state to disk
+ */
+export declare function saveTutorialState(state: TutorialState): Promise<void>;
+/**
+ * Reset tutorial state (delete the file)
+ */
+export declare function resetTutorialState(): Promise<void>;
+/**
+ * Get or create tutorial state
+ */
+export declare function getOrCreateTutorialState(): Promise<TutorialState>;
+/**
+ * Mark a step as completed and advance to the next step
+ */
+export declare function completeStep(state: TutorialState, stepId: string, nextStepId: string | null, responses?: Record<string, string>): Promise<TutorialState>;
+//# sourceMappingURL=state.d.ts.map

package/dist/agent-farm/tutorial/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/agent-farm/tutorial/state.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAsBjD;;GAEG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAavE;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAS3E;AAED;;GAEG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAMxD;AAED;;GAEG;AACH,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,aAAa,CAAC,CASvE;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,KAAK,EAAE,aAAa,EACpB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,GAAG,IAAI,EACzB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACjC,OAAO,CAAC,aAAa,CAAC,CAexB"}

package/dist/agent-farm/tutorial/state.js

@@ -0,0 +1,89 @@
+/**
+ * Tutorial state management
+ * Persists tutorial progress to disk
+ */
+import { readFile, writeFile, unlink } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { getConfig, ensureDirectories } from '../utils/index.js';
+const TUTORIAL_STATE_FILE = 'tutorial.json';
+function getTutorialStatePath() {
+    const config = getConfig();
+    return resolve(config.stateDir, TUTORIAL_STATE_FILE);
+}
+function getDefaultTutorialState() {
+    const config = getConfig();
+    return {
+        projectPath: config.projectRoot,
+        currentStep: 'welcome',
+        completedSteps: [],
+        userResponses: {},
+        startedAt: new Date().toISOString(),
+        lastActiveAt: new Date().toISOString(),
+    };
+}
+/**
+ * Load tutorial state from disk
+ */
+export async function loadTutorialState() {
+    const statePath = getTutorialStatePath();
+    if (!existsSync(statePath)) {
+        return null;
+    }
+    try {
+        const content = await readFile(statePath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Save tutorial state to disk
+ */
+export async function saveTutorialState(state) {
+    const config = getConfig();
+    await ensureDirectories(config);
+    // Update lastActiveAt on every save
+    state.lastActiveAt = new Date().toISOString();
+    const statePath = getTutorialStatePath();
+    await writeFile(statePath, JSON.stringify(state, null, 2));
+}
+/**
+ * Reset tutorial state (delete the file)
+ */
+export async function resetTutorialState() {
+    const statePath = getTutorialStatePath();
+    if (existsSync(statePath)) {
+        await unlink(statePath);
+    }
+}
+/**
+ * Get or create tutorial state
+ */
+export async function getOrCreateTutorialState() {
+    const existing = await loadTutorialState();
+    if (existing) {
+        return existing;
+    }
+    const newState = getDefaultTutorialState();
+    await saveTutorialState(newState);
+    return newState;
+}
+/**
+ * Mark a step as completed and advance to the next step
+ */
+export async function completeStep(state, stepId, nextStepId, responses) {
+    if (!state.completedSteps.includes(stepId)) {
+        state.completedSteps.push(stepId);
+    }
+    if (nextStepId) {
+        state.currentStep = nextStepId;
+    }
+    if (responses) {
+        state.userResponses = { ...state.userResponses, ...responses };
+    }
+    await saveTutorialState(state);
+    return state;
+}
+//# sourceMappingURL=state.js.map

package/dist/agent-farm/tutorial/state.js.map

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

package/dist/agent-farm/tutorial/steps/first-spec.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Tutorial Step 3: First Spec Walkthrough
+ * Guides user through creating their first specification
+ */
+import type { Step } from '../runner.js';
+export declare const firstSpecStep: Step;
+//# sourceMappingURL=first-spec.d.ts.map

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

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

package/dist/agent-farm/tutorial/steps/first-spec.js

@@ -0,0 +1,136 @@
+/**
+ * Tutorial Step 3: First Spec Walkthrough
+ * Guides user through creating their first specification
+ */
+import { existsSync } from 'node:fs';
+import { writeFile } from 'node:fs/promises';
+import { resolve } from 'node:path';
+import * as prompts from '../prompts.js';
+function generateSpec(title, description, projectType) {
+    const projectContext = projectType === 'nodejs'
+        ? 'Node.js/TypeScript'
+        : projectType === 'python'
+            ? 'Python'
+            : 'your project';
+    return `# Specification: ${title}
+
+## Overview
+
+${description}
+
+## Goals
+
+1. [Primary goal for this feature]
+2. [Secondary goal]
+3. [Success criteria]
+
+## Technical Requirements
+
+### Context
+
+This feature will be implemented in a ${projectContext} codebase.
+
+### Implementation Notes
+
+[Add technical details here]
+
+## User Experience
+
+[Describe how users will interact with this feature]
+
+## Success Criteria
+
+- [ ] [Measurable criterion 1]
+- [ ] [Measurable criterion 2]
+- [ ] Tests pass
+- [ ] Documentation updated
+
+## Open Questions
+
+1. [Any decisions that need to be made]
+2. [Unknowns to investigate]
+
+---
+
+*Created via Agent Farm tutorial*
+`;
+}
+export const firstSpecStep = {
+    id: 'first-spec',
+    title: 'Write Your First Spec',
+    async run(ctx) {
+        prompts.content('Now let\'s create your first specification!\n');
+        prompts.content('A spec is a document that describes WHAT you want to build.');
+        prompts.content('It should be clear enough that anyone (human or AI) can understand the goal.\n');
+        prompts.content('Good specs include:');
+        prompts.bullet('Clear goals and success criteria');
+        prompts.bullet('Technical requirements and constraints');
+        prompts.bullet('User experience considerations');
+        prompts.bullet('Open questions that need answers');
+        console.log();
+        // Ask what they want to build
+        prompts.content('Think of something small you\'d like to add to your project.');
+        prompts.content('Start small! A good first spec might be:');
+        prompts.bullet('Add a utility function');
+        prompts.bullet('Fix a small bug');
+        prompts.bullet('Add a configuration option');
+        prompts.bullet('Improve error handling');
+        console.log();
+        const title = await prompts.prompt('What do you want to build? (short title)');
+        if (!title) {
+            prompts.info('Using example: "Add logging utility"');
+            const exampleTitle = 'Add logging utility';
+            const exampleDesc = 'Create a simple logging utility that provides consistent log formatting across the application.';
+            prompts.content('\nHere\'s what a basic spec looks like:');
+            prompts.code(generateSpec(exampleTitle, exampleDesc, ctx.projectType).slice(0, 500) + '...');
+            console.log();
+            await prompts.pressEnter();
+            return {
+                status: 'completed',
+                responses: { specTitle: exampleTitle, specSkipped: 'true' },
+            };
+        }
+        const description = await prompts.prompt('Describe it in one sentence');
+        // Generate the spec
+        const specContent = generateSpec(title, description || `Implement ${title}`, ctx.projectType);
+        // Show preview
+        prompts.content('\nHere\'s your spec:\n');
+        console.log(specContent.slice(0, 800));
+        if (specContent.length > 800) {
+            console.log('...\n');
+        }
+        const shouldSave = await prompts.confirm('Save this spec to codev/specs/tutorial-example.md?');
+        if (shouldSave) {
+            const specsDir = resolve(ctx.projectPath, 'codev', 'specs');
+            const specPath = resolve(specsDir, 'tutorial-example.md');
+            try {
+                // Ensure specs directory exists
+                if (!existsSync(specsDir)) {
+                    const { mkdirSync } = await import('node:fs');
+                    mkdirSync(specsDir, { recursive: true });
+                }
+                await writeFile(specPath, specContent);
+                prompts.success(`Saved to codev/specs/tutorial-example.md`);
+            }
+            catch (error) {
+                prompts.warn(`Failed to save: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        }
+        else {
+            prompts.info('Spec not saved. You can create it manually later.');
+        }
+        console.log();
+        prompts.content('Tips for writing good specs:');
+        prompts.bullet('Be specific about what success looks like');
+        prompts.bullet('Include constraints and non-goals');
+        prompts.bullet('List open questions explicitly');
+        prompts.bullet('Keep it focused - one feature per spec');
+        console.log();
+        await prompts.pressEnter();
+        return {
+            status: 'completed',
+            responses: { specTitle: title, specDescription: description },
+        };
+    },
+};
+//# sourceMappingURL=first-spec.js.map

package/dist/agent-farm/tutorial/steps/first-spec.js.map

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

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

@@ -0,0 +1,7 @@
+/**
+ * Tutorial Step 5: Implementation Demo
+ * Shows how to implement using TICK or the Architect/Builder pattern
+ */
+import type { Step } from '../runner.js';
+export declare const implementationStep: Step;
+//# sourceMappingURL=implementation.d.ts.map

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

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

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

@@ -0,0 +1,76 @@
+/**
+ * Tutorial Step 5: Implementation Demo
+ * Shows how to implement using TICK or the Architect/Builder pattern
+ */
+import * as prompts from '../prompts.js';
+export const implementationStep = {
+    id: 'implementation',
+    title: 'Implementation Workflow',
+    async run(ctx) {
+        prompts.content('Now let\'s talk about implementation!\n');
+        prompts.content('There are two main ways to implement your specs:\n');
+        // TICK protocol
+        prompts.content('1. TICK Protocol (Simple Tasks)\n');
+        prompts.content('For small, well-defined work, just implement directly:');
+        prompts.code(`# Work with your AI assistant
+"Please implement the spec at codev/specs/0001-tutorial-task.md
+following the plan at codev/plans/0001-tutorial-task.md"
+
+# The assistant will:
+# 1. Read the spec and plan
+# 2. Implement the changes
+# 3. Write tests
+# 4. Create a PR when done`);
+        console.log();
+        // Architect/Builder pattern
+        prompts.content('2. Architect/Builder Pattern (Complex Work)\n');
+        prompts.content('For larger features or parallel development:\n');
+        prompts.code(`# Start the dashboard
+af start
+
+# Spawn a builder for a spec
+af spawn --project 0001
+
+# Or spawn for an ad-hoc task
+af spawn --task "Fix the login validation"`);
+        console.log();
+        prompts.content('The Architect/Builder pattern:');
+        prompts.bullet('Architect (you + AI): Creates specs, reviews work');
+        prompts.bullet('Builders (autonomous AI): Implement in isolated worktrees');
+        prompts.bullet('Each builder gets its own branch and terminal');
+        prompts.bullet('Multiple builders can work in parallel');
+        console.log();
+        // Key commands
+        prompts.content('Key Commands:\n');
+        prompts.step(1, 'af start       - Launch the architect dashboard');
+        prompts.step(2, 'af spawn -p X  - Spawn a builder for spec X');
+        prompts.step(3, 'af status      - Check status of all agents');
+        prompts.step(4, 'af send X      - Send instructions to a builder');
+        prompts.step(5, 'af open F      - Open file F in annotation viewer');
+        prompts.step(6, 'af stop        - Stop all agent farm processes');
+        console.log();
+        // Practical advice
+        prompts.content('Best Practices:\n');
+        prompts.bullet('Start with TICK for simple tasks');
+        prompts.bullet('Use Architect/Builder when you have multiple specs');
+        prompts.bullet('Keep specs focused - one feature per builder');
+        prompts.bullet('Review builder output before merging');
+        console.log();
+        const wantToTry = await prompts.confirm('Would you like to try starting the dashboard?', false);
+        if (wantToTry) {
+            prompts.content('\nTo start the dashboard, run in your terminal:\n');
+            prompts.highlight('af start');
+            console.log();
+            prompts.content('This will open a web-based dashboard where you can:');
+            prompts.bullet('See the architect terminal');
+            prompts.bullet('View spawned builders');
+            prompts.bullet('Open files in the annotation viewer');
+            console.log();
+            prompts.info('The dashboard runs at http://localhost:4200 by default.');
+        }
+        console.log();
+        await prompts.pressEnter();
+        return { status: 'completed' };
+    },
+};
+//# sourceMappingURL=implementation.js.map

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

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

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

@@ -0,0 +1,10 @@
+/**
+ * Export all tutorial steps
+ */
+export { welcomeStep } from './welcome.js';
+export { setupStep } from './setup.js';
+export { firstSpecStep } from './first-spec.js';
+export { planningStep } from './planning.js';
+export { implementationStep } from './implementation.js';
+export { reviewStep } from './review.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/agent-farm/tutorial/steps/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC"}

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

@@ -0,0 +1,10 @@
+/**
+ * Export all tutorial steps
+ */
+export { welcomeStep } from './welcome.js';
+export { setupStep } from './setup.js';
+export { firstSpecStep } from './first-spec.js';
+export { planningStep } from './planning.js';
+export { implementationStep } from './implementation.js';
+export { reviewStep } from './review.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/agent-farm/tutorial/steps/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC"}

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

@@ -0,0 +1,7 @@
+/**
+ * Tutorial Step 4: Planning Phase
+ * Shows how to create an implementation plan from a spec
+ */
+import type { Step } from '../runner.js';
+export declare const planningStep: Step;
+//# sourceMappingURL=planning.d.ts.map

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

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