@aaronsb/kg-cli 0.6.1

package/dist/lib/config.js

@@ -0,0 +1,537 @@
+"use strict";
+/**
+ * Configuration Manager for kg CLI
+ *
+ * Manages user configuration stored at ~/.config/kg/config.json
+ *
+ * ADR-054: OAuth 2.0 Authentication
+ * - All authentication uses personal OAuth clients (GitHub CLI-style)
+ * - Client credentials (client_id + client_secret) are long-lived
+ * - Fresh access tokens obtained on-demand via client credentials grant
+ * - JWT support removed (OAuth-only)
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigManager = void 0;
+exports.getConfig = getConfig;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+class ConfigManager {
+    constructor() {
+        // Use XDG config directory (~/.config/kg/)
+        const xdgConfig = process.env.XDG_CONFIG_HOME || path.join(os.homedir(), '.config');
+        this.configDir = path.join(xdgConfig, 'kg');
+        this.configPath = path.join(this.configDir, 'config.json');
+        this.config = this.load();
+    }
+    /**
+     * Get configuration directory path
+     */
+    getConfigDir() {
+        return this.configDir;
+    }
+    /**
+     * Get configuration file path
+     */
+    getConfigPath() {
+        return this.configPath;
+    }
+    /**
+     * Load configuration from disk
+     */
+    load() {
+        try {
+            if (fs.existsSync(this.configPath)) {
+                const data = fs.readFileSync(this.configPath, 'utf-8');
+                return JSON.parse(data);
+            }
+        }
+        catch (error) {
+            console.warn(`Warning: Failed to load config from ${this.configPath}:`, error);
+        }
+        // Return default config
+        return this.getDefaultConfig();
+    }
+    /**
+     * Get default configuration
+     */
+    getDefaultConfig() {
+        return {
+            api_url: 'http://localhost:8000',
+            backup_dir: path.join(os.homedir(), '.local', 'share', 'kg', 'backups'),
+            auto_approve: false, // ADR-014: Require manual approval by default
+            // ADR-029: Command aliases for shell compatibility
+            // Example: zsh users with 'alias cat=bat' can use this to prevent expansion conflicts
+            aliases: {
+                cat: ['bat'] // Allow 'kg bat' as alias for 'kg cat' (handles zsh cat→bat expansion)
+            },
+            // ADR-057: Display and search defaults
+            display: {
+                enableChafa: true, // Enable chafa if available
+                chafaScale: 0.3, // Default to 1/3 terminal width
+                chafaAlign: 'left', // Default to left alignment
+                chafaColors: '256' // Default to 256 colors for best compatibility
+            },
+            search: {
+                showEvidence: true, // Show evidence quotes by default
+                showImages: true // Display images inline by default
+            }
+        };
+    }
+    /**
+     * Save configuration to disk
+     */
+    save() {
+        try {
+            // Ensure config directory exists
+            if (!fs.existsSync(this.configDir)) {
+                fs.mkdirSync(this.configDir, { recursive: true });
+            }
+            // Write config file
+            fs.writeFileSync(this.configPath, JSON.stringify(this.config, null, 2), 'utf-8');
+        }
+        catch (error) {
+            throw new Error(`Failed to save config to ${this.configPath}: ${error}`);
+        }
+    }
+    /**
+     * Get entire configuration
+     */
+    getAll() {
+        return { ...this.config };
+    }
+    /**
+     * Get a configuration value by key (supports nested keys with dot notation)
+     */
+    get(key) {
+        const keys = key.split('.');
+        let value = this.config;
+        for (const k of keys) {
+            if (value && typeof value === 'object' && k in value) {
+                value = value[k];
+            }
+            else {
+                return undefined;
+            }
+        }
+        return value;
+    }
+    /**
+     * Set a configuration value by key (supports nested keys with dot notation)
+     */
+    set(key, value) {
+        const keys = key.split('.');
+        const lastKey = keys.pop();
+        let obj = this.config;
+        // Navigate to the nested object
+        for (const k of keys) {
+            if (!(k in obj) || typeof obj[k] !== 'object') {
+                obj[k] = {};
+            }
+            obj = obj[k];
+        }
+        obj[lastKey] = value;
+        this.save();
+    }
+    /**
+     * Delete a configuration key
+     */
+    delete(key) {
+        const keys = key.split('.');
+        const lastKey = keys.pop();
+        let obj = this.config;
+        // Navigate to the nested object
+        for (const k of keys) {
+            if (!(k in obj) || typeof obj[k] !== 'object') {
+                return; // Key doesn't exist
+            }
+            obj = obj[k];
+        }
+        delete obj[lastKey];
+        this.save();
+    }
+    /**
+     * Check if config file exists
+     */
+    exists() {
+        return fs.existsSync(this.configPath);
+    }
+    /**
+     * Initialize config with defaults and save
+     */
+    init() {
+        if (!this.exists()) {
+            this.config = this.getDefaultConfig();
+            this.save();
+        }
+    }
+    /**
+     * Reset configuration to defaults
+     */
+    reset() {
+        this.config = this.getDefaultConfig();
+        this.save();
+    }
+    /**
+     * Get API URL (from config or environment variable)
+     */
+    getApiUrl() {
+        return process.env.KG_API_URL || this.config.api_url || 'http://localhost:8000';
+    }
+    /**
+     * Get client ID (from config or environment variable)
+     */
+    getClientId() {
+        return process.env.KG_CLIENT_ID || this.config.username;
+    }
+    /**
+     * Get API key/secret (from config or environment variable)
+     */
+    getApiKey() {
+        return process.env.KG_API_KEY || this.config.secret;
+    }
+    /**
+     * Get backup directory (expands ~ to home directory)
+     */
+    getBackupDir() {
+        const dir = this.config.backup_dir || path.join(os.homedir(), '.local', 'share', 'kg', 'backups');
+        return dir.replace(/^~/, os.homedir());
+    }
+    /**
+     * Ensure backup directory exists
+     */
+    ensureBackupDir() {
+        const dir = this.getBackupDir();
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        return dir;
+    }
+    /**
+     * Get auto-approve setting (ADR-014)
+     */
+    getAutoApprove() {
+        return this.config.auto_approve ?? false;
+    }
+    /**
+     * Set auto-approve setting (ADR-014)
+     */
+    setAutoApprove(value) {
+        this.config.auto_approve = value;
+        this.save();
+    }
+    // ========== Authentication Methods (ADR-027, updated by ADR-054) ==========
+    /**
+     * Store OAuth client credentials (ADR-054 - personal OAuth clients)
+     *
+     * Stores long-lived client_id + client_secret for client credentials grant.
+     * This is the preferred authentication method for CLI tools.
+     *
+     * @param credentials OAuth client credentials
+     */
+    storeOAuthCredentials(credentials) {
+        this.set('auth.oauth_client_id', credentials.client_id);
+        this.set('auth.oauth_client_secret', credentials.client_secret);
+        this.set('auth.oauth_client_name', credentials.client_name);
+        this.set('auth.oauth_scopes', credentials.scopes);
+        this.set('auth.oauth_created_at', credentials.created_at);
+        this.set('auth.token_type', 'bearer');
+        if (credentials.username) {
+            this.set('auth.username', credentials.username);
+            this.set('username', credentials.username); // Backwards compatibility
+        }
+        // Clear any legacy fields
+        this.delete('auth.token');
+        this.delete('auth.access_token');
+        this.delete('auth.refresh_token');
+        this.delete('auth.expires_at');
+        this.delete('auth.client_id');
+        this.delete('auth.scope');
+    }
+    /**
+     * Get OAuth client credentials (ADR-054)
+     *
+     * @returns OAuth client credentials or null if not stored
+     */
+    getOAuthCredentials() {
+        const clientId = this.get('auth.oauth_client_id');
+        const clientSecret = this.get('auth.oauth_client_secret');
+        if (!clientId || !clientSecret) {
+            return null;
+        }
+        return {
+            client_id: clientId,
+            client_secret: clientSecret,
+            client_name: this.get('auth.oauth_client_name') || 'kg-cli',
+            scopes: this.get('auth.oauth_scopes') || [],
+            created_at: this.get('auth.oauth_created_at') || new Date().toISOString(),
+            username: this.get('auth.username')
+        };
+    }
+    /**
+     * Clear authentication token
+     */
+    clearAuthToken() {
+        this.delete('auth');
+    }
+    /**
+     * Check if user is authenticated (has OAuth client credentials)
+     *
+     * OAuth client credentials are long-lived and do not expire.
+     * Fresh access tokens are obtained on-demand via client credentials grant.
+     *
+     * @returns true if user has OAuth client credentials
+     */
+    isAuthenticated() {
+        return this.getOAuthCredentials() !== null;
+    }
+    // ========== Alias Methods (ADR-029) ==========
+    /**
+     * Get command aliases from config
+     *
+     * @returns Record mapping command names to their aliases
+     */
+    getAliases() {
+        return this.config.aliases ?? {};
+    }
+    /**
+     * Get aliases for a specific command
+     *
+     * @param commandName Name of the command
+     * @returns Array of aliases for this command
+     */
+    getCommandAliases(commandName) {
+        return this.config.aliases?.[commandName] ?? [];
+    }
+    /**
+     * Add an alias for a command
+     *
+     * @param commandName Name of the command
+     * @param alias Alias to add
+     */
+    addAlias(commandName, alias) {
+        if (!this.config.aliases) {
+            this.config.aliases = {};
+        }
+        if (!this.config.aliases[commandName]) {
+            this.config.aliases[commandName] = [];
+        }
+        if (!this.config.aliases[commandName].includes(alias)) {
+            this.config.aliases[commandName].push(alias);
+            this.save();
+        }
+    }
+    /**
+     * Remove an alias for a command
+     *
+     * @param commandName Name of the command
+     * @param alias Alias to remove
+     */
+    removeAlias(commandName, alias) {
+        if (!this.config.aliases?.[commandName]) {
+            return;
+        }
+        const index = this.config.aliases[commandName].indexOf(alias);
+        if (index !== -1) {
+            this.config.aliases[commandName].splice(index, 1);
+            // Clean up empty arrays
+            if (this.config.aliases[commandName].length === 0) {
+                delete this.config.aliases[commandName];
+            }
+            this.save();
+        }
+    }
+    // ========== Display Methods (ADR-057) ==========
+    /**
+     * Check if chafa terminal image display is enabled
+     * If not explicitly set, defaults to true (will check for chafa availability at runtime)
+     *
+     * @returns true if chafa display is enabled in config
+     */
+    isChafaEnabled() {
+        return this.config.display?.enableChafa ?? true;
+    }
+    /**
+     * Enable or disable chafa terminal image display
+     *
+     * @param enabled Whether to enable chafa
+     */
+    setChafaEnabled(enabled) {
+        if (!this.config.display) {
+            this.config.display = {};
+        }
+        this.config.display.enableChafa = enabled;
+        this.save();
+    }
+    /**
+     * Get chafa display width
+     *
+     * @returns Width in characters, or undefined for auto-sizing
+     */
+    getChafaWidth() {
+        return this.config.display?.chafaWidth;
+    }
+    /**
+     * Set chafa display width
+     *
+     * @param width Width in characters (undefined for auto)
+     */
+    setChafaWidth(width) {
+        if (!this.config.display) {
+            this.config.display = {};
+        }
+        this.config.display.chafaWidth = width;
+        this.save();
+    }
+    /**
+     * Get chafa color mode
+     *
+     * @returns Color mode ('256', '16', '2', or 'full')
+     */
+    getChafaColors() {
+        return this.config.display?.chafaColors ?? '256';
+    }
+    /**
+     * Set chafa color mode
+     *
+     * @param colors Color mode
+     */
+    setChafaColors(colors) {
+        if (!this.config.display) {
+            this.config.display = {};
+        }
+        this.config.display.chafaColors = colors;
+        this.save();
+    }
+    /**
+     * Get chafa scale factor
+     *
+     * @returns Scale factor (0.0-1.0, e.g., 0.3 for 1/3 width)
+     */
+    getChafaScale() {
+        return this.config.display?.chafaScale ?? 0.3;
+    }
+    /**
+     * Set chafa scale factor
+     *
+     * @param scale Scale factor (0.0-1.0)
+     */
+    setChafaScale(scale) {
+        if (!this.config.display) {
+            this.config.display = {};
+        }
+        this.config.display.chafaScale = scale;
+        this.save();
+    }
+    /**
+     * Get chafa alignment
+     *
+     * @returns Alignment ('left', 'center', or 'right')
+     */
+    getChafaAlign() {
+        return this.config.display?.chafaAlign ?? 'left';
+    }
+    /**
+     * Set chafa alignment
+     *
+     * @param align Alignment
+     */
+    setChafaAlign(align) {
+        if (!this.config.display) {
+            this.config.display = {};
+        }
+        this.config.display.chafaAlign = align;
+        this.save();
+    }
+    // ========== Search Methods (ADR-057) ==========
+    /**
+     * Check if search should show evidence by default
+     * Defaults to true for rich terminal experience
+     *
+     * @returns true if evidence should be shown by default
+     */
+    getSearchShowEvidence() {
+        return this.config.search?.showEvidence ?? true;
+    }
+    /**
+     * Set whether search should show evidence by default
+     *
+     * @param enabled Whether to show evidence by default
+     */
+    setSearchShowEvidence(enabled) {
+        if (!this.config.search) {
+            this.config.search = {};
+        }
+        this.config.search.showEvidence = enabled;
+        this.save();
+    }
+    /**
+     * Check if search should show images by default
+     * Defaults to true for rich terminal experience
+     *
+     * @returns true if images should be shown by default
+     */
+    getSearchShowImages() {
+        return this.config.search?.showImages ?? true;
+    }
+    /**
+     * Set whether search should show images by default
+     *
+     * @param enabled Whether to show images by default
+     */
+    setSearchShowImages(enabled) {
+        if (!this.config.search) {
+            this.config.search = {};
+        }
+        this.config.search.showImages = enabled;
+        this.save();
+    }
+}
+exports.ConfigManager = ConfigManager;
+/**
+ * Global config instance
+ */
+let globalConfig = null;
+/**
+ * Get or create global config instance
+ */
+function getConfig() {
+    if (!globalConfig) {
+        globalConfig = new ConfigManager();
+    }
+    return globalConfig;
+}
+//# sourceMappingURL=config.js.map

package/dist/lib/config.js.map

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

package/dist/lib/job-stream.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Server-Sent Events (SSE) job progress streaming (ADR-018 Phase 1)
+ *
+ * Provides real-time job progress updates via EventSource API.
+ * Gracefully falls back to polling if SSE fails.
+ */
+import type { JobProgress, JobResult } from '../types';
+export interface JobProgressCallbacks {
+    onProgress?: (progress: JobProgress) => void;
+    onCompleted?: (result: JobResult) => void;
+    onFailed?: (error: string) => void;
+    onCancelled?: (message: string) => void;
+    onError?: (error: Error) => void;
+}
+export declare class JobProgressStream {
+    private baseUrl;
+    private jobId;
+    private callbacks;
+    private eventSource;
+    private closed;
+    constructor(baseUrl: string, jobId: string, callbacks: JobProgressCallbacks);
+    /**
+     * Start streaming job progress events.
+     *
+     * Opens SSE connection to /jobs/{job_id}/stream endpoint.
+     * Auto-closes on terminal events (completed/failed/cancelled).
+     */
+    start(): void;
+    /**
+     * Close the SSE connection.
+     *
+     * Safe to call multiple times.
+     */
+    close(): void;
+    /**
+     * Check if stream is currently active.
+     */
+    isActive(): boolean;
+}
+/**
+ * Track job progress with automatic SSE fallback to polling.
+ *
+ * Tries SSE first for real-time updates. If SSE fails or is unavailable,
+ * gracefully falls back to polling-based tracking.
+ *
+ * @param baseUrl - API base URL (e.g., http://localhost:8000)
+ * @param jobId - Job ID to track
+ * @param callbacks - Progress callbacks
+ * @param useSSE - Whether to try SSE (default: true)
+ * @returns JobProgressStream instance or null if using polling
+ */
+export declare function trackJobProgress(baseUrl: string, jobId: string, callbacks: JobProgressCallbacks, useSSE?: boolean): Promise<JobProgressStream | null>;
+//# sourceMappingURL=job-stream.d.ts.map

package/dist/lib/job-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-stream.d.ts","sourceRoot":"","sources":["../../src/lib/job-stream.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAMvD,MAAM,WAAW,oBAAoB;IACnC,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,WAAW,KAAK,IAAI,CAAC;IAC7C,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,IAAI,CAAC;IAC1C,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC;AAED,qBAAa,iBAAiB;IAK1B,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,SAAS;IANnB,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,MAAM,CAAS;gBAGb,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,oBAAoB;IAGzC;;;;;OAKG;IACH,KAAK,IAAI,IAAI;IA8Eb;;;;OAIG;IACH,KAAK,IAAI,IAAI;IAQb;;OAEG;IACH,QAAQ,IAAI,OAAO;CAGpB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,oBAAoB,EAC/B,MAAM,GAAE,OAAc,GACrB,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAgBnC"}