@codebakers/mcp 5.2.0

package/dist/tools/get-context.d.ts

@@ -0,0 +1,35 @@
+/**
+ * codebakers_get_context
+ *
+ * Auto-detect project state and suggest next steps
+ * This runs before EVERY user interaction to make CodeBakers self-aware
+ */
+interface ProjectContext {
+    current_phase: string;
+    phase_number: number;
+    progress_percent: number;
+    next_steps: NextStep[];
+    blockers: Blocker[];
+    suggestions: Suggestion[];
+    project_name?: string;
+    project_type?: string;
+}
+interface NextStep {
+    description: string;
+    command?: string;
+    estimated_time?: string;
+}
+interface Blocker {
+    type: string;
+    description: string;
+    solutions: string[];
+}
+interface Suggestion {
+    type: string;
+    message: string;
+    action: string;
+    command?: string;
+}
+export declare function getContext(args: any): Promise<ProjectContext>;
+export {};
+//# sourceMappingURL=get-context.d.ts.map

package/dist/tools/get-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-context.d.ts","sourceRoot":"","sources":["../../src/tools/get-context.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,UAAU,cAAc;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,QAAQ,EAAE,CAAC;IACvB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,UAAU,QAAQ;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,UAAU,OAAO;IACf,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,UAAU,UAAU;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,UAAU,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,cAAc,CAAC,CA+BnE"}

package/dist/tools/get-context.js

@@ -0,0 +1,367 @@
+/**
+ * codebakers_get_context
+ *
+ * Auto-detect project state and suggest next steps
+ * This runs before EVERY user interaction to make CodeBakers self-aware
+ */
+import { promises as fs } from 'fs';
+import * as path from 'path';
+export async function getContext(args) {
+    const cwd = process.cwd();
+    // 1. DETECT PROJECT STATE
+    const state = await detectProjectState(cwd);
+    // 2. DETERMINE CURRENT PHASE
+    const phase = await determineCurrentPhase(state);
+    // 3. CALCULATE PROGRESS
+    const progress = calculateProgress(phase, state);
+    // 4. DETERMINE NEXT STEPS
+    const nextSteps = await determineNextSteps(phase, state);
+    // 5. DETECT BLOCKERS
+    const blockers = await detectBlockers(state);
+    // 6. GENERATE SUGGESTIONS
+    const suggestions = generateSuggestions(phase, state, blockers);
+    return {
+        current_phase: phase.name,
+        phase_number: phase.number,
+        progress_percent: progress,
+        next_steps: nextSteps,
+        blockers: blockers,
+        suggestions: suggestions,
+        project_name: state.projectName,
+        project_type: state.projectType,
+    };
+}
+async function detectProjectState(cwd) {
+    const state = {
+        hasCodabakersFolder: await exists(path.join(cwd, '.codebakers')),
+        hasBuildState: await exists(path.join(cwd, '.codebakers/BUILD-STATE.md')),
+        hasProjectSpec: await exists(path.join(cwd, '.codebakers/PROJECT-SPEC.md')),
+        hasRefsFolder: await exists(path.join(cwd, 'refs')),
+        hasMockups: await exists(path.join(cwd, 'refs/design')) && (await hasFiles(path.join(cwd, 'refs/design'))),
+        hasSchema: await exists(path.join(cwd, 'supabase/migrations')) || await exists(path.join(cwd, '.codebakers/SCHEMA.sql')),
+        hasDependencyMap: await exists(path.join(cwd, '.codebakers/DEPENDENCY-MAP.md')),
+        hasStoreContracts: await exists(path.join(cwd, '.codebakers/STORE-CONTRACTS.md')),
+        hasCode: await exists(path.join(cwd, 'app')) || await exists(path.join(cwd, 'src')),
+        hasPackageJson: await exists(path.join(cwd, 'package.json')),
+        hasGit: await exists(path.join(cwd, '.git')),
+        projectName: await getProjectName(cwd),
+        projectType: await getProjectType(cwd),
+    };
+    // Load BUILD-STATE if it exists
+    if (state.hasBuildState) {
+        try {
+            const buildStateContent = await fs.readFile(path.join(cwd, '.codebakers/BUILD-STATE.md'), 'utf-8');
+            state.buildState = parseBuildState(buildStateContent);
+        }
+        catch (error) {
+            // BUILD-STATE exists but couldn't read it
+        }
+    }
+    return state;
+}
+async function determineCurrentPhase(state) {
+    // If BUILD-STATE exists, read phase from there
+    if (state.buildState?.current_phase !== undefined) {
+        return {
+            number: state.buildState.current_phase,
+            name: getPhaseName(state.buildState.current_phase),
+        };
+    }
+    // Otherwise, infer from file existence
+    if (!state.hasCodabakersFolder) {
+        return { number: -1, name: 'PRE_INIT' };
+    }
+    if (!state.hasProjectSpec) {
+        return { number: 0, name: 'PHASE_0_SPEC' };
+    }
+    if (!state.hasMockups) {
+        return { number: 1, name: 'PHASE_1_MOCKUPS' };
+    }
+    if (!state.hasSchema || !state.hasDependencyMap) {
+        return { number: 2, name: 'PHASE_2_SCHEMA' };
+    }
+    if (!state.hasCode) {
+        return { number: 3, name: 'PHASE_3_FOUNDATION' };
+    }
+    // If has code, check BUILD-STATE for Phase 4/5/6
+    return { number: 4, name: 'PHASE_4_FEATURES' };
+}
+function getPhaseName(phaseNumber) {
+    const phases = [
+        'PHASE_0_SPEC',
+        'PHASE_1_MOCKUPS',
+        'PHASE_2_SCHEMA',
+        'PHASE_3_FOUNDATION',
+        'PHASE_4_FEATURES',
+        'PHASE_5_TESTING',
+        'PHASE_6_DEPLOYMENT',
+    ];
+    return phases[phaseNumber] || 'UNKNOWN';
+}
+function calculateProgress(phase, state) {
+    // Simple progress calculation based on phase milestones
+    const phaseProgress = {
+        PRE_INIT: 0,
+        PHASE_0_SPEC: 10,
+        PHASE_1_MOCKUPS: 25,
+        PHASE_2_SCHEMA: 40,
+        PHASE_3_FOUNDATION: 55,
+        PHASE_4_FEATURES: 70,
+        PHASE_5_TESTING: 85,
+        PHASE_6_DEPLOYMENT: 95,
+    };
+    return phaseProgress[phase.name] || 0;
+}
+async function determineNextSteps(phase, state) {
+    const steps = [];
+    switch (phase.name) {
+        case 'PRE_INIT':
+            steps.push({
+                description: 'Initialize CodeBakers project structure',
+                command: 'codebakers_init_session',
+                estimated_time: '1 minute',
+            });
+            steps.push({
+                description: 'Start Phase 0: Generate project specification',
+                command: 'codebakers_generate_spec',
+                estimated_time: '5-10 minutes',
+            });
+            break;
+        case 'PHASE_0_SPEC':
+            steps.push({
+                description: 'Complete PROJECT-SPEC.md (Gates 0-5)',
+                command: 'codebakers_generate_spec',
+                estimated_time: '5-10 minutes',
+            });
+            break;
+        case 'PHASE_1_MOCKUPS':
+            if (!state.hasMockups) {
+                steps.push({
+                    description: 'Generate UI mockups or upload existing mockups to refs/design/',
+                    estimated_time: '15-30 minutes',
+                });
+            }
+            else {
+                steps.push({
+                    description: 'Review mockups and proceed to Phase 2',
+                    command: 'codebakers_check_gate 1',
+                });
+            }
+            break;
+        case 'PHASE_2_SCHEMA':
+            if (!state.hasDependencyMap) {
+                steps.push({
+                    description: 'Analyze mockups and generate schema',
+                    command: 'codebakers_analyze_mockups_deep',
+                    estimated_time: '10-15 minutes',
+                });
+            }
+            else {
+                steps.push({
+                    description: 'Verify Phase 2 gate and proceed to Phase 3',
+                    command: 'codebakers_check_gate 2',
+                });
+            }
+            break;
+        case 'PHASE_3_FOUNDATION':
+            steps.push({
+                description: 'Build project scaffold, auth, and routing',
+                estimated_time: '20-30 minutes',
+            });
+            break;
+        case 'PHASE_4_FEATURES':
+            steps.push({
+                description: 'Build features from PROJECT-SPEC.md',
+                command: 'codebakers_enforce_feature',
+                estimated_time: 'Varies by feature',
+            });
+            break;
+        case 'PHASE_5_TESTING':
+            steps.push({
+                description: 'Run comprehensive testing suite',
+                estimated_time: '30-60 minutes',
+            });
+            break;
+        case 'PHASE_6_DEPLOYMENT':
+            steps.push({
+                description: 'Deploy to production and generate runbook',
+                estimated_time: '15-30 minutes',
+            });
+            break;
+    }
+    return steps;
+}
+async function detectBlockers(state) {
+    const blockers = [];
+    // No git repository
+    if (!state.hasGit) {
+        blockers.push({
+            type: 'CRITICAL',
+            description: 'No git repository detected. CodeBakers requires git for memory and crash recovery.',
+            solutions: [
+                'Run: git init',
+                'Create initial commit: git add . && git commit -m "initial commit"',
+            ],
+        });
+    }
+    // Mockups expected but missing
+    if (state.hasProjectSpec && !state.hasMockups && state.buildState?.current_phase === 1) {
+        blockers.push({
+            type: 'BLOCKED',
+            description: 'Phase 1 (Mockups) in progress but no mockups found in refs/design/',
+            solutions: [
+                'Generate mockups with AI',
+                'Upload your own mockups to refs/design/',
+                'Skip mockups (not recommended - violates Method principle P2)',
+            ],
+        });
+    }
+    // Schema expected but missing
+    if (state.hasMockups && !state.hasSchema && state.buildState?.current_phase === 2) {
+        blockers.push({
+            type: 'BLOCKED',
+            description: 'Phase 2 (Schema) in progress but schema not generated',
+            solutions: [
+                'Run: codebakers_analyze_mockups_deep',
+                'Then: codebakers_generate_schema',
+            ],
+        });
+    }
+    return blockers;
+}
+function generateSuggestions(phase, state, blockers) {
+    const suggestions = [];
+    // If blockers exist, suggest fixes first
+    if (blockers.length > 0) {
+        suggestions.push({
+            type: 'blocker',
+            message: `${blockers.length} blocker(s) detected. Fix these first before proceeding.`,
+            action: 'Show blockers',
+        });
+        return suggestions; // Don't suggest next steps if blocked
+    }
+    // Phase-specific suggestions
+    switch (phase.name) {
+        case 'PRE_INIT':
+            suggestions.push({
+                type: 'get_started',
+                message: 'New project detected. Let me guide you through the CodeBakers Method (7 phases).',
+                action: 'Start Phase 0',
+                command: 'codebakers_init_session',
+            });
+            break;
+        case 'PHASE_0_SPEC':
+            if (state.hasProjectSpec) {
+                suggestions.push({
+                    type: 'next_phase',
+                    message: 'PROJECT-SPEC.md complete. Ready to start Phase 1 (Mockups)?',
+                    action: 'Proceed to Phase 1',
+                });
+            }
+            break;
+        case 'PHASE_1_MOCKUPS':
+            if (state.hasMockups) {
+                suggestions.push({
+                    type: 'next_phase',
+                    message: 'Mockups ready. Run deep analysis to generate schema?',
+                    action: 'Start Phase 2',
+                    command: 'codebakers_analyze_mockups_deep',
+                });
+            }
+            break;
+        case 'PHASE_2_SCHEMA':
+            if (state.hasSchema && state.hasDependencyMap) {
+                suggestions.push({
+                    type: 'next_phase',
+                    message: 'Schema and dependencies mapped. Ready to build foundation?',
+                    action: 'Start Phase 3',
+                });
+            }
+            break;
+        case 'PHASE_4_FEATURES':
+            suggestions.push({
+                type: 'feature_build',
+                message: 'Ready to build features. Use // [feature name] for full enforcement.',
+                action: 'Build next feature',
+            });
+            break;
+    }
+    return suggestions;
+}
+// Helper functions
+async function exists(filePath) {
+    try {
+        await fs.access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function hasFiles(dirPath) {
+    try {
+        const files = await fs.readdir(dirPath);
+        return files.length > 0;
+    }
+    catch {
+        return false;
+    }
+}
+async function getProjectName(cwd) {
+    try {
+        const packageJsonPath = path.join(cwd, 'package.json');
+        if (await exists(packageJsonPath)) {
+            const content = await fs.readFile(packageJsonPath, 'utf-8');
+            const pkg = JSON.parse(content);
+            return pkg.name;
+        }
+        // Try BUILD-STATE
+        const buildStatePath = path.join(cwd, '.codebakers/BUILD-STATE.md');
+        if (await exists(buildStatePath)) {
+            const content = await fs.readFile(buildStatePath, 'utf-8');
+            const match = content.match(/Project:\s*(.+)/);
+            if (match)
+                return match[1].trim();
+        }
+    }
+    catch {
+        // Ignore errors
+    }
+    return undefined;
+}
+async function getProjectType(cwd) {
+    try {
+        const buildStatePath = path.join(cwd, '.codebakers/BUILD-STATE.md');
+        if (await exists(buildStatePath)) {
+            const content = await fs.readFile(buildStatePath, 'utf-8');
+            const match = content.match(/Type:\s*(.+)/);
+            if (match)
+                return match[1].trim();
+        }
+        const specPath = path.join(cwd, '.codebakers/PROJECT-SPEC.md');
+        if (await exists(specPath)) {
+            const content = await fs.readFile(specPath, 'utf-8');
+            const match = content.match(/Type:\s*(.+)/);
+            if (match)
+                return match[1].trim();
+        }
+    }
+    catch {
+        // Ignore errors
+    }
+    return undefined;
+}
+function parseBuildState(content) {
+    // Simple parser for BUILD-STATE.md
+    const state = {};
+    const phaseMatch = content.match(/Current Phase:\s*(\d+)/i);
+    if (phaseMatch) {
+        state.current_phase = parseInt(phaseMatch[1]);
+    }
+    const progressMatch = content.match(/Progress:\s*(\d+)%/i);
+    if (progressMatch) {
+        state.progress = parseInt(progressMatch[1]);
+    }
+    return state;
+}
+//# sourceMappingURL=get-context.js.map

package/dist/tools/get-context.js.map

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

package/dist/tools/init-session.d.ts

@@ -0,0 +1,22 @@
+/**
+ * codebakers_init_session
+ *
+ * Session Initialization Protocol (from CodeBakers Method)
+ * Loads BUILD-STATE.md, PROJECT-SPEC.md, and phase-specific context
+ * MUST run at the start of every AI session
+ */
+interface SessionContext {
+    initialized: true;
+    project_name: string;
+    current_phase: number;
+    phase_name: string;
+    current_task: string;
+    build_state: any;
+    project_spec: any;
+    phase_artifacts: string[];
+    verification_gate: string[];
+    next_action: string;
+}
+export declare function initSession(args: any): Promise<SessionContext>;
+export {};
+//# sourceMappingURL=init-session.d.ts.map

package/dist/tools/init-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-session.d.ts","sourceRoot":"","sources":["../../src/tools/init-session.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,UAAU,cAAc;IACtB,WAAW,EAAE,IAAI,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,GAAG,CAAC;IACjB,YAAY,EAAE,GAAG,CAAC;IAClB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,cAAc,CAAC,CAwCpE"}

package/dist/tools/init-session.js

@@ -0,0 +1,232 @@
+/**
+ * codebakers_init_session
+ *
+ * Session Initialization Protocol (from CodeBakers Method)
+ * Loads BUILD-STATE.md, PROJECT-SPEC.md, and phase-specific context
+ * MUST run at the start of every AI session
+ */
+import { promises as fs } from 'fs';
+import * as path from 'path';
+export async function initSession(args) {
+    const cwd = process.cwd();
+    console.error('🍞 CodeBakers: Initializing session...');
+    // 1. Load BUILD-STATE.md (establishes current project context)
+    const buildState = await loadBuildState(cwd);
+    // 2. Load PROJECT-SPEC.md (confirms scope boundaries)
+    const projectSpec = await loadProjectSpec(cwd);
+    // 3. Load phase-specific artifacts
+    const phaseArtifacts = await loadPhaseArtifacts(cwd, buildState.current_phase);
+    // 4. Confirm current phase and task
+    const currentTask = buildState.current_task || determineCurrentTask(buildState);
+    // 5. Confirm verification gate requirements
+    const verificationGate = getVerificationGate(buildState.current_phase);
+    // 6. Determine next action
+    const nextAction = determineNextAction(buildState, projectSpec);
+    console.error(`✓ Session initialized`);
+    console.error(`  Project: ${buildState.project_name}`);
+    console.error(`  Phase: ${buildState.current_phase} (${getPhaseName(buildState.current_phase)})`);
+    console.error(`  Task: ${currentTask}`);
+    return {
+        initialized: true,
+        project_name: buildState.project_name,
+        current_phase: buildState.current_phase,
+        phase_name: getPhaseName(buildState.current_phase),
+        current_task: currentTask,
+        build_state: buildState,
+        project_spec: projectSpec,
+        phase_artifacts: phaseArtifacts,
+        verification_gate: verificationGate,
+        next_action: nextAction,
+    };
+}
+async function loadBuildState(cwd) {
+    const buildStatePath = path.join(cwd, '.codebakers/BUILD-STATE.md');
+    try {
+        const content = await fs.readFile(buildStatePath, 'utf-8');
+        return parseBuildState(content);
+    }
+    catch (error) {
+        // BUILD-STATE doesn't exist - new project
+        // Initialize with defaults
+        return {
+            project_name: 'New Project',
+            current_phase: 0,
+            current_task: 'Generate PROJECT-SPEC.md',
+            created_at: new Date().toISOString(),
+            last_updated: new Date().toISOString(),
+        };
+    }
+}
+async function loadProjectSpec(cwd) {
+    const specPath = path.join(cwd, '.codebakers/PROJECT-SPEC.md');
+    try {
+        const content = await fs.readFile(specPath, 'utf-8');
+        return parseProjectSpec(content);
+    }
+    catch (error) {
+        // PROJECT-SPEC doesn't exist yet
+        return null;
+    }
+}
+async function loadPhaseArtifacts(cwd, phase) {
+    const artifacts = [];
+    const phaseArtifactPaths = {
+        0: ['.codebakers/PROJECT-SPEC.md', '.codebakers/COMPETITIVE-ANALYSIS.md'],
+        1: ['refs/design/', '.codebakers/DESIGN-SYSTEM.md'],
+        2: [
+            '.codebakers/MOCK-ANALYSIS.md',
+            '.codebakers/SCHEMA.sql',
+            '.codebakers/DEPENDENCY-MAP.md',
+            '.codebakers/STORE-CONTRACTS.md',
+        ],
+        3: ['app/', 'lib/', 'components/'],
+        4: ['app/', 'lib/', 'components/'],
+        5: ['.codebakers/TEST-REPORT.md'],
+        6: ['.codebakers/RUNBOOK.md'],
+    };
+    const paths = phaseArtifactPaths[phase] || [];
+    for (const artifactPath of paths) {
+        const fullPath = path.join(cwd, artifactPath);
+        try {
+            await fs.access(fullPath);
+            artifacts.push(artifactPath);
+        }
+        catch {
+            // Artifact doesn't exist yet
+        }
+    }
+    return artifacts;
+}
+function determineCurrentTask(buildState) {
+    const phase = buildState.current_phase;
+    const defaultTasks = {
+        0: 'Generate PROJECT-SPEC.md (Gates 0-5)',
+        1: 'Design UI mockups for all screens',
+        2: 'Analyze mockups and generate schema',
+        3: 'Build project foundation and authentication',
+        4: 'Build features from PROJECT-SPEC.md',
+        5: 'Run comprehensive testing suite',
+        6: 'Deploy to production',
+    };
+    return defaultTasks[phase] || 'Unknown task';
+}
+function getVerificationGate(phase) {
+    const gates = {
+        0: [
+            'PROJECT-SPEC.md complete through all 6 gates',
+            'Feature list atomically decomposed',
+            'All external dependencies identified',
+            'Human reviewed and approved spec',
+        ],
+        1: [
+            'Every screen in spec has mockup',
+            'All interactive states represented',
+            'Design system tokens documented',
+            'Human reviewed and approved all screens',
+        ],
+        2: [
+            'Every mockup field has database column',
+            'All entity relationships captured',
+            'Dependency map complete',
+            'Schema reviewed for normalization and security',
+        ],
+        3: [
+            'Application runs without errors',
+            'All routes resolve',
+            'Auth flows work end-to-end',
+            'Database migrations run cleanly',
+            'Design system components render correctly',
+        ],
+        4: [
+            'Every feature in spec implemented',
+            'Every screen matches mockup',
+            'All forms validate correctly',
+            'All data operations work',
+            'No console errors or TypeScript violations',
+        ],
+        5: [
+            'All automated tests pass',
+            'Lighthouse score >90',
+            'No critical security vulnerabilities',
+            'WCAG AA compliance met',
+            'Zero known blocking bugs',
+        ],
+        6: [
+            'Application live and accessible',
+            'CI/CD pipeline runs successfully',
+            'Monitoring alerts firing correctly',
+            'Backup and restore tested',
+            'Runbook complete',
+        ],
+    };
+    return gates[phase] || [];
+}
+function determineNextAction(buildState, projectSpec) {
+    const phase = buildState.current_phase;
+    if (!projectSpec && phase === 0) {
+        return 'Run: codebakers_generate_spec (provide project description)';
+    }
+    if (projectSpec && phase === 0) {
+        return 'Review PROJECT-SPEC.md and proceed to Phase 1 (Mockups)';
+    }
+    if (phase === 1) {
+        return 'Design mockups or upload to refs/design/';
+    }
+    if (phase === 2) {
+        return 'Run: codebakers_analyze_mockups_deep';
+    }
+    return 'Continue with current phase tasks';
+}
+function getPhaseName(phase) {
+    const names = [
+        'Domain Research & Spec',
+        'UI Mockup & Design',
+        'Mock Analysis & Schema',
+        'Foundation Build',
+        'Feature Build',
+        'Testing & Verification',
+        'Deployment & Ops',
+    ];
+    return names[phase] || 'Unknown Phase';
+}
+function parseBuildState(content) {
+    const state = {
+        project_name: 'Unknown',
+        current_phase: 0,
+        current_task: '',
+        created_at: new Date().toISOString(),
+        last_updated: new Date().toISOString(),
+    };
+    // Extract fields from BUILD-STATE.md
+    const projectMatch = content.match(/Project:\s*(.+)/);
+    if (projectMatch)
+        state.project_name = projectMatch[1].trim();
+    const phaseMatch = content.match(/Current Phase:\s*(\d+)/);
+    if (phaseMatch)
+        state.current_phase = parseInt(phaseMatch[1]);
+    const taskMatch = content.match(/Current Task:\s*(.+)/);
+    if (taskMatch)
+        state.current_task = taskMatch[1].trim();
+    const createdMatch = content.match(/Created:\s*(.+)/);
+    if (createdMatch)
+        state.created_at = createdMatch[1].trim();
+    const updatedMatch = content.match(/Last Updated:\s*(.+)/);
+    if (updatedMatch)
+        state.last_updated = updatedMatch[1].trim();
+    return state;
+}
+function parseProjectSpec(content) {
+    // Simple parser for PROJECT-SPEC.md
+    const spec = {
+        gates: {},
+        features: [],
+    };
+    // Extract features
+    const featuresSection = content.match(/## Features(.+?)(?=##|$)/s);
+    if (featuresSection) {
+        const featureLines = featuresSection[1].match(/- .+/g) || [];
+        spec.features = featureLines.map((line) => line.replace(/^- /, '').trim());
+    }
+    return spec;
+}
+//# sourceMappingURL=init-session.js.map