@phuetz/code-buddy 0.1.18 → 0.1.20

package/dist/utils/output-schema-validator.js

@@ -0,0 +1,137 @@
+/**
+ * Output Schema Validator
+ *
+ * Validates headless mode JSON output against a JSON Schema file (draft-07 subset).
+ * Supports: type, properties, required, enum, pattern, minLength, maxLength,
+ * minimum, maximum, items, additionalProperties.
+ *
+ * No external dependencies - uses basic manual JSON Schema validation.
+ */
+import fs from 'fs';
+import path from 'path';
+/**
+ * Load and parse a JSON Schema file from disk.
+ */
+export function loadSchema(schemaPath) {
+    const resolved = path.resolve(schemaPath);
+    const content = fs.readFileSync(resolved, 'utf-8');
+    return JSON.parse(content);
+}
+/**
+ * Validate a value against a JSON Schema (draft-07 subset).
+ */
+function validateValue(value, schema, path) {
+    const errors = [];
+    // Type check
+    if (schema.type !== undefined) {
+        const types = Array.isArray(schema.type) ? schema.type : [schema.type];
+        const actualType = getJSONType(value);
+        if (!types.includes(actualType)) {
+            errors.push(`${path}: expected type ${types.join(' | ')}, got ${actualType}`);
+            return errors; // No point checking further if type is wrong
+        }
+    }
+    // Enum check
+    if (schema.enum !== undefined) {
+        if (!schema.enum.some(e => JSON.stringify(e) === JSON.stringify(value))) {
+            errors.push(`${path}: value ${JSON.stringify(value)} not in enum [${schema.enum.map(e => JSON.stringify(e)).join(', ')}]`);
+        }
+    }
+    // String-specific checks
+    if (typeof value === 'string') {
+        if (schema.pattern !== undefined) {
+            const regex = new RegExp(schema.pattern);
+            if (!regex.test(value)) {
+                errors.push(`${path}: string "${value}" does not match pattern "${schema.pattern}"`);
+            }
+        }
+        if (schema.minLength !== undefined && value.length < schema.minLength) {
+            errors.push(`${path}: string length ${value.length} is less than minLength ${schema.minLength}`);
+        }
+        if (schema.maxLength !== undefined && value.length > schema.maxLength) {
+            errors.push(`${path}: string length ${value.length} exceeds maxLength ${schema.maxLength}`);
+        }
+    }
+    // Number-specific checks
+    if (typeof value === 'number') {
+        if (schema.minimum !== undefined && value < schema.minimum) {
+            errors.push(`${path}: value ${value} is less than minimum ${schema.minimum}`);
+        }
+        if (schema.maximum !== undefined && value > schema.maximum) {
+            errors.push(`${path}: value ${value} exceeds maximum ${schema.maximum}`);
+        }
+    }
+    // Object-specific checks
+    if (typeof value === 'object' && value !== null && !Array.isArray(value)) {
+        const obj = value;
+        // Required properties
+        if (schema.required) {
+            for (const req of schema.required) {
+                if (!(req in obj)) {
+                    errors.push(`${path}: missing required property "${req}"`);
+                }
+            }
+        }
+        // Validate properties
+        if (schema.properties) {
+            for (const [key, propSchema] of Object.entries(schema.properties)) {
+                if (key in obj) {
+                    errors.push(...validateValue(obj[key], propSchema, `${path}.${key}`));
+                }
+            }
+        }
+        // Additional properties check
+        if (schema.additionalProperties === false && schema.properties) {
+            const allowed = new Set(Object.keys(schema.properties));
+            for (const key of Object.keys(obj)) {
+                if (!allowed.has(key)) {
+                    errors.push(`${path}: unexpected additional property "${key}"`);
+                }
+            }
+        }
+    }
+    // Array-specific checks
+    if (Array.isArray(value)) {
+        if (schema.items) {
+            for (let i = 0; i < value.length; i++) {
+                errors.push(...validateValue(value[i], schema.items, `${path}[${i}]`));
+            }
+        }
+    }
+    return errors;
+}
+/**
+ * Get the JSON Schema type string for a value.
+ */
+function getJSONType(value) {
+    if (value === null)
+        return 'null';
+    if (Array.isArray(value))
+        return 'array';
+    return typeof value; // 'string' | 'number' | 'boolean' | 'object' | 'undefined'
+}
+/**
+ * Validate output against a JSON Schema file.
+ *
+ * @param output - The parsed output value to validate
+ * @param schemaPath - Path to the JSON Schema file
+ * @returns Validation result with errors array
+ */
+export function validateOutputSchema(output, schemaPath) {
+    try {
+        const schema = loadSchema(schemaPath);
+        const errors = validateValue(output, schema, '$');
+        return {
+            valid: errors.length === 0,
+            errors,
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            valid: false,
+            errors: [`Failed to load or parse schema: ${message}`],
+        };
+    }
+}
+//# sourceMappingURL=output-schema-validator.js.map

package/dist/utils/output-schema-validator.js.map

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

package/dist/utils/safety-misc.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Safety & Misc Utilities
+ *
+ * NestedLaunchGuard: prevents recursive CLI launches
+ * ConfigBackupManager: timestamped config file backups with pruning
+ * FeedbackCommand: pre-filled GitHub issue URL generation
+ */
+export declare class NestedLaunchGuard {
+    private envKey;
+    isNestedLaunch(): boolean;
+    setSessionMarker(sessionId: string): void;
+    getWarning(): string;
+}
+export declare class ConfigBackupManager {
+    createBackup(filePath: string): string;
+    listBackups(filePath: string): string[];
+    pruneBackups(filePath: string, keep?: number): string[];
+    restoreBackup(backupPath: string, targetPath: string): void;
+}
+export declare class FeedbackCommand {
+    getRepoUrl(): string;
+    generateIssueUrl(title?: string, body?: string): string;
+    formatFeedbackMessage(): string;
+}

package/dist/utils/safety-misc.js

@@ -0,0 +1,91 @@
+/**
+ * Safety & Misc Utilities
+ *
+ * NestedLaunchGuard: prevents recursive CLI launches
+ * ConfigBackupManager: timestamped config file backups with pruning
+ * FeedbackCommand: pre-filled GitHub issue URL generation
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { logger } from '../utils/logger.js';
+// ============================================================================
+// NestedLaunchGuard
+// ============================================================================
+export class NestedLaunchGuard {
+    envKey = 'CODEBUDDY_SESSION_ID';
+    isNestedLaunch() {
+        return !!process.env[this.envKey];
+    }
+    setSessionMarker(sessionId) {
+        process.env[this.envKey] = sessionId;
+        logger.debug(`Session marker set: ${sessionId}`);
+    }
+    getWarning() {
+        return 'Warning: You are launching Code Buddy inside an existing session. This may cause unexpected behavior. Use a separate terminal instead.';
+    }
+}
+// ============================================================================
+// ConfigBackupManager
+// ============================================================================
+export class ConfigBackupManager {
+    createBackup(filePath) {
+        const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+        const backupPath = `${filePath}.${timestamp}.bak`;
+        fs.copyFileSync(filePath, backupPath);
+        logger.info(`Backup created: ${backupPath}`);
+        return backupPath;
+    }
+    listBackups(filePath) {
+        const dir = path.dirname(filePath);
+        const base = path.basename(filePath);
+        if (!fs.existsSync(dir))
+            return [];
+        const files = fs.readdirSync(dir);
+        return files
+            .filter(f => f.startsWith(base + '.') && f.endsWith('.bak'))
+            .map(f => path.join(dir, f))
+            .sort();
+    }
+    pruneBackups(filePath, keep = 5) {
+        const backups = this.listBackups(filePath);
+        const toRemove = backups.slice(0, Math.max(0, backups.length - keep));
+        for (const bp of toRemove) {
+            fs.unlinkSync(bp);
+            logger.debug(`Pruned backup: ${bp}`);
+        }
+        return toRemove;
+    }
+    restoreBackup(backupPath, targetPath) {
+        fs.copyFileSync(backupPath, targetPath);
+        logger.info(`Restored ${backupPath} -> ${targetPath}`);
+    }
+}
+// ============================================================================
+// FeedbackCommand
+// ============================================================================
+export class FeedbackCommand {
+    getRepoUrl() {
+        return 'https://github.com/phuetz/code-buddy/issues/new';
+    }
+    generateIssueUrl(title, body) {
+        const base = this.getRepoUrl();
+        const params = new URLSearchParams();
+        if (title)
+            params.set('title', title);
+        if (body)
+            params.set('body', body);
+        const qs = params.toString();
+        return qs ? `${base}?${qs}` : base;
+    }
+    formatFeedbackMessage() {
+        return [
+            'We appreciate your feedback!',
+            '',
+            'To report a bug or request a feature, open a GitHub issue:',
+            `  ${this.getRepoUrl()}`,
+            '',
+            'Please include steps to reproduce and your environment details.',
+        ].join('\n');
+    }
+}
+//# sourceMappingURL=safety-misc.js.map

package/dist/utils/safety-misc.js.map

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

package/dist/utils/session-enhancements.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Session & Misc Enhancements
+ * Per-session settings, update channels, and elevated mode management.
+ */
+export declare class SessionPersistentSettings {
+    private static instance;
+    private sessions;
+    static getInstance(): SessionPersistentSettings;
+    static resetInstance(): void;
+    set(sessionId: string, key: string, value: unknown): void;
+    get(sessionId: string, key: string): unknown;
+    getAll(sessionId: string): Record<string, unknown>;
+    clear(sessionId: string): void;
+}
+export declare class UpdateChannelManager {
+    private static instance;
+    readonly channels: readonly ["stable", "beta", "dev"];
+    private currentChannel;
+    static getInstance(): UpdateChannelManager;
+    static resetInstance(): void;
+    getCurrentChannel(): string;
+    setChannel(channel: string): void;
+    getLatestVersion(channel: string): {
+        version: string;
+        channel: string;
+        date: string;
+    };
+    isValidChannel(channel: string): boolean;
+}
+export declare class ElevatedModeManager {
+    private static instance;
+    private elevated;
+    static getInstance(): ElevatedModeManager;
+    static resetInstance(): void;
+    isElevated(): boolean;
+    enable(): void;
+    disable(): void;
+    toggle(): boolean;
+    getWarning(): string;
+}

package/dist/utils/session-enhancements.js

@@ -0,0 +1,118 @@
+/**
+ * Session & Misc Enhancements
+ * Per-session settings, update channels, and elevated mode management.
+ */
+import { logger } from './logger.js';
+export class SessionPersistentSettings {
+    static instance = null;
+    sessions = new Map();
+    static getInstance() {
+        if (!SessionPersistentSettings.instance) {
+            SessionPersistentSettings.instance = new SessionPersistentSettings();
+        }
+        return SessionPersistentSettings.instance;
+    }
+    static resetInstance() {
+        SessionPersistentSettings.instance = null;
+    }
+    set(sessionId, key, value) {
+        if (!this.sessions.has(sessionId)) {
+            this.sessions.set(sessionId, new Map());
+        }
+        this.sessions.get(sessionId).set(key, value);
+        logger.debug(`Session ${sessionId}: set ${key}`);
+    }
+    get(sessionId, key) {
+        return this.sessions.get(sessionId)?.get(key);
+    }
+    getAll(sessionId) {
+        const map = this.sessions.get(sessionId);
+        if (!map)
+            return {};
+        const result = {};
+        for (const [k, v] of map) {
+            result[k] = v;
+        }
+        return result;
+    }
+    clear(sessionId) {
+        this.sessions.delete(sessionId);
+        logger.debug(`Session ${sessionId}: cleared`);
+    }
+}
+export class UpdateChannelManager {
+    static instance = null;
+    channels = ['stable', 'beta', 'dev'];
+    currentChannel = 'stable';
+    static getInstance() {
+        if (!UpdateChannelManager.instance) {
+            UpdateChannelManager.instance = new UpdateChannelManager();
+        }
+        return UpdateChannelManager.instance;
+    }
+    static resetInstance() {
+        UpdateChannelManager.instance = null;
+    }
+    getCurrentChannel() {
+        return this.currentChannel;
+    }
+    setChannel(channel) {
+        if (!this.isValidChannel(channel)) {
+            throw new Error(`Invalid channel: ${channel}. Must be one of: ${this.channels.join(', ')}`);
+        }
+        this.currentChannel = channel;
+        logger.debug(`Update channel set to: ${channel}`);
+    }
+    getLatestVersion(channel) {
+        if (!this.isValidChannel(channel)) {
+            throw new Error(`Invalid channel: ${channel}`);
+        }
+        // Stub implementation
+        const versions = {
+            stable: '1.0.0',
+            beta: '1.1.0-beta.1',
+            dev: '1.2.0-dev.1',
+        };
+        return {
+            version: versions[channel] || '0.0.0',
+            channel,
+            date: new Date().toISOString(),
+        };
+    }
+    isValidChannel(channel) {
+        return this.channels.includes(channel);
+    }
+}
+export class ElevatedModeManager {
+    static instance = null;
+    elevated = false;
+    static getInstance() {
+        if (!ElevatedModeManager.instance) {
+            ElevatedModeManager.instance = new ElevatedModeManager();
+        }
+        return ElevatedModeManager.instance;
+    }
+    static resetInstance() {
+        ElevatedModeManager.instance = null;
+    }
+    isElevated() {
+        return this.elevated;
+    }
+    enable() {
+        this.elevated = true;
+        logger.debug('Elevated mode enabled');
+    }
+    disable() {
+        this.elevated = false;
+        logger.debug('Elevated mode disabled');
+    }
+    toggle() {
+        this.elevated = !this.elevated;
+        logger.debug(`Elevated mode toggled to: ${this.elevated}`);
+        return this.elevated;
+    }
+    getWarning() {
+        return 'WARNING: Elevated mode bypasses safety confirmations. Use with caution.';
+    }
+}
+//# sourceMappingURL=session-enhancements.js.map

package/dist/utils/session-enhancements.js.map

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

package/dist/utils/shell-completions.js

@@ -72,7 +72,7 @@ function generateBashCompletion() {
     const modes = APPROVAL_MODES.join(' ');
     const themes = THEMES.join(' ');
     return `#!/bin/bash
-# Grok CLI Bash Completion
+# Code Buddy Bash Completion
 # Source this file or add to ~/.bashrc
 
 _codebuddy_completions() {
@@ -140,7 +140,7 @@ _codebuddy_theme_completions() {
     COMPREPLY=( $(compgen -W "\${themes}" -- "\${COMP_WORDS[COMP_CWORD]}") )
 }
 
-echo "Grok CLI bash completions loaded"
+echo "Code Buddy bash completions loaded"
 `;
 }
 // ============================================================================
@@ -162,7 +162,7 @@ function generateZshCompletion() {
     const modes = APPROVAL_MODES.join(' ');
     const themes = THEMES.join(' ');
     return `#compdef grok code-buddy
-# Grok CLI Zsh Completion
+# Code Buddy Zsh Completion
 # Save to ~/.zsh/completions/_codebuddy or /usr/local/share/zsh/site-functions/_codebuddy
 
 _codebuddy() {
@@ -245,7 +245,7 @@ function generateFishCompletion() {
         const desc = c.description.replace(/'/g, "\\'");
         return `complete -c grok -n '__fish_codebuddy_in_prompt' -a '${c.name}' -d '${desc}'`;
     }).join('\n');
-    return `# Grok CLI Fish Completion
+    return `# Code Buddy Fish Completion
 # Save to ~/.config/fish/completions/grok.fish
 
 # Helper function to detect if we're in the prompt context
@@ -293,7 +293,7 @@ function generatePowerShellCompletion() {
     const models = MODELS.map(m => `'${m}'`).join(', ');
     const modes = APPROVAL_MODES.map(m => `'${m}'`).join(', ');
     const themes = THEMES.map(t => `'${t}'`).join(', ');
-    return `# Grok CLI PowerShell Completion
+    return `# Code Buddy PowerShell Completion
 # Save to $PROFILE or run: grok --completions powershell | Out-File -Append $PROFILE
 
 $_codebuddyOptions = @(${CLI_OPTIONS.map(o => `'${o.name}'`).join(', ')})
@@ -375,7 +375,7 @@ Register-ArgumentCompleter -Native -CommandName grok, code-buddy -ScriptBlock {
         }
 }
 
-Write-Host "Grok CLI PowerShell completions loaded" -ForegroundColor Green
+Write-Host "Code Buddy PowerShell completions loaded" -ForegroundColor Green
 `;
 }
 // ============================================================================

package/dist/utils/shell-snapshot.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Shell Environment Snapshots
+ *
+ * Captures the user's shell environment for better context awareness.
+ * Includes shell type, env vars (filtered for safety), aliases, rc files,
+ * and common tool versions.
+ *
+ * Can be injected into the system prompt to help the agent understand
+ * the user's development environment.
+ */
+export interface ShellSnapshot {
+    /** Detected shell (bash, zsh, fish, sh) */
+    shell: string;
+    /** Filtered environment variables (safe ones only) */
+    env: Record<string, string>;
+    /** Parsed aliases from rc files */
+    aliases: string[];
+    /** Shell function names */
+    functions: string[];
+    /** Which rc files exist */
+    rcFiles: string[];
+    /** Node.js version */
+    nodeVersion?: string;
+    /** npm version */
+    npmVersion?: string;
+    /** Git version */
+    gitVersion?: string;
+    /** Python version */
+    pythonVersion?: string;
+}
+/**
+ * Capture a snapshot of the current shell environment.
+ */
+export declare function captureShellSnapshot(): Promise<ShellSnapshot>;
+/**
+ * Format a shell snapshot as a concise prompt string for system prompt injection.
+ */
+export declare function formatSnapshotForPrompt(snapshot: ShellSnapshot): string;