@rajat-rastogi/maestro 0.1.0

package/dist/plan/creator.js

@@ -0,0 +1,251 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import * as readline from 'readline';
+import { spawnSync } from 'child_process';
+import { loadPrompt } from '../config/prompts.js';
+import { expandTemplate } from '../config/template.js';
+const GENERATION_PROMPT_SUFFIX = `
+Based on the exploration above and the user's answers, generate a complete maestro plan
+file. Start the plan on its own line with "# Plan:" — everything from that line to the
+end of your response will be saved as the plan file.
+
+Use this structure:
+# Plan: [Concise descriptive title]
+
+## Overview
+[1–3 sentence goal description]
+
+## Validation Commands
+- \`command1\`
+
+### Task 1: [Action verb + subject]
+- [ ] [Specific verifiable step]
+
+[Continue with 3–10 tasks appropriate to the scope. Each task must have checkboxes.]
+`;
+const REVISION_PROMPT_SUFFIX = `
+Revise the plan according to the requested changes above. Output the complete updated plan
+starting on its own line with "# Plan:" — everything from that line to the end of your
+response will be saved as the plan file.
+`;
+export class PlanCreator {
+    config;
+    backend;
+    logger;
+    constructor(config, backend, logger) {
+        this.config = config;
+        this.backend = backend;
+        this.logger = logger;
+    }
+    async create(description) {
+        const cwd = process.cwd();
+        // ── Phase 1: exploration + questions ──
+        this.logger.info('Exploring codebase and generating questions...\n');
+        const exploration = await this.runExploration(description, cwd);
+        // ── Collect user answers ──
+        const answers = await this.collectAnswers();
+        // ── Phase 2: generate plan ──
+        this.logger.info('\nGenerating plan...\n');
+        const generationPrompt = this.buildGenerationPrompt(description, cwd, exploration, answers);
+        const output = await this.runGeneration(generationPrompt);
+        // ── Extract and save ──
+        const planContent = this.extractPlan(output);
+        const filePath = this.savePlan(planContent, description, cwd);
+        // ── Post-generation menu ──
+        return this.runMenu(planContent, filePath, description, cwd, exploration, answers);
+    }
+    // ── Menu loop ────────────────────────────────────────────────────────────
+    async runMenu(initialPlan, filePath, description, cwd, exploration, answers) {
+        let currentPlan = initialPlan;
+        while (true) {
+            this.printPlan(currentPlan);
+            process.stdout.write(`\n─── Plan saved: ${filePath} ───\n`);
+            process.stdout.write('  [A] Accept\n');
+            process.stdout.write('  [G] Accept and go (run now)\n');
+            process.stdout.write('  [E] Edit in editor\n');
+            process.stdout.write('  [R] Revise (re-generate with changes)\n');
+            process.stdout.write('  [X] Reject and discard\n\n');
+            const choice = await this.promptChoice('Choice [A/G/E/R/X]: ', ['a', 'g', 'e', 'r', 'x']);
+            if (choice === 'a') {
+                return { filePath, runNow: false };
+            }
+            if (choice === 'g') {
+                return { filePath, runNow: true };
+            }
+            if (choice === 'e') {
+                this.openEditor(filePath);
+                const runNow = await this.promptYesNo('Run now? [Y/n]: ');
+                return { filePath, runNow };
+            }
+            if (choice === 'r') {
+                const revision = await this.collectRevision();
+                this.logger.info('\nRevising plan...\n');
+                const revisedOutput = await this.runRevision(currentPlan, revision, description, cwd, exploration, answers);
+                currentPlan = this.extractPlan(revisedOutput);
+                fs.writeFileSync(filePath, currentPlan + '\n', 'utf8');
+                // loop back to show menu with updated plan
+            }
+            if (choice === 'x') {
+                try {
+                    fs.unlinkSync(filePath);
+                }
+                catch { /* already gone */ }
+                this.logger.info('Plan discarded.');
+                process.exit(0);
+            }
+        }
+    }
+    // ── Helpers ──────────────────────────────────────────────────────────────
+    printPlan(content) {
+        process.stdout.write('\n');
+        for (const line of content.split('\n')) {
+            this.logger.log(line, 'review');
+        }
+    }
+    openEditor(filePath) {
+        const editor = process.env['EDITOR'] ?? process.env['VISUAL']
+            ?? (process.platform === 'win32' ? 'notepad' : 'vi');
+        spawnSync(editor, [filePath], { stdio: 'inherit', shell: process.platform === 'win32' });
+    }
+    async promptChoice(prompt, valid) {
+        const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+        return new Promise((resolve) => {
+            const ask = () => {
+                rl.question(prompt, (answer) => {
+                    const lower = answer.trim().toLowerCase();
+                    if (valid.includes(lower)) {
+                        rl.close();
+                        resolve(lower);
+                    }
+                    else {
+                        ask();
+                    }
+                });
+            };
+            ask();
+        });
+    }
+    async promptYesNo(prompt) {
+        const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+        return new Promise((resolve) => {
+            rl.question(prompt, (answer) => {
+                rl.close();
+                resolve(answer.trim().toLowerCase() !== 'n');
+            });
+        });
+    }
+    async collectRevision() {
+        const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+        process.stdout.write('Describe what to change (blank line to finish):\n> ');
+        const lines = [];
+        return new Promise((resolve) => {
+            rl.on('line', (line) => {
+                if (line === '') {
+                    rl.close();
+                    resolve(lines.join('\n'));
+                }
+                else {
+                    lines.push(line);
+                    process.stdout.write('> ');
+                }
+            });
+            rl.on('close', () => resolve(lines.join('\n')));
+        });
+    }
+    // ── AI phases ─────────────────────────────────────────────────────────────
+    async runExploration(description, cwd) {
+        const template = loadPrompt('plan_create', this.config);
+        const prompt = expandTemplate(template, { DESCRIPTION: description, CWD: cwd });
+        const lines = [];
+        await this.backend.run(prompt, (line) => {
+            if (line.type === 'text' && line.text.trim()) {
+                for (const l of line.text.split('\n')) {
+                    this.logger.log(l, 'task');
+                    lines.push(l);
+                }
+            }
+        });
+        return lines.join('\n');
+    }
+    async collectAnswers() {
+        const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+        process.stdout.write('\n─── Your answers (blank line to finish) ───\n> ');
+        const lines = [];
+        return new Promise((resolve) => {
+            rl.on('line', (line) => {
+                if (line === '') {
+                    rl.close();
+                    resolve(lines.join('\n'));
+                }
+                else {
+                    lines.push(line);
+                    process.stdout.write('> ');
+                }
+            });
+            rl.on('close', () => resolve(lines.join('\n')));
+        });
+    }
+    buildGenerationPrompt(description, cwd, exploration, answers) {
+        return [
+            `Developer request: ${description}`,
+            `Working directory: ${cwd}`,
+            '',
+            'Your codebase exploration and questions:',
+            exploration,
+            '',
+            "Developer's answers:",
+            answers,
+            '',
+            GENERATION_PROMPT_SUFFIX,
+        ].join('\n');
+    }
+    async runGeneration(prompt) {
+        const lines = [];
+        await this.backend.run(prompt, (line) => {
+            if (line.type === 'text' && line.text.trim()) {
+                for (const l of line.text.split('\n')) {
+                    this.logger.log(l, 'review');
+                    lines.push(l);
+                }
+            }
+        });
+        return lines.join('\n');
+    }
+    async runRevision(currentPlan, revision, description, cwd, exploration, answers) {
+        const prompt = [
+            `Original request: ${description}`,
+            `Working directory: ${cwd}`,
+            '',
+            'Codebase exploration and initial Q&A:',
+            exploration,
+            '',
+            "Developer's original answers:",
+            answers,
+            '',
+            'Current plan:',
+            currentPlan,
+            '',
+            'Requested changes:',
+            revision,
+            '',
+            REVISION_PROMPT_SUFFIX,
+        ].join('\n');
+        return this.runGeneration(prompt);
+    }
+    extractPlan(output) {
+        const idx = output.indexOf('# Plan:');
+        if (idx === -1)
+            throw new Error('No plan found in output. Re-run with more detail.');
+        return output.slice(idx).trim();
+    }
+    savePlan(content, description, cwd) {
+        const plansDir = path.resolve(cwd, this.config.plans_dir);
+        fs.mkdirSync(plansDir, { recursive: true });
+        const slug = description
+            .toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/, '').slice(0, 50);
+        const filePath = path.join(plansDir, `${slug}.md`);
+        fs.writeFileSync(filePath, content + '\n', 'utf8');
+        return filePath;
+    }
+}
+//# sourceMappingURL=creator.js.map

package/dist/plan/creator.js.map

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

package/dist/plan/parser.d.ts

@@ -0,0 +1,11 @@
+import { Plan, Task } from './types.js';
+export declare function parsePlanFile(filePath: string): Plan;
+/**
+ * Find the first task that has at least one unchecked checkbox.
+ */
+export declare function findFirstIncompleteTask(plan: Plan): Task | null;
+/**
+ * Check if all tasks are complete.
+ */
+export declare function isAllTasksComplete(plan: Plan): boolean;
+//# sourceMappingURL=parser.d.ts.map

package/dist/plan/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/plan/parser.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,IAAI,EAAY,MAAM,YAAY,CAAC;AASlD,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAWpD;AAqID;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAQ/D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAEtD"}

package/dist/plan/parser.js

@@ -0,0 +1,151 @@
+import * as fs from 'fs';
+// Matches "### Task 1:", "### Task 2.5:", "### Task 2a:", "### Iteration 3:"
+const TASK_HEADER_RE = /^###\s+(?:Task|Iteration)\s+([\d]+(?:\.\d+|[a-z])?)\s*:(.*)$/i;
+const CHECKBOX_RE = /^(\s*)-\s+\[([ xX])\]\s+(.*)$/;
+const VALIDATION_SECTION_RE = /^##\s+Validation\s+Commands\s*$/i;
+const TASK_VALIDATION_RE = /^####\s+Validation\s+Commands\s*$/i;
+const OVERVIEW_SECTION_RE = /^##\s+Overview\s*$/i;
+export function parsePlanFile(filePath) {
+    const content = fs.readFileSync(filePath, 'utf8');
+    // Normalize CRLF (Windows) to LF so regexes work correctly on all platforms
+    const lines = content.replace(/\r\n/g, '\n').replace(/\r/g, '\n').split('\n');
+    const title = extractTitle(lines);
+    const goal = extractGoal(lines);
+    const validationCommands = extractValidationCommands(lines);
+    const tasks = extractTasks(lines);
+    return { title, goal, validationCommands, tasks, filePath, lines };
+}
+function extractTitle(lines) {
+    for (const line of lines) {
+        const m = line.match(/^#\s+(.+)$/);
+        if (m)
+            return m[1].trim();
+    }
+    return 'Untitled Plan';
+}
+function extractGoal(lines) {
+    let inOverview = false;
+    const goalLines = [];
+    for (const line of lines) {
+        if (OVERVIEW_SECTION_RE.test(line)) {
+            inOverview = true;
+            continue;
+        }
+        if (inOverview) {
+            if (/^#+\s/.test(line))
+                break;
+            goalLines.push(line);
+        }
+    }
+    return goalLines.join('\n').trim();
+}
+function extractValidationCommands(lines) {
+    let inSection = false;
+    const commands = [];
+    for (const line of lines) {
+        if (VALIDATION_SECTION_RE.test(line)) {
+            inSection = true;
+            continue;
+        }
+        if (inSection) {
+            // Stop at any heading (##, ###, etc.) — not just same-level
+            if (/^#+\s/.test(line))
+                break;
+            // Skip checkbox lines — they are never commands
+            if (/^\s*-\s+\[[ xX]\]/.test(line))
+                continue;
+            // Extract command from bullet: `- \`command\`` or `- command`
+            const m = line.match(/^\s*-\s+`?(.+?)`?\s*$/);
+            if (m)
+                commands.push(m[1].trim());
+        }
+    }
+    return commands;
+}
+function extractTasks(lines) {
+    const tasks = [];
+    let currentTask = null;
+    let inTaskValidation = false;
+    let taskValidationCommands = [];
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const taskMatch = line.match(TASK_HEADER_RE);
+        if (taskMatch) {
+            if (currentTask) {
+                // Finalize previous task
+                tasks.push(buildTask(currentTask, taskValidationCommands, i, lines));
+            }
+            currentTask = {
+                index: taskMatch[1],
+                title: taskMatch[2].trim(),
+                startLine: i,
+                checkboxes: [],
+            };
+            inTaskValidation = false;
+            taskValidationCommands = [];
+            continue;
+        }
+        if (currentTask) {
+            if (TASK_VALIDATION_RE.test(line)) {
+                inTaskValidation = true;
+                continue;
+            }
+            if (inTaskValidation) {
+                if (/^#+\s/.test(line)) {
+                    inTaskValidation = false;
+                }
+                else {
+                    const m = line.match(/^\s*-\s+`?(.+?)`?\s*$/);
+                    if (m)
+                        taskValidationCommands.push(m[1].trim());
+                    continue;
+                }
+            }
+            const cbMatch = line.match(CHECKBOX_RE);
+            if (cbMatch) {
+                currentTask.checkboxes.push({
+                    text: cbMatch[3].trim(),
+                    checked: cbMatch[2].toLowerCase() === 'x',
+                    lineIndex: i,
+                });
+            }
+        }
+    }
+    // Finalize last task
+    if (currentTask) {
+        tasks.push(buildTask(currentTask, taskValidationCommands, lines.length, lines));
+    }
+    return tasks;
+}
+function buildTask(current, validationCommands, endLine, lines) {
+    const rawLines = lines.slice(current.startLine, endLine);
+    return {
+        index: current.index,
+        title: current.title,
+        checkboxes: current.checkboxes,
+        validationCommands,
+        startLine: current.startLine,
+        endLine,
+        rawText: rawLines.join('\n'),
+    };
+}
+/**
+ * Find the first task that has at least one unchecked checkbox.
+ */
+export function findFirstIncompleteTask(plan) {
+    for (const task of plan.tasks) {
+        if (task.checkboxes.length === 0)
+            continue;
+        if (task.checkboxes.some(cb => !cb.checked)) {
+            return task;
+        }
+    }
+    return null;
+}
+/**
+ * Check if all tasks are complete.
+ */
+export function isAllTasksComplete(plan) {
+    return findFirstIncompleteTask(plan) === null;
+}
+//# sourceMappingURL=parser.js.map

package/dist/plan/parser.js.map

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

package/dist/plan/types.d.ts

@@ -0,0 +1,23 @@
+export interface Checkbox {
+    text: string;
+    checked: boolean;
+    lineIndex: number;
+}
+export interface Task {
+    index: string;
+    title: string;
+    checkboxes: Checkbox[];
+    validationCommands: string[];
+    startLine: number;
+    endLine: number;
+    rawText: string;
+}
+export interface Plan {
+    title: string;
+    goal: string;
+    validationCommands: string[];
+    tasks: Task[];
+    filePath: string;
+    lines: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/plan/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/plan/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,IAAI;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,QAAQ,EAAE,CAAC;IACvB,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,IAAI;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB"}

package/dist/plan/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/plan/types.js.map

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

package/dist/plan/updater.d.ts

@@ -0,0 +1,16 @@
+import { Plan, Task } from './types.js';
+/**
+ * Mark all checkboxes in a task as checked, writing the change back to the plan file.
+ * Mutates plan.lines in-place and writes to disk.
+ */
+export declare function markTaskComplete(plan: Plan, task: Task): void;
+/**
+ * Move a completed plan file to docs/plans/completed/ with a timestamp suffix.
+ * Returns the new file path.
+ */
+export declare function movePlanToCompleted(plan: Plan, plansDir: string): string;
+/**
+ * Reload plan from disk (after external modifications).
+ */
+export declare function reloadPlan(plan: Plan): void;
+//# sourceMappingURL=updater.d.ts.map

package/dist/plan/updater.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"updater.d.ts","sourceRoot":"","sources":["../../src/plan/updater.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAExC;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI,CAa7D;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAYxE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAc3C"}

package/dist/plan/updater.js

@@ -0,0 +1,59 @@
+import * as fs from 'fs';
+import * as path from 'path';
+/**
+ * Mark all checkboxes in a task as checked, writing the change back to the plan file.
+ * Mutates plan.lines in-place and writes to disk.
+ */
+export function markTaskComplete(plan, task) {
+    for (const checkbox of task.checkboxes) {
+        if (!checkbox.checked) {
+            const line = plan.lines[checkbox.lineIndex];
+            plan.lines[checkbox.lineIndex] = line.replace(/\[ \]/, '[x]');
+            checkbox.checked = true;
+        }
+    }
+    // Also update the task's rawText
+    task.rawText = plan.lines.slice(task.startLine, task.endLine).join('\n');
+    fs.writeFileSync(plan.filePath, plan.lines.join('\n'), 'utf8');
+}
+/**
+ * Move a completed plan file to docs/plans/completed/ with a timestamp suffix.
+ * Returns the new file path.
+ */
+export function movePlanToCompleted(plan, plansDir) {
+    const now = new Date();
+    const ts = formatTimestampForFilename(now);
+    const baseName = path.basename(plan.filePath, '.md');
+    const completedDir = path.join(plansDir, 'completed');
+    fs.mkdirSync(completedDir, { recursive: true });
+    const destPath = path.join(completedDir, `${baseName}-${ts}.md`);
+    fs.renameSync(plan.filePath, destPath);
+    return destPath;
+}
+/**
+ * Reload plan from disk (after external modifications).
+ */
+export function reloadPlan(plan) {
+    const content = fs.readFileSync(plan.filePath, 'utf8');
+    const newLines = content.split('\n');
+    plan.lines = newLines;
+    // Update checkbox state from disk
+    for (const task of plan.tasks) {
+        for (const checkbox of task.checkboxes) {
+            const line = newLines[checkbox.lineIndex];
+            if (line !== undefined) {
+                checkbox.checked = /\[x\]/i.test(line);
+            }
+        }
+    }
+}
+function formatTimestampForFilename(date) {
+    const yyyy = date.getFullYear();
+    const mm = String(date.getMonth() + 1).padStart(2, '0');
+    const dd = String(date.getDate()).padStart(2, '0');
+    const hh = String(date.getHours()).padStart(2, '0');
+    const min = String(date.getMinutes()).padStart(2, '0');
+    const ss = String(date.getSeconds()).padStart(2, '0');
+    return `${yyyy}${mm}${dd}-${hh}${min}${ss}`;
+}
+//# sourceMappingURL=updater.js.map

package/dist/plan/updater.js.map

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

package/dist/progress/colors.d.ts

@@ -0,0 +1,9 @@
+import { Config } from '../config/types.js';
+export type Phase = 'task' | 'review' | 'claude_eval' | 'warn' | 'error' | 'signal' | 'timestamp' | 'info';
+/**
+ * Render text with 24-bit ANSI color.
+ * Returns plain text when noColor is true or when running in an env that doesn't support colors.
+ */
+export declare function colorize(text: string, hexColor: string, noColor: boolean): string;
+export declare function getPhaseColor(phase: Phase, config: Config): string;
+//# sourceMappingURL=colors.d.ts.map

package/dist/progress/colors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors.d.ts","sourceRoot":"","sources":["../../src/progress/colors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,MAAM,MAAM,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,aAAa,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,WAAW,GAAG,MAAM,CAAC;AAE3G;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAKjF;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAYlE"}

package/dist/progress/colors.js

@@ -0,0 +1,39 @@
+/**
+ * Render text with 24-bit ANSI color.
+ * Returns plain text when noColor is true or when running in an env that doesn't support colors.
+ */
+export function colorize(text, hexColor, noColor) {
+    if (noColor)
+        return text;
+    const rgb = hexToRgb(hexColor);
+    if (!rgb)
+        return text;
+    return `\x1b[38;2;${rgb.r};${rgb.g};${rgb.b}m${text}\x1b[0m`;
+}
+export function getPhaseColor(phase, config) {
+    const map = {
+        task: config.color_task,
+        review: config.color_review,
+        claude_eval: config.color_claude_eval,
+        warn: config.color_warn,
+        error: config.color_error,
+        signal: config.color_signal,
+        timestamp: config.color_timestamp,
+        info: config.color_info,
+    };
+    return map[phase] ?? config.color_info;
+}
+function hexToRgb(hex) {
+    const cleaned = hex.replace('#', '');
+    if (cleaned.length !== 6)
+        return null;
+    const n = parseInt(cleaned, 16);
+    if (isNaN(n))
+        return null;
+    return {
+        r: (n >> 16) & 0xff,
+        g: (n >> 8) & 0xff,
+        b: n & 0xff,
+    };
+}
+//# sourceMappingURL=colors.js.map

package/dist/progress/colors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors.js","sourceRoot":"","sources":["../../src/progress/colors.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAE,QAAgB,EAAE,OAAgB;IACvE,IAAI,OAAO;QAAE,OAAO,IAAI,CAAC;IACzB,MAAM,GAAG,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC/B,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,OAAO,aAAa,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,IAAI,SAAS,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAY,EAAE,MAAc;IACxD,MAAM,GAAG,GAA0B;QACjC,IAAI,EAAE,MAAM,CAAC,UAAU;QACvB,MAAM,EAAE,MAAM,CAAC,YAAY;QAC3B,WAAW,EAAE,MAAM,CAAC,iBAAiB;QACrC,IAAI,EAAE,MAAM,CAAC,UAAU;QACvB,KAAK,EAAE,MAAM,CAAC,WAAW;QACzB,MAAM,EAAE,MAAM,CAAC,YAAY;QAC3B,SAAS,EAAE,MAAM,CAAC,eAAe;QACjC,IAAI,EAAE,MAAM,CAAC,UAAU;KACxB,CAAC;IACF,OAAO,GAAG,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,UAAU,CAAC;AACzC,CAAC;AAED,SAAS,QAAQ,CAAC,GAAW;IAC3B,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACrC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACtC,MAAM,CAAC,GAAG,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAChC,IAAI,KAAK,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1B,OAAO;QACL,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI;QACnB,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI;QAClB,CAAC,EAAE,CAAC,GAAG,IAAI;KACZ,CAAC;AACJ,CAAC"}

package/dist/progress/logger.d.ts

@@ -0,0 +1,17 @@
+import { Config } from '../config/types.js';
+import { Phase } from './colors.js';
+import { EventBus } from '../dashboard/event-bus.js';
+export interface Logger {
+    log(text: string, phase?: Phase): void;
+    header(text: string): void;
+    signal(text: string): void;
+    error(text: string): void;
+    warn(text: string): void;
+    info(text: string): void;
+    debug(text: string): void;
+    setProgressFile(planName: string): void;
+    getProgressFilePath(): string;
+    setEventBus(bus: EventBus): void;
+}
+export declare function createLogger(config: Config, progressDir: string | undefined): Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/progress/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/progress/logger.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAA2B,KAAK,EAAE,MAAM,aAAa,CAAC;AAE7D,OAAO,EAAE,QAAQ,EAAY,MAAM,2BAA2B,CAAC;AAE/D,MAAM,WAAW,MAAM;IACrB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;IACvC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,mBAAmB,IAAI,MAAM,CAAC;IAC9B,WAAW,CAAC,GAAG,EAAE,QAAQ,GAAG,IAAI,CAAC;CAClC;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CA6GpF"}