midas-mcp 5.18.0 → 5.41.0

package/dist/atomic-state.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Atomic State Management
+ *
+ * Solves race conditions with:
+ * 1. Atomic writes (temp file → rename) - prevents corruption
+ * 2. Version detection - knows when conflicts occur
+ * 3. Smart merge - arrays union, scalars last-write-wins
+ * 4. Zero blocking - no locks, no waits, no deadlocks
+ *
+ * This approach guarantees:
+ * - No data corruption (atomic rename is OS-level atomic)
+ * - No lost array entries (union merge)
+ * - No blocking (optimistic, non-locking)
+ * - No deadlocks (nothing to deadlock on)
+ */
+export interface VersionedState {
+    _version: number;
+    _lastModified: string;
+    _processId: string;
+    [key: string]: unknown;
+}
+export interface MergeStrategy<T> {
+    /**
+     * Merge two states when a conflict is detected.
+     * @param local - The state we're trying to write
+     * @param remote - The state currently on disk (written by another process)
+     * @returns Merged state
+     */
+    merge: (local: T, remote: T) => T;
+}
+export interface AtomicWriteResult {
+    success: boolean;
+    conflictDetected: boolean;
+    conflictResolved: boolean;
+    finalVersion: number;
+}
+/**
+ * Default merge: arrays union by unique key, scalars last-write-wins
+ */
+export declare function defaultMerge<T extends VersionedState>(local: T, remote: T, arrayKeys?: string[], uniqueKeyField?: string): T;
+/**
+ * Read state from file with version info
+ */
+export declare function readStateAtomic<T extends VersionedState>(filePath: string, defaultState: () => T): T;
+/**
+ * Write state atomically with conflict detection and merge
+ */
+export declare function writeStateAtomic<T extends VersionedState>(filePath: string, state: T, options?: {
+    expectedVersion?: number;
+    merge?: MergeStrategy<T>;
+    arrayKeys?: string[];
+}): Promise<AtomicWriteResult>;
+/**
+ * Synchronous atomic write (for compatibility with existing sync APIs)
+ * Uses writeFileAtomic.sync under the hood
+ */
+export declare function writeStateAtomicSync<T extends VersionedState>(filePath: string, state: T, options?: {
+    expectedVersion?: number;
+    arrayKeys?: string[];
+}): AtomicWriteResult;
+/**
+ * Perform a read-modify-write operation atomically with automatic conflict resolution.
+ * This is the recommended API for most use cases.
+ */
+export declare function atomicUpdate<T extends VersionedState>(filePath: string, defaultState: () => T, modifier: (state: T) => T, options?: {
+    arrayKeys?: string[];
+    maxRetries?: number;
+}): Promise<{
+    state: T;
+    result: AtomicWriteResult;
+}>;
+/**
+ * Synchronous version of atomicUpdate
+ */
+export declare function atomicUpdateSync<T extends VersionedState>(filePath: string, defaultState: () => T, modifier: (state: T) => T, options?: {
+    arrayKeys?: string[];
+}): {
+    state: T;
+    result: AtomicWriteResult;
+};
+//# sourceMappingURL=atomic-state.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"atomic-state.d.ts","sourceRoot":"","sources":["../src/atomic-state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAWH,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B;;;;;OAKG;IACH,KAAK,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;CACtB;AAMD;;GAEG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,cAAc,EACnD,KAAK,EAAE,CAAC,EACR,MAAM,EAAE,CAAC,EACT,SAAS,GAAE,MAAM,EAAO,EACxB,cAAc,GAAE,MAAa,GAC5B,CAAC,CAoBH;AA8BD;;GAEG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,cAAc,EACtD,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,CAAC,GACpB,CAAC,CA2BH;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,SAAS,cAAc,EAC7D,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,CAAC,EACR,OAAO,GAAE;IACP,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB,GACL,OAAO,CAAC,iBAAiB,CAAC,CA0E5B;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,cAAc,EAC3D,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,CAAC,EACR,OAAO,GAAE;IACP,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB,GACL,iBAAiB,CA4DnB;AAMD;;;GAGG;AACH,wBAAsB,YAAY,CAAC,CAAC,SAAS,cAAc,EACzD,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,CAAC,EACrB,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,EACzB,OAAO,GAAE;IACP,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CAChB,GACL,OAAO,CAAC;IAAE,KAAK,EAAE,CAAC,CAAC;IAAC,MAAM,EAAE,iBAAiB,CAAA;CAAE,CAAC,CAkClD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,cAAc,EACvD,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,CAAC,EACrB,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,EACzB,OAAO,GAAE;IACP,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB,GACL;IAAE,KAAK,EAAE,CAAC,CAAC;IAAC,MAAM,EAAE,iBAAiB,CAAA;CAAE,CAezC"}

package/dist/atomic-state.js

@@ -0,0 +1,278 @@
+/**
+ * Atomic State Management
+ *
+ * Solves race conditions with:
+ * 1. Atomic writes (temp file → rename) - prevents corruption
+ * 2. Version detection - knows when conflicts occur
+ * 3. Smart merge - arrays union, scalars last-write-wins
+ * 4. Zero blocking - no locks, no waits, no deadlocks
+ *
+ * This approach guarantees:
+ * - No data corruption (atomic rename is OS-level atomic)
+ * - No lost array entries (union merge)
+ * - No blocking (optimistic, non-locking)
+ * - No deadlocks (nothing to deadlock on)
+ */
+import { readFileSync, existsSync, mkdirSync } from 'fs';
+import { dirname } from 'path';
+import writeFileAtomic from 'write-file-atomic';
+import { logger } from './logger.js';
+// ============================================================================
+// MERGE STRATEGIES
+// ============================================================================
+/**
+ * Default merge: arrays union by unique key, scalars last-write-wins
+ */
+export function defaultMerge(local, remote, arrayKeys = [], uniqueKeyField = 'id') {
+    const result = { ...remote }; // Start with remote (it's newer on disk)
+    for (const key of Object.keys(local)) {
+        const localVal = local[key];
+        const remoteVal = remote[key];
+        if (arrayKeys.includes(key) && Array.isArray(localVal) && Array.isArray(remoteVal)) {
+            // Union merge for arrays - never lose entries
+            result[key] = unionArrays(localVal, remoteVal, uniqueKeyField);
+        }
+        else if (key === '_version' || key === '_lastModified' || key === '_processId') {
+            // Version fields handled separately
+            continue;
+        }
+        else if (localVal !== undefined) {
+            // Scalar: local wins (we're the latest intent)
+            result[key] = localVal;
+        }
+    }
+    return result;
+}
+/**
+ * Union two arrays, deduplicating by a unique key field
+ */
+function unionArrays(arr1, arr2, uniqueKey) {
+    const seen = new Map();
+    // Add all from arr2 first (older)
+    for (const item of arr2) {
+        const key = item[uniqueKey] ?? JSON.stringify(item);
+        seen.set(key, item);
+    }
+    // Add/overwrite with arr1 (newer)
+    for (const item of arr1) {
+        const key = item[uniqueKey] ?? JSON.stringify(item);
+        seen.set(key, item);
+    }
+    return Array.from(seen.values());
+}
+// ============================================================================
+// CORE FUNCTIONS
+// ============================================================================
+// Process ID for conflict detection
+const PROCESS_ID = `${process.pid}-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+/**
+ * Read state from file with version info
+ */
+export function readStateAtomic(filePath, defaultState) {
+    if (!existsSync(filePath)) {
+        const state = defaultState();
+        state._version = 0;
+        state._lastModified = new Date().toISOString();
+        state._processId = PROCESS_ID;
+        return state;
+    }
+    try {
+        const raw = readFileSync(filePath, 'utf-8');
+        if (!raw || raw.trim() === '') {
+            return defaultState();
+        }
+        const parsed = JSON.parse(raw);
+        // Validate it has version info
+        if (typeof parsed._version !== 'number') {
+            parsed._version = 0;
+        }
+        return parsed;
+    }
+    catch (error) {
+        logger.warn(`Failed to read ${filePath}, using default`, { error });
+        return defaultState();
+    }
+}
+/**
+ * Write state atomically with conflict detection and merge
+ */
+export async function writeStateAtomic(filePath, state, options = {}) {
+    // Ensure directory exists
+    const dir = dirname(filePath);
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    // Read current state on disk
+    const currentOnDisk = existsSync(filePath)
+        ? (() => {
+            try {
+                return JSON.parse(readFileSync(filePath, 'utf-8'));
+            }
+            catch {
+                return null;
+            }
+        })()
+        : null;
+    let finalState = state;
+    let conflictDetected = false;
+    let conflictResolved = false;
+    // Check for conflict
+    if (currentOnDisk && options.expectedVersion !== undefined) {
+        const diskVersion = currentOnDisk._version ?? 0;
+        if (diskVersion > options.expectedVersion) {
+            // Conflict! Another process wrote while we were modifying
+            conflictDetected = true;
+            if (options.merge) {
+                // Use custom merge
+                finalState = options.merge.merge(state, currentOnDisk);
+                conflictResolved = true;
+            }
+            else if (options.arrayKeys && options.arrayKeys.length > 0) {
+                // Use default merge with array union
+                finalState = defaultMerge(state, currentOnDisk, options.arrayKeys);
+                conflictResolved = true;
+            }
+            // Else: last-write-wins (state overwrites disk)
+            logger.debug('Conflict detected and resolved', {
+                expectedVersion: options.expectedVersion,
+                diskVersion,
+                resolved: conflictResolved,
+            });
+        }
+    }
+    // Increment version
+    const newVersion = (currentOnDisk?._version ?? state._version ?? 0) + 1;
+    finalState._version = newVersion;
+    finalState._lastModified = new Date().toISOString();
+    finalState._processId = PROCESS_ID;
+    // Atomic write (temp file → rename)
+    try {
+        await writeFileAtomic(filePath, JSON.stringify(finalState, null, 2));
+        return {
+            success: true,
+            conflictDetected,
+            conflictResolved,
+            finalVersion: newVersion,
+        };
+    }
+    catch (error) {
+        logger.error('Atomic write failed', error);
+        return {
+            success: false,
+            conflictDetected,
+            conflictResolved: false,
+            finalVersion: state._version ?? 0,
+        };
+    }
+}
+/**
+ * Synchronous atomic write (for compatibility with existing sync APIs)
+ * Uses writeFileAtomic.sync under the hood
+ */
+export function writeStateAtomicSync(filePath, state, options = {}) {
+    // Ensure directory exists
+    const dir = dirname(filePath);
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    // Read current state on disk
+    let currentOnDisk = null;
+    if (existsSync(filePath)) {
+        try {
+            currentOnDisk = JSON.parse(readFileSync(filePath, 'utf-8'));
+        }
+        catch {
+            currentOnDisk = null;
+        }
+    }
+    let finalState = state;
+    let conflictDetected = false;
+    let conflictResolved = false;
+    // Check for conflict
+    if (currentOnDisk && options.expectedVersion !== undefined) {
+        const diskVersion = currentOnDisk._version ?? 0;
+        if (diskVersion > options.expectedVersion) {
+            conflictDetected = true;
+            if (options.arrayKeys && options.arrayKeys.length > 0) {
+                finalState = defaultMerge(state, currentOnDisk, options.arrayKeys);
+                conflictResolved = true;
+            }
+        }
+    }
+    // Increment version
+    const newVersion = (currentOnDisk?._version ?? state._version ?? 0) + 1;
+    finalState._version = newVersion;
+    finalState._lastModified = new Date().toISOString();
+    finalState._processId = PROCESS_ID;
+    // Atomic write
+    try {
+        writeFileAtomic.sync(filePath, JSON.stringify(finalState, null, 2));
+        return {
+            success: true,
+            conflictDetected,
+            conflictResolved,
+            finalVersion: newVersion,
+        };
+    }
+    catch (error) {
+        logger.error('Atomic write failed', error);
+        return {
+            success: false,
+            conflictDetected,
+            conflictResolved: false,
+            finalVersion: state._version ?? 0,
+        };
+    }
+}
+// ============================================================================
+// HIGH-LEVEL API: Read-Modify-Write with Automatic Merge
+// ============================================================================
+/**
+ * Perform a read-modify-write operation atomically with automatic conflict resolution.
+ * This is the recommended API for most use cases.
+ */
+export async function atomicUpdate(filePath, defaultState, modifier, options = {}) {
+    const maxRetries = options.maxRetries ?? 3;
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+        // Read current state
+        const current = readStateAtomic(filePath, defaultState);
+        const expectedVersion = current._version;
+        // Modify
+        const modified = modifier(current);
+        // Write with conflict detection
+        const result = await writeStateAtomic(filePath, modified, {
+            expectedVersion,
+            arrayKeys: options.arrayKeys,
+        });
+        if (result.success) {
+            return { state: modified, result };
+        }
+        // If failed, retry (conflict will be auto-merged)
+        if (attempt < maxRetries) {
+            logger.debug(`Atomic update retry ${attempt + 1}/${maxRetries}`);
+        }
+    }
+    // Final attempt with force write
+    const final = modifier(readStateAtomic(filePath, defaultState));
+    const result = await writeStateAtomic(filePath, final, {
+        arrayKeys: options.arrayKeys,
+    });
+    return { state: final, result };
+}
+/**
+ * Synchronous version of atomicUpdate
+ */
+export function atomicUpdateSync(filePath, defaultState, modifier, options = {}) {
+    // Read current state
+    const current = readStateAtomic(filePath, defaultState);
+    const expectedVersion = current._version;
+    // Modify
+    const modified = modifier(current);
+    // Write with conflict detection
+    const result = writeStateAtomicSync(filePath, modified, {
+        expectedVersion,
+        arrayKeys: options.arrayKeys,
+    });
+    return { state: modified, result };
+}
+//# sourceMappingURL=atomic-state.js.map

package/dist/atomic-state.js.map

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

package/dist/gameplan-tracker.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Gameplan Tracker
+ *
+ * Intelligently tracks progress through the gameplan by:
+ * 1. Parsing tasks from gameplan.md (checkbox items)
+ * 2. Cross-referencing tasks against actual code
+ * 3. Detecting what's done vs what's missing
+ * 4. Detecting scope creep (code not in plan)
+ */
+export interface GameplanTask {
+    id: string;
+    text: string;
+    completed: boolean;
+    phase?: string;
+    priority?: 'high' | 'medium' | 'low';
+    relatedFiles?: string[];
+    confidence: number;
+    implementationStatus: 'not_started' | 'partial' | 'complete' | 'unknown';
+}
+export interface GameplanAnalysis {
+    totalTasks: number;
+    completedTasks: number;
+    implementedTasks: number;
+    tasks: GameplanTask[];
+    documentProgress: number;
+    actualProgress: number;
+    progressMatch: boolean;
+    missingImplementation: GameplanTask[];
+    scopeCreep: string[];
+    summary: string;
+    nextTask?: GameplanTask;
+}
+/**
+ * Parse tasks from gameplan content.
+ * Supports multiple formats:
+ * - [ ] Task description
+ * - [x] Completed task
+ * - 1. Task description (numbered)
+ * - - Task description (bullet)
+ */
+export declare function parseGameplanTasks(content: string): GameplanTask[];
+/**
+ * Analyze gameplan and cross-reference with codebase
+ */
+export declare function analyzeGameplan(projectPath: string): GameplanAnalysis;
+/**
+ * Get a simple progress summary
+ */
+export declare function getGameplanProgress(projectPath: string): {
+    documented: number;
+    actual: number;
+    discrepancy: boolean;
+    nextSuggested?: string;
+};
+/**
+ * Check if gameplan tasks align with code
+ */
+export declare function validateGameplanProgress(projectPath: string): {
+    valid: boolean;
+    warnings: string[];
+    suggestions: string[];
+};
+//# sourceMappingURL=gameplan-tracker.d.ts.map

package/dist/gameplan-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gameplan-tracker.d.ts","sourceRoot":"","sources":["../src/gameplan-tracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAaH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IAGrC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,oBAAoB,EAAE,aAAa,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC;CAC1E;AAED,MAAM,WAAW,gBAAgB;IAE/B,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IAGzB,KAAK,EAAE,YAAY,EAAE,CAAC;IAGtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,OAAO,CAAC;IAGvB,qBAAqB,EAAE,YAAY,EAAE,CAAC;IACtC,UAAU,EAAE,MAAM,EAAE,CAAC;IAGrB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,YAAY,CAAC;CACzB;AAMD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,EAAE,CAqDlE;AAuHD;;GAEG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,gBAAgB,CAqIrE;AAMD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG;IACxD,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,OAAO,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAQA;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,MAAM,GAAG;IAC7D,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB,CAiCA"}