@brainfile/cli 0.11.1 → 0.12.0

package/dist/utils/auth-store.js

@@ -0,0 +1,308 @@
+"use strict";
+/**
+ * Authentication token storage for Brainfile CLI
+ *
+ * Stores tokens with the following priority:
+ * 1. System keychain (via keytar, if available)
+ * 2. Config file (~/.config/brainfile/auth.json)
+ * 3. Environment variables (read-only)
+ *
+ * @packageDocumentation
+ */
+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.authStore = exports.AuthStore = void 0;
+exports.getGitHubCLIToken = getGitHubCLIToken;
+exports.isGitHubCLIAvailable = isGitHubCLIAvailable;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const child_process_1 = require("child_process");
+const config_1 = require("./config");
+// ============================================================================
+// Constants
+// ============================================================================
+const SERVICE_NAME = 'brainfile';
+const AUTH_FILE = path.join((0, config_1.getConfigDir)(), 'auth.json');
+const ENV_VAR_MAP = {
+    github: ['GITHUB_TOKEN', 'GH_TOKEN'],
+    linear: ['LINEAR_API_KEY', 'LINEAR_TOKEN'],
+};
+// ============================================================================
+// Keytar Integration (Optional)
+// ============================================================================
+let keytar = null;
+let keytarChecked = false;
+/**
+ * Try to load keytar (system keychain integration)
+ * Returns null if keytar is not available
+ */
+function getKeytar() {
+    if (keytarChecked) {
+        return keytar;
+    }
+    keytarChecked = true;
+    try {
+        // Dynamic require to make keytar optional
+        keytar = require('keytar');
+        return keytar;
+    }
+    catch {
+        // keytar not installed or native module not built
+        return null;
+    }
+}
+// ============================================================================
+// GitHub CLI Integration
+// ============================================================================
+/**
+ * Try to get GitHub token from gh CLI
+ * @returns Token from gh CLI, or null if not available
+ */
+function getGitHubCLIToken() {
+    try {
+        const token = (0, child_process_1.execSync)('gh auth token', {
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+        if (token && token.length > 0) {
+            return token;
+        }
+    }
+    catch {
+        // gh CLI not installed or not authenticated
+    }
+    return null;
+}
+/**
+ * Check if gh CLI is installed and authenticated
+ */
+function isGitHubCLIAvailable() {
+    return getGitHubCLIToken() !== null;
+}
+// ============================================================================
+// Auth Store Class
+// ============================================================================
+class AuthStore {
+    /**
+     * Get a token for a provider
+     * Checks: env vars → keychain → config file → gh CLI (for github)
+     */
+    async get(provider) {
+        // 1. Check environment variables
+        const envToken = this.getFromEnv(provider);
+        if (envToken) {
+            return envToken;
+        }
+        // 2. Check system keychain
+        const kt = getKeytar();
+        if (kt) {
+            try {
+                const keychainToken = await kt.getPassword(SERVICE_NAME, provider);
+                if (keychainToken) {
+                    return keychainToken;
+                }
+            }
+            catch {
+                // Keychain access failed, continue to next option
+            }
+        }
+        // 3. Check config file
+        const fileToken = this.getFromFile(provider);
+        if (fileToken) {
+            return fileToken;
+        }
+        // 4. For GitHub, check gh CLI as last resort
+        if (provider === 'github') {
+            return getGitHubCLIToken();
+        }
+        return null;
+    }
+    /**
+     * Get stored token info (includes metadata like username)
+     */
+    async getTokenInfo(provider) {
+        // Check config file for metadata
+        const authData = this.loadAuthFile();
+        return authData[provider] || null;
+    }
+    /**
+     * Store a token for a provider
+     * Stores in: keychain (if available) AND config file (for metadata)
+     */
+    async set(provider, token, metadata) {
+        const storedToken = {
+            token,
+            savedAt: new Date().toISOString(),
+            ...metadata,
+        };
+        // 1. Try to store in keychain
+        const kt = getKeytar();
+        if (kt) {
+            try {
+                await kt.setPassword(SERVICE_NAME, provider, token);
+            }
+            catch {
+                // Keychain storage failed, will fall back to file
+            }
+        }
+        // 2. Store in config file (always, for metadata)
+        this.saveToFile(provider, storedToken);
+    }
+    /**
+     * Clear a token for a provider
+     */
+    async clear(provider) {
+        // 1. Remove from keychain
+        const kt = getKeytar();
+        if (kt) {
+            try {
+                await kt.deletePassword(SERVICE_NAME, provider);
+            }
+            catch {
+                // Ignore errors
+            }
+        }
+        // 2. Remove from config file
+        this.removeFromFile(provider);
+    }
+    /**
+     * Check if a provider is authenticated
+     */
+    async isAuthenticated(provider) {
+        const token = await this.get(provider);
+        return token !== null;
+    }
+    /**
+     * Get authentication status for all providers
+     */
+    async getStatus() {
+        const result = {
+            github: { authenticated: false },
+            linear: { authenticated: false },
+        };
+        for (const provider of ['github', 'linear']) {
+            // Check env first
+            if (this.getFromEnv(provider)) {
+                result[provider] = { authenticated: true, source: 'environment' };
+                continue;
+            }
+            // Check keychain
+            const kt = getKeytar();
+            if (kt) {
+                try {
+                    const token = await kt.getPassword(SERVICE_NAME, provider);
+                    if (token) {
+                        const info = await this.getTokenInfo(provider);
+                        result[provider] = {
+                            authenticated: true,
+                            source: 'keychain',
+                            username: info?.username,
+                        };
+                        continue;
+                    }
+                }
+                catch {
+                    // Continue to next check
+                }
+            }
+            // Check config file
+            const fileToken = this.getFromFile(provider);
+            if (fileToken) {
+                const info = await this.getTokenInfo(provider);
+                result[provider] = {
+                    authenticated: true,
+                    source: 'config',
+                    username: info?.username,
+                };
+                continue;
+            }
+            // For GitHub, check gh CLI
+            if (provider === 'github' && getGitHubCLIToken()) {
+                result[provider] = { authenticated: true, source: 'gh-cli' };
+            }
+        }
+        return result;
+    }
+    // ============================================================================
+    // Private Methods
+    // ============================================================================
+    getFromEnv(provider) {
+        const vars = ENV_VAR_MAP[provider];
+        for (const varName of vars) {
+            const value = process.env[varName];
+            if (value && value.length > 0) {
+                return value;
+            }
+        }
+        return null;
+    }
+    loadAuthFile() {
+        try {
+            if (fs.existsSync(AUTH_FILE)) {
+                const content = fs.readFileSync(AUTH_FILE, 'utf-8');
+                return JSON.parse(content);
+            }
+        }
+        catch {
+            // File corrupted or unreadable
+        }
+        return {};
+    }
+    saveAuthFile(data) {
+        (0, config_1.ensureConfigDir)();
+        fs.writeFileSync(AUTH_FILE, JSON.stringify(data, null, 2), {
+            encoding: 'utf-8',
+            mode: 0o600, // Owner read/write only
+        });
+    }
+    getFromFile(provider) {
+        const data = this.loadAuthFile();
+        return data[provider]?.token || null;
+    }
+    saveToFile(provider, tokenInfo) {
+        const data = this.loadAuthFile();
+        data[provider] = tokenInfo;
+        this.saveAuthFile(data);
+    }
+    removeFromFile(provider) {
+        const data = this.loadAuthFile();
+        delete data[provider];
+        this.saveAuthFile(data);
+    }
+}
+exports.AuthStore = AuthStore;
+// Export singleton instance
+exports.authStore = new AuthStore();
+//# sourceMappingURL=auth-store.js.map

package/dist/utils/auth-store.js.map

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

package/dist/utils/config.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Configuration file management for Brainfile CLI
+ *
+ * Handles reading/writing ~/.config/brainfile/config.json for:
+ * - Archive destination defaults
+ * - GitHub connection details (owner, repo)
+ * - Linear connection details (teamId)
+ * - User preferences
+ *
+ * @packageDocumentation
+ */
+export interface GitHubConfig {
+    /** GitHub repository owner (username or org) */
+    owner?: string;
+    /** GitHub repository name */
+    repo?: string;
+    /** Extra labels to add to archived issues */
+    labels?: string[];
+}
+export interface LinearConfig {
+    /** Linear team ID */
+    teamId?: string;
+    /** Linear project ID (optional) */
+    projectId?: string;
+}
+export interface ArchiveConfig {
+    /** Default archive destination: 'local' | 'github' | 'linear' */
+    default?: 'local' | 'github' | 'linear';
+    /** GitHub-specific settings */
+    github?: GitHubConfig;
+    /** Linear-specific settings */
+    linear?: LinearConfig;
+}
+export interface BrainfileConfig {
+    /** Archive configuration */
+    archive?: ArchiveConfig;
+}
+/**
+ * Get the path to the config directory
+ */
+export declare function getConfigDir(): string;
+/**
+ * Get the path to the config file
+ */
+export declare function getConfigPath(): string;
+/**
+ * Ensure the config directory exists
+ */
+export declare function ensureConfigDir(): void;
+/**
+ * Load the config file
+ * @returns Config object, or empty object if file doesn't exist
+ */
+export declare function loadConfig(): BrainfileConfig;
+/**
+ * Save the config file
+ * @param config - Config object to save
+ */
+export declare function saveConfig(config: BrainfileConfig): void;
+/**
+ * Update specific config values (merges with existing)
+ * @param updates - Partial config to merge
+ */
+export declare function updateConfig(updates: Partial<BrainfileConfig>): BrainfileConfig;
+/**
+ * Get archive configuration with defaults
+ */
+export declare function getArchiveConfig(): ArchiveConfig;
+/**
+ * Set archive default destination
+ */
+export declare function setArchiveDefault(destination: 'local' | 'github' | 'linear'): void;
+/**
+ * Set GitHub configuration
+ */
+export declare function setGitHubConfig(github: GitHubConfig): void;
+/**
+ * Set Linear configuration
+ */
+export declare function setLinearConfig(linear: LinearConfig): void;
+/**
+ * Get the effective archive destination
+ * Priority: brainfile.md archive.destination > config default > 'local'
+ *
+ * @param brainfileDestination - Destination from brainfile.md (if any)
+ * @returns The effective destination
+ */
+export declare function getEffectiveArchiveDestination(brainfileDestination?: string): 'local' | 'github' | 'linear';
+//# sourceMappingURL=config.d.ts.map

package/dist/utils/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAUH,MAAM,WAAW,YAAY;IAC3B,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6BAA6B;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,qBAAqB;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,iEAAiE;IACjE,OAAO,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACxC,+BAA+B;IAC/B,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,+BAA+B;IAC/B,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,4BAA4B;IAC5B,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB;AAaD;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAItC;AAED;;;GAGG;AACH,wBAAgB,UAAU,IAAI,eAAe,CAW5C;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAMxD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,eAAe,CAK/E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,CAGhD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,IAAI,CAKlF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAK1D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAK1D;AAED;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAC5C,oBAAoB,CAAC,EAAE,MAAM,GAC5B,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAc/B"}

package/dist/utils/config.js

@@ -0,0 +1,211 @@
+"use strict";
+/**
+ * Configuration file management for Brainfile CLI
+ *
+ * Handles reading/writing ~/.config/brainfile/config.json for:
+ * - Archive destination defaults
+ * - GitHub connection details (owner, repo)
+ * - Linear connection details (teamId)
+ * - User preferences
+ *
+ * @packageDocumentation
+ */
+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.getConfigDir = getConfigDir;
+exports.getConfigPath = getConfigPath;
+exports.ensureConfigDir = ensureConfigDir;
+exports.loadConfig = loadConfig;
+exports.saveConfig = saveConfig;
+exports.updateConfig = updateConfig;
+exports.getArchiveConfig = getArchiveConfig;
+exports.setArchiveDefault = setArchiveDefault;
+exports.setGitHubConfig = setGitHubConfig;
+exports.setLinearConfig = setLinearConfig;
+exports.getEffectiveArchiveDestination = getEffectiveArchiveDestination;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+// ============================================================================
+// Constants
+// ============================================================================
+const CONFIG_DIR = path.join(os.homedir(), '.config', 'brainfile');
+const CONFIG_FILE = path.join(CONFIG_DIR, 'config.json');
+// ============================================================================
+// Config Functions
+// ============================================================================
+/**
+ * Get the path to the config directory
+ */
+function getConfigDir() {
+    return CONFIG_DIR;
+}
+/**
+ * Get the path to the config file
+ */
+function getConfigPath() {
+    return CONFIG_FILE;
+}
+/**
+ * Ensure the config directory exists
+ */
+function ensureConfigDir() {
+    if (!fs.existsSync(CONFIG_DIR)) {
+        fs.mkdirSync(CONFIG_DIR, { recursive: true, mode: 0o700 });
+    }
+}
+/**
+ * Load the config file
+ * @returns Config object, or empty object if file doesn't exist
+ */
+function loadConfig() {
+    try {
+        if (fs.existsSync(CONFIG_FILE)) {
+            const content = fs.readFileSync(CONFIG_FILE, 'utf-8');
+            return JSON.parse(content);
+        }
+    }
+    catch (error) {
+        // If file is corrupted, return empty config
+        console.error(`Warning: Could not read config file: ${error}`);
+    }
+    return {};
+}
+/**
+ * Save the config file
+ * @param config - Config object to save
+ */
+function saveConfig(config) {
+    ensureConfigDir();
+    fs.writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2), {
+        encoding: 'utf-8',
+        mode: 0o600, // Owner read/write only
+    });
+}
+/**
+ * Update specific config values (merges with existing)
+ * @param updates - Partial config to merge
+ */
+function updateConfig(updates) {
+    const current = loadConfig();
+    const updated = deepMerge(current, updates);
+    saveConfig(updated);
+    return updated;
+}
+/**
+ * Get archive configuration with defaults
+ */
+function getArchiveConfig() {
+    const config = loadConfig();
+    return config.archive || { default: 'local' };
+}
+/**
+ * Set archive default destination
+ */
+function setArchiveDefault(destination) {
+    const config = loadConfig();
+    config.archive = config.archive || {};
+    config.archive.default = destination;
+    saveConfig(config);
+}
+/**
+ * Set GitHub configuration
+ */
+function setGitHubConfig(github) {
+    const config = loadConfig();
+    config.archive = config.archive || {};
+    config.archive.github = { ...config.archive.github, ...github };
+    saveConfig(config);
+}
+/**
+ * Set Linear configuration
+ */
+function setLinearConfig(linear) {
+    const config = loadConfig();
+    config.archive = config.archive || {};
+    config.archive.linear = { ...config.archive.linear, ...linear };
+    saveConfig(config);
+}
+/**
+ * Get the effective archive destination
+ * Priority: brainfile.md archive.destination > config default > 'local'
+ *
+ * @param brainfileDestination - Destination from brainfile.md (if any)
+ * @returns The effective destination
+ */
+function getEffectiveArchiveDestination(brainfileDestination) {
+    // Priority 1: brainfile.md setting
+    if (brainfileDestination && isValidDestination(brainfileDestination)) {
+        return brainfileDestination;
+    }
+    // Priority 2: config default
+    const config = getArchiveConfig();
+    if (config.default && isValidDestination(config.default)) {
+        return config.default;
+    }
+    // Priority 3: fallback to local
+    return 'local';
+}
+// ============================================================================
+// Helper Functions
+// ============================================================================
+function isValidDestination(dest) {
+    return ['local', 'github', 'linear'].includes(dest);
+}
+/**
+ * Deep merge two objects
+ */
+function deepMerge(target, source) {
+    const result = { ...target };
+    for (const key in source) {
+        if (Object.prototype.hasOwnProperty.call(source, key)) {
+            const sourceValue = source[key];
+            const targetValue = result[key];
+            if (sourceValue !== null &&
+                typeof sourceValue === 'object' &&
+                !Array.isArray(sourceValue) &&
+                targetValue !== null &&
+                typeof targetValue === 'object' &&
+                !Array.isArray(targetValue)) {
+                result[key] = deepMerge(targetValue, sourceValue);
+            }
+            else {
+                result[key] = sourceValue;
+            }
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=config.js.map

package/dist/utils/config.js.map

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

package/dist/utils/github-auth.d.ts

@@ -0,0 +1,56 @@
+/**
+ * GitHub Authentication for Brainfile CLI
+ *
+ * Supports:
+ * 1. Piggyback on gh CLI auth (if available)
+ * 2. OAuth Device Flow (browser-based, no server needed)
+ * 3. Personal Access Token (manual entry)
+ *
+ * @packageDocumentation
+ */
+/**
+ * Check if GitHub is already authenticated
+ */
+export declare function isGitHubAuthenticated(): Promise<boolean>;
+/**
+ * Get the current GitHub token (from any source)
+ */
+export declare function getGitHubToken(): Promise<string | null>;
+/**
+ * Authenticate with GitHub using the best available method
+ *
+ * Priority:
+ * 1. Use existing gh CLI auth
+ * 2. OAuth Device Flow
+ * 3. Manual PAT entry
+ */
+export declare function authenticateGitHub(options: {
+    usePAT?: boolean;
+    token?: string;
+    silent?: boolean;
+}): Promise<{
+    success: boolean;
+    username?: string;
+    error?: string;
+}>;
+/**
+ * Create a GitHub Issue
+ */
+export declare function createGitHubIssue(options: {
+    owner: string;
+    repo: string;
+    title: string;
+    body: string;
+    labels?: string[];
+    state?: 'open' | 'closed';
+}): Promise<{
+    success: boolean;
+    issueNumber?: number;
+    issueUrl?: string;
+    error?: string;
+}>;
+/**
+ * Logout from GitHub
+ */
+export declare function logoutGitHub(): Promise<void>;
+//# sourceMappingURL=github-auth.d.ts.map