daedalus-cli 3.67.1 → 3.68.0

package/dist/marathon/git-checkpoint.js

@@ -0,0 +1,119 @@
+import { execSync } from 'child_process';
+export function isGitRepository(cwd) {
+    try {
+        execSync('git rev-parse --is-inside-work-tree', {
+            cwd,
+            stdio: 'ignore',
+            windowsHide: true,
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function getMilestoneTag(milestoneId) {
+    const clean = milestoneId.toLowerCase().replace(/[^a-z0-9]+/g, '-');
+    return `daedalus-checkpoint/${clean}`;
+}
+export function getCurrentCommitSha(cwd) {
+    try {
+        return execSync('git rev-parse HEAD', {
+            cwd,
+            encoding: 'utf8',
+            windowsHide: true,
+        }).trim();
+    }
+    catch {
+        return '';
+    }
+}
+export function createMilestoneCheckpoint(cwd, milestone, commitMessage) {
+    if (!isGitRepository(cwd))
+        return null;
+    const tag = getMilestoneTag(milestone.id);
+    const msg = commitMessage || `feat(marathon): [${milestone.id.toUpperCase()}] ${milestone.title}`;
+    try {
+        execSync('git add -A', { cwd, stdio: 'ignore', windowsHide: true });
+        try {
+            execSync(`git commit -m "${msg.replace(/"/g, '\\"')}"`, {
+                cwd,
+                stdio: 'ignore',
+                windowsHide: true,
+            });
+        }
+        catch {
+            // Nothing to commit if already committed, proceed to tagging
+        }
+        // Force tag to point to current HEAD
+        execSync(`git tag -f ${tag}`, { cwd, stdio: 'ignore', windowsHide: true });
+        const commit = getCurrentCommitSha(cwd);
+        return { tag, commit };
+    }
+    catch {
+        return null;
+    }
+}
+export function rollbackToLastCheckpoint(cwd, targetTag) {
+    if (!isGitRepository(cwd))
+        return false;
+    try {
+        // Reset to the tagged commit and wipe untracked files
+        execSync(`git reset --hard ${targetTag}`, {
+            cwd,
+            stdio: 'ignore',
+            windowsHide: true,
+        });
+        execSync('git clean -fd', {
+            cwd,
+            stdio: 'ignore',
+            windowsHide: true,
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function ensureMarathonBranch(cwd, branchName, baseBranch) {
+    if (!isGitRepository(cwd))
+        return false;
+    try {
+        // Check if branch exists
+        const branches = execSync('git branch --list', {
+            cwd,
+            encoding: 'utf8',
+            windowsHide: true,
+        });
+        if (branches.includes(branchName)) {
+            execSync(`git checkout ${branchName}`, {
+                cwd,
+                stdio: 'ignore',
+                windowsHide: true,
+            });
+        }
+        else {
+            // Checkout base first, then create marathon branch
+            try {
+                execSync(`git checkout ${baseBranch}`, {
+                    cwd,
+                    stdio: 'ignore',
+                    windowsHide: true,
+                });
+            }
+            catch {
+                // base might already be current
+            }
+            execSync(`git checkout -b ${branchName}`, {
+                cwd,
+                stdio: 'ignore',
+                windowsHide: true,
+            });
+        }
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=git-checkpoint.js.map

package/dist/marathon/git-checkpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-checkpoint.js","sourceRoot":"","sources":["../../src/marathon/git-checkpoint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGzC,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,IAAI,CAAC;QACH,QAAQ,CAAC,qCAAqC,EAAE;YAC9C,GAAG;YACH,KAAK,EAAE,QAAQ;YACf,WAAW,EAAE,IAAI;SAClB,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,WAAmB;IACjD,MAAM,KAAK,GAAG,WAAW,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;IACpE,OAAO,uBAAuB,KAAK,EAAE,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,GAAW;IAC7C,IAAI,CAAC;QACH,OAAO,QAAQ,CAAC,oBAAoB,EAAE;YACpC,GAAG;YACH,QAAQ,EAAE,MAAM;YAChB,WAAW,EAAE,IAAI;SAClB,CAAC,CAAC,IAAI,EAAE,CAAC;IACZ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,GAAW,EACX,SAA4B,EAC5B,aAAsB;IAEtB,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAEvC,MAAM,GAAG,GAAG,eAAe,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IAC1C,MAAM,GAAG,GAAG,aAAa,IAAI,oBAAoB,SAAS,CAAC,EAAE,CAAC,WAAW,EAAE,KAAK,SAAS,CAAC,KAAK,EAAE,CAAC;IAElG,IAAI,CAAC;QACH,QAAQ,CAAC,YAAY,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;QACpE,IAAI,CAAC;YACH,QAAQ,CAAC,kBAAkB,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,EAAE;gBACtD,GAAG;gBACH,KAAK,EAAE,QAAQ;gBACf,WAAW,EAAE,IAAI;aAClB,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,6DAA6D;QAC/D,CAAC;QAED,qCAAqC;QACrC,QAAQ,CAAC,cAAc,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3E,MAAM,MAAM,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC;QAExC,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;IACzB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,GAAW,EAAE,SAAiB;IACrE,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAExC,IAAI,CAAC;QACH,sDAAsD;QACtD,QAAQ,CAAC,oBAAoB,SAAS,EAAE,EAAE;YACxC,GAAG;YACH,KAAK,EAAE,QAAQ;YACf,WAAW,EAAE,IAAI;SAClB,CAAC,CAAC;QACH,QAAQ,CAAC,eAAe,EAAE;YACxB,GAAG;YACH,KAAK,EAAE,QAAQ;YACf,WAAW,EAAE,IAAI;SAClB,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,GAAW,EACX,UAAkB,EAClB,UAAkB;IAElB,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAExC,IAAI,CAAC;QACH,yBAAyB;QACzB,MAAM,QAAQ,GAAG,QAAQ,CAAC,mBAAmB,EAAE;YAC7C,GAAG;YACH,QAAQ,EAAE,MAAM;YAChB,WAAW,EAAE,IAAI;SAClB,CAAC,CAAC;QAEH,IAAI,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;YAClC,QAAQ,CAAC,gBAAgB,UAAU,EAAE,EAAE;gBACrC,GAAG;gBACH,KAAK,EAAE,QAAQ;gBACf,WAAW,EAAE,IAAI;aAClB,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,mDAAmD;YACnD,IAAI,CAAC;gBACH,QAAQ,CAAC,gBAAgB,UAAU,EAAE,EAAE;oBACrC,GAAG;oBACH,KAAK,EAAE,QAAQ;oBACf,WAAW,EAAE,IAAI;iBAClB,CAAC,CAAC;YACL,CAAC;YAAC,MAAM,CAAC;gBACP,gCAAgC;YAClC,CAAC;YACD,QAAQ,CAAC,mBAAmB,UAAU,EAAE,EAAE;gBACxC,GAAG;gBACH,KAAK,EAAE,QAAQ;gBACf,WAAW,EAAE,IAAI;aAClB,CAAC,CAAC;QACL,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/marathon/git-checkpoint.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=git-checkpoint.test.d.ts.map

package/dist/marathon/git-checkpoint.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-checkpoint.test.d.ts","sourceRoot":"","sources":["../../src/marathon/git-checkpoint.test.ts"],"names":[],"mappings":""}

package/dist/marathon/git-checkpoint.test.js

@@ -0,0 +1,72 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+import { execSync } from 'child_process';
+import { isGitRepository, getMilestoneTag, createMilestoneCheckpoint, rollbackToLastCheckpoint, ensureMarathonBranch, } from './git-checkpoint.js';
+describe('Marathon Git Checkpointing', () => {
+    let tmpRepo;
+    beforeEach(() => {
+        tmpRepo = fs.mkdtempSync(path.join(os.tmpdir(), 'daedalus-git-test-'));
+        execSync('git init -b main', { cwd: tmpRepo, stdio: 'ignore' });
+        execSync('git config user.name "Test Runner"', { cwd: tmpRepo, stdio: 'ignore' });
+        execSync('git config user.email "test@example.com"', { cwd: tmpRepo, stdio: 'ignore' });
+        fs.writeFileSync(path.join(tmpRepo, 'README.md'), '# Initial Repo\n');
+        execSync('git add README.md && git commit -m "init"', { cwd: tmpRepo, stdio: 'ignore' });
+    });
+    afterEach(() => {
+        try {
+            fs.rmSync(tmpRepo, { recursive: true, force: true });
+        }
+        catch {
+            // Best effort
+        }
+    });
+    it('detects valid git repository', () => {
+        expect(isGitRepository(tmpRepo)).toBe(true);
+        expect(isGitRepository(os.tmpdir())).toBe(false);
+    });
+    it('formats milestone tag cleanly', () => {
+        expect(getMilestoneTag('m-1')).toBe('daedalus-checkpoint/m-1');
+        expect(getMilestoneTag('M_2_API')).toBe('daedalus-checkpoint/m-2-api');
+    });
+    it('creates milestone checkpoints and supports clean rollback', () => {
+        const milestone = {
+            id: 'm-1',
+            title: 'Setup Database',
+            description: 'Create SQLite schema',
+            targetFiles: ['src/db.ts'],
+            acceptanceCriteria: ['DB exists'],
+            status: 'in_progress',
+            attempts: 0,
+            maxAttempts: 3,
+        };
+        fs.writeFileSync(path.join(tmpRepo, 'db.ts'), 'export const db = 1;\n');
+        const cp = createMilestoneCheckpoint(tmpRepo, milestone);
+        expect(cp).not.toBeNull();
+        expect(cp?.tag).toBe('daedalus-checkpoint/m-1');
+        expect(cp?.commit).toBeTruthy();
+        // Verify git tag exists
+        const tags = execSync('git tag', { cwd: tmpRepo, encoding: 'utf8' });
+        expect(tags).toContain('daedalus-checkpoint/m-1');
+        // Simulate a broken iteration: add a bad file and corrupt db.ts
+        fs.writeFileSync(path.join(tmpRepo, 'db.ts'), 'SYNTAX ERROR BROKEN\n');
+        fs.writeFileSync(path.join(tmpRepo, 'corrupt.txt'), 'trash\n');
+        // Rollback to m-1 checkpoint
+        const ok = rollbackToLastCheckpoint(tmpRepo, cp.tag);
+        expect(ok).toBe(true);
+        // Verify repository is restored to clean state
+        expect(fs.readFileSync(path.join(tmpRepo, 'db.ts'), 'utf8')).toBe('export const db = 1;\n');
+        expect(fs.existsSync(path.join(tmpRepo, 'corrupt.txt'))).toBe(false);
+    });
+    it('ensures marathon branch creation and checkout', () => {
+        const ok = ensureMarathonBranch(tmpRepo, 'marathon/test-run', 'main');
+        expect(ok).toBe(true);
+        const currentBranch = execSync('git branch --show-current', {
+            cwd: tmpRepo,
+            encoding: 'utf8',
+        }).trim();
+        expect(currentBranch).toBe('marathon/test-run');
+    });
+});
+//# sourceMappingURL=git-checkpoint.test.js.map

package/dist/marathon/git-checkpoint.test.js.map

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

package/dist/marathon/planner.d.ts

@@ -0,0 +1,10 @@
+import { LocalRouter } from '../router/index.js';
+import { MarathonMilestone } from './types.js';
+export declare function buildMacroPlanningPrompt(macroGoal: string, projectContext?: string): string;
+export declare function parseMilestonesJson(raw: string): MarathonMilestone[];
+export declare function planMarathonRoadmap(macroGoal: string, opts: {
+    router: LocalRouter;
+    modelOverride?: string;
+    projectContext?: string;
+}): Promise<MarathonMilestone[]>;
+//# sourceMappingURL=planner.d.ts.map

package/dist/marathon/planner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planner.d.ts","sourceRoot":"","sources":["../../src/marathon/planner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE/C,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,EAAE,cAAc,GAAE,MAAW,GAAG,MAAM,CA6B/F;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAwCpE;AAED,wBAAsB,mBAAmB,CACvC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE;IACJ,MAAM,EAAE,WAAW,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,GACA,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAsC9B"}

package/dist/marathon/planner.js

@@ -0,0 +1,109 @@
+import { messageText } from '../types.js';
+export function buildMacroPlanningPrompt(macroGoal, projectContext = '') {
+    return `You are Metis, the master architect and planner for the Daedalus Marathon Engine.
+Your task is to decompose the following high-level project vision into an ordered sequence of 3 to 12 atomic, verifiable milestones.
+
+## Project Vision:
+${macroGoal}
+
+## Project Context:
+${projectContext || '(New project or clean workspace)'}
+
+## Requirements for each Milestone:
+1. Atomic & Focused: Changes 1 to 5 files maximum per milestone.
+2. Ordered by Dependency: Foundation/Schema first, then Business Logic/APIs, then UI/Polish/Integration.
+3. Verifiable: Must have explicit, measurable acceptance criteria.
+4. Output Format: Pure JSON array of milestone objects with NO conversational wrapper:
+
+[
+  {
+    "id": "m-1",
+    "title": "Short title",
+    "description": "Clear explanation of what is built in this milestone",
+    "targetFiles": ["path/to/file1.ts", "path/to/file2.ts"],
+    "acceptanceCriteria": [
+      "Explicit testable requirement 1",
+      "Explicit testable requirement 2"
+    ],
+    "verifyCommand": "npm test"
+  }
+]`;
+}
+export function parseMilestonesJson(raw) {
+    let cleaned = raw.trim();
+    if (cleaned.startsWith('```json')) {
+        cleaned = cleaned.replace(/^```json\s*/i, '').replace(/```\s*$/, '');
+    }
+    else if (cleaned.startsWith('```')) {
+        cleaned = cleaned.replace(/^```\s*/, '').replace(/```\s*$/, '');
+    }
+    try {
+        const arr = JSON.parse(cleaned);
+        if (!Array.isArray(arr) || arr.length === 0) {
+            return [];
+        }
+        return arr.map((item, index) => {
+            const id = String(item.id || `m-${index + 1}`).toLowerCase();
+            const title = String(item.title || `Milestone ${index + 1}`);
+            const description = String(item.description || title);
+            const targetFiles = Array.isArray(item.targetFiles) ? item.targetFiles.map(String) : [];
+            const acceptanceCriteria = Array.isArray(item.acceptanceCriteria) && item.acceptanceCriteria.length > 0
+                ? item.acceptanceCriteria.map(String)
+                : ['Code compiles cleanly and tests pass'];
+            const verifyCommand = item.verifyCommand ? String(item.verifyCommand) : undefined;
+            const milestone = {
+                id,
+                title,
+                description,
+                targetFiles,
+                acceptanceCriteria,
+                verifyCommand,
+                status: 'pending',
+                attempts: 0,
+                maxAttempts: 3,
+            };
+            return milestone;
+        });
+    }
+    catch {
+        return [];
+    }
+}
+export async function planMarathonRoadmap(macroGoal, opts) {
+    const prompt = buildMacroPlanningPrompt(macroGoal, opts.projectContext);
+    const messages = [
+        { role: 'system', content: 'You are Metis. Output pure JSON milestone array only.' },
+        { role: 'user', content: prompt },
+    ];
+    try {
+        const res = await opts.router.chat.completions.create({
+            model: opts.modelOverride || 'intelligence',
+            complexity: 'complex',
+            messages,
+            temperature: 0.2,
+            max_tokens: 2500,
+        });
+        const text = messageText(res.choices?.[0]?.message?.content ?? '');
+        const milestones = parseMilestonesJson(text);
+        if (milestones.length > 0) {
+            return milestones;
+        }
+    }
+    catch {
+        // Fallback on failure
+    }
+    // Fallback default milestone if model generation fails
+    return [
+        {
+            id: 'm-1',
+            title: 'Initial Implementation',
+            description: `Implement core foundation for: ${macroGoal}`,
+            targetFiles: [],
+            acceptanceCriteria: ['Project builds without compiler errors', 'Basic unit tests pass'],
+            status: 'pending',
+            attempts: 0,
+            maxAttempts: 3,
+        },
+    ];
+}
+//# sourceMappingURL=planner.js.map

package/dist/marathon/planner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"planner.js","sourceRoot":"","sources":["../../src/marathon/planner.ts"],"names":[],"mappings":"AACA,OAAO,EAAe,WAAW,EAAE,MAAM,aAAa,CAAC;AAGvD,MAAM,UAAU,wBAAwB,CAAC,SAAiB,EAAE,iBAAyB,EAAE;IACrF,OAAO;;;;EAIP,SAAS;;;EAGT,cAAc,IAAI,kCAAkC;;;;;;;;;;;;;;;;;;;;EAoBpD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,GAAW;IAC7C,IAAI,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IACzB,IAAI,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAClC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IACvE,CAAC;SAAM,IAAI,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QACrC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IAClE,CAAC;IAED,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAChC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5C,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;YAC7B,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,KAAK,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;YAC7D,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,IAAI,aAAa,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC;YAC7D,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,IAAI,KAAK,CAAC,CAAC;YACtD,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACxF,MAAM,kBAAkB,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,kBAAkB,CAAC,IAAI,IAAI,CAAC,kBAAkB,CAAC,MAAM,GAAG,CAAC;gBACrG,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,MAAM,CAAC;gBACrC,CAAC,CAAC,CAAC,sCAAsC,CAAC,CAAC;YAC7C,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAElF,MAAM,SAAS,GAAsB;gBACnC,EAAE;gBACF,KAAK;gBACL,WAAW;gBACX,WAAW;gBACX,kBAAkB;gBAClB,aAAa;gBACb,MAAM,EAAE,SAAS;gBACjB,QAAQ,EAAE,CAAC;gBACX,WAAW,EAAE,CAAC;aACf,CAAC;YACF,OAAO,SAAS,CAAC;QACnB,CAAC,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,SAAiB,EACjB,IAIC;IAED,MAAM,MAAM,GAAG,wBAAwB,CAAC,SAAS,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;IACxE,MAAM,QAAQ,GAAkB;QAC9B,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,uDAAuD,EAAE;QACpF,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE;KAClC,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC;YACpD,KAAK,EAAE,IAAI,CAAC,aAAa,IAAI,cAAc;YAC3C,UAAU,EAAE,SAAS;YACrB,QAAQ;YACR,WAAW,EAAE,GAAG;YAChB,UAAU,EAAE,IAAI;SACjB,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC;QACnE,MAAM,UAAU,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;QAC7C,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1B,OAAO,UAAU,CAAC;QACpB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,sBAAsB;IACxB,CAAC;IAED,uDAAuD;IACvD,OAAO;QACL;YACE,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,wBAAwB;YAC/B,WAAW,EAAE,kCAAkC,SAAS,EAAE;YAC1D,WAAW,EAAE,EAAE;YACf,kBAAkB,EAAE,CAAC,wCAAwC,EAAE,uBAAuB,CAAC;YACvF,MAAM,EAAE,SAAS;YACjB,QAAQ,EAAE,CAAC;YACX,WAAW,EAAE,CAAC;SACf;KACF,CAAC;AACJ,CAAC"}

package/dist/marathon/planner.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=planner.test.d.ts.map

package/dist/marathon/planner.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planner.test.d.ts","sourceRoot":"","sources":["../../src/marathon/planner.test.ts"],"names":[],"mappings":""}

package/dist/marathon/planner.test.js

@@ -0,0 +1,58 @@
+import { describe, it, expect, vi } from 'vitest';
+import { buildMacroPlanningPrompt, parseMilestonesJson, planMarathonRoadmap, } from './planner.js';
+describe('Metis Macro-Planner (Milestone DAG Synthesis)', () => {
+    it('builds clear macro planning prompt', () => {
+        const prompt = buildMacroPlanningPrompt('Build a Snake Game in Terminal');
+        expect(prompt).toContain('Metis');
+        expect(prompt).toContain('Build a Snake Game in Terminal');
+        expect(prompt).toContain('Atomic & Focused');
+    });
+    it('parses valid milestone JSON', () => {
+        const raw = JSON.stringify([
+            {
+                id: 'm-1',
+                title: 'Core Grid and Engine',
+                description: 'Initialize game grid and movement vectors',
+                targetFiles: ['src/grid.ts'],
+                acceptanceCriteria: ['Grid initializes with correct dimensions'],
+                verifyCommand: 'npm test',
+            },
+            {
+                id: 'm-2',
+                title: 'Input Handler and Loop',
+                description: 'Process arrow key inputs and tick loop',
+                targetFiles: ['src/loop.ts'],
+                acceptanceCriteria: ['Arrow keys update heading'],
+            },
+        ]);
+        const milestones = parseMilestonesJson(raw);
+        expect(milestones.length).toBe(2);
+        expect(milestones[0].id).toBe('m-1');
+        expect(milestones[0].status).toBe('pending');
+        expect(milestones[0].attempts).toBe(0);
+        expect(milestones[0].maxAttempts).toBe(3);
+        expect(milestones[1].id).toBe('m-2');
+    });
+    it('cleans markdown wrappers when parsing JSON', () => {
+        const fenced = '```json\n[{"id": "m-1", "title": "Setup", "acceptanceCriteria": ["Done"]}]\n```';
+        const milestones = parseMilestonesJson(fenced);
+        expect(milestones.length).toBe(1);
+        expect(milestones[0].title).toBe('Setup');
+    });
+    it('calls router and falls back gracefully on error', async () => {
+        const mockRouter = {
+            chat: {
+                completions: {
+                    create: vi.fn().mockRejectedValue(new Error('Network error')),
+                },
+            },
+        };
+        const milestones = await planMarathonRoadmap('Build CLI app', {
+            router: mockRouter,
+        });
+        expect(milestones.length).toBe(1);
+        expect(milestones[0].id).toBe('m-1');
+        expect(milestones[0].title).toBe('Initial Implementation');
+    });
+});
+//# sourceMappingURL=planner.test.js.map

package/dist/marathon/planner.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"planner.test.js","sourceRoot":"","sources":["../../src/marathon/planner.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAClD,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,cAAc,CAAC;AAEtB,QAAQ,CAAC,+CAA+C,EAAE,GAAG,EAAE;IAC7D,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,MAAM,GAAG,wBAAwB,CAAC,gCAAgC,CAAC,CAAC;QAC1E,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAClC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,gCAAgC,CAAC,CAAC;QAC3D,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC;YACzB;gBACE,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE,sBAAsB;gBAC7B,WAAW,EAAE,2CAA2C;gBACxD,WAAW,EAAE,CAAC,aAAa,CAAC;gBAC5B,kBAAkB,EAAE,CAAC,0CAA0C,CAAC;gBAChE,aAAa,EAAE,UAAU;aAC1B;YACD;gBACE,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE,wBAAwB;gBAC/B,WAAW,EAAE,wCAAwC;gBACrD,WAAW,EAAE,CAAC,aAAa,CAAC;gBAC5B,kBAAkB,EAAE,CAAC,2BAA2B,CAAC;aAClD;SACF,CAAC,CAAC;QAEH,MAAM,UAAU,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC;QAC5C,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC7C,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACvC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC1C,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,MAAM,MAAM,GAAG,iFAAiF,CAAC;QACjG,MAAM,UAAU,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;QAC/C,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,KAAK,IAAI,EAAE;QAC/D,MAAM,UAAU,GAAG;YACjB,IAAI,EAAE;gBACJ,WAAW,EAAE;oBACX,MAAM,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC;iBAC9D;aACF;SACK,CAAC;QAET,MAAM,UAAU,GAAG,MAAM,mBAAmB,CAAC,eAAe,EAAE;YAC5D,MAAM,EAAE,UAAU;SACnB,CAAC,CAAC;QAEH,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/marathon/state.d.ts

@@ -0,0 +1,12 @@
+import { MarathonRun, MarathonMilestone, MilestoneStatus } from './types.js';
+export declare function getMarathonDir(projectRoot: string): string;
+export declare function getMarathonStatePath(projectRoot: string): string;
+export declare function getRoadmapPath(projectRoot: string): string;
+export declare function loadMarathonRun(projectRoot: string): MarathonRun | null;
+export declare function saveMarathonRun(projectRoot: string, run: MarathonRun): void;
+export declare function initMarathonRun(projectRoot: string, macroGoal: string, baseBranch: string, milestones?: MarathonMilestone[]): MarathonRun;
+export declare function updateMilestoneStatus(run: MarathonRun, milestoneId: string, status: MilestoneStatus, details?: Partial<MarathonMilestone>): MarathonRun;
+export declare function advanceToNextMilestone(run: MarathonRun): boolean;
+export declare function renderRoadmapMarkdown(run: MarathonRun): string;
+export declare function saveRoadmapFile(projectRoot: string, run: MarathonRun): string;
+//# sourceMappingURL=state.d.ts.map

package/dist/marathon/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/marathon/state.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7E,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CASvE;AAED,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,GAAG,IAAI,CAQ3E;AAED,wBAAgB,eAAe,CAC7B,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,UAAU,GAAE,iBAAiB,EAAO,GACnC,WAAW,CA6Bb;AAED,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,WAAW,EAChB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,eAAe,EACvB,OAAO,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,GACnC,WAAW,CAiBb;AAED,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAQhE;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,CAgD9D;AAED,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,GAAG,MAAM,CAS7E"}

package/dist/marathon/state.js

@@ -0,0 +1,146 @@
+import fs from 'fs';
+import path from 'path';
+export function getMarathonDir(projectRoot) {
+    return path.join(projectRoot, '.daedalus');
+}
+export function getMarathonStatePath(projectRoot) {
+    return path.join(getMarathonDir(projectRoot), 'marathon.json');
+}
+export function getRoadmapPath(projectRoot) {
+    return path.join(projectRoot, 'MARATHON_ROADMAP.md');
+}
+export function loadMarathonRun(projectRoot) {
+    const file = getMarathonStatePath(projectRoot);
+    if (!fs.existsSync(file))
+        return null;
+    try {
+        const raw = fs.readFileSync(file, 'utf8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+export function saveMarathonRun(projectRoot, run) {
+    const dir = getMarathonDir(projectRoot);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    run.updatedAt = new Date().toISOString();
+    fs.writeFileSync(getMarathonStatePath(projectRoot), JSON.stringify(run, null, 2), 'utf8');
+    saveRoadmapFile(projectRoot, run);
+}
+export function initMarathonRun(projectRoot, macroGoal, baseBranch, milestones = []) {
+    const slug = macroGoal
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-|-$/g, '')
+        .slice(0, 30);
+    const runId = `marathon-${Date.now()}-${slug || 'run'}`;
+    const marathonBranch = `marathon/${slug || 'main'}`;
+    const run = {
+        id: runId,
+        macroGoal,
+        baseBranch,
+        marathonBranch,
+        status: 'planning',
+        createdAt: new Date().toISOString(),
+        updatedAt: new Date().toISOString(),
+        activeMilestoneIndex: 0,
+        milestones,
+        roadmapPath: getRoadmapPath(projectRoot),
+        metrics: {
+            totalIterations: 0,
+            totalRollbacks: 0,
+            totalEvaluations: 0,
+        },
+    };
+    saveMarathonRun(projectRoot, run);
+    return run;
+}
+export function updateMilestoneStatus(run, milestoneId, status, details) {
+    const milestone = run.milestones.find((m) => m.id === milestoneId);
+    if (!milestone)
+        return run;
+    milestone.status = status;
+    if (details) {
+        Object.assign(milestone, details);
+    }
+    if (status === 'in_progress' && !milestone.startedAt) {
+        milestone.startedAt = new Date().toISOString();
+    }
+    if (status === 'passed' && !milestone.completedAt) {
+        milestone.completedAt = new Date().toISOString();
+    }
+    return run;
+}
+export function advanceToNextMilestone(run) {
+    if (run.activeMilestoneIndex < run.milestones.length - 1) {
+        run.activeMilestoneIndex += 1;
+        return true;
+    }
+    run.status = 'completed';
+    run.completedAt = new Date().toISOString();
+    return false;
+}
+export function renderRoadmapMarkdown(run) {
+    const completed = run.milestones.filter((m) => m.status === 'passed').length;
+    const total = run.milestones.length;
+    const pct = total > 0 ? Math.round((completed / total) * 100) : 0;
+    const lines = [];
+    lines.push(`# Marathon Roadmap: ${run.macroGoal}`);
+    lines.push('');
+    lines.push(`- **Status**: \`${run.status.toUpperCase()}\``);
+    lines.push(`- **Progress**: ${completed}/${total} milestones passed (${pct}%)`);
+    lines.push(`- **Base Branch**: \`${run.baseBranch}\``);
+    lines.push(`- **Integration Branch**: \`${run.marathonBranch}\``);
+    lines.push(`- **Last Updated**: ${run.updatedAt}`);
+    lines.push('');
+    lines.push('## Milestones');
+    lines.push('');
+    for (let i = 0; i < run.milestones.length; i++) {
+        const m = run.milestones[i];
+        const isCurrent = i === run.activeMilestoneIndex && run.status === 'running';
+        let icon = '[ ]';
+        if (m.status === 'passed')
+            icon = '[x]';
+        else if (m.status === 'in_progress')
+            icon = '[>]';
+        else if (m.status === 'failed')
+            icon = '[!]';
+        else if (m.status === 'rolled_back')
+            icon = '[<]';
+        lines.push(`### ${icon} ${m.id.toUpperCase()}: ${m.title}${isCurrent ? '  *(Active)*' : ''}`);
+        lines.push('');
+        lines.push(`${m.description}`);
+        lines.push('');
+        if (m.targetFiles.length > 0) {
+            lines.push(`- **Target Files**: ${m.targetFiles.map((f) => '`' + f + '`').join(', ')}`);
+        }
+        if (m.gitTag) {
+            lines.push(`- **Git Tag**: \`${m.gitTag}\``);
+        }
+        lines.push(`- **Attempts**: ${m.attempts}/${m.maxAttempts}`);
+        lines.push('');
+        lines.push('**Acceptance Criteria:**');
+        for (const c of m.acceptanceCriteria) {
+            const match = m.evalReport?.criteriaResults?.find((cr) => cr.criterion === c);
+            const mark = match ? (match.satisfied ? '[x]' : '[ ]') : (m.status === 'passed' ? '[x]' : '[ ]');
+            lines.push(`- ${mark} ${c}`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+export function saveRoadmapFile(projectRoot, run) {
+    const content = renderRoadmapMarkdown(run);
+    const target = getRoadmapPath(projectRoot);
+    try {
+        fs.writeFileSync(target, content, 'utf8');
+    }
+    catch {
+        // Best-effort write
+    }
+    return target;
+}
+//# sourceMappingURL=state.js.map

package/dist/marathon/state.js.map

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

package/dist/marathon/state.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=state.test.d.ts.map

package/dist/marathon/state.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.test.d.ts","sourceRoot":"","sources":["../../src/marathon/state.test.ts"],"names":[],"mappings":""}