247-cli 0.3.0

package/dist/lib/config.js

@@ -0,0 +1,161 @@
+import { existsSync, readFileSync, writeFileSync, mkdirSync, readdirSync, unlinkSync } from 'fs';
+import { join } from 'path';
+import { randomUUID } from 'crypto';
+import { getAgentPaths, ensureDirectories } from './paths.js';
+const DEFAULT_CONFIG = {
+    machine: {
+        id: '',
+        name: '',
+    },
+    agent: {
+        port: 4678,
+    },
+    projects: {
+        basePath: '~/Dev',
+        whitelist: [],
+    },
+    editor: {
+        enabled: false,
+        portRange: { start: 4680, end: 4699 },
+        idleTimeout: 1800000,
+    },
+};
+/**
+ * Get the profiles directory path
+ */
+export function getProfilesDir() {
+    const paths = getAgentPaths();
+    return join(paths.configDir, 'profiles');
+}
+/**
+ * Get the config file path for a specific profile
+ * @param profileName - Profile name, or undefined/null/'default' for default config
+ */
+export function getProfilePath(profileName) {
+    const paths = getAgentPaths();
+    if (!profileName || profileName === 'default') {
+        return paths.configPath;
+    }
+    return join(getProfilesDir(), `${profileName}.json`);
+}
+/**
+ * List all available profiles
+ */
+export function listProfiles() {
+    const paths = getAgentPaths();
+    const profilesDir = getProfilesDir();
+    const profiles = [];
+    // Add default profile if it exists
+    if (existsSync(paths.configPath)) {
+        profiles.push('default');
+    }
+    // Add named profiles
+    if (existsSync(profilesDir)) {
+        const files = readdirSync(profilesDir);
+        for (const file of files) {
+            if (file.endsWith('.json')) {
+                profiles.push(file.replace('.json', ''));
+            }
+        }
+    }
+    return profiles;
+}
+/**
+ * Check if a profile exists
+ */
+export function profileExists(profileName) {
+    const configPath = getProfilePath(profileName);
+    return existsSync(configPath);
+}
+/**
+ * Delete a profile
+ */
+export function deleteProfile(profileName) {
+    if (!profileName || profileName === 'default') {
+        throw new Error('Cannot delete default profile');
+    }
+    const configPath = getProfilePath(profileName);
+    if (!existsSync(configPath)) {
+        return false;
+    }
+    unlinkSync(configPath);
+    return true;
+}
+/**
+ * Load configuration from ~/.247/config.json or a profile
+ * @param profileName - Profile name to load, or undefined for default
+ */
+export function loadConfig(profileName) {
+    const configPath = getProfilePath(profileName);
+    if (!existsSync(configPath)) {
+        return null;
+    }
+    try {
+        const content = readFileSync(configPath, 'utf-8');
+        const config = JSON.parse(content);
+        // Apply environment overrides
+        if (process.env.AGENT_247_PORT) {
+            config.agent.port = parseInt(process.env.AGENT_247_PORT, 10);
+        }
+        if (process.env.AGENT_247_PROJECTS) {
+            config.projects.basePath = process.env.AGENT_247_PROJECTS;
+        }
+        return config;
+    }
+    catch (err) {
+        console.error(`Failed to load config: ${err.message}`);
+        return null;
+    }
+}
+/**
+ * Save configuration to ~/.247/config.json or a profile
+ * @param config - Configuration to save
+ * @param profileName - Profile name to save to, or undefined for default
+ */
+export function saveConfig(config, profileName) {
+    const configPath = getProfilePath(profileName);
+    ensureDirectories();
+    // Ensure profiles directory exists for named profiles
+    if (profileName && profileName !== 'default') {
+        const profilesDir = getProfilesDir();
+        if (!existsSync(profilesDir)) {
+            mkdirSync(profilesDir, { recursive: true });
+        }
+    }
+    const content = JSON.stringify(config, null, 2);
+    writeFileSync(configPath, content, 'utf-8');
+}
+/**
+ * Create a new configuration with defaults
+ */
+export function createConfig(options) {
+    return {
+        ...DEFAULT_CONFIG,
+        machine: {
+            id: randomUUID(),
+            name: options.machineName,
+        },
+        agent: {
+            port: options.port ?? DEFAULT_CONFIG.agent.port,
+        },
+        projects: {
+            basePath: options.projectsPath ?? DEFAULT_CONFIG.projects.basePath,
+            whitelist: [],
+        },
+    };
+}
+/**
+ * Check if configuration exists
+ * @param profileName - Profile name to check, or undefined for default
+ */
+export function configExists(profileName) {
+    const configPath = getProfilePath(profileName);
+    return existsSync(configPath);
+}
+/**
+ * Get default configuration
+ */
+export function getDefaultConfig() {
+    return { ...DEFAULT_CONFIG };
+}
+//# 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/paths.d.ts

@@ -0,0 +1,34 @@
+export interface AgentPaths {
+    /** Where the CLI package is installed */
+    cliRoot: string;
+    /** Where the agent server code is located */
+    agentRoot: string;
+    /** Where the hooks package source is located */
+    hooksSource: string;
+    /** Where hooks should be installed for Claude Code */
+    hooksDestination: string;
+    /** Configuration directory (~/.247/) */
+    configDir: string;
+    /** Configuration file path */
+    configPath: string;
+    /** Data directory for SQLite */
+    dataDir: string;
+    /** Log directory */
+    logDir: string;
+    /** PID file path */
+    pidFile: string;
+    /** Node binary path */
+    nodePath: string;
+    /** Is this a development install? */
+    isDev: boolean;
+}
+export declare function getAgentPaths(): AgentPaths;
+/**
+ * Ensure all required directories exist
+ */
+export declare function ensureDirectories(): void;
+/**
+ * Clear cached paths (useful for testing)
+ */
+export declare function clearPathsCache(): void;
+//# sourceMappingURL=paths.d.ts.map

package/dist/lib/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/lib/paths.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,UAAU;IACzB,yCAAyC;IACzC,OAAO,EAAE,MAAM,CAAC;IAEhB,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;IAElB,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;IAEpB,sDAAsD;IACtD,gBAAgB,EAAE,MAAM,CAAC;IAEzB,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;IAElB,8BAA8B;IAC9B,UAAU,EAAE,MAAM,CAAC;IAEnB,gCAAgC;IAChC,OAAO,EAAE,MAAM,CAAC;IAEhB,oBAAoB;IACpB,MAAM,EAAE,MAAM,CAAC;IAEf,oBAAoB;IACpB,OAAO,EAAE,MAAM,CAAC;IAEhB,uBAAuB;IACvB,QAAQ,EAAE,MAAM,CAAC;IAEjB,qCAAqC;IACrC,KAAK,EAAE,OAAO,CAAC;CAChB;AAID,wBAAgB,aAAa,IAAI,UAAU,CAmD1C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAcxC;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAEtC"}

package/dist/lib/paths.js

@@ -0,0 +1,76 @@
+import { dirname, join, resolve } from 'path';
+import { fileURLToPath } from 'url';
+import { existsSync, mkdirSync } from 'fs';
+import { homedir, platform } from 'os';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+let cachedPaths = null;
+export function getAgentPaths() {
+    if (cachedPaths)
+        return cachedPaths;
+    // CLI root is 2 levels up from lib/ (dist/lib -> dist -> cli root)
+    const cliRoot = resolve(__dirname, '..', '..');
+    // Check if running from source (monorepo) or installed (npm global)
+    // In monorepo: cliRoot is packages/cli, parent has pnpm-workspace.yaml
+    const monorepoRoot = resolve(cliRoot, '..', '..');
+    const isDev = existsSync(join(monorepoRoot, 'pnpm-workspace.yaml'));
+    let agentRoot;
+    let hooksSource;
+    if (isDev) {
+        // Development: agent and hooks are in the monorepo
+        agentRoot = resolve(monorepoRoot, 'apps', 'agent');
+        hooksSource = resolve(monorepoRoot, 'packages', 'hooks');
+    }
+    else {
+        // Production: agent code is bundled with CLI
+        agentRoot = join(cliRoot, 'agent');
+        hooksSource = join(cliRoot, 'hooks');
+    }
+    // Configuration directory
+    const configDir = join(homedir(), '.247');
+    // Log directory varies by platform
+    const os = platform();
+    let logDir;
+    if (os === 'darwin') {
+        logDir = join(homedir(), 'Library', 'Logs', '247-agent');
+    }
+    else {
+        logDir = join(homedir(), '.local', 'log', '247-agent');
+    }
+    cachedPaths = {
+        cliRoot,
+        agentRoot,
+        hooksSource,
+        hooksDestination: join(homedir(), '.claude-plugins', '247-hooks'),
+        configDir,
+        configPath: join(configDir, 'config.json'),
+        dataDir: join(configDir, 'data'),
+        logDir,
+        pidFile: join(configDir, 'agent.pid'),
+        nodePath: process.execPath,
+        isDev,
+    };
+    return cachedPaths;
+}
+/**
+ * Ensure all required directories exist
+ */
+export function ensureDirectories() {
+    const paths = getAgentPaths();
+    const dirs = [
+        paths.configDir,
+        paths.dataDir,
+        paths.logDir,
+    ];
+    for (const dir of dirs) {
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+    }
+}
+/**
+ * Clear cached paths (useful for testing)
+ */
+export function clearPathsCache() {
+    cachedPaths = null;
+}
+//# sourceMappingURL=paths.js.map

package/dist/lib/paths.js.map

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

package/dist/lib/prerequisites.d.ts

@@ -0,0 +1,36 @@
+export interface PrerequisiteCheck {
+    name: string;
+    status: 'ok' | 'warn' | 'error';
+    message: string;
+    required: boolean;
+}
+/**
+ * Check if Node.js version is sufficient
+ */
+export declare function checkNodeVersion(): PrerequisiteCheck;
+/**
+ * Check if tmux is installed
+ */
+export declare function checkTmux(): PrerequisiteCheck;
+/**
+ * Check platform compatibility
+ */
+export declare function checkPlatform(): PrerequisiteCheck;
+/**
+ * Check if a port is available
+ */
+export declare function checkPort(port: number): Promise<PrerequisiteCheck>;
+/**
+ * Run all prerequisite checks
+ */
+export declare function checkAllPrerequisites(port?: number): Promise<PrerequisiteCheck[]>;
+/**
+ * Check if all required prerequisites are met
+ */
+export declare function allRequiredMet(checks: PrerequisiteCheck[]): boolean;
+/**
+ * Check native dependencies (node-pty, better-sqlite3)
+ */
+export declare function checkNativeDeps(): Promise<PrerequisiteCheck>;
+export declare const checkNode: typeof checkNodeVersion;
+//# sourceMappingURL=prerequisites.d.ts.map

package/dist/lib/prerequisites.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prerequisites.d.ts","sourceRoot":"","sources":["../../src/lib/prerequisites.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,IAAI,GAAG,MAAM,GAAG,OAAO,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,iBAAiB,CA4BpD;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,iBAAiB,CAsB7C;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,iBAAiB,CA2BjD;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAkCxE;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAYvF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,iBAAiB,EAAE,GAAG,OAAO,CAInE;AAED;;GAEG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAgClE;AAGD,eAAO,MAAM,SAAS,yBAAmB,CAAC"}

package/dist/lib/prerequisites.js

@@ -0,0 +1,181 @@
+import { execSync } from 'child_process';
+import { platform } from 'os';
+import * as net from 'net';
+/**
+ * Check if Node.js version is sufficient
+ */
+export function checkNodeVersion() {
+    const version = process.version;
+    const major = parseInt(version.slice(1).split('.')[0], 10);
+    if (major >= 22) {
+        return {
+            name: 'Node.js',
+            status: 'ok',
+            message: version,
+            required: true,
+        };
+    }
+    if (major >= 18) {
+        return {
+            name: 'Node.js',
+            status: 'warn',
+            message: `${version} (recommended: >=22)`,
+            required: true,
+        };
+    }
+    return {
+        name: 'Node.js',
+        status: 'error',
+        message: `${version} (required: >=22)`,
+        required: true,
+    };
+}
+/**
+ * Check if tmux is installed
+ */
+export function checkTmux() {
+    try {
+        const output = execSync('tmux -V', { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] });
+        return {
+            name: 'tmux',
+            status: 'ok',
+            message: output.trim(),
+            required: true,
+        };
+    }
+    catch {
+        const os = platform();
+        const installCmd = os === 'darwin'
+            ? 'brew install tmux'
+            : 'sudo apt install tmux';
+        return {
+            name: 'tmux',
+            status: 'error',
+            message: `Not installed. Run: ${installCmd}`,
+            required: true,
+        };
+    }
+}
+/**
+ * Check platform compatibility
+ */
+export function checkPlatform() {
+    const os = platform();
+    if (os === 'darwin') {
+        return {
+            name: 'Platform',
+            status: 'ok',
+            message: 'macOS',
+            required: true,
+        };
+    }
+    if (os === 'linux') {
+        return {
+            name: 'Platform',
+            status: 'ok',
+            message: 'Linux',
+            required: true,
+        };
+    }
+    return {
+        name: 'Platform',
+        status: 'error',
+        message: `Unsupported: ${os}. Only macOS and Linux are supported.`,
+        required: true,
+    };
+}
+/**
+ * Check if a port is available
+ */
+export async function checkPort(port) {
+    return new Promise((resolve) => {
+        const server = net.createServer();
+        server.once('error', (err) => {
+            if (err.code === 'EADDRINUSE') {
+                resolve({
+                    name: `Port ${port}`,
+                    status: 'error',
+                    message: 'Port is already in use',
+                    required: false,
+                });
+            }
+            else {
+                resolve({
+                    name: `Port ${port}`,
+                    status: 'warn',
+                    message: `Could not check: ${err.message}`,
+                    required: false,
+                });
+            }
+        });
+        server.once('listening', () => {
+            server.close();
+            resolve({
+                name: `Port ${port}`,
+                status: 'ok',
+                message: 'Available',
+                required: false,
+            });
+        });
+        server.listen(port, '127.0.0.1');
+    });
+}
+/**
+ * Run all prerequisite checks
+ */
+export async function checkAllPrerequisites(port) {
+    const checks = [
+        checkPlatform(),
+        checkNodeVersion(),
+        checkTmux(),
+    ];
+    if (port) {
+        checks.push(await checkPort(port));
+    }
+    return checks;
+}
+/**
+ * Check if all required prerequisites are met
+ */
+export function allRequiredMet(checks) {
+    return checks
+        .filter(c => c.required)
+        .every(c => c.status !== 'error');
+}
+/**
+ * Check native dependencies (node-pty, better-sqlite3)
+ */
+export async function checkNativeDeps() {
+    const issues = [];
+    // Check node-pty
+    try {
+        await import('@homebridge/node-pty-prebuilt-multiarch');
+    }
+    catch {
+        issues.push('node-pty');
+    }
+    // Check better-sqlite3
+    try {
+        await import('better-sqlite3');
+    }
+    catch {
+        issues.push('better-sqlite3');
+    }
+    if (issues.length === 0) {
+        return {
+            name: 'Native modules',
+            status: 'ok',
+            message: 'All native modules loaded successfully',
+            required: true,
+        };
+    }
+    return {
+        name: 'Native modules',
+        status: 'error',
+        message: `Failed to load: ${issues.join(', ')}`,
+        required: true,
+    };
+}
+// Aliases for backwards compatibility
+export const checkNode = checkNodeVersion;
+//# sourceMappingURL=prerequisites.js.map

package/dist/lib/prerequisites.js.map

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

package/dist/lib/process.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Check if the agent process is running
+ */
+export declare function isAgentRunning(): {
+    running: boolean;
+    pid?: number;
+};
+/**
+ * Start the agent as a background daemon
+ * @param profileName - Optional profile name to use
+ */
+export declare function startAgentDaemon(profileName?: string | null): Promise<{
+    success: boolean;
+    pid?: number;
+    error?: string;
+}>;
+/**
+ * Stop the running agent
+ */
+export declare function stopAgent(): {
+    success: boolean;
+    error?: string;
+};
+/**
+ * Restart the agent
+ */
+export declare function restartAgent(): Promise<{
+    success: boolean;
+    pid?: number;
+    error?: string;
+}>;
+/**
+ * Get agent health status by checking the API
+ */
+export declare function getAgentHealth(port: number): Promise<{
+    healthy: boolean;
+    sessions?: number;
+    error?: string;
+}>;
+//# sourceMappingURL=process.d.ts.map

package/dist/lib/process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.d.ts","sourceRoot":"","sources":["../../src/lib/process.ts"],"names":[],"mappings":"AAMA;;GAEG;AACH,wBAAgB,cAAc,IAAI;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,CA+BnE;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAgF/H;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAqDhE;AAED;;GAEG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAUhG;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAC1D,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC,CAWD"}