@cluesmith/codev 1.1.0

package/dist/agent-farm/commands/start.js

@@ -0,0 +1,175 @@
+/**
+ * Start command - launches the architect dashboard
+ */
+import { resolve } from 'node:path';
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { getConfig, ensureDirectories } from '../utils/index.js';
+import { logger, fatal } from '../utils/logger.js';
+import { spawnDetached, commandExists, openBrowser, run } from '../utils/shell.js';
+import { checkCoreDependencies } from '../utils/deps.js';
+import { loadState, setArchitect } from '../state.js';
+import { handleOrphanedSessions, warnAboutStaleArtifacts } from '../utils/orphan-handler.js';
+/**
+ * Find and load a role file - tries local codev/roles/ first, falls back to bundled
+ */
+function loadRolePrompt(config, roleName) {
+    // Try local project first
+    const localPath = resolve(config.codevDir, 'roles', `${roleName}.md`);
+    if (existsSync(localPath)) {
+        return { content: readFileSync(localPath, 'utf-8'), source: 'local' };
+    }
+    // Fall back to bundled
+    const bundledPath = resolve(config.bundledRolesDir, `${roleName}.md`);
+    if (existsSync(bundledPath)) {
+        return { content: readFileSync(bundledPath, 'utf-8'), source: 'bundled' };
+    }
+    return null;
+}
+/**
+ * Start the architect dashboard
+ */
+export async function start(options = {}) {
+    const config = getConfig();
+    // Check for and clean up orphaned tmux sessions
+    await handleOrphanedSessions({ kill: true });
+    // Warn about stale artifacts from bash-era
+    warnAboutStaleArtifacts(config.codevDir);
+    // Check if already running
+    const state = loadState();
+    if (state.architect) {
+        logger.warn(`Architect already running on port ${state.architect.port}`);
+        logger.info(`Dashboard: http://localhost:${config.dashboardPort}`);
+        return;
+    }
+    // Ensure directories exist
+    await ensureDirectories(config);
+    // Check all core dependencies (node, tmux, ttyd, git)
+    await checkCoreDependencies();
+    // Command is passed from index.ts (already resolved via CLI > config.json > default)
+    let cmd = options.cmd || 'claude';
+    // Check if base command exists before we wrap it in a launch script
+    const baseCmdName = cmd.split(' ')[0];
+    if (!(await commandExists(baseCmdName))) {
+        fatal(`Command not found: ${baseCmdName}`);
+    }
+    // Load architect role if available and not disabled
+    if (!options.noRole) {
+        const role = loadRolePrompt(config, 'architect');
+        if (role) {
+            // Write role to a file and create a launch script to avoid shell escaping issues
+            // The architect.md file contains backticks, $variables, and other shell-sensitive chars
+            const roleFile = resolve(config.stateDir, 'architect-role.md');
+            writeFileSync(roleFile, role.content, 'utf-8');
+            const launchScript = resolve(config.stateDir, 'launch-architect.sh');
+            writeFileSync(launchScript, `#!/bin/bash
+cd "${config.projectRoot}"
+exec ${cmd} --append-system-prompt "$(cat '${roleFile}')"
+`, { mode: 0o755 });
+            cmd = launchScript;
+            logger.info(`Loaded architect role (${role.source})`);
+        }
+    }
+    // Find available port for architect terminal
+    let architectPort = config.architectPort;
+    if (options.port !== undefined) {
+        const parsedPort = Number(options.port);
+        if (!Number.isFinite(parsedPort) || parsedPort < 1024 || parsedPort > 65535) {
+            fatal(`Invalid port: ${options.port}. Must be a number between 1024-65535`);
+        }
+        architectPort = parsedPort;
+    }
+    logger.header('Starting Agent Farm');
+    logger.kv('Project', config.projectRoot);
+    logger.kv('Command', cmd);
+    logger.kv('Port', architectPort);
+    // Start architect in tmux session for persistence
+    // Use port in session name to ensure uniqueness across projects
+    const sessionName = `af-architect-${architectPort}`;
+    // Kill any existing session
+    try {
+        await run(`tmux kill-session -t ${sessionName} 2>/dev/null || true`);
+    }
+    catch {
+        // Ignore
+    }
+    // Create tmux session with the command
+    await run(`tmux new-session -d -s ${sessionName} -x 200 -y 50 '${cmd}'`, { cwd: config.projectRoot });
+    await run(`tmux set-option -t ${sessionName} -g mouse on`);
+    await run(`tmux set-option -t ${sessionName} -g set-clipboard on`);
+    await run(`tmux set-option -t ${sessionName} -g allow-passthrough on`);
+    // Copy selection to clipboard when mouse is released (pbcopy for macOS)
+    await run(`tmux bind-key -T copy-mode MouseDragEnd1Pane send-keys -X copy-pipe-and-cancel "pbcopy"`);
+    await run(`tmux bind-key -T copy-mode-vi MouseDragEnd1Pane send-keys -X copy-pipe-and-cancel "pbcopy"`);
+    // Start ttyd attached to the tmux session
+    // Use custom index.html for file path click-to-open functionality (optional)
+    const customIndexPath = resolve(config.templatesDir, 'ttyd-index.html');
+    const ttydArgs = [
+        '-W',
+        '-p', String(architectPort),
+        '-t', 'theme={"background":"#000000"}',
+        '-t', 'rightClickSelectsWord=true', // Enable word selection on right-click for better UX
+    ];
+    // Add custom index if it exists
+    if (existsSync(customIndexPath)) {
+        ttydArgs.push('-I', customIndexPath);
+        logger.info('Using custom terminal with file click support');
+    }
+    ttydArgs.push('tmux', 'attach-session', '-t', sessionName);
+    const ttydProcess = spawnDetached('ttyd', ttydArgs, {
+        cwd: config.projectRoot,
+    });
+    if (!ttydProcess.pid) {
+        fatal('Failed to start ttyd process');
+    }
+    // Save architect state
+    const architectState = {
+        port: architectPort,
+        pid: ttydProcess.pid,
+        cmd,
+        startedAt: new Date().toISOString(),
+        tmuxSession: sessionName,
+    };
+    setArchitect(architectState);
+    // Wait a moment for ttyd to start
+    await new Promise((resolve) => setTimeout(resolve, 500));
+    // Start the dashboard server on the main port
+    const dashboardPort = config.dashboardPort;
+    await startDashboard(config.projectRoot, dashboardPort, architectPort);
+    logger.blank();
+    logger.success('Agent Farm started!');
+    logger.kv('Dashboard', `http://localhost:${dashboardPort}`);
+    // Open dashboard in browser
+    await openBrowser(`http://localhost:${dashboardPort}`);
+}
+/**
+ * Start the dashboard HTTP server
+ */
+async function startDashboard(projectRoot, port, _architectPort) {
+    const config = getConfig();
+    // Try TypeScript source first (dev mode), then compiled JS
+    const tsScript = resolve(config.serversDir, 'dashboard-server.ts');
+    const jsScript = resolve(config.serversDir, 'dashboard-server.js');
+    let command;
+    let args;
+    if (existsSync(tsScript)) {
+        // Dev mode: run with tsx
+        command = 'npx';
+        args = ['tsx', tsScript, String(port)];
+    }
+    else if (existsSync(jsScript)) {
+        // Prod mode: run compiled JS
+        command = 'node';
+        args = [jsScript, String(port)];
+    }
+    else {
+        logger.warn('Dashboard server not found, skipping dashboard');
+        return;
+    }
+    const serverProcess = spawnDetached(command, args, {
+        cwd: projectRoot,
+    });
+    if (!serverProcess.pid) {
+        logger.warn('Failed to start dashboard server');
+    }
+}
+//# sourceMappingURL=start.js.map

package/dist/agent-farm/commands/start.js.map

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

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

@@ -0,0 +1,8 @@
+/**
+ * Status command - shows status of all agents
+ */
+/**
+ * Display status of all agent farm processes
+ */
+export declare function status(): Promise<void>;
+//# sourceMappingURL=status.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/agent-farm/commands/status.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH;;GAEG;AACH,wBAAsB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CA2F5C"}

package/dist/agent-farm/commands/status.js

@@ -0,0 +1,123 @@
+/**
+ * Status command - shows status of all agents
+ */
+import { loadState } from '../state.js';
+import { logger } from '../utils/logger.js';
+import { isProcessRunning } from '../utils/shell.js';
+import chalk from 'chalk';
+/**
+ * Display status of all agent farm processes
+ */
+export async function status() {
+    const state = loadState();
+    logger.header('Agent Farm Status');
+    // Architect status
+    if (state.architect) {
+        const running = await isProcessRunning(state.architect.pid);
+        const statusText = running ? chalk.green('running') : chalk.red('stopped');
+        logger.kv('Architect', `${statusText} (PID: ${state.architect.pid}, port: ${state.architect.port})`);
+        logger.kv('  Command', state.architect.cmd);
+        logger.kv('  Started', state.architect.startedAt);
+    }
+    else {
+        logger.kv('Architect', chalk.gray('not running'));
+    }
+    logger.blank();
+    // Builders
+    if (state.builders.length > 0) {
+        logger.info('Builders:');
+        const widths = [12, 20, 10, 12, 10, 6];
+        logger.row(['ID', 'Name', 'Type', 'Status', 'Phase', 'Port'], widths);
+        logger.row(['──', '────', '────', '──────', '─────', '────'], widths);
+        for (const builder of state.builders) {
+            const running = await isProcessRunning(builder.pid);
+            const statusColor = getStatusColor(builder.status, running);
+            const typeColor = getTypeColor(builder.type || 'spec');
+            logger.row([
+                builder.id,
+                builder.name.substring(0, 18),
+                typeColor(builder.type || 'spec'),
+                statusColor(builder.status),
+                builder.phase.substring(0, 8),
+                String(builder.port),
+            ], widths);
+        }
+    }
+    else {
+        logger.info('Builders: none');
+    }
+    logger.blank();
+    // Utils
+    if (state.utils.length > 0) {
+        logger.info('Utility Terminals:');
+        const widths = [8, 20, 8];
+        logger.row(['ID', 'Name', 'Port'], widths);
+        logger.row(['──', '────', '────'], widths);
+        for (const util of state.utils) {
+            const running = await isProcessRunning(util.pid);
+            const name = running ? util.name : chalk.gray(util.name + ' (stopped)');
+            logger.row([
+                util.id,
+                name.substring(0, 18),
+                String(util.port),
+            ], widths);
+        }
+    }
+    else {
+        logger.info('Utility Terminals: none');
+    }
+    logger.blank();
+    // Annotations
+    if (state.annotations.length > 0) {
+        logger.info('Annotations:');
+        const widths = [8, 30, 8];
+        logger.row(['ID', 'File', 'Port'], widths);
+        logger.row(['──', '────', '────'], widths);
+        for (const annotation of state.annotations) {
+            const running = await isProcessRunning(annotation.pid);
+            const file = running ? annotation.file : chalk.gray(annotation.file + ' (stopped)');
+            logger.row([
+                annotation.id,
+                file.substring(0, 28),
+                String(annotation.port),
+            ], widths);
+        }
+    }
+    else {
+        logger.info('Annotations: none');
+    }
+}
+function getStatusColor(status, running) {
+    if (!running) {
+        return chalk.gray;
+    }
+    switch (status) {
+        case 'implementing':
+            return chalk.blue;
+        case 'blocked':
+            return chalk.yellow;
+        case 'pr-ready':
+            return chalk.green;
+        case 'complete':
+            return chalk.green;
+        default:
+            return chalk.white;
+    }
+}
+function getTypeColor(type) {
+    switch (type) {
+        case 'spec':
+            return chalk.cyan;
+        case 'task':
+            return chalk.magenta;
+        case 'protocol':
+            return chalk.yellow;
+        case 'worktree':
+            return chalk.blue;
+        case 'shell':
+            return chalk.gray;
+        default:
+            return chalk.white;
+    }
+}
+//# sourceMappingURL=status.js.map

package/dist/agent-farm/commands/status.js.map

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

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

@@ -0,0 +1,8 @@
+/**
+ * Stop command - stops all agent farm processes
+ */
+/**
+ * Stop all agent farm processes
+ */
+export declare function stop(): Promise<void>;
+//# sourceMappingURL=stop.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stop.d.ts","sourceRoot":"","sources":["../../../src/agent-farm/commands/stop.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH;;GAEG;AACH,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAoE1C"}

package/dist/agent-farm/commands/stop.js

@@ -0,0 +1,76 @@
+/**
+ * Stop command - stops all agent farm processes
+ */
+import { loadState, clearState } from '../state.js';
+import { logger } from '../utils/logger.js';
+import { killProcess, isProcessRunning } from '../utils/shell.js';
+/**
+ * Stop all agent farm processes
+ */
+export async function stop() {
+    const state = loadState();
+    logger.header('Stopping Agent Farm');
+    let stopped = 0;
+    // Stop architect
+    if (state.architect) {
+        logger.info(`Stopping architect (PID: ${state.architect.pid})`);
+        try {
+            if (await isProcessRunning(state.architect.pid)) {
+                await killProcess(state.architect.pid);
+                stopped++;
+            }
+        }
+        catch (error) {
+            logger.warn(`Failed to stop architect: ${error}`);
+        }
+    }
+    // Stop all builders
+    for (const builder of state.builders) {
+        logger.info(`Stopping builder ${builder.id} (PID: ${builder.pid})`);
+        try {
+            if (await isProcessRunning(builder.pid)) {
+                await killProcess(builder.pid);
+                stopped++;
+            }
+        }
+        catch (error) {
+            logger.warn(`Failed to stop builder ${builder.id}: ${error}`);
+        }
+    }
+    // Stop all utils
+    for (const util of state.utils) {
+        logger.info(`Stopping util ${util.id} (PID: ${util.pid})`);
+        try {
+            if (await isProcessRunning(util.pid)) {
+                await killProcess(util.pid);
+                stopped++;
+            }
+        }
+        catch (error) {
+            logger.warn(`Failed to stop util ${util.id}: ${error}`);
+        }
+    }
+    // Stop all annotations
+    for (const annotation of state.annotations) {
+        logger.info(`Stopping annotation ${annotation.id} (PID: ${annotation.pid})`);
+        try {
+            if (await isProcessRunning(annotation.pid)) {
+                await killProcess(annotation.pid);
+                stopped++;
+            }
+        }
+        catch (error) {
+            logger.warn(`Failed to stop annotation ${annotation.id}: ${error}`);
+        }
+    }
+    // Clear state
+    clearState();
+    logger.blank();
+    if (stopped > 0) {
+        logger.success(`Stopped ${stopped} process(es)`);
+    }
+    else {
+        logger.info('No processes were running');
+    }
+}
+//# sourceMappingURL=stop.js.map

package/dist/agent-farm/commands/stop.js.map

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

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

@@ -0,0 +1,19 @@
+/**
+ * Tower command - launches the tower dashboard showing all instances
+ */
+export interface TowerStartOptions {
+    port?: number;
+}
+export interface TowerStopOptions {
+    port?: number;
+}
+/**
+ * Start the tower dashboard
+ */
+export declare function towerStart(options?: TowerStartOptions): Promise<void>;
+/**
+ * Stop the tower dashboard
+ */
+export declare function towerStop(options?: TowerStopOptions): Promise<void>;
+export declare const tower: typeof towerStart;
+//# sourceMappingURL=tower.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tower.d.ts","sourceRoot":"","sources":["../../../src/agent-farm/commands/tower.ts"],"names":[],"mappings":"AAAA;;GAEG;AAaH,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAsCD;;GAEG;AACH,wBAAsB,UAAU,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAuD/E;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAyB7E;AAGD,eAAO,MAAM,KAAK,mBAAa,CAAC"}

package/dist/agent-farm/commands/tower.js

@@ -0,0 +1,125 @@
+/**
+ * Tower command - launches the tower dashboard showing all instances
+ */
+import { resolve } from 'node:path';
+import { existsSync } from 'node:fs';
+import net from 'node:net';
+import { logger, fatal } from '../utils/logger.js';
+import { spawnDetached, openBrowser } from '../utils/shell.js';
+import { getConfig } from '../utils/config.js';
+import { execSync } from 'node:child_process';
+// Default port for tower dashboard
+const DEFAULT_TOWER_PORT = 4100;
+/**
+ * Check if a port is already in use
+ */
+async function isPortInUse(port) {
+    return new Promise((resolve) => {
+        const server = net.createServer();
+        server.once('error', (err) => {
+            if (err.code === 'EADDRINUSE') {
+                resolve(true);
+            }
+            else {
+                resolve(false);
+            }
+        });
+        server.once('listening', () => {
+            server.close(() => resolve(false));
+        });
+        server.listen(port, '127.0.0.1');
+    });
+}
+/**
+ * Get all PIDs of processes listening on a port
+ */
+function getProcessesOnPort(port) {
+    try {
+        const result = execSync(`lsof -ti :${port} 2>/dev/null`, { encoding: 'utf-8' });
+        return result
+            .trim()
+            .split('\n')
+            .map((line) => parseInt(line, 10))
+            .filter((pid) => !isNaN(pid));
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Start the tower dashboard
+ */
+export async function towerStart(options = {}) {
+    const port = options.port || DEFAULT_TOWER_PORT;
+    // Check if already running
+    if (await isPortInUse(port)) {
+        const dashboardUrl = `http://localhost:${port}`;
+        logger.info(`Tower already running at ${dashboardUrl}`);
+        await openBrowser(dashboardUrl);
+        return;
+    }
+    const config = getConfig();
+    // Find tower server script
+    const tsScript = resolve(config.serversDir, 'tower-server.ts');
+    const jsScript = resolve(config.serversDir, 'tower-server.js');
+    let command;
+    let args;
+    if (existsSync(tsScript)) {
+        // Dev mode: run with tsx
+        command = 'npx';
+        args = ['tsx', tsScript, String(port)];
+    }
+    else if (existsSync(jsScript)) {
+        // Prod mode: run compiled JS
+        command = 'node';
+        args = [jsScript, String(port)];
+    }
+    else {
+        fatal('Tower server not found');
+    }
+    logger.header('Starting Tower');
+    logger.kv('Port', port);
+    // Start tower server
+    const serverProcess = spawnDetached(command, args, {
+        cwd: process.cwd(),
+    });
+    if (!serverProcess.pid) {
+        fatal('Failed to start tower server');
+    }
+    // Wait a moment for server to start
+    await new Promise((resolve) => setTimeout(resolve, 500));
+    const dashboardUrl = `http://localhost:${port}`;
+    logger.blank();
+    logger.success('Tower started!');
+    logger.kv('Dashboard', dashboardUrl);
+    // Open in browser
+    await openBrowser(dashboardUrl);
+}
+/**
+ * Stop the tower dashboard
+ */
+export async function towerStop(options = {}) {
+    const port = options.port || DEFAULT_TOWER_PORT;
+    logger.header('Stopping Tower');
+    const pids = getProcessesOnPort(port);
+    if (pids.length === 0) {
+        logger.info('Tower is not running');
+        return;
+    }
+    let stopped = 0;
+    for (const pid of pids) {
+        try {
+            process.kill(pid, 'SIGTERM');
+            stopped++;
+        }
+        catch {
+            // Process may have already exited
+        }
+    }
+    if (stopped > 0) {
+        logger.success(`Tower stopped (${stopped} process${stopped > 1 ? 'es' : ''}: PIDs ${pids.join(', ')})`);
+    }
+}
+// Legacy export for backward compatibility
+export const tower = towerStart;
+//# sourceMappingURL=tower.js.map

package/dist/agent-farm/commands/tower.js.map

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

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

@@ -0,0 +1,10 @@
+/**
+ * Tutorial command handler
+ * Interactive onboarding for new users
+ */
+import type { TutorialOptions } from '../types.js';
+/**
+ * Main tutorial command
+ */
+export declare function tutorial(options: TutorialOptions): Promise<void>;
+//# sourceMappingURL=tutorial.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tutorial.d.ts","sourceRoot":"","sources":["../../../src/agent-farm/commands/tutorial.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAyBnD;;GAEG;AACH,wBAAsB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAsBtE"}

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

@@ -0,0 +1,49 @@
+/**
+ * Tutorial command handler
+ * Interactive onboarding for new users
+ */
+import { logger } from '../utils/logger.js';
+import { resetTutorialState } from '../tutorial/state.js';
+import { runTutorial, showStatus, skipCurrentStep } from '../tutorial/runner.js';
+// Import all tutorial steps
+import { welcomeStep } from '../tutorial/steps/welcome.js';
+import { setupStep } from '../tutorial/steps/setup.js';
+import { firstSpecStep } from '../tutorial/steps/first-spec.js';
+import { planningStep } from '../tutorial/steps/planning.js';
+import { implementationStep } from '../tutorial/steps/implementation.js';
+import { reviewStep } from '../tutorial/steps/review.js';
+/**
+ * All tutorial steps in order
+ */
+const TUTORIAL_STEPS = [
+    welcomeStep,
+    setupStep,
+    firstSpecStep,
+    planningStep,
+    implementationStep,
+    reviewStep,
+];
+/**
+ * Main tutorial command
+ */
+export async function tutorial(options) {
+    // Handle --reset flag
+    if (options.reset) {
+        await resetTutorialState();
+        logger.success('Tutorial progress reset. Run `af tutorial` to start fresh.');
+        return;
+    }
+    // Handle --status flag
+    if (options.status) {
+        await showStatus(TUTORIAL_STEPS);
+        return;
+    }
+    // Handle --skip flag
+    if (options.skip) {
+        await skipCurrentStep(TUTORIAL_STEPS);
+        return;
+    }
+    // Default: run the tutorial
+    await runTutorial(TUTORIAL_STEPS);
+}
+//# sourceMappingURL=tutorial.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tutorial.js","sourceRoot":"","sources":["../../../src/agent-farm/commands/tutorial.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,eAAe,EAAa,MAAM,uBAAuB,CAAC;AAE5F,4BAA4B;AAC5B,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AACzE,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAEzD;;GAEG;AACH,MAAM,cAAc,GAAW;IAC7B,WAAW;IACX,SAAS;IACT,aAAa;IACb,YAAY;IACZ,kBAAkB;IAClB,UAAU;CACX,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,OAAwB;IACrD,sBAAsB;IACtB,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,MAAM,kBAAkB,EAAE,CAAC;QAC3B,MAAM,CAAC,OAAO,CAAC,4DAA4D,CAAC,CAAC;QAC7E,OAAO;IACT,CAAC;IAED,uBAAuB;IACvB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,MAAM,UAAU,CAAC,cAAc,CAAC,CAAC;QACjC,OAAO;IACT,CAAC;IAED,qBAAqB;IACrB,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,MAAM,eAAe,CAAC,cAAc,CAAC,CAAC;QACtC,OAAO;IACT,CAAC;IAED,4BAA4B;IAC5B,MAAM,WAAW,CAAC,cAAc,CAAC,CAAC;AACpC,CAAC"}