ciscollm-cli 1.0.1

package/dist/core/guardrails/ErrorAnalyzer.d.ts

@@ -0,0 +1,7 @@
+export interface IOSErrorStatus {
+    hasError: boolean;
+    errorType: string | null;
+}
+export declare class ErrorAnalyzer {
+    static checkOutput(output: string): IOSErrorStatus;
+}

package/dist/core/guardrails/ErrorAnalyzer.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ErrorAnalyzer = void 0;
+const constants_1 = require("../../shared/constants");
+class ErrorAnalyzer {
+    static checkOutput(output) {
+        for (const pattern of constants_1.IOS_ERROR_PATTERNS) {
+            if (pattern.regex.test(output)) {
+                return { hasError: true, errorType: pattern.type };
+            }
+        }
+        return { hasError: false, errorType: null };
+    }
+}
+exports.ErrorAnalyzer = ErrorAnalyzer;
+//# sourceMappingURL=ErrorAnalyzer.js.map

package/dist/core/guardrails/ErrorAnalyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorAnalyzer.js","sourceRoot":"","sources":["../../../src/core/guardrails/ErrorAnalyzer.ts"],"names":[],"mappings":";;;AAAA,sDAA4D;AAO5D,MAAa,aAAa;IAEf,MAAM,CAAC,WAAW,CAAC,MAAc;QACpC,KAAK,MAAM,OAAO,IAAI,8BAAkB,EAAE,CAAC;YACvC,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC7B,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC;YACvD,CAAC;QACL,CAAC;QACD,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;IAChD,CAAC;CACJ;AAVD,sCAUC"}

package/dist/core/rollback/TransactionManager.d.ts

@@ -0,0 +1,13 @@
+import { BaseSession } from '../../infrastructure/protocols/BaseSession';
+export declare class TransactionManager {
+    private configChangeLog;
+    private targetInterface;
+    private backupCreated;
+    private readonly backupFilename;
+    initializeBackup(session: BaseSession): Promise<void>;
+    trackMutation(command: string): void;
+    private isMutational;
+    executeRollback(session: BaseSession): Promise<string>;
+    clear(): void;
+    hasMutations(): boolean;
+}

package/dist/core/rollback/TransactionManager.js

@@ -0,0 +1,144 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TransactionManager = void 0;
+class TransactionManager {
+    configChangeLog = [];
+    targetInterface = null;
+    backupCreated = false;
+    backupFilename = 'flash:backup-agent.cfg';
+    async initializeBackup(session) {
+        const state = session.getState();
+        if (state.currentMode === 'USER_EXEC') {
+            console.log('[TransactionManager]: Elevating to privileged mode for backup...');
+            await session.execute('enable');
+        }
+        try {
+            console.log('[TransactionManager]: Creating device running-config backup on flash...');
+            const rawOutput = await session.execute(`copy running-config ${this.backupFilename}`);
+            if (rawOutput.includes('Destination filename') || rawOutput.includes('?')) {
+                const confirmOutput = await session.execute('');
+                if (confirmOutput.includes('copied') || confirmOutput.includes('OK')) {
+                    this.backupCreated = true;
+                    console.log('[TransactionManager]: Running configuration backup successfully created.');
+                }
+                else {
+                    console.warn('[TransactionManager Warning]: Backup confirmation response did not confirm copy completion.');
+                }
+            }
+            else if (rawOutput.includes('copied') || rawOutput.includes('OK')) {
+                this.backupCreated = true;
+                console.log('[TransactionManager]: Running configuration backup successfully created.');
+            }
+            else {
+                console.warn('[TransactionManager Warning]: Failed to backup running-config. Flash may be missing or read-only.');
+            }
+        }
+        catch (err) {
+            console.warn(`[TransactionManager Warning]: Backup creation skipped/failed: ${err.message}`);
+        }
+    }
+    trackMutation(command) {
+        const cleanCmd = command.trim();
+        const interfaceMatch = /^interface\s+([A-Za-z0-9\/\.\-]+)/i.exec(cleanCmd);
+        if (interfaceMatch) {
+            this.targetInterface = interfaceMatch[1];
+        }
+        if (this.isMutational(cleanCmd)) {
+            this.configChangeLog.push(cleanCmd);
+        }
+    }
+    isMutational(command) {
+        const lower = command.toLowerCase();
+        return !lower.startsWith('show') &&
+            !lower.startsWith('enable') &&
+            !lower.startsWith('exit') &&
+            !lower.startsWith('end') &&
+            !lower.startsWith('configure terminal') &&
+            !lower.startsWith('conf t') &&
+            !lower.startsWith('copy') &&
+            !lower.startsWith('interface');
+    }
+    async executeRollback(session) {
+        console.warn('[TransactionManager]: Safety rollback triggered!');
+        if (this.backupCreated) {
+            try {
+                console.warn(`[TransactionManager]: Restoring running configuration atomically using ${this.backupFilename}...`);
+                const state = session.getState();
+                if (state.currentMode === 'USER_EXEC') {
+                    await session.execute('enable');
+                }
+                else if (state.currentMode === 'GLOBAL_CONFIG' || state.currentMode === 'INTERFACE_CONFIG') {
+                    await session.execute('end');
+                }
+                const restoreOutput = await session.execute(`configure replace ${this.backupFilename} force`);
+                if (!restoreOutput.includes('% Invalid') && !restoreOutput.includes('Unrecognized')) {
+                    console.log('[TransactionManager]: Atomic restore completed successfully.');
+                    this.clear();
+                    return restoreOutput;
+                }
+                console.warn('[TransactionManager]: configure replace failed/unsupported. Falling back to command inversion.');
+            }
+            catch (err) {
+                console.warn(`[TransactionManager Warning]: Atomic replace failed: ${err.message}. Falling back to command inversion.`);
+            }
+        }
+        console.warn(`[TransactionManager]: Executing manual inversion for ${this.configChangeLog.length} mutations...`);
+        let rollbackSequence = ['configure terminal'];
+        if (this.targetInterface) {
+            rollbackSequence.push(`interface ${this.targetInterface}`);
+            for (const cmd of [...this.configChangeLog].reverse()) {
+                const clean = cmd.trim();
+                const lower = clean.toLowerCase();
+                if (lower.startsWith('ip address') || lower.startsWith('ip add')) {
+                    rollbackSequence.push('no ip address');
+                }
+                else if (lower.startsWith('shutdown')) {
+                    rollbackSequence.push('no shutdown');
+                }
+                else if (lower.startsWith('no shutdown')) {
+                    rollbackSequence.push('shutdown');
+                }
+                else if (lower.startsWith('description')) {
+                    rollbackSequence.push('no description');
+                }
+                else {
+                    if (lower.startsWith('no ')) {
+                        rollbackSequence.push(clean.substring(3));
+                    }
+                    else {
+                        rollbackSequence.push(`no ${clean}`);
+                    }
+                }
+            }
+        }
+        else {
+            for (const cmd of [...this.configChangeLog].reverse()) {
+                const clean = cmd.trim();
+                const lower = clean.toLowerCase();
+                if (lower.startsWith('no ')) {
+                    rollbackSequence.push(clean.substring(3));
+                }
+                else {
+                    rollbackSequence.push(`no ${clean}`);
+                }
+            }
+        }
+        rollbackSequence.push('end');
+        let summary = '';
+        for (const rollbackCmd of rollbackSequence) {
+            console.log(`[TransactionManager Rollback]: Executing "${rollbackCmd}"`);
+            summary += await session.execute(rollbackCmd);
+        }
+        this.clear();
+        return summary;
+    }
+    clear() {
+        this.configChangeLog = [];
+        this.targetInterface = null;
+    }
+    hasMutations() {
+        return this.configChangeLog.length > 0;
+    }
+}
+exports.TransactionManager = TransactionManager;
+//# sourceMappingURL=TransactionManager.js.map

package/dist/core/rollback/TransactionManager.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};