@pcircle/footprint 1.2.2 → 1.3.0

package/dist/src/cli/setup.js

@@ -0,0 +1,334 @@
+#!/usr/bin/env node
+/* global console, process, Buffer, NodeJS */
+import prompts from "prompts";
+import chalk from "chalk";
+import ora from "ora";
+import { timingSafeEqual } from "crypto";
+import * as path from "path";
+import { detectSystem } from "./utils/detect.js";
+import { validatePassword, validatePath } from "./utils/validation.js";
+import { readClaudeConfig, writeClaudeConfig, backupConfig, addFootprintToConfig, } from "./utils/config.js";
+import { generateEnvExport, appendToShellRc } from "./utils/env.js";
+import { DEFAULT_DATA_DIR } from "./constants.js";
+import * as fs from "fs";
+/**
+ * Extract error message from unknown error type
+ */
+function getErrorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+/**
+ * Timing-safe string comparison to prevent timing attacks
+ */
+function safeCompare(a, b) {
+    if (a.length !== b.length)
+        return false;
+    // Convert strings to buffers for timing-safe comparison
+    const bufA = Buffer.from(a, "utf-8");
+    const bufB = Buffer.from(b, "utf-8");
+    return timingSafeEqual(bufA, bufB);
+}
+/**
+ * Welcome message
+ */
+function printWelcome() {
+    console.log(chalk.bold.cyan("\n🦶 Welcome to Footprint Setup!\n"));
+    console.log("Let's configure your AI audit trail in 3 simple steps.\n");
+}
+/**
+ * Print system info
+ */
+function printSystemInfo(system) {
+    console.log(chalk.gray("Detected System:"));
+    console.log(chalk.gray(`  OS: ${system.platform}`));
+    console.log(chalk.gray(`  Shell: ${system.shell}`));
+    if (system.claudeConfigPath) {
+        console.log(chalk.green(`  ✅ Claude Desktop found at: ${system.claudeConfigPath}`));
+    }
+    else {
+        console.log(chalk.yellow(`  ⚠️  Claude Desktop config not found`));
+    }
+    console.log("");
+}
+/**
+ * Prompt for setup configuration
+ */
+async function promptSetup(system) {
+    const response = await prompts([
+        {
+            type: "text",
+            name: "dataDir",
+            message: "Where should we store your data?",
+            initial: DEFAULT_DATA_DIR,
+            validate: (value) => {
+                const result = validatePath(value);
+                return result.valid ? true : result.message;
+            },
+        },
+        {
+            type: "password",
+            name: "passphrase",
+            message: "Create a secure passphrase (min 12 characters):",
+            validate: (value) => {
+                const result = validatePassword(value);
+                return result.valid ? true : result.message;
+            },
+        },
+        {
+            type: "password",
+            name: "confirmPassphrase",
+            message: "Confirm your passphrase:",
+            validate: (value, previous) => {
+                // Use timing-safe comparison to prevent timing attacks
+                return safeCompare(value, previous.passphrase)
+                    ? true
+                    : "Passphrases do not match";
+            },
+        },
+        {
+            type: system.claudeConfigPath ? "confirm" : null,
+            name: "autoConfig",
+            message: "Auto-configure Claude Desktop?",
+            initial: true,
+        },
+    ]);
+    if (!response.passphrase) {
+        return null; // User cancelled
+    }
+    return {
+        dataDir: response.dataDir,
+        passphrase: response.passphrase,
+        autoConfig: response.autoConfig ?? false,
+    };
+}
+/**
+ * Print security warning about password storage
+ */
+function printSecurityWarning() {
+    console.log(chalk.bold.yellow("\n⚠️  Security Notice:\n"));
+    console.log(chalk.yellow("Your passphrase will be stored in configuration files on this system."));
+    console.log(chalk.yellow("We set restrictive permissions (600/700), but anyone with system access"));
+    console.log(chalk.yellow("or file system backups may be able to access it.\n"));
+    console.log(chalk.gray("Recommendations:"));
+    console.log(chalk.gray("  • Use a unique passphrase (not reused elsewhere)"));
+    console.log(chalk.gray("  • Ensure only you have access to this user account"));
+    console.log(chalk.gray("  • Encrypt your backups if they contain config files\n"));
+}
+/**
+ * Configure Claude Desktop with improved error handling
+ */
+async function configureClaudeDesktop(configPath, config) {
+    const spinner = ora("Configuring Claude Desktop...").start();
+    try {
+        // Backup existing config
+        if (fs.existsSync(configPath)) {
+            const backupPath = backupConfig(configPath);
+            spinner.info(chalk.gray(`Backed up existing config to: ${backupPath}`));
+        }
+        // Read and update config
+        const claudeConfig = readClaudeConfig(configPath);
+        const updatedConfig = addFootprintToConfig(claudeConfig, config.dataDir, config.passphrase);
+        writeClaudeConfig(configPath, updatedConfig);
+        spinner.succeed(chalk.green("Claude Desktop configured!"));
+    }
+    catch (error) {
+        spinner.fail(chalk.red(`Failed to configure Claude Desktop: ${getErrorMessage(error)}`));
+        throw error;
+    }
+}
+/**
+ * Setup environment variables with improved error handling
+ */
+async function setupEnvironment(system, config) {
+    if (!system.shellRcPath) {
+        console.log(chalk.yellow("\n⚠️  Shell RC file not found. Manual setup required:"));
+        console.log(chalk.gray(generateEnvExport(system.shell, config.dataDir, config.passphrase)));
+        return;
+    }
+    const { setupEnv } = await prompts({
+        type: "confirm",
+        name: "setupEnv",
+        message: `Add environment variables to ${system.shellRcPath}?`,
+        initial: true,
+    });
+    if (!setupEnv)
+        return;
+    const spinner = ora("Setting up environment variables...").start();
+    try {
+        const envExport = generateEnvExport(system.shell, config.dataDir, config.passphrase);
+        appendToShellRc(system.shellRcPath, envExport);
+        spinner.succeed(chalk.green("Environment variables configured!"));
+    }
+    catch (error) {
+        spinner.fail(chalk.red(`Failed to setup environment: ${getErrorMessage(error)}`));
+        throw error; // Propagate error for rollback
+    }
+}
+/**
+ * Create data directory with secure permissions (0o700)
+ */
+async function createDataDirectory(dataDir) {
+    const spinner = ora("Creating data directory...").start();
+    const normalized = validatePath(dataDir).normalizedPath;
+    try {
+        fs.mkdirSync(normalized, { recursive: true, mode: 0o700 });
+        spinner.succeed(chalk.green(`Data directory created: ${normalized}`));
+    }
+    catch (error) {
+        const nodeError = error;
+        if (nodeError.code === "EEXIST") {
+            spinner.info(chalk.gray(`Data directory already exists: ${normalized}`));
+            // Ensure secure permissions on existing directory
+            try {
+                fs.chmodSync(normalized, 0o700);
+            }
+            catch (chmodError) {
+                spinner.warn(chalk.yellow(`Could not set permissions: ${getErrorMessage(chmodError)}`));
+            }
+            return;
+        }
+        spinner.fail(chalk.red(`Failed to create directory: ${getErrorMessage(error)}`));
+        throw error;
+    }
+}
+/**
+ * Print manual configuration instructions when Claude Desktop not found
+ */
+function printManualConfigInstructions(config) {
+    console.log(chalk.yellow("\n⚠️  Claude Desktop not found. Manual configuration required."));
+    console.log(chalk.gray("Add to claude_desktop_config.json:"));
+    console.log(chalk.gray(JSON.stringify({
+        mcpServers: {
+            footprint: {
+                command: "npx",
+                args: ["@pcircle/footprint"],
+                env: {
+                    FOOTPRINT_DATA_DIR: config.dataDir,
+                    FOOTPRINT_PASSPHRASE: config.passphrase,
+                },
+            },
+        },
+    }, null, 2)));
+}
+/**
+ * Print next steps
+ */
+function printNextSteps(_config) {
+    console.log(chalk.bold.green("\n🎉 Setup Complete!\n"));
+    console.log(chalk.bold("Next steps:"));
+    console.log(chalk.gray("  1. Close Claude Desktop completely"));
+    console.log(chalk.gray("  2. Reopen Claude Desktop"));
+    console.log(chalk.gray('  3. Say "capture this conversation" to test\n'));
+    console.log(chalk.yellow("⚠️  Important: Keep your passphrase safe!"));
+    console.log(chalk.gray("  Loss means permanent data loss.\n"));
+}
+/**
+ * Create rollback action for directory removal
+ */
+function createDirectoryRollback(dirPath) {
+    return () => {
+        try {
+            if (fs.existsSync(dirPath)) {
+                fs.rmSync(dirPath, { recursive: true });
+                console.log(chalk.gray(`  Rolled back: Removed ${dirPath}`));
+            }
+        }
+        catch (error) {
+            console.warn(chalk.yellow(`  Warning: Failed to remove ${dirPath}: ${getErrorMessage(error)}`));
+        }
+    };
+}
+/**
+ * Create rollback action for config restoration
+ */
+function createConfigRollback(backupPath, configPath) {
+    return () => {
+        try {
+            if (fs.existsSync(backupPath)) {
+                fs.copyFileSync(backupPath, configPath);
+                console.log(chalk.gray(`  Rolled back: Restored config from backup`));
+            }
+        }
+        catch (error) {
+            console.warn(chalk.yellow(`  Warning: Failed to restore config: ${getErrorMessage(error)}`));
+        }
+    };
+}
+/**
+ * Find the most recent backup file for a config
+ */
+function findLatestBackup(configPath) {
+    const dir = path.dirname(configPath);
+    const basename = path.basename(configPath);
+    const backupFiles = fs
+        .readdirSync(dir)
+        .filter((f) => f.startsWith(`${basename}.backup`));
+    if (backupFiles.length === 0)
+        return null;
+    return path.join(dir, backupFiles[backupFiles.length - 1]);
+}
+/**
+ * Main setup flow with transaction-like rollback on failure
+ */
+export async function runSetup() {
+    // Track all changes for potential rollback
+    const rollbackActions = [];
+    try {
+        printWelcome();
+        const system = detectSystem();
+        printSystemInfo(system);
+        const config = await promptSetup(system);
+        if (!config) {
+            console.log(chalk.yellow("\nSetup cancelled."));
+            process.exit(0);
+        }
+        // Print security warning about password storage
+        printSecurityWarning();
+        // Create data directory (tracked for rollback)
+        const normalized = validatePath(config.dataDir).normalizedPath;
+        const directoryCreated = !fs.existsSync(normalized);
+        await createDataDirectory(config.dataDir);
+        if (directoryCreated) {
+            rollbackActions.push(createDirectoryRollback(normalized));
+        }
+        // Configure Claude Desktop if requested (tracked for rollback)
+        if (config.autoConfig && system.claudeConfigPath) {
+            await configureClaudeDesktop(system.claudeConfigPath, config);
+            // Track config backup for rollback
+            const backupPath = findLatestBackup(system.claudeConfigPath);
+            if (backupPath) {
+                rollbackActions.push(createConfigRollback(backupPath, system.claudeConfigPath));
+            }
+        }
+        else if (!system.claudeConfigPath) {
+            printManualConfigInstructions(config);
+        }
+        // Setup environment variables (tracked for rollback)
+        await setupEnvironment(system, config);
+        // If we get here, setup succeeded - discard rollback actions
+        rollbackActions.length = 0;
+        printNextSteps(config);
+    }
+    catch (error) {
+        console.error(chalk.red(`\n❌ Setup failed: ${getErrorMessage(error)}`));
+        // Perform rollback if any changes were made
+        if (rollbackActions.length > 0) {
+            console.log(chalk.yellow("\n🔄 Rolling back changes...\n"));
+            // Execute rollback actions in reverse order
+            for (const action of rollbackActions.reverse()) {
+                await action();
+            }
+            console.log(chalk.green("\n✅ Rollback complete. No changes were made.\n"));
+        }
+        console.log(chalk.gray("\nTroubleshooting:"));
+        console.log(chalk.gray("  • Check file permissions"));
+        console.log(chalk.gray("  • Ensure Claude Desktop is not running"));
+        console.log(chalk.gray("  • Verify disk space is available\n"));
+        process.exit(1);
+    }
+}
+// Run if executed directly
+if (import.meta.url === `file://${process.argv[1]}`) {
+    runSetup();
+}
+//# sourceMappingURL=setup.js.map

package/dist/src/cli/setup.js.map

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

package/dist/src/cli/types.d.ts

@@ -0,0 +1,38 @@
+/**
+ * CLI types for interactive setup
+ */
+export interface SetupConfig {
+    /** Directory to store Footprint data */
+    dataDir: string;
+    /** Encryption passphrase */
+    passphrase: string;
+    /** Auto-configure Claude Desktop */
+    autoConfig: boolean;
+    /** Skip backup of existing config */
+    skipBackup?: boolean;
+}
+export interface SystemInfo {
+    /** Operating system platform */
+    platform: "darwin" | "linux" | "win32";
+    /** Default shell */
+    shell: "bash" | "zsh" | "fish" | "powershell";
+    /** Path to Claude Desktop config */
+    claudeConfigPath: string | null;
+    /** User home directory */
+    homeDir: string;
+    /** Shell RC file path */
+    shellRcPath: string | null;
+}
+export interface ClaudeConfig {
+    mcpServers?: Record<string, {
+        command: string;
+        args: string[];
+        env?: Record<string, string>;
+    }>;
+}
+export interface ValidationResult {
+    valid: boolean;
+    message?: string;
+    score?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/cli/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/cli/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,WAAW;IAC1B,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,UAAU,EAAE,OAAO,CAAC;IACpB,qCAAqC;IACrC,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,gCAAgC;IAChC,QAAQ,EAAE,QAAQ,GAAG,OAAO,GAAG,OAAO,CAAC;IACvC,oBAAoB;IACpB,KAAK,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,YAAY,CAAC;IAC9C,oCAAoC;IACpC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,0BAA0B;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,yBAAyB;IACzB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,CAAC,EAAE,MAAM,CACjB,MAAM,EACN;QACE,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,EAAE,CAAC;QACf,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAC9B,CACF,CAAC;CACH;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/src/cli/types.js

@@ -0,0 +1,5 @@
+/**
+ * CLI types for interactive setup
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/cli/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/cli/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/src/cli/utils/config.d.ts

@@ -0,0 +1,19 @@
+import type { ClaudeConfig } from "../types.js";
+/**
+ * Read Claude Desktop config file
+ */
+export declare function readClaudeConfig(configPath: string): ClaudeConfig;
+/**
+ * Write Claude Desktop config file with secure permissions (0o600)
+ * CRITICAL: Config contains passphrase, must be owner-only readable
+ */
+export declare function writeClaudeConfig(configPath: string, config: ClaudeConfig): void;
+/**
+ * Backup existing config file with secure permissions (0o600)
+ */
+export declare function backupConfig(configPath: string): string;
+/**
+ * Add Footprint to Claude config
+ */
+export declare function addFootprintToConfig(config: ClaudeConfig, dataDir: string, passphrase: string): ClaudeConfig;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../../src/cli/utils/config.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AA0BhD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,YAAY,CAcjE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,YAAY,GACnB,IAAI,CASN;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAYvD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,GACjB,YAAY,CAed"}

package/dist/src/cli/utils/config.js

@@ -0,0 +1,86 @@
+/* global console, NodeJS */
+import * as fs from "fs";
+import * as path from "path";
+/** Secure file permissions: owner read/write only */
+const SECURE_FILE_MODE = 0o600;
+/** Secure directory permissions: owner read/write/execute only */
+const SECURE_DIR_MODE = 0o700;
+/**
+ * Safely set file permissions with warning on failure
+ */
+function setSecurePermissions(filePath, showManualHint = false) {
+    try {
+        fs.chmodSync(filePath, SECURE_FILE_MODE);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        console.warn(`Warning: Could not set secure permissions on ${filePath}: ${message}`);
+        if (showManualHint) {
+            console.warn("  Please manually restrict access to this file (chmod 600 on Unix).");
+        }
+    }
+}
+/**
+ * Read Claude Desktop config file
+ */
+export function readClaudeConfig(configPath) {
+    try {
+        if (!fs.existsSync(configPath)) {
+            return {};
+        }
+        return JSON.parse(fs.readFileSync(configPath, "utf-8"));
+    }
+    catch (error) {
+        const nodeError = error;
+        if (nodeError.code === "ENOENT") {
+            return {};
+        }
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to read config at ${configPath}: ${message}`);
+    }
+}
+/**
+ * Write Claude Desktop config file with secure permissions (0o600)
+ * CRITICAL: Config contains passphrase, must be owner-only readable
+ */
+export function writeClaudeConfig(configPath, config) {
+    const dir = path.dirname(configPath);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true, mode: SECURE_DIR_MODE });
+    }
+    fs.writeFileSync(configPath, JSON.stringify(config, null, 2), "utf-8");
+    setSecurePermissions(configPath, true);
+}
+/**
+ * Backup existing config file with secure permissions (0o600)
+ */
+export function backupConfig(configPath) {
+    if (!fs.existsSync(configPath)) {
+        throw new Error("Config file does not exist");
+    }
+    const timestamp = new Date().toISOString().replace(/[:.]/g, "-");
+    const backupPath = `${configPath}.backup-${timestamp}`;
+    fs.copyFileSync(configPath, backupPath);
+    setSecurePermissions(backupPath);
+    return backupPath;
+}
+/**
+ * Add Footprint to Claude config
+ */
+export function addFootprintToConfig(config, dataDir, passphrase) {
+    return {
+        ...config,
+        mcpServers: {
+            ...config.mcpServers,
+            footprint: {
+                command: "npx",
+                args: ["@pcircle/footprint"],
+                env: {
+                    FOOTPRINT_DATA_DIR: dataDir,
+                    FOOTPRINT_PASSPHRASE: passphrase,
+                },
+            },
+        },
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/src/cli/utils/config.js.map

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

package/dist/src/cli/utils/detect.d.ts

@@ -0,0 +1,14 @@
+import type { SystemInfo } from '../types.js';
+/**
+ * Detect current operating system and environment
+ */
+export declare function detectSystem(): SystemInfo;
+/**
+ * Detect user's default shell
+ */
+export declare function detectShell(): SystemInfo['shell'];
+/**
+ * Find Claude Desktop config file path
+ */
+export declare function findClaudeConfig(): string | null;
+//# sourceMappingURL=detect.d.ts.map

package/dist/src/cli/utils/detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.d.ts","sourceRoot":"","sources":["../../../../src/cli/utils/detect.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAG9C;;GAEG;AACH,wBAAgB,YAAY,IAAI,UAAU,CAczC;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,UAAU,CAAC,OAAO,CAAC,CASjD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,GAAG,IAAI,CAOhD"}

package/dist/src/cli/utils/detect.js

@@ -0,0 +1,57 @@
+import * as os from 'os';
+import * as fs from 'fs';
+import * as path from 'path';
+import { CLAUDE_CONFIG_PATHS, SHELL_RC_FILES } from '../constants.js';
+/**
+ * Detect current operating system and environment
+ */
+export function detectSystem() {
+    const platform = os.platform();
+    const shell = detectShell();
+    const homeDir = os.homedir();
+    const claudeConfigPath = findClaudeConfig();
+    const shellRcPath = findShellRcPath(shell, homeDir);
+    return {
+        platform,
+        shell,
+        claudeConfigPath,
+        homeDir,
+        shellRcPath,
+    };
+}
+/**
+ * Detect user's default shell
+ */
+export function detectShell() {
+    const shellEnv = process.env.SHELL || '';
+    if (shellEnv.includes('zsh'))
+        return 'zsh';
+    if (shellEnv.includes('bash'))
+        return 'bash';
+    if (shellEnv.includes('fish'))
+        return 'fish';
+    if (process.platform === 'win32')
+        return 'powershell';
+    return 'bash'; // Default fallback
+}
+/**
+ * Find Claude Desktop config file path
+ */
+export function findClaudeConfig() {
+    const platform = os.platform();
+    const configPath = CLAUDE_CONFIG_PATHS[platform];
+    if (!configPath)
+        return null;
+    return fs.existsSync(configPath) ? configPath : null;
+}
+/**
+ * Find shell RC file path
+ */
+function findShellRcPath(shell, homeDir) {
+    const rcFile = SHELL_RC_FILES[shell];
+    if (!rcFile)
+        return null;
+    const rcPath = path.join(homeDir, rcFile);
+    return fs.existsSync(rcPath) ? rcPath : null;
+}
+//# sourceMappingURL=detect.js.map

package/dist/src/cli/utils/detect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.js","sourceRoot":"","sources":["../../../../src/cli/utils/detect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtE;;GAEG;AACH,MAAM,UAAU,YAAY;IAC1B,MAAM,QAAQ,GAAG,EAAE,CAAC,QAAQ,EAA4B,CAAC;IACzD,MAAM,KAAK,GAAG,WAAW,EAAE,CAAC;IAC5B,MAAM,OAAO,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;IAC7B,MAAM,gBAAgB,GAAG,gBAAgB,EAAE,CAAC;IAC5C,MAAM,WAAW,GAAG,eAAe,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAEpD,OAAO;QACL,QAAQ;QACR,KAAK;QACL,gBAAgB;QAChB,OAAO;QACP,WAAW;KACZ,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW;IACzB,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC;IAEzC,IAAI,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC3C,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,MAAM,CAAC;IAC7C,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,MAAM,CAAC;IAC7C,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO;QAAE,OAAO,YAAY,CAAC;IAEtD,OAAO,MAAM,CAAC,CAAC,mBAAmB;AACpC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,MAAM,QAAQ,GAAG,EAAE,CAAC,QAAQ,EAAsC,CAAC;IACnE,MAAM,UAAU,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IAEjD,IAAI,CAAC,UAAU;QAAE,OAAO,IAAI,CAAC;IAE7B,OAAO,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC;AACvD,CAAC;AAED;;GAEG;AACH,SAAS,eAAe,CAAC,KAAa,EAAE,OAAe;IACrD,MAAM,MAAM,GAAG,cAAc,CAAC,KAAoC,CAAC,CAAC;IACpE,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAEzB,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC1C,OAAO,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;AAC/C,CAAC"}

package/dist/src/cli/utils/env.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Generate environment variable export statement with proper escaping
+ * Note: _shell parameter reserved for future shell-specific syntax (e.g., fish)
+ */
+export declare function generateEnvExport(_shell: string, dataDir: string, passphrase: string): string;
+/**
+ * Append environment variables to shell RC file with secure permissions (0o600)
+ */
+export declare function appendToShellRc(rcPath: string, content: string): void;
+//# sourceMappingURL=env.d.ts.map

package/dist/src/cli/utils/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../../../src/cli/utils/env.ts"],"names":[],"mappings":"AAcA;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,GACjB,MAAM,CAQR;AAMD;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CA8BrE"}