@openreef/cli 0.1.1 → 0.3.0

package/dist/commands/status.js

@@ -0,0 +1,181 @@
+import { existsSync } from 'node:fs';
+import chalk from 'chalk';
+import { resolveGatewayUrl } from '../core/openclaw-paths.js';
+import { readConfig } from '../core/config-patcher.js';
+import { GatewayClient, resolveGatewayAuth } from '../core/gateway-client.js';
+import { icons, header, label, value, table } from '../utils/output.js';
+import { resolveFormationState, FormationNotFoundError, AmbiguousFormationError, } from '../utils/identifiers.js';
+export async function status(identifier, options) {
+    let state;
+    try {
+        state = await resolveFormationState(identifier);
+    }
+    catch (err) {
+        if (err instanceof FormationNotFoundError) {
+            console.error(`${icons.error} ${err.message}`);
+            process.exit(1);
+        }
+        if (err instanceof AmbiguousFormationError) {
+            console.error(`${icons.error} Multiple formations named "${err.message.split('"')[1]}" found:`);
+            for (const m of err.matches) {
+                console.error(`  - ${m.namespace}/${m.name}`);
+            }
+            console.error('  Specify the full namespace/name.');
+            process.exit(1);
+        }
+        throw err;
+    }
+    // Read config to check agents and bindings
+    const { config } = await readConfig();
+    const agentsList = config.agents?.list ?? [];
+    const bindingsList = (config.bindings ?? []);
+    // Check cron jobs if Gateway reachable
+    let cronJobs = [];
+    let cronReachable = false;
+    if (state.cronJobs.length > 0) {
+        try {
+            const gwUrl = options.gatewayUrl ?? resolveGatewayUrl(config, process.env);
+            const gwAuth = resolveGatewayAuth({
+                gatewayUrl: options.gatewayUrl,
+                gatewayToken: options.gatewayToken,
+                gatewayPassword: options.gatewayPassword,
+                config,
+            });
+            const gw = new GatewayClient({
+                url: gwUrl,
+                ...gwAuth,
+            });
+            await gw.connect();
+            cronJobs = await gw.cronList({ includeDisabled: true });
+            cronReachable = true;
+            gw.close();
+        }
+        catch {
+            // Gateway not reachable — skip cron check
+        }
+    }
+    // Build status data
+    const agentStatuses = Object.entries(state.agents).map(([slug, agent]) => {
+        const inConfig = agentsList.some((a) => a.id === agent.id);
+        const workspaceExists = existsSync(agent.workspace);
+        return {
+            slug,
+            id: agent.id,
+            inConfig,
+            workspaceExists,
+            fileCount: agent.files.length,
+        };
+    });
+    const bindingStatuses = state.bindings.map((binding) => {
+        const inConfig = bindingsList.some((b) => {
+            const match = b.match;
+            return b.agentId === binding.agentId && match?.channel === binding.match.channel;
+        });
+        return { ...binding, inConfig };
+    });
+    const cronStatuses = state.cronJobs.map((job) => {
+        const liveJob = cronJobs.find((j) => j.id === job.id);
+        return {
+            ...job,
+            exists: !!liveJob,
+            enabled: liveJob?.enabled,
+            state: liveJob?.state,
+        };
+    });
+    if (options.json) {
+        console.log(JSON.stringify({
+            namespace: state.namespace,
+            name: state.name,
+            version: state.version,
+            installedAt: state.installedAt,
+            agents: agentStatuses,
+            bindings: bindingStatuses,
+            cronJobs: cronStatuses,
+            cronReachable,
+        }, null, 2));
+        return;
+    }
+    // Pretty print
+    console.log('');
+    console.log(header('Formation Status'));
+    console.log('');
+    console.log(`${label('Name:')} ${value(`${state.namespace}/${state.name}`)}`);
+    console.log(`${label('Version:')} ${value(state.version)}`);
+    console.log(`${label('Installed:')} ${value(new Date(state.installedAt).toLocaleString())}`);
+    console.log('');
+    // Agents table
+    console.log(label('Agents:'));
+    const agentRows = [
+        [
+            chalk.dim('SLUG'),
+            chalk.dim('ID'),
+            chalk.dim('CONFIG'),
+            chalk.dim('WORKSPACE'),
+            chalk.dim('FILES'),
+        ],
+    ];
+    for (const a of agentStatuses) {
+        agentRows.push([
+            a.slug,
+            a.id,
+            a.inConfig ? chalk.green('ok') : chalk.red('missing'),
+            a.workspaceExists ? chalk.green('ok') : chalk.red('missing'),
+            String(a.fileCount),
+        ]);
+    }
+    console.log(table(agentRows));
+    // Bindings
+    if (bindingStatuses.length > 0) {
+        console.log('');
+        console.log(label('Bindings:'));
+        const bindingRows = [
+            [chalk.dim('CHANNEL'), chalk.dim('AGENT'), chalk.dim('CONFIG')],
+        ];
+        for (const b of bindingStatuses) {
+            bindingRows.push([
+                b.match.channel,
+                b.agentId,
+                b.inConfig ? chalk.green('ok') : chalk.red('missing'),
+            ]);
+        }
+        console.log(table(bindingRows));
+    }
+    // Cron
+    if (cronStatuses.length > 0) {
+        console.log('');
+        console.log(label('Cron Jobs:'));
+        if (!cronReachable) {
+            console.log(`  ${icons.warning} ${chalk.yellow('Gateway not reachable — cannot verify cron jobs')}`);
+        }
+        else {
+            const cronRows = [
+                [
+                    chalk.dim('NAME'),
+                    chalk.dim('AGENT'),
+                    chalk.dim('STATUS'),
+                ],
+            ];
+            for (const c of cronStatuses) {
+                const statusText = c.exists
+                    ? c.enabled
+                        ? chalk.green('active')
+                        : chalk.yellow('disabled')
+                    : chalk.red('missing');
+                cronRows.push([c.name, c.agentSlug, statusText]);
+            }
+            console.log(table(cronRows));
+        }
+    }
+    // Overall health
+    console.log('');
+    const allHealthy = agentStatuses.every((a) => a.inConfig && a.workspaceExists) &&
+        bindingStatuses.every((b) => b.inConfig) &&
+        (!cronReachable || cronStatuses.every((c) => c.exists));
+    if (allHealthy) {
+        console.log(`${icons.success} ${chalk.green('All resources healthy')}`);
+    }
+    else {
+        console.log(`${icons.warning} ${chalk.yellow('Some resources are missing or degraded')}`);
+    }
+}
+//# sourceMappingURL=status.js.map

package/dist/commands/status.js.map

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

package/dist/commands/uninstall.d.ts

@@ -0,0 +1,9 @@
+export interface UninstallOptions {
+    yes?: boolean;
+    dryRun?: boolean;
+    gatewayUrl?: string;
+    gatewayToken?: string;
+    gatewayPassword?: string;
+}
+export declare function uninstall(identifier: string, options: UninstallOptions): Promise<void>;
+//# sourceMappingURL=uninstall.d.ts.map

package/dist/commands/uninstall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uninstall.d.ts","sourceRoot":"","sources":["../../src/commands/uninstall.ts"],"names":[],"mappings":"AAyBA,MAAM,WAAW,gBAAgB;IAC/B,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAsB,SAAS,CAC7B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,IAAI,CAAC,CAoLf"}

package/dist/commands/uninstall.js

@@ -0,0 +1,166 @@
+import { rm } from 'node:fs/promises';
+import { resolve, relative } from 'node:path';
+import { existsSync } from 'node:fs';
+import ora from 'ora';
+import chalk from 'chalk';
+import { resolveGatewayUrl, resolveStateDir, resolveAgentStatePaths } from '../core/openclaw-paths.js';
+import { readConfig, writeConfig, removeAgentEntry, removeBinding, removeAgentToAgent, } from '../core/config-patcher.js';
+import { GatewayClient, resolveGatewayAuth } from '../core/gateway-client.js';
+import { deleteState, listStates, } from '../core/state-manager.js';
+import { icons, header, label, value } from '../utils/output.js';
+import { resolveFormationState, FormationNotFoundError, AmbiguousFormationError, } from '../utils/identifiers.js';
+export async function uninstall(identifier, options) {
+    // 1. Resolve identifier to state
+    let state;
+    try {
+        state = await resolveFormationState(identifier);
+    }
+    catch (err) {
+        if (err instanceof FormationNotFoundError) {
+            console.error(`${icons.error} ${err.message}`);
+            process.exit(1);
+        }
+        if (err instanceof AmbiguousFormationError) {
+            console.error(`${icons.error} Multiple formations named "${err.message.split('"')[1]}" found:`);
+            for (const m of err.matches) {
+                console.error(`  - ${m.namespace}/${m.name}`);
+            }
+            console.error('  Specify the full namespace/name.');
+            process.exit(1);
+        }
+        throw err;
+    }
+    // 2. Dry run
+    if (options.dryRun) {
+        console.log('');
+        console.log(header('Dry Run — No changes will be made'));
+        console.log('');
+        console.log('Would remove:');
+        for (const agent of Object.values(state.agents)) {
+            console.log(`  - Agent ${agent.id} from config`);
+            console.log(`  - Workspace ${agent.workspace}`);
+        }
+        for (const binding of state.bindings) {
+            console.log(`  - Binding ${binding.match.channel} → ${binding.agentId}`);
+        }
+        for (const job of state.cronJobs) {
+            console.log(`  - Cron job ${job.name} (${job.id})`);
+        }
+        console.log(`  - State file ${state.namespace}/${state.name}`);
+        return;
+    }
+    // 3. Confirm
+    if (!options.yes) {
+        console.log('');
+        console.log(header('Uninstall'));
+        console.log('');
+        console.log(`${label('Formation:')} ${value(`${state.namespace}/${state.name}`)} v${state.version}`);
+        console.log(`${label('Agents:')} ${Object.keys(state.agents).length}`);
+        console.log(`${label('Bindings:')} ${state.bindings.length}`);
+        console.log(`${label('Cron Jobs:')} ${state.cronJobs.length}`);
+        console.log('');
+        const { confirm } = await import('@inquirer/prompts');
+        const ok = await confirm({
+            message: 'Remove this formation and all its resources?',
+        });
+        if (!ok) {
+            console.log('Aborted.');
+            process.exit(0);
+        }
+    }
+    const spinner = ora('Uninstalling formation...').start();
+    // 4. Gateway RPC cleanup — agents.delete + cron removal
+    // Always attempt Gateway connection (not just for cron), because agents.delete
+    // invalidates the agent in Gateway's runtime state, preventing dashboard ghosts.
+    spinner.text = 'Cleaning up Gateway state...';
+    const { config: gwConfig } = await readConfig();
+    const gwUrl = options.gatewayUrl ?? resolveGatewayUrl(gwConfig, process.env);
+    const gwAuth = resolveGatewayAuth({
+        gatewayUrl: options.gatewayUrl,
+        gatewayToken: options.gatewayToken,
+        gatewayPassword: options.gatewayPassword,
+        config: gwConfig,
+    });
+    const gw = new GatewayClient({
+        url: gwUrl,
+        ...gwAuth,
+    });
+    try {
+        await gw.connect();
+        for (const agent of Object.values(state.agents)) {
+            try {
+                await gw.call('agents.delete', { agentId: agent.id });
+            }
+            catch {
+                // Agent may not exist in Gateway runtime — that's fine
+            }
+        }
+        for (const job of state.cronJobs) {
+            try {
+                await gw.cronRemove(job.id);
+            }
+            catch {
+                // Job may already be gone
+            }
+        }
+        gw.close();
+    }
+    catch {
+        spinner.warn('Could not connect to Gateway — restart Gateway to clear agent state');
+    }
+    // 5. Patch config
+    spinner.text = 'Removing config entries...';
+    let { config, path: configPath } = await readConfig();
+    for (const binding of state.bindings) {
+        config = removeBinding(config, binding);
+    }
+    for (const agent of Object.values(state.agents)) {
+        config = removeAgentEntry(config, agent.id);
+    }
+    // Remove agentToAgent allow entry if no other formations share namespace
+    if (state.agentToAgent?.allowAdded) {
+        const allStates = await listStates();
+        const otherInNamespace = allStates.some((s) => s.namespace === state.namespace &&
+            s.name !== state.name);
+        config = removeAgentToAgent(config, state.namespace, otherInNamespace, state.agentToAgent.wasEnabled);
+    }
+    await writeConfig(configPath, config, { silent: true });
+    // 6. Delete workspace directories
+    spinner.text = 'Removing workspace directories...';
+    for (const agent of Object.values(state.agents)) {
+        try {
+            await rm(agent.workspace, { recursive: true, force: true });
+        }
+        catch {
+            // Already gone
+        }
+    }
+    // 7. Clean up Gateway agent state (sessions, agent dir, qmd memory)
+    const resolvedStateDir = resolve(resolveStateDir());
+    for (const agent of Object.values(state.agents)) {
+        const statePaths = resolveAgentStatePaths(agent.id);
+        for (const p of statePaths) {
+            if (!existsSync(p))
+                continue;
+            // Robust containment check: resolve both paths, verify relative path
+            // doesn't escape (no leading ".." segments)
+            const resolvedPath = resolve(p);
+            const rel = relative(resolvedStateDir, resolvedPath);
+            if (rel.startsWith('..') || resolve(resolvedStateDir, rel) !== resolvedPath) {
+                continue;
+            }
+            try {
+                await rm(p, { recursive: true, force: true });
+            }
+            catch {
+                // May fail if parent dir has other contents — that's fine
+            }
+        }
+    }
+    // 8. Delete state
+    await deleteState(state.namespace, state.name);
+    spinner.succeed('Formation uninstalled');
+    console.log('');
+    console.log(`${icons.success} ${chalk.green(`Removed ${Object.keys(state.agents).length} agents, ${state.bindings.length} bindings, ${state.cronJobs.length} cron jobs`)}`);
+}
+//# sourceMappingURL=uninstall.js.map

package/dist/commands/uninstall.js.map

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

package/dist/commands/update.d.ts

@@ -0,0 +1,12 @@
+export interface UpdateOptions {
+    set?: string[];
+    namespace?: string;
+    yes?: boolean;
+    noEnv?: boolean;
+    dryRun?: boolean;
+    gatewayUrl?: string;
+    gatewayToken?: string;
+    gatewayPassword?: string;
+}
+export declare function update(formationPath: string, options: UpdateOptions): Promise<void>;
+//# sourceMappingURL=update.d.ts.map

package/dist/commands/update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../src/commands/update.ts"],"names":[],"mappings":"AA+CA,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAoBD,wBAAsB,MAAM,CAC1B,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,IAAI,CAAC,CA2iBf"}