conductor-bridge 1.0.0

package/dist/sync/convergence-tracker.js

@@ -0,0 +1,299 @@
+/**
+ * Convergence Tracker
+ *
+ * Tracks RC^+xi convergence in the Conductor context.
+ * Measures epistemic tension and detects attractor basins.
+ *
+ * Formula: xi_n = ||A_{n+1} - A_n||_2 (epistemic tension)
+ * Epsilon: 0.1 (convergence threshold)
+ * Stable: 3 exchanges at xi < epsilon = CONVERGED
+ *
+ * DETERMINISM GUARANTEES (ThinkingMachines [He2025] compliance):
+ *
+ * 1. FIXED STATE VECTOR ORDER: The 6-dimensional state vector is computed
+ *    in a hardcoded order: [progress, blocked, active, trackCompletion,
+ *    momentum, energy]. This order never changes.
+ *
+ * 2. FIXED REDUCTION SEQUENCE: L2 norm uses Array.reduce() which processes
+ *    elements left-to-right per ECMAScript spec. Same inputs → same output.
+ *
+ * 3. FIXED ATTRACTOR PRIORITY: Attractor detection evaluates conditions in
+ *    fixed order: RECOVERY > EXPLORING > TEACHING > FOCUSED.
+ *    First match wins, no dynamic reordering.
+ *
+ * 4. CONSTANT THRESHOLDS: EPSILON (0.1), STABLE_EXCHANGES_REQUIRED (3),
+ *    normalization divisors (5, 3) are compile-time constants.
+ *
+ * Reference: [He2025] "Defeating Nondeterminism in LLM Inference"
+ * https://thinkingmachines.ai/blog/defeating-nondeterminism-in-llm-inference/
+ */
+import { ConvergenceAttractor, ConvergenceStability, MomentumPhase } from '../schemas/enums.js';
+// ============================================================================
+// Constants
+// ============================================================================
+const EPSILON = 0.1; // Convergence threshold
+const STABLE_EXCHANGES_REQUIRED = 3;
+const MAX_TRAJECTORY_LENGTH = 50;
+// Momentum to numeric mapping
+const MOMENTUM_VALUES = {
+    [MomentumPhase.COLD_START]: 0,
+    [MomentumPhase.BUILDING]: 1,
+    [MomentumPhase.ROLLING]: 2,
+    [MomentumPhase.PEAK]: 3,
+    [MomentumPhase.DECLINING]: 2,
+    [MomentumPhase.CRASHED]: 0,
+};
+// Energy to numeric mapping
+const ENERGY_VALUES = {
+    high: 3,
+    medium: 2,
+    low: 1,
+    depleted: 0,
+};
+// ============================================================================
+// State Vector Computation
+// ============================================================================
+/**
+ * Extract state vector from plan and cognitive state.
+ */
+export function extractStateVector(plan, cognitiveState) {
+    // Count tasks by state
+    let total = 0;
+    let complete = 0;
+    let blocked = 0;
+    let active = 0;
+    for (const track of plan.tracks) {
+        for (const task of track.tasks) {
+            total++;
+            if (task.state === 'complete')
+                complete++;
+            if (task.state === 'blocked')
+                blocked++;
+            if (task.state === 'in_progress')
+                active++;
+            // Count subtasks
+            for (const subtask of task.subtasks) {
+                total++;
+                if (subtask.state === 'complete')
+                    complete++;
+                if (subtask.state === 'blocked')
+                    blocked++;
+                if (subtask.state === 'in_progress')
+                    active++;
+            }
+        }
+    }
+    const completedTracks = plan.tracks.filter((t) => t.status === 'complete').length;
+    return {
+        progress: total > 0 ? complete / total : 0,
+        blocked: total > 0 ? blocked / total : 0,
+        active: total > 0 ? active / total : 0,
+        trackCompletion: plan.tracks.length > 0 ? completedTracks / plan.tracks.length : 0,
+        momentum: cognitiveState
+            ? MOMENTUM_VALUES[cognitiveState.momentum_phase] ?? 1
+            : 1,
+        energy: cognitiveState
+            ? ENERGY_VALUES[cognitiveState.energy_level] ?? 2
+            : 2,
+    };
+}
+/**
+ * Compute L2 norm between two state vectors.
+ */
+export function computeL2Norm(v1, v2) {
+    const diffs = [
+        v1.progress - v2.progress,
+        v1.blocked - v2.blocked,
+        v1.active - v2.active,
+        v1.trackCompletion - v2.trackCompletion,
+        (v1.momentum - v2.momentum) / 5, // Normalize momentum (0-5 → 0-1)
+        (v1.energy - v2.energy) / 3, // Normalize energy (0-3 → 0-1)
+    ];
+    const sumSquares = diffs.reduce((sum, d) => sum + d * d, 0);
+    return Math.sqrt(sumSquares / diffs.length); // Normalized L2
+}
+// ============================================================================
+// Attractor Detection
+// ============================================================================
+/**
+ * Detect which attractor basin the current state is in.
+ *
+ * Attractors:
+ * - focused: High progress, low blocked, steady momentum
+ * - exploring: Active work, building momentum
+ * - recovery: Low energy, crashed momentum
+ * - teaching: (Not derived from tasks, set explicitly)
+ */
+export function detectAttractor(vector, cognitiveState) {
+    // Check for recovery state
+    if (vector.energy <= 1 ||
+        vector.momentum === 0 ||
+        vector.blocked > 0.3) {
+        return ConvergenceAttractor.RECOVERY;
+    }
+    // Check for exploring state
+    if (vector.active > 0.2 &&
+        vector.momentum >= 1 &&
+        vector.momentum <= 2 &&
+        vector.progress < 0.5) {
+        return ConvergenceAttractor.EXPLORING;
+    }
+    // Check for teaching (explicitly set via cognitive state)
+    if (cognitiveState?.active_mode === 'teaching') {
+        return ConvergenceAttractor.TEACHING;
+    }
+    // Default to focused
+    return ConvergenceAttractor.FOCUSED;
+}
+// ============================================================================
+// Convergence Tracking
+// ============================================================================
+/**
+ * Convergence tracker class.
+ *
+ * Maintains state across exchanges and detects convergence.
+ */
+export class ConductorConvergenceTracker {
+    previousVector = null;
+    trajectory = [];
+    stableCount = 0;
+    currentAttractor = ConvergenceAttractor.FOCUSED;
+    /**
+     * Record an exchange and compute convergence metrics.
+     */
+    recordExchange(plan, cognitiveState) {
+        const currentVector = extractStateVector(plan, cognitiveState);
+        // Compute xi_n (epistemic tension)
+        let xi_n = 0;
+        if (this.previousVector) {
+            xi_n = computeL2Norm(currentVector, this.previousVector);
+        }
+        // Update trajectory
+        this.trajectory.push(xi_n);
+        if (this.trajectory.length > MAX_TRAJECTORY_LENGTH) {
+            this.trajectory.shift();
+        }
+        // Check for stability
+        if (xi_n < EPSILON) {
+            this.stableCount++;
+        }
+        else {
+            this.stableCount = 0;
+        }
+        // Detect attractor
+        const attractor = detectAttractor(currentVector, cognitiveState);
+        // Detect stability state
+        let stability;
+        if (this.stableCount >= STABLE_EXCHANGES_REQUIRED) {
+            stability = ConvergenceStability.STABLE;
+        }
+        else if (this.trajectory.length >= 3) {
+            // Check for oscillation (alternating high/low)
+            const recent = this.trajectory.slice(-3);
+            const isOscillating = (recent[0] > EPSILON && recent[1] < EPSILON && recent[2] > EPSILON) ||
+                (recent[0] < EPSILON && recent[1] > EPSILON && recent[2] < EPSILON);
+            stability = isOscillating
+                ? ConvergenceStability.OSCILLATING
+                : ConvergenceStability.CONVERGING;
+        }
+        else {
+            stability = ConvergenceStability.CONVERGING;
+        }
+        // Update state
+        this.previousVector = currentVector;
+        this.currentAttractor = attractor;
+        return {
+            xi_n,
+            attractor,
+            stability,
+            stableExchangeCount: this.stableCount,
+            isConverged: this.stableCount >= STABLE_EXCHANGES_REQUIRED,
+            trajectory: [...this.trajectory],
+        };
+    }
+    /**
+     * Get RC^+xi glyph for display.
+     *
+     * Format: RC^+xi[attractor:stability:xi]
+     * Example: RC^+xi[focused:stable:0.05]
+     */
+    getGlyph() {
+        const xi = this.trajectory.length > 0
+            ? this.trajectory[this.trajectory.length - 1].toFixed(2)
+            : '0.00';
+        const attractorShort = this.currentAttractor.charAt(0).toUpperCase();
+        const stabilityShort = this.stableCount >= STABLE_EXCHANGES_REQUIRED ? 'S' : 'C';
+        return `RC^+xi[${attractorShort}:${stabilityShort}:${xi}]`;
+    }
+    /**
+     * Create a convergence record for persistence.
+     */
+    createRecord(sessionId, exchangeNumber, cognitiveState) {
+        const xi_n = this.trajectory.length > 0
+            ? this.trajectory[this.trajectory.length - 1]
+            : 0;
+        return {
+            timestamp: new Date().toISOString(),
+            session_id: sessionId,
+            exchange_number: exchangeNumber,
+            expert: cognitiveState?.active_intervention_expert,
+            paradigm: cognitiveState?.active_paradigm,
+            altitude: cognitiveState?.current_altitude,
+            burnout_level: cognitiveState?.burnout_level,
+            energy_level: cognitiveState?.energy_level,
+            xi_n,
+            attractor: this.currentAttractor,
+            stability: this.stableCount >= STABLE_EXCHANGES_REQUIRED
+                ? ConvergenceStability.STABLE
+                : ConvergenceStability.CONVERGING,
+        };
+    }
+    /**
+     * Reset tracker state.
+     */
+    reset() {
+        this.previousVector = null;
+        this.trajectory = [];
+        this.stableCount = 0;
+        this.currentAttractor = ConvergenceAttractor.FOCUSED;
+    }
+}
+// ============================================================================
+// Utility Functions
+// ============================================================================
+/**
+ * Analyze convergence trajectory for insights.
+ */
+export function analyzeTrajectory(trajectory) {
+    if (trajectory.length < 2) {
+        return { trend: 'stable', averageXi: trajectory[0] ?? 0, volatility: 0 };
+    }
+    // Compute average
+    const averageXi = trajectory.reduce((sum, x) => sum + x, 0) / trajectory.length;
+    // Compute volatility (standard deviation)
+    const variance = trajectory.reduce((sum, x) => sum + (x - averageXi) ** 2, 0) / trajectory.length;
+    const volatility = Math.sqrt(variance);
+    // Compute trend (linear regression slope)
+    const n = trajectory.length;
+    const xMean = (n - 1) / 2;
+    const yMean = averageXi;
+    let numerator = 0;
+    let denominator = 0;
+    for (let i = 0; i < n; i++) {
+        numerator += (i - xMean) * (trajectory[i] - yMean);
+        denominator += (i - xMean) ** 2;
+    }
+    const slope = denominator !== 0 ? numerator / denominator : 0;
+    let trend;
+    if (slope < -0.01) {
+        trend = 'improving'; // xi decreasing = converging
+    }
+    else if (slope > 0.01) {
+        trend = 'degrading'; // xi increasing = diverging
+    }
+    else {
+        trend = 'stable';
+    }
+    return { trend, averageXi, volatility };
+}
+//# sourceMappingURL=convergence-tracker.js.map

package/dist/sync/convergence-tracker.js.map

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

package/dist/sync/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Sync Module
+ *
+ * Bidirectional state synchronization between Conductor (Markdown)
+ * and USD Substrate (JSON).
+ */
+export { syncConductorToUSD, syncUSDToConductor, syncBidirectional, deriveMomentumFromTasks, deriveEnergyFromTasks, deriveCognitiveState, computeFileChecksum, hasFileChanged, type SyncConfig, type SyncResult, type DerivedCognitiveState, } from './state-sync.js';
+export { ConductorConvergenceTracker, extractStateVector, computeL2Norm, detectAttractor, analyzeTrajectory, type StateVector, type ConvergenceState, } from './convergence-tracker.js';
+export { ConductorWatcher, createWatcher, type WatcherConfig, type WatcherStats, type WatcherEvent, } from './watcher.js';
+export { SessionBreakType, detectBreakType, applyMomentumPenalty, generateResumeSummary, createSessionHandoff, getRecoveryRecommendations, type BreakAnalysis, type ResumeSummary, type MomentumState, } from './adhd-continuity.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sync/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,uBAAuB,EACvB,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,cAAc,EACd,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,qBAAqB,GAC3B,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,2BAA2B,EAC3B,kBAAkB,EAClB,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,KAAK,WAAW,EAChB,KAAK,gBAAgB,GACtB,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,YAAY,GAClB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,0BAA0B,EAC1B,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,aAAa,GACnB,MAAM,sBAAsB,CAAC"}

package/dist/sync/index.js

@@ -0,0 +1,15 @@
+/**
+ * Sync Module
+ *
+ * Bidirectional state synchronization between Conductor (Markdown)
+ * and USD Substrate (JSON).
+ */
+// State sync
+export { syncConductorToUSD, syncUSDToConductor, syncBidirectional, deriveMomentumFromTasks, deriveEnergyFromTasks, deriveCognitiveState, computeFileChecksum, hasFileChanged, } from './state-sync.js';
+// Convergence tracking
+export { ConductorConvergenceTracker, extractStateVector, computeL2Norm, detectAttractor, analyzeTrajectory, } from './convergence-tracker.js';
+// File watcher
+export { ConductorWatcher, createWatcher, } from './watcher.js';
+// ADHD continuity
+export { SessionBreakType, detectBreakType, applyMomentumPenalty, generateResumeSummary, createSessionHandoff, getRecoveryRecommendations, } from './adhd-continuity.js';
+//# sourceMappingURL=index.js.map

package/dist/sync/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sync/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,aAAa;AACb,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,uBAAuB,EACvB,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,cAAc,GAIf,MAAM,iBAAiB,CAAC;AAEzB,uBAAuB;AACvB,OAAO,EACL,2BAA2B,EAC3B,kBAAkB,EAClB,aAAa,EACb,eAAe,EACf,iBAAiB,GAGlB,MAAM,0BAA0B,CAAC;AAElC,eAAe;AACf,OAAO,EACL,gBAAgB,EAChB,aAAa,GAId,MAAM,cAAc,CAAC;AAEtB,kBAAkB;AAClB,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,0BAA0B,GAI3B,MAAM,sBAAsB,CAAC"}

package/dist/sync/state-sync.d.ts

@@ -0,0 +1,105 @@
+/**
+ * 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 type { ParsedPlan } from '../parsers/types.js';
+import { MomentumPhase, EnergyLevel } from '../schemas/enums.js';
+export interface SyncConfig {
+    conductorDir: string;
+    cognitiveStatePath: string;
+    autoSave: boolean;
+    autoSaveIntervalMs: number;
+}
+export interface SyncResult {
+    success: boolean;
+    direction: 'conductor-to-usd' | 'usd-to-conductor' | 'bidirectional';
+    changes: string[];
+    warnings: string[];
+    timestamp: string;
+}
+export interface DerivedCognitiveState {
+    momentum_phase: MomentumPhase;
+    energy_level: EnergyLevel;
+    progress_percent: number;
+    tasks_completed: number;
+    tasks_total: number;
+    tracks_completed: number;
+    tracks_total: number;
+    has_blocked_tasks: boolean;
+}
+/**
+ * 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 declare function deriveMomentumFromTasks(plan: ParsedPlan, recentCompletions?: number, sessionDurationMinutes?: number): MomentumPhase;
+/**
+ * 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 declare function deriveEnergyFromTasks(plan: ParsedPlan, sessionDurationMinutes?: number, recentBlockedCount?: number): EnergyLevel;
+/**
+ * Derive complete cognitive state from task data.
+ */
+export declare function deriveCognitiveState(plan: ParsedPlan, sessionDurationMinutes?: number, recentCompletions?: number): DerivedCognitiveState;
+/**
+ * Sync Conductor state to USD Substrate.
+ *
+ * Reads plan.md and state.md, derives cognitive state,
+ * writes to cognitive_state.json.
+ */
+export declare function syncConductorToUSD(config: SyncConfig): Promise<SyncResult>;
+/**
+ * Sync USD Substrate state to Conductor.
+ *
+ * Reads cognitive_state.json, updates state.md with
+ * cognitive context (warnings, recommendations).
+ */
+export declare function syncUSDToConductor(config: SyncConfig): Promise<SyncResult>;
+/**
+ * Perform bidirectional sync.
+ *
+ * 1. Read both sources
+ * 2. Conductor → USD (task state → cognitive state)
+ * 3. USD → Conductor (cognitive warnings → state.md)
+ */
+export declare function syncBidirectional(config: SyncConfig): Promise<SyncResult>;
+/**
+ * Compute checksum for a file.
+ */
+export declare function computeFileChecksum(filePath: string): Promise<string>;
+/**
+ * Check if a file has changed since last checksum.
+ */
+export declare function hasFileChanged(currentChecksum: string, previousChecksum: string): boolean;
+//# sourceMappingURL=state-sync.d.ts.map

package/dist/sync/state-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-sync.d.ts","sourceRoot":"","sources":["../../src/sync/state-sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAKH,OAAO,KAAK,EACV,UAAU,EAIX,MAAM,qBAAqB,CAAC;AAU7B,OAAO,EACL,aAAa,EACb,WAAW,EAMZ,MAAM,qBAAqB,CAAC;AAM7B,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,QAAQ,EAAE,OAAO,CAAC;IAClB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,kBAAkB,GAAG,kBAAkB,GAAG,eAAe,CAAC;IACrE,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,cAAc,EAAE,aAAa,CAAC;IAC9B,YAAY,EAAE,WAAW,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAMD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,UAAU,EAChB,iBAAiB,GAAE,MAAU,EAC7B,sBAAsB,GAAE,MAAU,GACjC,aAAa,CAiDf;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,UAAU,EAChB,sBAAsB,GAAE,MAAU,EAClC,kBAAkB,GAAE,MAAU,GAC7B,WAAW,CAsCb;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,UAAU,EAChB,sBAAsB,GAAE,MAAU,EAClC,iBAAiB,GAAE,MAAU,GAC5B,qBAAqB,CAgBvB;AAMD;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,UAAU,GACjB,OAAO,CAAC,UAAU,CAAC,CAwIrB;AAMD;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,UAAU,GACjB,OAAO,CAAC,UAAU,CAAC,CAmFrB;AAMD;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,UAAU,GACjB,OAAO,CAAC,UAAU,CAAC,CA+BrB;AAMD;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAO3E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,eAAe,EAAE,MAAM,EACvB,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAET"}