@qduc/term2 0.1.1 → 0.1.3

package/dist/modes/companion/output-classifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-classifier.js","sourceRoot":"","sources":["../../../source/modes/companion/output-classifier.ts"],"names":[],"mappings":"AAUA;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAmB;IAClD,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;IAE/C,gBAAgB;IAChB,IACI,iFAAiF,CAAC,IAAI,CAClF,GAAG,CACN,EACH,CAAC;QACC,OAAO,cAAc,CAAC;IAC1B,CAAC;IAED,iBAAiB;IACjB,IACI,yFAAyF,CAAC,IAAI,CAC1F,GAAG,CACN,EACH,CAAC;QACC,OAAO,cAAc,CAAC;IAC1B,CAAC;IAED,eAAe;IACf,IAAI,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACrB,OAAO,YAAY,CAAC;IACxB,CAAC;IAED,eAAe;IACf,IAAI,oBAAoB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACjC,OAAO,YAAY,CAAC;IACxB,CAAC;IAED,mBAAmB;IACnB,IAAI,KAAK,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,cAAc,CAAC;IAC1B,CAAC;IAED,OAAO,SAAS,CAAC;AACrB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,KAAmB;IAC/C,6BAA6B;IAC7B,IAAI,KAAK,CAAC,WAAW,GAAG,EAAE,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,sCAAsC;IACtC,MAAM,cAAc,GAChB,gFAAgF,CAAC;IACrF,IAAI,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;QACnD,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,6BAA6B;IAC7B,OAAO,IAAI,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,UAAsB;IACzD,MAAM,OAAO,GAA+B;QACxC,YAAY,EAAE;;;;yCAImB;QAEjC,YAAY,EAAE;;;yBAGG;QAEjB,UAAU,EAAE;;;0BAGM;QAElB,UAAU,EAAE;;;yBAGK;QAEjB,YAAY,EAAE;;;6BAGO;QAErB,OAAO,EAAE;;;iCAGgB;KAC5B,CAAC;IAEF,OAAO,OAAO,CAAC,UAAU,CAAC,CAAC;AAC/B,CAAC"}

package/dist/modes/companion/output-classifier.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=output-classifier.test.d.ts.map

package/dist/modes/companion/output-classifier.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-classifier.test.d.ts","sourceRoot":"","sources":["../../../source/modes/companion/output-classifier.test.ts"],"names":[],"mappings":""}

package/dist/modes/companion/output-classifier.test.js

@@ -0,0 +1,133 @@
+import test from 'ava';
+import { classifyOutputType, shouldSummarize, getSummarizationPrompt, } from './output-classifier.js';
+// Helper to create a test entry
+function createEntry(command, output = '', exitCode = 0) {
+    return {
+        command,
+        output,
+        exitCode,
+        timestamp: Date.now(),
+        outputLines: output.split('\n').length,
+    };
+}
+// classifyOutputType tests
+test('classifies npm test as test_results', t => {
+    const entry = createEntry('npm test', 'PASS');
+    t.is(classifyOutputType(entry), 'test_results');
+});
+test('classifies yarn test as test_results', t => {
+    const entry = createEntry('yarn test', 'PASS');
+    t.is(classifyOutputType(entry), 'test_results');
+});
+test('classifies jest as test_results', t => {
+    const entry = createEntry('jest --coverage', 'PASS');
+    t.is(classifyOutputType(entry), 'test_results');
+});
+test('classifies vitest as test_results', t => {
+    const entry = createEntry('vitest run', 'PASS');
+    t.is(classifyOutputType(entry), 'test_results');
+});
+test('classifies ava as test_results', t => {
+    const entry = createEntry('ava', 'PASS');
+    t.is(classifyOutputType(entry), 'test_results');
+});
+test('classifies npm run build as build_output', t => {
+    const entry = createEntry('npm run build', 'Building...');
+    t.is(classifyOutputType(entry), 'build_output');
+});
+test('classifies tsc as build_output', t => {
+    const entry = createEntry('tsc', 'Compiling...');
+    t.is(classifyOutputType(entry), 'build_output');
+});
+test('classifies webpack as build_output', t => {
+    const entry = createEntry('webpack --mode production', 'Building...');
+    t.is(classifyOutputType(entry), 'build_output');
+});
+test('classifies git commands as git_output', t => {
+    const entry = createEntry('git status', 'On branch main');
+    t.is(classifyOutputType(entry), 'git_output');
+});
+test('classifies git diff as git_output', t => {
+    const entry = createEntry('git diff HEAD~1', '+new line');
+    t.is(classifyOutputType(entry), 'git_output');
+});
+test('classifies npm install as npm_output', t => {
+    const entry = createEntry('npm install lodash', 'installed');
+    t.is(classifyOutputType(entry), 'npm_output');
+});
+test('classifies yarn add as npm_output', t => {
+    const entry = createEntry('yarn add lodash', 'installed');
+    t.is(classifyOutputType(entry), 'npm_output');
+});
+test('classifies pnpm as npm_output', t => {
+    const entry = createEntry('pnpm install', 'installed');
+    t.is(classifyOutputType(entry), 'npm_output');
+});
+test('classifies failed command as error_output', t => {
+    const entry = createEntry('unknown', 'error', 1);
+    t.is(classifyOutputType(entry), 'error_output');
+});
+test('classifies unknown success as general', t => {
+    const entry = createEntry('echo hello', 'hello', 0);
+    t.is(classifyOutputType(entry), 'general');
+});
+test('classification is case insensitive', t => {
+    const entry = createEntry('NPM TEST', 'PASS');
+    t.is(classifyOutputType(entry), 'test_results');
+});
+// shouldSummarize tests
+test('shouldSummarize returns false for small output', t => {
+    const entry = createEntry('cmd', 'small output', 0);
+    t.false(shouldSummarize(entry));
+});
+test('shouldSummarize returns false for simple commands', t => {
+    const entry = createEntry('cd /path', '\n'.repeat(100), 0);
+    entry.outputLines = 100;
+    t.false(shouldSummarize(entry));
+});
+test('shouldSummarize returns false for pwd', t => {
+    const entry = createEntry('pwd', '\n'.repeat(100), 0);
+    entry.outputLines = 100;
+    t.false(shouldSummarize(entry));
+});
+test('shouldSummarize returns false for echo', t => {
+    const entry = createEntry('echo hello', '\n'.repeat(100), 0);
+    entry.outputLines = 100;
+    t.false(shouldSummarize(entry));
+});
+test('shouldSummarize returns true for large output', t => {
+    const entry = createEntry('npm test', '\n'.repeat(100), 0);
+    entry.outputLines = 100;
+    t.true(shouldSummarize(entry));
+});
+test('shouldSummarize threshold is 50 lines', t => {
+    const entry49 = createEntry('npm test', '\n'.repeat(49), 0);
+    entry49.outputLines = 49;
+    const entry50 = createEntry('npm test', '\n'.repeat(50), 0);
+    entry50.outputLines = 50;
+    t.false(shouldSummarize(entry49));
+    t.true(shouldSummarize(entry50));
+});
+// getSummarizationPrompt tests
+test('getSummarizationPrompt returns prompt for test_results', t => {
+    const prompt = getSummarizationPrompt('test_results');
+    t.true(prompt.includes('test results'));
+});
+test('getSummarizationPrompt returns prompt for build_output', t => {
+    const prompt = getSummarizationPrompt('build_output');
+    t.true(prompt.includes('build'));
+});
+test('getSummarizationPrompt returns prompt for git_output', t => {
+    const prompt = getSummarizationPrompt('git_output');
+    t.true(prompt.includes('git'));
+});
+test('getSummarizationPrompt returns prompt for error_output', t => {
+    const prompt = getSummarizationPrompt('error_output');
+    t.true(prompt.includes('error'));
+});
+test('getSummarizationPrompt returns prompt for general', t => {
+    const prompt = getSummarizationPrompt('general');
+    t.truthy(prompt);
+    t.true(prompt.includes('Summarize'));
+});
+//# sourceMappingURL=output-classifier.test.js.map

package/dist/modes/companion/output-classifier.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-classifier.test.js","sourceRoot":"","sources":["../../../source/modes/companion/output-classifier.test.ts"],"names":[],"mappings":"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"}

package/dist/modes/companion/pty-wrapper.d.ts

@@ -0,0 +1,46 @@
+import { EventEmitter } from 'events';
+import type { ILoggingService } from '../../services/service-interfaces.js';
+export interface PTYWrapperOptions {
+    logger: ILoggingService;
+    shell?: string;
+    cwd?: string;
+    env?: NodeJS.ProcessEnv;
+}
+export interface PTYWrapperEvents {
+    output: (data: string) => void;
+    exit: (exitCode: number, signal?: number) => void;
+    error: (error: Error) => void;
+}
+/**
+ * PTY Wrapper for companion mode.
+ * Spawns user's shell in a PTY, intercepting I/O for context building.
+ */
+export declare class PTYWrapper extends EventEmitter {
+    #private;
+    constructor(options: PTYWrapperOptions);
+    /**
+     * Start the PTY with the user's shell.
+     */
+    start(): void;
+    /**
+     * Write data to the PTY.
+     */
+    write(data: string): void;
+    /**
+     * Resize the PTY.
+     */
+    resize(cols: number, rows: number): void;
+    /**
+     * Stop the PTY.
+     */
+    stop(): void;
+    /**
+     * Check if PTY is running.
+     */
+    get isRunning(): boolean;
+    /**
+     * Get the PTY process ID.
+     */
+    get pid(): number | undefined;
+}
+//# sourceMappingURL=pty-wrapper.d.ts.map

package/dist/modes/companion/pty-wrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pty-wrapper.d.ts","sourceRoot":"","sources":["../../../source/modes/companion/pty-wrapper.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,YAAY,EAAC,MAAM,QAAQ,CAAC;AACpC,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,sCAAsC,CAAC;AAE1E,MAAM,WAAW,iBAAiB;IAC9B,MAAM,EAAE,eAAe,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC7B,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,IAAI,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAClD,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACjC;AAID;;;GAGG;AACH,qBAAa,UAAW,SAAQ,YAAY;;gBAS5B,OAAO,EAAE,iBAAiB;IAQtC;;OAEG;IACH,KAAK,IAAI,IAAI;IA4Db;;OAEG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAQzB;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAQxC;;OAEG;IACH,IAAI,IAAI,IAAI;IAUZ;;OAEG;IACH,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED;;OAEG;IACH,IAAI,GAAG,IAAI,MAAM,GAAG,SAAS,CAE5B;CA0BJ"}

package/dist/modes/companion/pty-wrapper.js

@@ -0,0 +1,143 @@
+import * as pty from 'node-pty';
+import { EventEmitter } from 'events';
+const MAX_RESTART_ATTEMPTS = 3;
+/**
+ * PTY Wrapper for companion mode.
+ * Spawns user's shell in a PTY, intercepting I/O for context building.
+ */
+export class PTYWrapper extends EventEmitter {
+    #pty = null;
+    #logger;
+    #shell;
+    #cwd;
+    #env;
+    #restartAttempts = 0;
+    #isStarted = false;
+    constructor(options) {
+        super();
+        this.#logger = options.logger;
+        this.#shell = options.shell || process.env.SHELL || '/bin/bash';
+        this.#cwd = options.cwd || process.cwd();
+        this.#env = options.env || process.env;
+    }
+    /**
+     * Start the PTY with the user's shell.
+     */
+    start() {
+        if (this.#isStarted) {
+            this.#logger.warn('PTY already started');
+            return;
+        }
+        try {
+            const cols = process.stdout.columns || 80;
+            const rows = process.stdout.rows || 24;
+            this.#pty = pty.spawn(this.#shell, [], {
+                name: 'xterm-256color',
+                cols,
+                rows,
+                cwd: this.#cwd,
+                // Filter out undefined env values for type safety
+                env: Object.fromEntries(Object.entries(this.#env)
+                    .filter((entry) => entry[1] !== undefined)),
+            });
+            this.#isStarted = true;
+            this.#restartAttempts = 0;
+            this.#logger.info('PTY started', {
+                shell: this.#shell,
+                cwd: this.#cwd,
+                cols,
+                rows,
+                pid: this.#pty.pid,
+            });
+            // Handle output from PTY
+            this.#pty.onData((data) => {
+                this.emit('output', data);
+            });
+            // Handle PTY exit
+            this.#pty.onExit(({ exitCode, signal }) => {
+                this.#isStarted = false;
+                this.#logger.info('PTY exited', { exitCode, signal });
+                this.emit('exit', exitCode, signal);
+                // Attempt restart if unexpected exit
+                if (exitCode !== 0) {
+                    this.#handleUnexpectedExit(exitCode, signal);
+                }
+            });
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            this.#logger.error('Failed to spawn PTY', {
+                error: errorMessage,
+                shell: this.#shell,
+            });
+            this.emit('error', new Error(`Could not start shell: ${this.#shell}`));
+        }
+    }
+    /**
+     * Write data to the PTY.
+     */
+    write(data) {
+        if (!this.#pty) {
+            this.#logger.warn('Cannot write to PTY: not started');
+            return;
+        }
+        this.#pty.write(data);
+    }
+    /**
+     * Resize the PTY.
+     */
+    resize(cols, rows) {
+        if (!this.#pty) {
+            return;
+        }
+        this.#pty.resize(cols, rows);
+        this.#logger.debug('PTY resized', { cols, rows });
+    }
+    /**
+     * Stop the PTY.
+     */
+    stop() {
+        if (!this.#pty) {
+            return;
+        }
+        this.#pty.kill();
+        this.#pty = null;
+        this.#isStarted = false;
+        this.#logger.info('PTY stopped');
+    }
+    /**
+     * Check if PTY is running.
+     */
+    get isRunning() {
+        return this.#isStarted && this.#pty !== null;
+    }
+    /**
+     * Get the PTY process ID.
+     */
+    get pid() {
+        return this.#pty?.pid;
+    }
+    /**
+     * Handle unexpected PTY exit with restart logic.
+     */
+    #handleUnexpectedExit(exitCode, signal) {
+        if (this.#restartAttempts >= MAX_RESTART_ATTEMPTS) {
+            this.#logger.error('PTY crashed repeatedly, giving up', {
+                attempts: this.#restartAttempts,
+            });
+            this.emit('error', new Error('Shell crashed repeatedly'));
+            return;
+        }
+        this.#restartAttempts++;
+        this.#logger.warn('PTY exited unexpectedly, attempting restart', {
+            exitCode,
+            signal,
+            attempt: this.#restartAttempts,
+        });
+        // Wait a bit before restarting
+        setTimeout(() => {
+            this.start();
+        }, 500);
+    }
+}
+//# sourceMappingURL=pty-wrapper.js.map

package/dist/modes/companion/pty-wrapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pty-wrapper.js","sourceRoot":"","sources":["../../../source/modes/companion/pty-wrapper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAChC,OAAO,EAAC,YAAY,EAAC,MAAM,QAAQ,CAAC;AAgBpC,MAAM,oBAAoB,GAAG,CAAC,CAAC;AAE/B;;;GAGG;AACH,MAAM,OAAO,UAAW,SAAQ,YAAY;IACxC,IAAI,GAAoB,IAAI,CAAC;IAC7B,OAAO,CAAkB;IACzB,MAAM,CAAS;IACf,IAAI,CAAS;IACb,IAAI,CAAoB;IACxB,gBAAgB,GAAG,CAAC,CAAC;IACrB,UAAU,GAAG,KAAK,CAAC;IAEnB,YAAY,OAA0B;QAClC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;QAC9B,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,WAAW,CAAC;QAChE,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QACzC,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,KAAK;QACD,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YAClB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;YACzC,OAAO;QACX,CAAC;QAED,IAAI,CAAC;YACD,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC;YAC1C,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;YAEvC,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE;gBACnC,IAAI,EAAE,gBAAgB;gBACtB,IAAI;gBACJ,IAAI;gBACJ,GAAG,EAAE,IAAI,CAAC,IAAI;gBACd,kDAAkD;gBAClD,GAAG,EAAE,MAAM,CAAC,WAAW,CACnB,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;qBACpB,MAAM,CAAC,CAAC,KAAK,EAA6B,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAC5E;aACJ,CAAC,CAAC;YAEH,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;YACvB,IAAI,CAAC,gBAAgB,GAAG,CAAC,CAAC;YAE1B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE;gBAC7B,KAAK,EAAE,IAAI,CAAC,MAAM;gBAClB,GAAG,EAAE,IAAI,CAAC,IAAI;gBACd,IAAI;gBACJ,IAAI;gBACJ,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG;aACrB,CAAC,CAAC;YAEH,yBAAyB;YACzB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAY,EAAE,EAAE;gBAC9B,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;YAC9B,CAAC,CAAC,CAAC;YAEH,kBAAkB;YAClB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,EAAC,QAAQ,EAAE,MAAM,EAAC,EAAE,EAAE;gBACpC,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;gBACxB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,EAAC,QAAQ,EAAE,MAAM,EAAC,CAAC,CAAC;gBACpD,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;gBAEpC,qCAAqC;gBACrC,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;oBACjB,IAAI,CAAC,qBAAqB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;gBACjD,CAAC;YACL,CAAC,CAAC,CAAC;QACP,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACtB,MAAM,YAAY,GACd,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC3D,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,qBAAqB,EAAE;gBACtC,KAAK,EAAE,YAAY;gBACnB,KAAK,EAAE,IAAI,CAAC,MAAM;aACrB,CAAC,CAAC;YACH,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,KAAK,CAAC,0BAA0B,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAC3E,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAY;QACd,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACb,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;YACtD,OAAO;QACX,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,IAAY,EAAE,IAAY;QAC7B,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACb,OAAO;QACX,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC7B,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,aAAa,EAAE,EAAC,IAAI,EAAE,IAAI,EAAC,CAAC,CAAC;IACpD,CAAC;IAED;;OAEG;IACH,IAAI;QACA,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACb,OAAO;QACX,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;QACxB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,IAAI,SAAS;QACT,OAAO,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC;IACjD,CAAC;IAED;;OAEG;IACH,IAAI,GAAG;QACH,OAAO,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,qBAAqB,CAAC,QAAgB,EAAE,MAAe;QACnD,IAAI,IAAI,CAAC,gBAAgB,IAAI,oBAAoB,EAAE,CAAC;YAChD,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,mCAAmC,EAAE;gBACpD,QAAQ,EAAE,IAAI,CAAC,gBAAgB;aAClC,CAAC,CAAC;YACH,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC,CAAC;YAC1D,OAAO;QACX,CAAC;QAED,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACxB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,6CAA6C,EAAE;YAC7D,QAAQ;YACR,MAAM;YACN,OAAO,EAAE,IAAI,CAAC,gBAAgB;SACjC,CAAC,CAAC;QAEH,+BAA+B;QAC/B,UAAU,CAAC,GAAG,EAAE;YACZ,IAAI,CAAC,KAAK,EAAE,CAAC;QACjB,CAAC,EAAE,GAAG,CAAC,CAAC;IACZ,CAAC;CACJ"}

package/dist/modes/companion/safety-classifier.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Safety classifier for companion mode Auto commands.
+ *
+ * Classifies commands into safety levels:
+ * - GREEN: Safe, auto-approve
+ * - YELLOW: Potentially risky, show for confirmation
+ * - RED: Dangerous, block or require explicit approval
+ */
+export type SafetyLevel = 'green' | 'yellow' | 'red';
+export interface SafetyClassification {
+    level: SafetyLevel;
+    reason: string;
+    command: string;
+}
+/**
+ * Classify a command's safety level.
+ */
+export declare function classifyCommandSafety(command: string): SafetyClassification;
+/**
+ * Check if a command should be auto-approved.
+ */
+export declare function shouldAutoApprove(classification: SafetyClassification): boolean;
+/**
+ * Check if a command should be blocked.
+ */
+export declare function shouldBlock(classification: SafetyClassification): boolean;
+/**
+ * Get user-friendly description of safety level.
+ */
+export declare function getSafetyDescription(level: SafetyLevel): string;
+//# sourceMappingURL=safety-classifier.d.ts.map

package/dist/modes/companion/safety-classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safety-classifier.d.ts","sourceRoot":"","sources":["../../../source/modes/companion/safety-classifier.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;AAErD,MAAM,WAAW,oBAAoB;IACjC,KAAK,EAAE,WAAW,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACnB;AAoFD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,oBAAoB,CA2B3E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,cAAc,EAAE,oBAAoB,GAAG,OAAO,CAE/E;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,cAAc,EAAE,oBAAoB,GAAG,OAAO,CAEzE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAS/D"}

package/dist/modes/companion/safety-classifier.js

@@ -0,0 +1,140 @@
+/**
+ * Safety classifier for companion mode Auto commands.
+ *
+ * Classifies commands into safety levels:
+ * - GREEN: Safe, auto-approve
+ * - YELLOW: Potentially risky, show for confirmation
+ * - RED: Dangerous, block or require explicit approval
+ */
+// Patterns for dangerous operations (RED)
+const DANGEROUS_PATTERNS = [
+    { pattern: /\brm\s+(-rf?|--recursive)?\s*\/\s*$/i, reason: 'Recursive delete of root' },
+    { pattern: /\brm\s+(-rf?|--recursive)?\s*~\s*$/i, reason: 'Recursive delete of home' },
+    { pattern: /\brm\s+(-rf?|--recursive)?\s*\.\s*$/i, reason: 'Recursive delete of current directory' },
+    { pattern: /\bsudo\s+rm\b/i, reason: 'Sudo delete operation' },
+    { pattern: /\bsudo\s+dd\b/i, reason: 'Sudo disk write operation' },
+    { pattern: /\bmkfs\b/i, reason: 'Filesystem creation' },
+    { pattern: /\bformat\s+[a-z]:/i, reason: 'Drive format' },
+    { pattern: /\bshutdown\b/i, reason: 'System shutdown' },
+    { pattern: /\breboot\b/i, reason: 'System reboot' },
+    { pattern: /\bsystemctl\s+(stop|disable|mask)\b/i, reason: 'System service modification' },
+    { pattern: /\bchmod\s+777\b/i, reason: 'Overly permissive chmod' },
+    { pattern: /\bchown\s+-R\s+root\b/i, reason: 'Recursive chown to root' },
+    { pattern: />\s*\/dev\/(sd[a-z]|nvme|hd[a-z])/i, reason: 'Direct disk write' },
+    { pattern: /\bcurl\b.*\|\s*(bash|sh)\b/i, reason: 'Pipe remote script to shell' },
+    { pattern: /\bwget\b.*\|\s*(bash|sh)\b/i, reason: 'Pipe remote script to shell' },
+    { pattern: /\beval\s+.*\$\(/i, reason: 'Eval with command substitution' },
+    { pattern: /\bkill\s+-9\s+1\b/i, reason: 'Kill init process' },
+    { pattern: /\b:()\s*{\s*:\s*\|\s*:\s*&\s*}\s*;\s*:/i, reason: 'Fork bomb' },
+];
+// Patterns for risky operations (YELLOW)
+const RISKY_PATTERNS = [
+    { pattern: /\brm\s+(-r|-f|-rf)/i, reason: 'Recursive or forced delete' },
+    { pattern: /\bsudo\b/i, reason: 'Sudo command' },
+    { pattern: /\bgit\s+(push|force-push|reset\s+--hard)/i, reason: 'Git destructive operation' },
+    { pattern: /\bgit\s+checkout\s+--\s*\./i, reason: 'Git discard all changes' },
+    { pattern: /\bnpm\s+(publish|unpublish)/i, reason: 'npm publish operation' },
+    { pattern: /\bdocker\s+(rm|rmi|stop|kill)/i, reason: 'Docker destructive operation' },
+    { pattern: /\bchmod\s+[0-7]{3}/i, reason: 'Permission change' },
+    { pattern: /\bchown\b/i, reason: 'Ownership change' },
+    { pattern: />\s*[^|&]/i, reason: 'File overwrite redirection' },
+    { pattern: /\bmv\b.*\//i, reason: 'File move operation' },
+    { pattern: /\bcp\s+-r/i, reason: 'Recursive copy' },
+    { pattern: /\btar\s+.*-x/i, reason: 'Archive extraction' },
+    { pattern: /\bunzip\b/i, reason: 'Archive extraction' },
+    { pattern: /\bpip\s+install\b(?!.*--user)/i, reason: 'System-wide pip install' },
+    { pattern: /\bnpm\s+install\s+-g/i, reason: 'Global npm install' },
+    { pattern: /\bapt\s+(install|remove|purge)/i, reason: 'System package operation' },
+    { pattern: /\bbrew\s+(install|uninstall|remove)/i, reason: 'Homebrew package operation' },
+];
+// Patterns for safe operations (GREEN)
+const SAFE_PATTERNS = [
+    { pattern: /^\s*(ls|ll|la|dir)\b/i, reason: 'List files' },
+    { pattern: /^\s*cd\b/i, reason: 'Change directory' },
+    { pattern: /^\s*pwd\b/i, reason: 'Print working directory' },
+    { pattern: /^\s*echo\b/i, reason: 'Echo output' },
+    { pattern: /^\s*cat\b/i, reason: 'View file' },
+    { pattern: /^\s*head\b/i, reason: 'View file head' },
+    { pattern: /^\s*tail\b/i, reason: 'View file tail' },
+    { pattern: /^\s*less\b/i, reason: 'View file with pager' },
+    { pattern: /^\s*more\b/i, reason: 'View file with pager' },
+    { pattern: /^\s*grep\b/i, reason: 'Search text' },
+    { pattern: /^\s*find\b/i, reason: 'Find files' },
+    { pattern: /^\s*which\b/i, reason: 'Locate command' },
+    { pattern: /^\s*whereis\b/i, reason: 'Locate command' },
+    { pattern: /^\s*type\b/i, reason: 'Describe command' },
+    { pattern: /^\s*whoami\b/i, reason: 'Show current user' },
+    { pattern: /^\s*hostname\b/i, reason: 'Show hostname' },
+    { pattern: /^\s*date\b/i, reason: 'Show date' },
+    { pattern: /^\s*uptime\b/i, reason: 'Show uptime' },
+    { pattern: /^\s*df\b/i, reason: 'Show disk usage' },
+    { pattern: /^\s*du\b/i, reason: 'Show directory usage' },
+    { pattern: /^\s*free\b/i, reason: 'Show memory usage' },
+    { pattern: /^\s*top\b/i, reason: 'Show processes' },
+    { pattern: /^\s*ps\b/i, reason: 'Show processes' },
+    { pattern: /^\s*git\s+(status|log|diff|branch|show|stash\s+list)\b/i, reason: 'Git read-only' },
+    { pattern: /^\s*npm\s+(ls|list|outdated|audit|view|info)\b/i, reason: 'npm read-only' },
+    { pattern: /^\s*node\s+--version/i, reason: 'Version check' },
+    { pattern: /^\s*npm\s+--version/i, reason: 'Version check' },
+    { pattern: /^\s*python\s+--version/i, reason: 'Version check' },
+    { pattern: /^\s*npm\s+test\b/i, reason: 'Run tests' },
+    { pattern: /^\s*npm\s+run\s+(test|lint|check|build)\b/i, reason: 'Run npm script' },
+    { pattern: /^\s*npm\s+install\b(?!.*-g)/i, reason: 'Local npm install' },
+    { pattern: /^\s*yarn\s+(install|add)\b(?!.*--global)/i, reason: 'Local yarn install' },
+    { pattern: /^\s*pnpm\s+(install|add)\b(?!.*--global)/i, reason: 'Local pnpm install' },
+    { pattern: /^\s*pip\s+install\s+--user\b/i, reason: 'User pip install' },
+    { pattern: /^\s*pip\s+list\b/i, reason: 'pip read-only' },
+];
+/**
+ * Classify a command's safety level.
+ */
+export function classifyCommandSafety(command) {
+    const trimmed = command.trim();
+    // Check for dangerous patterns first (RED) - always takes precedence
+    for (const { pattern, reason } of DANGEROUS_PATTERNS) {
+        if (pattern.test(trimmed)) {
+            return { level: 'red', reason, command: trimmed };
+        }
+    }
+    // Check for risky patterns (YELLOW) - before safe patterns
+    // This ensures operations like redirects are caught even with safe base commands
+    for (const { pattern, reason } of RISKY_PATTERNS) {
+        if (pattern.test(trimmed)) {
+            return { level: 'yellow', reason, command: trimmed };
+        }
+    }
+    // Check for safe patterns (GREEN)
+    for (const { pattern, reason } of SAFE_PATTERNS) {
+        if (pattern.test(trimmed)) {
+            return { level: 'green', reason, command: trimmed };
+        }
+    }
+    // Default to YELLOW for unknown commands
+    return { level: 'yellow', reason: 'Unknown command', command: trimmed };
+}
+/**
+ * Check if a command should be auto-approved.
+ */
+export function shouldAutoApprove(classification) {
+    return classification.level === 'green';
+}
+/**
+ * Check if a command should be blocked.
+ */
+export function shouldBlock(classification) {
+    return classification.level === 'red';
+}
+/**
+ * Get user-friendly description of safety level.
+ */
+export function getSafetyDescription(level) {
+    switch (level) {
+        case 'green':
+            return 'Safe - will auto-execute';
+        case 'yellow':
+            return 'Needs confirmation';
+        case 'red':
+            return 'Blocked - potentially dangerous';
+    }
+}
+//# sourceMappingURL=safety-classifier.js.map

package/dist/modes/companion/safety-classifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safety-classifier.js","sourceRoot":"","sources":["../../../source/modes/companion/safety-classifier.ts"],"names":[],"mappings":"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"}

package/dist/modes/companion/safety-classifier.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=safety-classifier.test.d.ts.map

package/dist/modes/companion/safety-classifier.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safety-classifier.test.d.ts","sourceRoot":"","sources":["../../../source/modes/companion/safety-classifier.test.ts"],"names":[],"mappings":""}