@orgloop/cli 0.1.0

package/dist/commands/apply.js

@@ -0,0 +1,289 @@
+/**
+ * orgloop apply — Start/update the runtime with current config.
+ *
+ * Loads config, creates OrgLoop engine instance, starts it.
+ * Foreground by default; --daemon forks to background.
+ */
+import { fork } from 'node:child_process';
+import { mkdir, writeFile } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import chalk from 'chalk';
+import { loadCliConfig, resolveConfigPath } from '../config.js';
+import { getEnvVarMeta } from '../env-metadata.js';
+import * as output from '../output.js';
+import { resolveConnectors } from '../resolve-connectors.js';
+import { scanEnvVars } from './env.js';
+const PID_DIR = join(homedir(), '.orgloop');
+const PID_FILE = join(PID_DIR, 'orgloop.pid');
+const STATE_FILE = join(PID_DIR, 'state.json');
+// ─── State persistence ──────────────────────────────────────────────────────
+async function saveState(config) {
+    await mkdir(PID_DIR, { recursive: true });
+    const state = {
+        sources: Object.fromEntries(config.sources.map((s) => [
+            s.id,
+            { connector: s.connector, poll_interval: s.poll?.interval },
+        ])),
+        actors: Object.fromEntries(config.actors.map((a) => [a.id, { connector: a.connector }])),
+        routes: Object.fromEntries(config.routes.map((r) => [r.name, { source: r.when.source, actor: r.then.actor }])),
+        transforms: Object.fromEntries(config.transforms.map((t) => [t.name, { type: t.type }])),
+        loggers: Object.fromEntries(config.loggers.map((l) => [l.name, { type: l.type }])),
+    };
+    await writeFile(STATE_FILE, JSON.stringify(state, null, 2), 'utf-8');
+}
+// ─── Foreground run ──────────────────────────────────────────────────────────
+async function runForeground(configPath) {
+    // Pre-flight: check all env vars before loadCliConfig crashes on the first one
+    try {
+        const resolvedPath = resolveConfigPath(configPath);
+        const envVars = await scanEnvVars(resolvedPath);
+        const missing = [];
+        const present = [];
+        for (const [name, source] of envVars) {
+            if (process.env[name] === undefined) {
+                missing.push({ name, source });
+            }
+            else {
+                present.push({ name, source });
+            }
+        }
+        if (missing.length > 0) {
+            const maxLen = Math.max(...[...envVars.keys()].map((k) => k.length));
+            output.blank();
+            output.heading('Environment Variables:');
+            output.blank();
+            for (const v of present) {
+                console.log(`  ${chalk.green('\u2713')} ${v.name.padEnd(maxLen)}  ${chalk.dim(v.source)}`);
+            }
+            for (const v of missing) {
+                console.log(`  ${chalk.red('\u2717')} ${v.name.padEnd(maxLen)}  ${chalk.dim(v.source)}`);
+                const meta = getEnvVarMeta(v.name);
+                if (meta) {
+                    console.log(`    ${chalk.dim('\u2192')} ${chalk.dim(meta.description)}`);
+                    if (meta.help_url) {
+                        console.log(`    ${chalk.dim('\u2192')} ${chalk.dim(meta.help_url)}`);
+                    }
+                }
+            }
+            output.blank();
+            output.error(`${missing.length} variable${missing.length > 1 ? 's' : ''} missing \u2014 run \`orgloop env\` for details.`);
+            process.exitCode = 1;
+            return;
+        }
+    }
+    catch {
+        // Pre-flight is best-effort — fall through to loadCliConfig
+    }
+    const config = await loadCliConfig({ configPath });
+    output.blank();
+    output.info('Applying plan...');
+    output.blank();
+    // Import OrgLoop from core — this may fail if core isn't built yet
+    let OrgLoop;
+    try {
+        const core = await import('@orgloop/core');
+        OrgLoop = core.OrgLoop;
+    }
+    catch {
+        // Core not available yet — run in stub mode
+        output.warn('OrgLoop core not available — running in config-only mode');
+        output.blank();
+        // Display what would be started
+        for (const s of config.sources) {
+            const interval = s.poll?.interval
+                ? `polling started (every ${s.poll.interval})`
+                : 'hook listener started';
+            output.success(`Source ${s.id} — ${interval}`);
+        }
+        for (const a of config.actors) {
+            output.success(`Actor ${a.id} — ready`);
+        }
+        for (const r of config.routes) {
+            output.success(`Route ${r.name} — active`);
+        }
+        for (const l of config.loggers) {
+            output.success(`Logger ${l.name} — configured`);
+        }
+        await saveState(config);
+        // Write PID file
+        await mkdir(PID_DIR, { recursive: true });
+        await writeFile(PID_FILE, String(process.pid), 'utf-8');
+        output.blank();
+        output.info(`OrgLoop is running. PID: ${process.pid}`);
+        output.info('Logs: orgloop logs | Status: orgloop status | Stop: orgloop stop');
+        // Keep process alive
+        const shutdown = async () => {
+            output.blank();
+            output.info('Shutting down...');
+            const { unlink } = await import('node:fs/promises');
+            try {
+                await unlink(PID_FILE);
+            }
+            catch {
+                /* ignore */
+            }
+            process.exit(0);
+        };
+        process.on('SIGTERM', shutdown);
+        process.on('SIGINT', shutdown);
+        // Block forever
+        await new Promise(() => { });
+        return;
+    }
+    // Resolve connectors from config
+    let resolvedSources;
+    let resolvedActors;
+    try {
+        const resolved = await resolveConnectors(config);
+        resolvedSources = resolved.sources;
+        resolvedActors = resolved.actors;
+    }
+    catch (err) {
+        output.error(`Connector resolution failed: ${err instanceof Error ? err.message : String(err)}`);
+        process.exitCode = 1;
+        return;
+    }
+    // Create persistent checkpoint store
+    let checkpointStore;
+    try {
+        const { FileCheckpointStore } = await import('@orgloop/core');
+        checkpointStore = new FileCheckpointStore();
+    }
+    catch {
+        // Fall through — engine will use InMemoryCheckpointStore
+    }
+    // Resolve package transforms from config
+    const resolvedTransforms = new Map();
+    for (const tDef of config.transforms) {
+        if (tDef.type === 'package' && tDef.package) {
+            try {
+                const mod = await import(tDef.package);
+                if (typeof mod.register === 'function') {
+                    const reg = mod.register();
+                    resolvedTransforms.set(tDef.name, new reg.transform());
+                }
+            }
+            catch (err) {
+                output.warn(`Transform "${tDef.name}" (${tDef.package}) not available: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+    }
+    // Resolve loggers from config
+    const resolvedLoggers = new Map();
+    for (const loggerDef of config.loggers) {
+        try {
+            const mod = await import(loggerDef.type);
+            if (typeof mod.register === 'function') {
+                const reg = mod.register();
+                resolvedLoggers.set(loggerDef.name, new reg.logger());
+            }
+        }
+        catch (err) {
+            output.warn(`Logger "${loggerDef.name}" (${loggerDef.type}) not available: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    // Core is available — start the engine
+    const engine = new OrgLoop(config, {
+        sources: resolvedSources,
+        actors: resolvedActors,
+        transforms: resolvedTransforms,
+        loggers: resolvedLoggers,
+        ...(checkpointStore ? { checkpointStore } : {}),
+    });
+    // Signal handling
+    const shutdown = async () => {
+        output.blank();
+        output.info('Shutting down...');
+        await engine.stop();
+        const { unlink } = await import('node:fs/promises');
+        try {
+            await unlink(PID_FILE);
+        }
+        catch {
+            /* ignore */
+        }
+        process.exit(0);
+    };
+    process.on('SIGTERM', shutdown);
+    process.on('SIGINT', shutdown);
+    try {
+        // Display progress as components initialize
+        for (const s of config.sources) {
+            const interval = s.poll?.interval
+                ? `polling started (every ${s.poll.interval})`
+                : 'hook listener started';
+            output.success(`Source ${s.id} — ${interval}`);
+        }
+        for (const a of config.actors) {
+            output.success(`Actor ${a.id} — ready`);
+        }
+        for (const r of config.routes) {
+            output.success(`Route ${r.name} — active`);
+        }
+        for (const l of config.loggers) {
+            output.success(`Logger ${l.name} — configured`);
+        }
+        await engine.start();
+        await saveState(config);
+        // Write PID file
+        await mkdir(PID_DIR, { recursive: true });
+        await writeFile(PID_FILE, String(process.pid), 'utf-8');
+        output.blank();
+        output.info(`OrgLoop is running. PID: ${process.pid}`);
+        output.info('Logs: orgloop logs | Status: orgloop status | Stop: orgloop stop');
+    }
+    catch (err) {
+        output.error(`Failed to start: ${err instanceof Error ? err.message : String(err)}`);
+        process.exitCode = 1;
+    }
+}
+// ─── Command registration ────────────────────────────────────────────────────
+export function registerApplyCommand(program) {
+    program
+        .command('apply')
+        .description('Start/update the runtime with current config')
+        .option('--daemon', 'Run as background daemon')
+        .action(async (opts, cmd) => {
+        try {
+            const globalOpts = cmd.parent?.opts() ?? {};
+            if (opts.daemon) {
+                // Fork to background
+                const config = await loadCliConfig({ configPath: globalOpts.config });
+                output.info('Starting OrgLoop daemon...');
+                const child = fork(fileURLToPath(import.meta.url), ['--foreground'], {
+                    detached: true,
+                    stdio: 'ignore',
+                    env: {
+                        ...process.env,
+                        ORGLOOP_CONFIG: globalOpts.config ?? '',
+                        ORGLOOP_DAEMON: '1',
+                    },
+                });
+                child.unref();
+                if (child.pid) {
+                    await mkdir(PID_DIR, { recursive: true });
+                    await writeFile(PID_FILE, String(child.pid), 'utf-8');
+                    output.success(`OrgLoop daemon started. PID: ${child.pid}`);
+                    output.info(`PID file: ${PID_FILE}`);
+                }
+            }
+            else {
+                await runForeground(globalOpts.config);
+            }
+        }
+        catch (err) {
+            output.error(`Apply failed: ${err instanceof Error ? err.message : String(err)}`);
+            process.exitCode = 1;
+        }
+    });
+}
+// Handle being run as a forked daemon child
+if (process.env.ORGLOOP_DAEMON === '1') {
+    runForeground(process.env.ORGLOOP_CONFIG || undefined).catch((err) => {
+        console.error('Daemon failed:', err);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=apply.js.map

package/dist/commands/apply.js.map

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

package/dist/commands/doctor.d.ts

@@ -0,0 +1,45 @@
+/**
+ * orgloop doctor — Pre-flight environment validation.
+ *
+ * Runs validate internally (config, transforms, route graph), then adds
+ * live checks: credential validation, service detection. Uses Stage 2
+ * connector maturity (credential validators and service detectors) when
+ * connectors provide them.
+ *
+ * Supports --json for machine-readable output.
+ */
+import type { CredentialValidator, ServiceDetector } from '@orgloop/sdk';
+import type { Command } from 'commander';
+import { type ImportFn } from '../resolve-connectors.js';
+export interface DoctorCheck {
+    category: 'credential' | 'config' | 'transform' | 'route-graph' | 'service';
+    name: string;
+    status: 'ok' | 'missing' | 'error' | 'warning';
+    detail?: string;
+    description?: string;
+    help_url?: string;
+    /** Identity from credential validation (e.g., "user: @alice") */
+    identity?: string;
+    /** Scopes from credential validation (e.g., ["repo", "read:org"]) */
+    scopes?: string[];
+}
+export interface DoctorResult {
+    status: 'ok' | 'degraded' | 'error';
+    project: string;
+    checks: DoctorCheck[];
+}
+/**
+ * Run validate internally, converting its results to DoctorCheck format.
+ * This is the static analysis phase — config, transforms, route graph.
+ */
+export declare function checkValidation(configPath: string): Promise<DoctorCheck[]>;
+export declare function checkCredentials(configPath: string, validators?: Map<string, CredentialValidator>): Promise<DoctorCheck[]>;
+/**
+ * Check service availability using service detectors from connector registrations.
+ * Connector-agnostic: discovers detectors through the registration, never hardcodes
+ * connector-specific logic.
+ */
+export declare function checkServices(detectors: Map<string, ServiceDetector>): Promise<DoctorCheck[]>;
+export declare function runDoctor(configPath: string, importFn?: ImportFn): Promise<DoctorResult>;
+export declare function registerDoctorCommand(program: Command): void;
+//# sourceMappingURL=doctor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEzE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKzC,OAAO,EAAE,KAAK,QAAQ,EAAiC,MAAM,0BAA0B,CAAC;AAMxF,MAAM,WAAW,WAAW;IAC3B,QAAQ,EAAE,YAAY,GAAG,QAAQ,GAAG,WAAW,GAAG,aAAa,GAAG,SAAS,CAAC;IAC5E,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,IAAI,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC5B,MAAM,EAAE,IAAI,GAAG,UAAU,GAAG,OAAO,CAAC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,WAAW,EAAE,CAAC;CACtB;AAWD;;;GAGG;AACH,wBAAsB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CA4ChF;AAED,wBAAsB,gBAAgB,CACrC,UAAU,EAAE,MAAM,EAClB,UAAU,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,GAC3C,OAAO,CAAC,WAAW,EAAE,CAAC,CAiExB;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAClC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,GACrC,OAAO,CAAC,WAAW,EAAE,CAAC,CAmCxB;AAID,wBAAsB,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,YAAY,CAAC,CA+D9F;AAiFD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA2B5D"}