specmem-hardwicksoftware 3.5.99

package/dist/config/apiKeyDetection.js

@@ -0,0 +1,211 @@
+/**
+ * SpecMem API Key Detection
+ *
+ * Auto-detects / API keys from common locations.
+ * Used for orchestrating  instances via SpecMem CLI.
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import * as os from 'os';
+import { logger } from '../utils/logger.js';
+/**
+ * All locations where / API keys might be stored
+ */
+const KEY_LOCATIONS = [
+    // Environment variables (highest priority)
+    { type: 'env', path: 'ANTHROPIC_API_KEY' },
+    { type: 'env', path: 'CLAUDE_API_KEY' },
+    //  Code credentials file
+    { type: 'file', path: '~/.claude/.credentials.json', keyPath: 'claudeAiOauth.accessToken' },
+    //  config files
+    { type: 'file', path: '~/.config/claude/credentials.json', keyPath: 'api_key' },
+    { type: 'file', path: '~/.anthropic/credentials', keyPath: null }, // Plain text file
+    // Project-level
+    { type: 'file', path: '.env', keyPath: null, pattern: /ANTHROPIC_API_KEY=(.+)/ },
+    { type: 'file', path: 'specmem.env', keyPath: null, pattern: /ANTHROPIC_API_KEY=(.+)/ },
+    // Common dotenv locations
+    { type: 'file', path: '.env.local', keyPath: null, pattern: /ANTHROPIC_API_KEY=(.+)/ },
+    { type: 'file', path: '.env.development', keyPath: null, pattern: /ANTHROPIC_API_KEY=(.+)/ },
+];
+/**
+ * Expand ~ to home directory
+ */
+function expandPath(p) {
+    if (p.startsWith('~')) {
+        return path.join(os.homedir(), p.slice(1));
+    }
+    return p;
+}
+/**
+ * Get a nested value from an object using dot notation
+ */
+function getNestedValue(obj, keyPath) {
+    const parts = keyPath.split('.');
+    let current = obj;
+    for (const part of parts) {
+        if (current === null || current === undefined)
+            return null;
+        current = current[part];
+    }
+    return typeof current === 'string' ? current : null;
+}
+/**
+ * Validate that a string looks like an  API key
+ */
+function isValidApiKey(key) {
+    if (!key)
+        return false;
+    //  keys typically start with 'sk-ant-'
+    return key.startsWith('sk-ant-') || key.startsWith('sk-');
+}
+/**
+ * Try to read API key from a file
+ */
+async function readKeyFromFile(filePath, keyPath, pattern) {
+    const fullPath = expandPath(filePath);
+    try {
+        const content = await fs.readFile(fullPath, 'utf-8');
+        // If it's a JSON file with a keyPath
+        if (keyPath) {
+            try {
+                const json = JSON.parse(content);
+                return getNestedValue(json, keyPath);
+            }
+            catch {
+                return null;
+            }
+        }
+        // If we have a pattern (for .env files)
+        if (pattern) {
+            const match = content.match(pattern);
+            if (match && match[1]) {
+                // Remove quotes if present
+                return match[1].replace(/^["']|["']$/g, '').trim();
+            }
+            return null;
+        }
+        // Plain text file - just trim and return
+        return content.trim();
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Detect / API key from all known locations.
+ * Returns the first valid key found.
+ */
+export async function detectApiKey() {
+    for (const location of KEY_LOCATIONS) {
+        let key = null;
+        let source = '';
+        if (location.type === 'env') {
+            key = process.env[location.path] || null;
+            source = `environment variable ${location.path}`;
+        }
+        else if (location.type === 'file') {
+            key = await readKeyFromFile(location.path, location.keyPath || null, location.pattern);
+            source = `file ${location.path}`;
+        }
+        if (isValidApiKey(key)) {
+            logger.info({ source }, 'Found valid API key');
+            return { key, source, isValid: true };
+        }
+    }
+    logger.warn('No valid API key found in any known location');
+    return { key: null, source: 'not found', isValid: false };
+}
+/**
+ * Get API key from cache or detect fresh.
+ * Caches the result in memory for subsequent calls.
+ */
+let cachedApiKey = null;
+export async function getApiKey(forceRefresh = false) {
+    if (!cachedApiKey || forceRefresh) {
+        cachedApiKey = await detectApiKey();
+    }
+    return cachedApiKey;
+}
+/**
+ * Set API key manually (overrides detection).
+ * Useful for CLI commands that take --api-key argument.
+ */
+export function setApiKey(key, source = 'manual') {
+    cachedApiKey = {
+        key,
+        source,
+        isValid: isValidApiKey(key),
+    };
+    // Also set in environment for child processes
+    process.env['ANTHROPIC_API_KEY'] = key;
+    logger.info({ source }, 'API key set manually');
+}
+/**
+ * Clear cached API key
+ */
+export function clearApiKeyCache() {
+    cachedApiKey = null;
+}
+/**
+ * Save API key to a persistent location.
+ * Stores in ~/.specmem/credentials.json
+ */
+export async function saveApiKey(key) {
+    const credPath = path.join(os.homedir(), '.specmem', 'credentials.json');
+    try {
+        // Ensure directory exists
+        await fs.mkdir(path.dirname(credPath), { recursive: true });
+        // Read existing credentials if any
+        let creds = {};
+        try {
+            const existing = await fs.readFile(credPath, 'utf-8');
+            creds = JSON.parse(existing);
+        }
+        catch {
+            // No existing file
+        }
+        // Update with new key
+        creds.anthropic_api_key = key;
+        creds.updated_at = new Date().toISOString();
+        // Write atomically
+        await fs.writeFile(credPath, JSON.stringify(creds, null, 2), 'utf-8');
+        await fs.chmod(credPath, 0o600); // Owner read/write only
+        logger.info({ path: credPath }, 'API key saved to credentials file');
+        // Update cache
+        setApiKey(key, credPath);
+        return true;
+    }
+    catch (err) {
+        logger.error({ err }, 'Failed to save API key');
+        return false;
+    }
+}
+/**
+ * Extract API key from  Code's OAuth token.
+ * This is what you stored at ~/.claude/.credentials.json
+ */
+export async function getCodeApiKey() {
+    const credPath = path.join(os.homedir(), '.claude', '.credentials.json');
+    try {
+        const content = await fs.readFile(credPath, 'utf-8');
+        const creds = JSON.parse(content);
+        //  Code stores the OAuth access token
+        const token = creds?.claudeAiOauth?.accessToken;
+        if (token && typeof token === 'string') {
+            logger.info('Found  Code OAuth token');
+            return token;
+        }
+    }
+    catch {
+        // File doesn't exist or invalid
+    }
+    return null;
+}
+/**
+ * Check if we have a usable API key from any source.
+ */
+export async function hasValidApiKey() {
+    const result = await getApiKey();
+    return result.isValid;
+}
+//# sourceMappingURL=apiKeyDetection.js.map

package/dist/config/apiKeyDetection.js.map

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

package/dist/config/autoConfig.d.ts

@@ -0,0 +1,188 @@
+import { ServerConfig } from '../types/index.js';
+interface AutoConfigResult {
+    isFirstRun: boolean;
+    configPath: string;
+    envPath: string;
+    config: ServerConfig;
+    wasGenerated: boolean;
+}
+interface PostgresDetectionResult {
+    host: string;
+    port: number;
+    available: boolean;
+    version?: string;
+}
+/**
+ * isThisTheFirstRodeo - checks if this is the first time running SpecMem
+ *
+ * looks for config files in:
+ * 1. ~/.specmem/config.json
+ * 2. .env file in project root
+ * 3. existing database connection
+ */
+export declare function isThisTheFirstRodeo(): Promise<boolean>;
+/**
+ * detectThePostgresVibes - auto-detect PostgreSQL connection details
+ *
+ * checks common locations:
+ * 1. DATABASE_URL (if set, takes priority)
+ * 2. Environment variables (PGHOST, PGPORT, etc)
+ * 3. localhost:5432 (standard port)
+ * 4. Unix socket connection
+ * 5. Common Docker/Podman ports
+ */
+export declare function detectThePostgresVibes(): Promise<PostgresDetectionResult>;
+/**
+ * generateSecretSauce - creates secure random keys and passwords
+ *
+ * uses crypto.randomBytes for cryptographically secure randomness
+ * generates URL-safe base64 strings for maximum compatibility
+ */
+export declare function generateSecretSauce(length?: number): string;
+/**
+ * autoMagicSetup - generates complete server configuration
+ *
+ * creates a production-ready config with:
+ * - secure random passwords
+ * - auto-detected postgres settings
+ * - per-project isolation via project hash
+ * - sensible defaults for all options
+ */
+export declare function autoMagicSetup(): Promise<ServerConfig>;
+/**
+ * getConfigDirectory - returns the user's config directory
+ * creates it if it doesn't exist
+ */
+export declare function getConfigDirectory(): Promise<string>;
+/**
+ * getProjectRoot - returns the project root directory
+ */
+export declare function getProjectRoot(): string;
+/**
+ * saveConfigToFile - saves config to ~/.specmem/config.json
+ */
+export declare function saveConfigToFile(config: ServerConfig): Promise<string>;
+/**
+ * createEnvFile - creates .env file in project root
+ */
+export declare function createEnvFile(config: ServerConfig): Promise<string>;
+/**
+ * runAutoConfig - main entry point for auto-configuration
+ *
+ * orchestrates the entire auto-config process:
+ * 1. Check if first run
+ * 2. Detect postgres
+ * 3. Generate config
+ * 4. Save to files
+ */
+export declare function runAutoConfig(): Promise<AutoConfigResult>;
+/**
+ * syncConfigToUserFile - ALWAYS syncs current running config to ~/.specmem/config.json
+ *
+ * This ensures the hook ALWAYS has the latest config, even if .env changed
+ * Called on EVERY startup - makes SpecMem deployable anywhere
+ */
+export declare function syncConfigToUserFile(config: ServerConfig): Promise<void>;
+/**
+ * ConfigPersistenceResult - Result of a config persistence operation
+ */
+export interface ConfigPersistenceResult {
+    success: boolean;
+    message: string;
+    backupPath?: string;
+    requiresRestart?: boolean;
+    changedFields?: string[];
+}
+/**
+ * DashboardModeConfig - Configuration for dashboard access mode
+ */
+export interface DashboardModeConfig {
+    mode: 'private' | 'public';
+    host?: string;
+    port?: number;
+    password?: string;
+}
+/**
+ * InstanceConfig - Configuration stored in .specmem/instance.json
+ * Extends the basic instance state with runtime config
+ * Per-project isolation via project hash
+ */
+export interface InstanceConfig {
+    pid?: number;
+    projectPath: string;
+    projectHash: string;
+    startTime?: string;
+    status?: string;
+    stopReason?: string;
+    dashboardMode?: 'private' | 'public';
+    dashboardPort?: number;
+    dashboardHost?: string;
+    coordinationPort?: number;
+    databaseName?: string;
+    databasePort?: number;
+    lastConfigUpdate?: string;
+    configVersion?: number;
+}
+/**
+ * Get the .specmem directory path for current project
+ */
+export declare function getLocalSpecMemDir(): string;
+/**
+ * Get the instance.json path for current project
+ */
+export declare function getInstanceConfigPath(): string;
+/**
+ * createAtomicBackup - Create a backup of a file before modifying
+ *
+ * Uses timestamp-based naming for multiple backup versions
+ * Returns the backup path for potential rollback
+ */
+export declare function createAtomicBackup(filePath: string): Promise<string | null>;
+/**
+ * atomicWriteFile - Write a file atomically using temp file + rename
+ *
+ * Prevents file corruption by writing to a temp file first,
+ * then atomically renaming (which is atomic on most filesystems)
+ */
+export declare function atomicWriteFile(filePath: string, content: string): Promise<void>;
+/**
+ * rollbackFromBackup - Restore a file from its backup
+ *
+ * Used when a config update fails and we need to revert
+ */
+export declare function rollbackFromBackup(originalPath: string, backupPath: string): Promise<boolean>;
+/**
+ * loadInstanceConfig - Load the current instance.json configuration
+ */
+export declare function loadInstanceConfig(): Promise<InstanceConfig | null>;
+/**
+ * saveInstanceConfig - Save instance configuration atomically
+ *
+ * Creates backup before updating, supports rollback on error
+ * Uses project hash for per-project isolation
+ */
+export declare function saveInstanceConfig(config: Partial<InstanceConfig>): Promise<ConfigPersistenceResult>;
+/**
+ * updateEnvFile - Update a specific variable in specmem.env or .env
+ *
+ * Handles atomic updates with backup and rollback
+ */
+export declare function updateEnvFile(varName: string, value: string, envFilePath?: string): Promise<ConfigPersistenceResult>;
+/**
+ * persistDashboardMode - Persist dashboard mode changes to both instance.json and specmem.env
+ *
+ * Updates:
+ * - .specmem/instance.json with mode/host/port
+ * - specmem.env with SPECMEM_DASHBOARD_MODE and related vars
+ *
+ * Returns whether a restart is required (mode change requires rebinding)
+ */
+export declare function persistDashboardMode(config: DashboardModeConfig): Promise<ConfigPersistenceResult>;
+/**
+ * cleanupOldBackups - Remove backup files older than specified age
+ *
+ * Keeps the filesystem clean while maintaining recent backups
+ */
+export declare function cleanupOldBackups(directory: string, maxAgeMs?: number): Promise<number>;
+export type { AutoConfigResult, PostgresDetectionResult };
+//# sourceMappingURL=autoConfig.d.ts.map

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

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