conductor-bridge 1.0.0

package/dist/sync/state-sync.js

@@ -0,0 +1,403 @@
+/**
+ * State Sync Module
+ *
+ * Handles bidirectional synchronization between:
+ * - Conductor (Markdown files) → USD Substrate (JSON)
+ * - USD Substrate (JSON) → Conductor (Markdown files)
+ *
+ * Key concepts:
+ * - Conductor is source of truth for TASK state (checkboxes)
+ * - USD Substrate is source of truth for COGNITIVE state (energy, burnout, momentum)
+ * - Sync derives cognitive state from task progress and vice versa
+ *
+ * DETERMINISM GUARANTEES (ThinkingMachines [He2025] compliance):
+ *
+ * 1. FIXED MOMENTUM DERIVATION ORDER: Conditions in deriveMomentumFromTasks()
+ *    are checked in priority order: CRASHED > DECLINING > COLD_START >
+ *    BUILDING > ROLLING > PEAK. First match wins.
+ *
+ * 2. FIXED ENERGY DERIVATION ORDER: Conditions in deriveEnergyFromTasks()
+ *    are checked in order: HIGH > DEPLETED > LOW > MEDIUM (default).
+ *
+ * 3. SEQUENTIAL SYNC: syncBidirectional() runs Conductor→USD first,
+ *    then USD→Conductor. Never parallel to prevent race conditions.
+ *
+ * 4. FILE-ORDER ITERATION: Tasks are processed in markdown file order
+ *    (line numbers), not by arbitrary collection ordering.
+ *
+ * Reference: [He2025] "Defeating Nondeterminism in LLM Inference"
+ */
+import { readFile, writeFile } from 'fs/promises';
+import { join } from 'path';
+import { createHash } from 'crypto';
+import { parsePlan, countTasksByState } from '../parsers/plan-parser.js';
+import { parseState } from '../parsers/state-parser.js';
+import { JsonInterchangeWriter, JsonInterchangeReader, } from '../bridge/json-interchange.js';
+import { MomentumPhase, EnergyLevel, BurnoutLevel, ActiveMode, Paradigm, } from '../schemas/enums.js';
+// ============================================================================
+// Momentum Derivation
+// ============================================================================
+/**
+ * Derive momentum phase from task completion trajectory.
+ *
+ * Momentum is about VELOCITY of progress, not just completion count.
+ * We look at recent activity patterns to determine phase.
+ */
+export function deriveMomentumFromTasks(plan, recentCompletions = 0, sessionDurationMinutes = 0) {
+    const counts = countTasksByState(plan);
+    const total = counts.pending + counts.in_progress + counts.complete + counts.blocked;
+    if (total === 0) {
+        return MomentumPhase.COLD_START;
+    }
+    const completionRate = counts.complete / total;
+    const hasBlockedTasks = counts.blocked > 0;
+    const hasActiveTasks = counts.in_progress > 0;
+    // Check for crashed state
+    if (hasBlockedTasks && !hasActiveTasks && recentCompletions === 0) {
+        return MomentumPhase.CRASHED;
+    }
+    // Check for declining (blocked with some progress)
+    if (hasBlockedTasks && completionRate > 0.3) {
+        return MomentumPhase.DECLINING;
+    }
+    // Cold start: Very early in session or no completions
+    if (sessionDurationMinutes < 15 && counts.complete < 2) {
+        return MomentumPhase.COLD_START;
+    }
+    // Building: Some progress, active work
+    if (completionRate < 0.4 && hasActiveTasks) {
+        return MomentumPhase.BUILDING;
+    }
+    // Rolling: Good progress, sustained activity
+    if (completionRate >= 0.4 && completionRate < 0.8 && hasActiveTasks) {
+        return MomentumPhase.ROLLING;
+    }
+    // Peak: High completion, still active
+    if (completionRate >= 0.8 && hasActiveTasks) {
+        return MomentumPhase.PEAK;
+    }
+    // All complete
+    if (completionRate === 1.0) {
+        return MomentumPhase.PEAK;
+    }
+    // Default to building
+    return MomentumPhase.BUILDING;
+}
+/**
+ * Derive energy level from task patterns.
+ *
+ * Energy correlates with:
+ * - Task completion velocity (higher = more energy)
+ * - Blocked task ratio (higher = lower energy)
+ * - Session duration (longer = lower energy)
+ */
+export function deriveEnergyFromTasks(plan, sessionDurationMinutes = 0, recentBlockedCount = 0) {
+    const counts = countTasksByState(plan);
+    const total = counts.pending + counts.in_progress + counts.complete + counts.blocked;
+    if (total === 0) {
+        return EnergyLevel.MEDIUM;
+    }
+    const blockedRatio = counts.blocked / total;
+    const completionRate = counts.complete / total;
+    // High energy indicators
+    if (blockedRatio === 0 &&
+        completionRate > 0.3 &&
+        sessionDurationMinutes < 120) {
+        return EnergyLevel.HIGH;
+    }
+    // Depleted indicators
+    if (blockedRatio > 0.3 ||
+        (sessionDurationMinutes > 240 && completionRate < 0.5)) {
+        return EnergyLevel.DEPLETED;
+    }
+    // Low energy indicators
+    if (blockedRatio > 0.1 ||
+        sessionDurationMinutes > 180 ||
+        recentBlockedCount > 2) {
+        return EnergyLevel.LOW;
+    }
+    return EnergyLevel.MEDIUM;
+}
+/**
+ * Derive complete cognitive state from task data.
+ */
+export function deriveCognitiveState(plan, sessionDurationMinutes = 0, recentCompletions = 0) {
+    const counts = countTasksByState(plan);
+    const total = counts.pending + counts.in_progress + counts.complete + counts.blocked;
+    const completedTracks = plan.tracks.filter((t) => t.status === 'complete').length;
+    return {
+        momentum_phase: deriveMomentumFromTasks(plan, recentCompletions, sessionDurationMinutes),
+        energy_level: deriveEnergyFromTasks(plan, sessionDurationMinutes),
+        progress_percent: total > 0 ? Math.round((counts.complete / total) * 100) : 0,
+        tasks_completed: counts.complete,
+        tasks_total: total,
+        tracks_completed: completedTracks,
+        tracks_total: plan.tracks.length,
+        has_blocked_tasks: counts.blocked > 0,
+    };
+}
+// ============================================================================
+// Conductor → USD Sync
+// ============================================================================
+/**
+ * Sync Conductor state to USD Substrate.
+ *
+ * Reads plan.md and state.md, derives cognitive state,
+ * writes to cognitive_state.json.
+ */
+export async function syncConductorToUSD(config) {
+    const changes = [];
+    const warnings = [];
+    try {
+        // Read Conductor files
+        const statePath = join(config.conductorDir, 'state.md');
+        const stateContent = await readFile(statePath, 'utf-8');
+        const stateResult = parseState(stateContent);
+        if (!stateResult.success || !stateResult.data) {
+            return {
+                success: false,
+                direction: 'conductor-to-usd',
+                changes: [],
+                warnings: ['Failed to parse state.md'],
+                timestamp: new Date().toISOString(),
+            };
+        }
+        const state = stateResult.data;
+        // Read plan
+        const planPath = join(config.conductorDir, state.frontmatter.plan || 'plan.md');
+        const planContent = await readFile(planPath, 'utf-8');
+        const planResult = parsePlan(planContent);
+        if (!planResult.success || !planResult.data) {
+            return {
+                success: false,
+                direction: 'conductor-to-usd',
+                changes: [],
+                warnings: ['Failed to parse plan.md'],
+                timestamp: new Date().toISOString(),
+            };
+        }
+        const plan = planResult.data;
+        // Calculate session duration
+        const sessionStart = state.frontmatter.created
+            ? new Date(state.frontmatter.created)
+            : new Date();
+        const sessionDuration = Math.round((Date.now() - sessionStart.getTime()) / (1000 * 60));
+        // Derive cognitive state from tasks
+        const derived = deriveCognitiveState(plan, sessionDuration);
+        changes.push(`Derived momentum: ${derived.momentum_phase}`);
+        changes.push(`Derived energy: ${derived.energy_level}`);
+        changes.push(`Progress: ${derived.progress_percent}%`);
+        // Build session state
+        const sessionState = {
+            session_id: state.frontmatter.session_id,
+            timestamp: new Date().toISOString(),
+            version: '1.0.0',
+            active_mode: ActiveMode.FOCUSED,
+            active_paradigm: Paradigm.CORTEX,
+            energy_level: derived.energy_level,
+            burnout_level: derived.has_blocked_tasks ? BurnoutLevel.YELLOW : BurnoutLevel.GREEN,
+            momentum_phase: derived.momentum_phase,
+            session_start_goal: state.currentAssignment?.task || '',
+            parked_ideas: [],
+            active_project_profile: plan.frontmatter.spec.split('/').pop()?.replace('.md', '') || 'default',
+        };
+        // Build conductor session context
+        const conductorSession = {
+            conductor_version: '1.0',
+            session_id: state.frontmatter.session_id,
+            agent: state.frontmatter.agent,
+            spec_path: state.frontmatter.spec,
+            plan_path: state.frontmatter.plan,
+            current_assignment: state.currentAssignment
+                ? {
+                    track: state.currentAssignment.track,
+                    task: state.currentAssignment.task,
+                    subtask: state.currentAssignment.subtask,
+                    iteration: state.currentAssignment.iteration,
+                }
+                : undefined,
+            context_files: state.contextFiles,
+            scratchpad: state.scratchpad,
+            warnings: state.warnings,
+            created_at: state.frontmatter.created,
+            updated_at: new Date().toISOString(),
+        };
+        // Write to USD format
+        const writer = new JsonInterchangeWriter();
+        const doc = writer.createConductorSyncDocument(conductorSession, plan.tracks.map((t) => ({
+            id: t.id,
+            name: t.name,
+            description: t.description,
+            status: t.status,
+            agent: t.agent,
+            dependencies: t.dependencies,
+            tasks: t.tasks.map((task) => ({
+                id: task.id,
+                content: task.content,
+                status: task.state,
+                track: t.name,
+                parent_id: null,
+                artifacts: [],
+                started_at: null,
+                completed_at: task.state === 'complete' ? new Date().toISOString() : null,
+            })),
+            started_at: t.started || null,
+            completed_at: t.completed || null,
+        })), sessionState);
+        await writer.writeToFile(doc, config.cognitiveStatePath);
+        changes.push(`Wrote cognitive state to ${config.cognitiveStatePath}`);
+        return {
+            success: true,
+            direction: 'conductor-to-usd',
+            changes,
+            warnings,
+            timestamp: new Date().toISOString(),
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            direction: 'conductor-to-usd',
+            changes,
+            warnings: [`Sync failed: ${error instanceof Error ? error.message : String(error)}`],
+            timestamp: new Date().toISOString(),
+        };
+    }
+}
+// ============================================================================
+// USD → Conductor Sync
+// ============================================================================
+/**
+ * Sync USD Substrate state to Conductor.
+ *
+ * Reads cognitive_state.json, updates state.md with
+ * cognitive context (warnings, recommendations).
+ */
+export async function syncUSDToConductor(config) {
+    const changes = [];
+    const warnings = [];
+    try {
+        // Read USD state
+        const reader = new JsonInterchangeReader();
+        const doc = await reader.readFromFile(config.cognitiveStatePath);
+        const sessionState = reader.extractSessionState(doc);
+        if (!sessionState) {
+            return {
+                success: false,
+                direction: 'usd-to-conductor',
+                changes: [],
+                warnings: ['No session state found in cognitive_state.json'],
+                timestamp: new Date().toISOString(),
+            };
+        }
+        // Read current Conductor state
+        const statePath = join(config.conductorDir, 'state.md');
+        let stateContent = await readFile(statePath, 'utf-8');
+        // Update warnings based on cognitive state
+        const newWarnings = [];
+        if (sessionState.burnout_level === BurnoutLevel.YELLOW) {
+            newWarnings.push('WARN: Burnout level YELLOW - consider taking a break');
+        }
+        if (sessionState.burnout_level === BurnoutLevel.ORANGE) {
+            newWarnings.push('WARN: Burnout level ORANGE - strongly recommend a break');
+        }
+        if (sessionState.energy_level === EnergyLevel.LOW) {
+            newWarnings.push('WARN: Energy level low - switch to easier tasks');
+        }
+        if (sessionState.energy_level === EnergyLevel.DEPLETED) {
+            newWarnings.push('WARN: Energy depleted - recovery mode recommended');
+        }
+        if (sessionState.momentum_phase === MomentumPhase.CRASHED) {
+            newWarnings.push('WARN: Momentum crashed - no judgment, restart tomorrow is fine');
+        }
+        // Update warnings section in state.md
+        if (newWarnings.length > 0) {
+            const warningsSection = newWarnings.map((w) => `- ${w}`).join('\n');
+            // Replace or add warnings section
+            if (stateContent.includes('## Warnings')) {
+                stateContent = stateContent.replace(/## Warnings\n[\s\S]*?(?=\n##|$)/, `## Warnings\n\n${warningsSection}\n`);
+            }
+            changes.push(`Updated warnings: ${newWarnings.length} items`);
+        }
+        // Update timestamp
+        stateContent = stateContent.replace(/^updated: .+$/m, `updated: ${new Date().toISOString()}`);
+        await writeFile(statePath, stateContent);
+        changes.push('Updated state.md');
+        return {
+            success: true,
+            direction: 'usd-to-conductor',
+            changes,
+            warnings,
+            timestamp: new Date().toISOString(),
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            direction: 'usd-to-conductor',
+            changes,
+            warnings: [`Sync failed: ${error instanceof Error ? error.message : String(error)}`],
+            timestamp: new Date().toISOString(),
+        };
+    }
+}
+// ============================================================================
+// Bidirectional Sync
+// ============================================================================
+/**
+ * Perform bidirectional sync.
+ *
+ * 1. Read both sources
+ * 2. Conductor → USD (task state → cognitive state)
+ * 3. USD → Conductor (cognitive warnings → state.md)
+ */
+export async function syncBidirectional(config) {
+    const allChanges = [];
+    const allWarnings = [];
+    // Conductor → USD first
+    const toUSD = await syncConductorToUSD(config);
+    allChanges.push(...toUSD.changes);
+    allWarnings.push(...toUSD.warnings);
+    if (!toUSD.success) {
+        return {
+            success: false,
+            direction: 'bidirectional',
+            changes: allChanges,
+            warnings: allWarnings,
+            timestamp: new Date().toISOString(),
+        };
+    }
+    // USD → Conductor
+    const toConductor = await syncUSDToConductor(config);
+    allChanges.push(...toConductor.changes);
+    allWarnings.push(...toConductor.warnings);
+    return {
+        success: toConductor.success,
+        direction: 'bidirectional',
+        changes: allChanges,
+        warnings: allWarnings,
+        timestamp: new Date().toISOString(),
+    };
+}
+// ============================================================================
+// Checksum-Based Change Detection
+// ============================================================================
+/**
+ * Compute checksum for a file.
+ */
+export async function computeFileChecksum(filePath) {
+    try {
+        const content = await readFile(filePath, 'utf-8');
+        return createHash('sha256').update(content).digest('hex').slice(0, 16);
+    }
+    catch {
+        return '';
+    }
+}
+/**
+ * Check if a file has changed since last checksum.
+ */
+export function hasFileChanged(currentChecksum, previousChecksum) {
+    return currentChecksum !== previousChecksum && currentChecksum !== '';
+}
+//# sourceMappingURL=state-sync.js.map

package/dist/sync/state-sync.js.map

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

package/dist/sync/watcher.d.ts

@@ -0,0 +1,90 @@
+/**
+ * File Watcher Daemon
+ *
+ * Watches .conductor/ directory for changes and triggers auto-sync.
+ * Provides real-time bidirectional state synchronization.
+ */
+import { EventEmitter } from 'events';
+import { type SyncConfig, type SyncResult } from './state-sync.js';
+export interface WatcherConfig extends SyncConfig {
+    /** Debounce delay in ms */
+    debounceMs: number;
+    /** Whether to sync on initial start */
+    syncOnStart: boolean;
+    /** Files to watch */
+    watchPatterns: string[];
+    /** Files to ignore */
+    ignorePatterns: string[];
+}
+export interface WatcherStats {
+    startTime: Date;
+    syncCount: number;
+    lastSyncTime: Date | null;
+    lastSyncResult: SyncResult | null;
+    errors: string[];
+    exchangeCount: number;
+}
+export type WatcherEvent = 'started' | 'stopped' | 'sync' | 'error' | 'change' | 'convergence';
+export declare class ConductorWatcher extends EventEmitter {
+    private config;
+    private watcher;
+    private checksums;
+    private debounceTimer;
+    private stats;
+    private convergenceTracker;
+    private isRunning;
+    constructor(config: Partial<WatcherConfig>);
+    /**
+     * Start watching for file changes.
+     */
+    start(): Promise<void>;
+    /**
+     * Stop watching for file changes.
+     */
+    stop(): Promise<void>;
+    /**
+     * Handle file change event.
+     */
+    private handleChange;
+    /**
+     * Handle debounced file change.
+     */
+    private onDebouncedChange;
+    /**
+     * Perform sync with convergence tracking.
+     */
+    private syncWithConvergence;
+    /**
+     * Perform bidirectional sync.
+     */
+    sync(): Promise<SyncResult>;
+    /**
+     * Record sync result in stats.
+     */
+    private recordSyncResult;
+    /**
+     * Handle errors.
+     */
+    private handleError;
+    /**
+     * Capture initial file checksums.
+     */
+    private captureChecksums;
+    /**
+     * Get current stats.
+     */
+    getStats(): WatcherStats;
+    /**
+     * Get convergence glyph.
+     */
+    getConvergenceGlyph(): string;
+    /**
+     * Check if watcher is running.
+     */
+    isActive(): boolean;
+}
+/**
+ * Create and start a conductor watcher.
+ */
+export declare function createWatcher(conductorDir: string, options?: Partial<WatcherConfig>): Promise<ConductorWatcher>;
+//# sourceMappingURL=watcher.d.ts.map

package/dist/sync/watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcher.d.ts","sourceRoot":"","sources":["../../src/sync/watcher.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAKL,KAAK,UAAU,EACf,KAAK,UAAU,EAChB,MAAM,iBAAiB,CAAC;AAWzB,MAAM,WAAW,aAAc,SAAQ,UAAU;IAC/C,2BAA2B;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,WAAW,EAAE,OAAO,CAAC;IACrB,qBAAqB;IACrB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,sBAAsB;IACtB,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,IAAI,GAAG,IAAI,CAAC;IAC1B,cAAc,EAAE,UAAU,GAAG,IAAI,CAAC;IAClC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,YAAY,GACpB,SAAS,GACT,SAAS,GACT,MAAM,GACN,OAAO,GACP,QAAQ,GACR,aAAa,CAAC;AA0BlB,qBAAa,gBAAiB,SAAQ,YAAY;IAChD,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,SAAS,CAAkC;IACnD,OAAO,CAAC,aAAa,CAA+B;IACpD,OAAO,CAAC,KAAK,CAAe;IAC5B,OAAO,CAAC,kBAAkB,CAA8B;IACxD,OAAO,CAAC,SAAS,CAAkB;gBAEvB,MAAM,EAAE,OAAO,CAAC,aAAa,CAAC;IA0B1C;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAqC5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAoB3B;;OAEG;IACH,OAAO,CAAC,YAAY;IAcpB;;OAEG;YACW,iBAAiB;IA8B/B;;OAEG;YACW,mBAAmB;IAmDjC;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,UAAU,CAAC;IAMjC;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAYxB;;OAEG;IACH,OAAO,CAAC,WAAW;IAOnB;;OAEG;YACW,gBAAgB;IAgB9B;;OAEG;IACH,QAAQ,IAAI,YAAY;IAIxB;;OAEG;IACH,mBAAmB,IAAI,MAAM;IAI7B;;OAEG;IACH,QAAQ,IAAI,OAAO;CAGpB;AAMD;;GAEG;AACH,wBAAsB,aAAa,CACjC,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GAC/B,OAAO,CAAC,gBAAgB,CAAC,CAS3B"}