statecli-mcp-server 0.1.2 → 0.3.0

package/dist/rollback-preview.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Rollback Preview - Preview state before undoing
+ *
+ * Shows what the state would look like after a rollback before executing it.
+ */
+import { StateCLI } from './statecli';
+export interface RollbackStep {
+    step: number;
+    timestamp: string;
+    entity: string;
+    action: string;
+    stateBefore: Record<string, unknown> | null;
+    stateAfter: Record<string, unknown>;
+    willBeUndone: boolean;
+}
+export interface RollbackPreviewResult {
+    entity: string;
+    currentState: Record<string, unknown> | null;
+    targetState: Record<string, unknown> | null;
+    stepsToUndo: number;
+    changes: RollbackStep[];
+    diff: StateDiff[];
+    warnings: string[];
+    estimatedImpact: 'minimal' | 'moderate' | 'significant';
+}
+export interface StateDiff {
+    path: string;
+    currentValue: unknown;
+    targetValue: unknown;
+    action: 'add' | 'remove' | 'modify';
+}
+export interface CheckpointPreview {
+    checkpointName: string;
+    checkpointTimestamp: string;
+    currentState: Record<string, unknown> | null;
+    checkpointState: Record<string, unknown>;
+    changesSinceCheckpoint: number;
+    diff: StateDiff[];
+}
+export declare class RollbackPreview {
+    private statecli;
+    constructor(statecli: StateCLI);
+    /**
+     * Preview what will happen if we undo N steps
+     */
+    previewUndo(entity: string, steps?: number): RollbackPreviewResult;
+    /**
+     * Preview restoring to a specific checkpoint
+     */
+    previewCheckpointRestore(entity: string, checkpointName: string): CheckpointPreview | null;
+    /**
+     * Compare two states and show differences
+     */
+    compareStates(state1: Record<string, unknown> | null, state2: Record<string, unknown> | null, label1?: string, label2?: string): {
+        diff: StateDiff[];
+        summary: string;
+    };
+    /**
+     * Get a visual diff as a string
+     */
+    formatDiff(diff: StateDiff[]): string;
+    /**
+     * Simulate undo without actually doing it
+     */
+    simulateUndo(entity: string, steps?: number): {
+        preview: RollbackPreviewResult;
+        wouldSucceed: boolean;
+        resultingState: Record<string, unknown> | null;
+        sideEffects: string[];
+    };
+    private calculateDiff;
+    private flattenObject;
+    private describeChange;
+    private generateWarnings;
+    private estimateImpact;
+}
+//# sourceMappingURL=rollback-preview.d.ts.map

package/dist/rollback-preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rollback-preview.d.ts","sourceRoot":"","sources":["../src/rollback-preview.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGtC,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC5C,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC7C,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC5C,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,IAAI,EAAE,SAAS,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,eAAe,EAAE,SAAS,GAAG,UAAU,GAAG,aAAa,CAAC;CACzD;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAC;CACrC;AAED,MAAM,WAAW,iBAAiB;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC7C,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,sBAAsB,EAAE,MAAM,CAAC;IAC/B,IAAI,EAAE,SAAS,EAAE,CAAC;CACnB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAW;gBAEf,QAAQ,EAAE,QAAQ;IAI9B;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,qBAAqB;IA8DrE;;OAEG;IACH,wBAAwB,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI;IA2B1F;;OAEG;IACH,aAAa,CACX,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,EACtC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,EACtC,MAAM,GAAE,MAAkB,EAC1B,MAAM,GAAE,MAAkB,GACzB;QACD,IAAI,EAAE,SAAS,EAAE,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;KACjB;IAYD;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,MAAM;IAsBrC;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG;QAC/C,OAAO,EAAE,qBAAqB,CAAC;QAC/B,YAAY,EAAE,OAAO,CAAC;QACtB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;QAC/C,WAAW,EAAE,MAAM,EAAE,CAAC;KACvB;IAwBD,OAAO,CAAC,aAAa;IAgDrB,OAAO,CAAC,aAAa;IAgBrB,OAAO,CAAC,cAAc;IAoBtB,OAAO,CAAC,gBAAgB;IA4BxB,OAAO,CAAC,cAAc;CAOvB"}

package/dist/rollback-preview.js

@@ -0,0 +1,244 @@
+"use strict";
+/**
+ * Rollback Preview - Preview state before undoing
+ *
+ * Shows what the state would look like after a rollback before executing it.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RollbackPreview = void 0;
+class RollbackPreview {
+    statecli;
+    constructor(statecli) {
+        this.statecli = statecli;
+    }
+    /**
+     * Preview what will happen if we undo N steps
+     */
+    previewUndo(entity, steps = 1) {
+        const replay = this.statecli.replay(entity);
+        const currentState = this.statecli.getCurrentState(entity);
+        const changes = replay.changes;
+        if (changes.length === 0) {
+            return {
+                entity,
+                currentState,
+                targetState: null,
+                stepsToUndo: 0,
+                changes: [],
+                diff: [],
+                warnings: ['No changes to undo for this entity.'],
+                estimatedImpact: 'minimal'
+            };
+        }
+        const actualSteps = Math.min(steps, changes.length);
+        const targetIndex = changes.length - actualSteps - 1;
+        const targetState = targetIndex >= 0 ? changes[targetIndex].after : null;
+        // Build rollback steps
+        const rollbackSteps = changes.map((change, index) => ({
+            step: change.step,
+            timestamp: change.timestamp,
+            entity: change.entity || entity,
+            action: this.describeChange(change.before, change.after),
+            stateBefore: change.before,
+            stateAfter: change.after,
+            willBeUndone: index >= changes.length - actualSteps
+        }));
+        // Calculate diff
+        const diff = this.calculateDiff(currentState, targetState);
+        // Generate warnings
+        const warnings = this.generateWarnings(currentState, targetState, actualSteps, changes);
+        // Estimate impact
+        const estimatedImpact = this.estimateImpact(diff, actualSteps);
+        // Track preview
+        this.statecli.track('rollback', 'preview', {
+            entity,
+            stepsToUndo: actualSteps,
+            diffCount: diff.length,
+            estimatedImpact
+        }, 'rollback-preview');
+        return {
+            entity,
+            currentState,
+            targetState,
+            stepsToUndo: actualSteps,
+            changes: rollbackSteps,
+            diff,
+            warnings,
+            estimatedImpact
+        };
+    }
+    /**
+     * Preview restoring to a specific checkpoint
+     */
+    previewCheckpointRestore(entity, checkpointName) {
+        const checkpoint = this.statecli.getCheckpoint?.(entity, checkpointName) || null;
+        if (!checkpoint) {
+            return null;
+        }
+        const currentState = this.statecli.getCurrentState(entity);
+        const replay = this.statecli.replay(entity);
+        // Count changes since checkpoint
+        const changesSince = replay.changes.filter(c => new Date(c.timestamp) > new Date(checkpoint.timestamp)).length;
+        const diff = this.calculateDiff(currentState, checkpoint.state);
+        return {
+            checkpointName: checkpoint.name,
+            checkpointTimestamp: checkpoint.timestamp,
+            currentState,
+            checkpointState: checkpoint.state,
+            changesSinceCheckpoint: changesSince,
+            diff
+        };
+    }
+    /**
+     * Compare two states and show differences
+     */
+    compareStates(state1, state2, label1 = 'State 1', label2 = 'State 2') {
+        const diff = this.calculateDiff(state1, state2);
+        const adds = diff.filter(d => d.action === 'add').length;
+        const removes = diff.filter(d => d.action === 'remove').length;
+        const mods = diff.filter(d => d.action === 'modify').length;
+        const summary = `Comparing ${label1} to ${label2}: ${adds} additions, ${removes} removals, ${mods} modifications`;
+        return { diff, summary };
+    }
+    /**
+     * Get a visual diff as a string
+     */
+    formatDiff(diff) {
+        const lines = [];
+        for (const d of diff) {
+            switch (d.action) {
+                case 'add':
+                    lines.push(`+ ${d.path}: ${JSON.stringify(d.targetValue)}`);
+                    break;
+                case 'remove':
+                    lines.push(`- ${d.path}: ${JSON.stringify(d.currentValue)}`);
+                    break;
+                case 'modify':
+                    lines.push(`~ ${d.path}:`);
+                    lines.push(`  - ${JSON.stringify(d.currentValue)}`);
+                    lines.push(`  + ${JSON.stringify(d.targetValue)}`);
+                    break;
+            }
+        }
+        return lines.join('\n');
+    }
+    /**
+     * Simulate undo without actually doing it
+     */
+    simulateUndo(entity, steps = 1) {
+        const preview = this.previewUndo(entity, steps);
+        const wouldSucceed = preview.warnings.length === 0 ||
+            !preview.warnings.some((w) => w.includes('Cannot') || w.includes('Error'));
+        const sideEffects = [];
+        if (preview.stepsToUndo > 5) {
+            sideEffects.push('Large rollback - may take longer to process');
+        }
+        if (preview.diff.some(d => d.path.includes('id') || d.path.includes('Id'))) {
+            sideEffects.push('IDs will change - may affect relationships');
+        }
+        return {
+            preview,
+            wouldSucceed,
+            resultingState: preview.targetState,
+            sideEffects
+        };
+    }
+    calculateDiff(current, target) {
+        const diff = [];
+        if (!current && !target)
+            return diff;
+        if (!current && target) {
+            // All target properties are additions
+            this.flattenObject(target, '').forEach(([path, value]) => {
+                diff.push({ path, currentValue: undefined, targetValue: value, action: 'add' });
+            });
+            return diff;
+        }
+        if (current && !target) {
+            // All current properties are removals
+            this.flattenObject(current, '').forEach(([path, value]) => {
+                diff.push({ path, currentValue: value, targetValue: undefined, action: 'remove' });
+            });
+            return diff;
+        }
+        // Both exist - compare
+        const currentFlat = new Map(this.flattenObject(current, ''));
+        const targetFlat = new Map(this.flattenObject(target, ''));
+        // Check for modifications and removals
+        for (const [path, currentValue] of currentFlat) {
+            if (targetFlat.has(path)) {
+                const targetValue = targetFlat.get(path);
+                if (JSON.stringify(currentValue) !== JSON.stringify(targetValue)) {
+                    diff.push({ path, currentValue, targetValue, action: 'modify' });
+                }
+            }
+            else {
+                diff.push({ path, currentValue, targetValue: undefined, action: 'remove' });
+            }
+        }
+        // Check for additions
+        for (const [path, targetValue] of targetFlat) {
+            if (!currentFlat.has(path)) {
+                diff.push({ path, currentValue: undefined, targetValue, action: 'add' });
+            }
+        }
+        return diff;
+    }
+    flattenObject(obj, prefix) {
+        const result = [];
+        for (const [key, value] of Object.entries(obj)) {
+            const path = prefix ? `${prefix}.${key}` : key;
+            if (value && typeof value === 'object' && !Array.isArray(value)) {
+                result.push(...this.flattenObject(value, path));
+            }
+            else {
+                result.push([path, value]);
+            }
+        }
+        return result;
+    }
+    describeChange(before, after) {
+        if (!before)
+            return 'Created';
+        const beforeKeys = Object.keys(before);
+        const afterKeys = Object.keys(after);
+        const added = afterKeys.filter(k => !beforeKeys.includes(k));
+        const removed = beforeKeys.filter(k => !afterKeys.includes(k));
+        const modified = afterKeys.filter(k => beforeKeys.includes(k) && JSON.stringify(before[k]) !== JSON.stringify(after[k]));
+        const parts = [];
+        if (added.length)
+            parts.push(`Added: ${added.join(', ')}`);
+        if (removed.length)
+            parts.push(`Removed: ${removed.join(', ')}`);
+        if (modified.length)
+            parts.push(`Modified: ${modified.join(', ')}`);
+        return parts.join('; ') || 'No visible changes';
+    }
+    generateWarnings(currentState, targetState, steps, changes) {
+        const warnings = [];
+        if (steps > 10) {
+            warnings.push(`Rolling back ${steps} steps is a large change. Consider restoring to a checkpoint instead.`);
+        }
+        if (!targetState) {
+            warnings.push('Target state is null - entity will be effectively reset.');
+        }
+        // Check for checkpoint in undo range
+        const checkpointsInRange = changes
+            .slice(-steps)
+            .filter(c => c.checkpointName);
+        if (checkpointsInRange.length > 0) {
+            warnings.push(`This will undo past checkpoint(s): ${checkpointsInRange.map(c => c.checkpointName).join(', ')}`);
+        }
+        return warnings;
+    }
+    estimateImpact(diff, steps) {
+        const changeCount = diff.length;
+        if (changeCount === 0 || steps === 1)
+            return 'minimal';
+        if (changeCount <= 5 && steps <= 3)
+            return 'moderate';
+        return 'significant';
+    }
+}
+exports.RollbackPreview = RollbackPreview;
+//# sourceMappingURL=rollback-preview.js.map

package/dist/rollback-preview.js.map

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

package/dist/session-memory.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Session Memory - Cross-session persistence and memory
+ *
+ * Remembers what happened across sessions and provides memory queries
+ */
+import { StateCLI } from './statecli';
+import { StateChange } from './types';
+export interface SessionInfo {
+    id: string;
+    startTime: string;
+    endTime?: string;
+    summary: string;
+    changesCount: number;
+    entities: string[];
+}
+export interface MemoryQuery {
+    entity?: string;
+    entityPattern?: string;
+    timeRange?: {
+        start: string;
+        end: string;
+    };
+    actor?: string;
+    keyword?: string;
+}
+export interface MemoryResult {
+    query: MemoryQuery;
+    sessions: SessionInfo[];
+    changes: StateChange[];
+    summary: string;
+}
+export declare class SessionMemory {
+    private statecli;
+    private sessionId;
+    private sessionStartTime;
+    private memoryDir;
+    constructor(statecli: StateCLI, memoryDir?: string);
+    /**
+     * Get current session ID
+     */
+    getSessionId(): string;
+    /**
+     * Query memory across sessions
+     */
+    queryMemory(query: MemoryQuery): MemoryResult;
+    /**
+     * Ask a natural language question about past actions
+     */
+    ask(question: string): MemoryResult;
+    /**
+     * Get all recorded sessions
+     */
+    getSessions(): SessionInfo[];
+    /**
+     * Get session data by ID
+     */
+    getSession(sessionId: string): {
+        info: SessionInfo;
+        changes: StateChange[];
+    } | null;
+    /**
+     * Save current session data
+     */
+    saveSession(): void;
+    /**
+     * End current session
+     */
+    endSession(): SessionInfo;
+    /**
+     * Get recent activity summary
+     */
+    getRecentActivity(hours?: number): MemoryResult;
+    /**
+     * Get activity for a specific entity across all sessions
+     */
+    getEntityHistory(entityPattern: string): MemoryResult;
+    private generateSessionId;
+    private ensureMemoryDir;
+    private recordSessionStart;
+    private loadSessionData;
+    private changeMatchesQuery;
+    private parseQuestion;
+    private createQuerySummary;
+}
+//# sourceMappingURL=session-memory.d.ts.map

package/dist/session-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-memory.d.ts","sourceRoot":"","sources":["../src/session-memory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,WAAW,EAAgB,MAAM,SAAS,CAAC;AAEpD,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE;QACV,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;IACF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,SAAS,CAAS;gBAEd,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC,EAAE,MAAM;IAUlD;;OAEG;IACH,YAAY,IAAI,MAAM;IAItB;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,YAAY;IAkC7C;;OAEG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY;IAMnC;;OAEG;IACH,WAAW,IAAI,WAAW,EAAE;IAqB5B;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG;QAAE,IAAI,EAAE,WAAW,CAAC;QAAC,OAAO,EAAE,WAAW,EAAE,CAAA;KAAE,GAAG,IAAI;IAInF;;OAEG;IACH,WAAW,IAAI,IAAI;IA0CnB;;OAEG;IACH,UAAU,IAAI,WAAW;IAczB;;OAEG;IACH,iBAAiB,CAAC,KAAK,GAAE,MAAW,GAAG,YAAY;IAWnD;;OAEG;IACH,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,YAAY;IAIrD,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,eAAe;IAMvB,OAAO,CAAC,kBAAkB;IAO1B,OAAO,CAAC,eAAe;IAcvB,OAAO,CAAC,kBAAkB;IA0C1B,OAAO,CAAC,aAAa;IA0CrB,OAAO,CAAC,kBAAkB;CA6B3B"}