@orgloop/cli 0.1.0

package/dist/commands/hook.js

@@ -0,0 +1,80 @@
+/**
+ * orgloop hook — Forward hook events to a running OrgLoop engine.
+ *
+ * Reads stdin and POSTs the raw JSON body to the engine's webhook endpoint.
+ * This is a stdin-to-HTTP bridge — the connector's webhook handler builds
+ * the OrgLoopEvent from the raw payload.
+ */
+// ─── Constants ──────────────────────────────────────────────────────────────
+const DEFAULT_PORT = 4800;
+// ─── Helpers ────────────────────────────────────────────────────────────────
+function resolvePort(portFlag) {
+    if (portFlag) {
+        const n = Number.parseInt(portFlag, 10);
+        if (!Number.isNaN(n) && n > 0 && n <= 65535)
+            return n;
+    }
+    const envPort = process.env.ORGLOOP_PORT;
+    if (envPort) {
+        const n = Number.parseInt(envPort, 10);
+        if (!Number.isNaN(n) && n > 0 && n <= 65535)
+            return n;
+    }
+    return DEFAULT_PORT;
+}
+export function readStdin() {
+    return new Promise((resolve, reject) => {
+        let data = '';
+        process.stdin.setEncoding('utf-8');
+        process.stdin.on('data', (chunk) => {
+            data += chunk;
+        });
+        process.stdin.on('end', () => resolve(data));
+        process.stdin.on('error', reject);
+    });
+}
+export async function postToWebhook(sourceId, body, port) {
+    const url = `http://127.0.0.1:${port}/webhook/${sourceId}`;
+    const res = await fetch(url, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body,
+    });
+    const text = await res.text();
+    return { ok: res.ok, status: res.status, body: text };
+}
+// ─── Command registration ────────────────────────────────────────────────────
+export function registerHookCommand(program) {
+    const hook = program.command('hook').description('Forward hook events to running OrgLoop engine');
+    hook
+        .command('claude-code-stop')
+        .description('Forward Claude Code stop hook event')
+        .option('--port <port>', 'Engine webhook port')
+        .action(async (opts) => {
+        const port = resolvePort(opts.port);
+        let body;
+        try {
+            body = await readStdin();
+        }
+        catch {
+            process.stderr.write('orgloop hook: failed to read stdin\n');
+            process.exitCode = 1;
+            return;
+        }
+        try {
+            const result = await postToWebhook('claude-code', body, port);
+            if (!result.ok) {
+                process.stderr.write(`orgloop hook: webhook returned ${result.status}: ${result.body}\n`);
+                process.exitCode = 1;
+            }
+        }
+        catch (err) {
+            const msg = err instanceof Error && 'code' in err && err.code === 'ECONNREFUSED'
+                ? 'OrgLoop engine is not running. Start it with: orgloop apply'
+                : `Failed to deliver hook event: ${err instanceof Error ? err.message : String(err)}`;
+            process.stderr.write(`orgloop hook: ${msg}\n`);
+            process.exitCode = 1;
+        }
+    });
+}
+//# sourceMappingURL=hook.js.map

package/dist/commands/hook.js.map

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

package/dist/commands/init.d.ts

@@ -0,0 +1,42 @@
+/**
+ * orgloop init — Scaffold a new OrgLoop project.
+ *
+ * Interactive mode (default): prompts for project name, description, connectors.
+ * Non-interactive: --name, --connectors, --no-interactive flags.
+ */
+import type { Command } from 'commander';
+/**
+ * Scan connector YAML for ${VAR} references and return a map of
+ * var name → connector file that requires it.
+ */
+export declare function collectEnvVars(connectors: string[]): Map<string, string>;
+/**
+ * Build the contents for a .env.example file from collected env vars.
+ */
+export declare function buildEnvExampleContent(envVars: Map<string, string>): string;
+/**
+ * Build a Claude Code Stop hook entry in the object format expected by
+ * Claude Code's settings.json.
+ */
+export declare function buildClaudeCodeHookEntry(command: string): {
+    matcher: string;
+    hooks: {
+        type: string;
+        command: string;
+    }[];
+};
+/**
+ * Check whether a Stop hooks array already contains an orgloop hook.
+ * Handles the object format: [{ matcher, hooks: [{ type, command }] }].
+ */
+export declare function hasExistingOrgloopHook(stopHooks: unknown[]): boolean;
+/**
+ * Merge an orgloop hook into a settings object. Returns the updated settings
+ * and a boolean indicating whether the hook was already present.
+ */
+export declare function mergeClaudeCodeHook(settings: Record<string, unknown>, hookCommand: string): {
+    settings: Record<string, unknown>;
+    alreadyInstalled: boolean;
+};
+export declare function registerInitCommand(program: Command): void;
+//# sourceMappingURL=init.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAyOzC;;;GAGG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAaxE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAgB3E;AAiGD;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM;;;;;;EAKvD;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,OAAO,EAAE,GAAG,OAAO,CAOpE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAClC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,WAAW,EAAE,MAAM,GACjB;IAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,gBAAgB,EAAE,OAAO,CAAA;CAAE,CAYlE;AA0DD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAyH1D"}

package/dist/commands/init.js

@@ -0,0 +1,532 @@
+/**
+ * orgloop init — Scaffold a new OrgLoop project.
+ *
+ * Interactive mode (default): prompts for project name, description, connectors.
+ * Non-interactive: --name, --connectors, --no-interactive flags.
+ */
+import { access, mkdir, readFile, writeFile } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { join, resolve } from 'node:path';
+import chalk from 'chalk';
+import { getEnvVarMeta } from '../env-metadata.js';
+import * as output from '../output.js';
+// ─── Connectors ──────────────────────────────────────────────────────────────
+const AVAILABLE_CONNECTORS = [
+    'github',
+    'linear',
+    'openclaw',
+    'claude-code',
+    'webhook',
+    'slack',
+    'pagerduty',
+];
+function connectorYaml(name, role) {
+    const configs = {
+        github: `apiVersion: orgloop/v1alpha1
+kind: ConnectorGroup
+
+sources:
+  - id: github
+    description: GitHub repository events
+    connector: "@orgloop/connector-github"
+    config:
+      repo: "\${GITHUB_REPO}"
+      token: "\${GITHUB_TOKEN}"
+      events:
+        - "pull_request.review_submitted"
+        - "pull_request_review_comment"
+        - "issue_comment"
+        - "pull_request.closed"
+        - "pull_request.merged"
+        - "workflow_run.completed"
+    poll:
+      interval: "5m"
+    emits:
+      - resource.changed
+`,
+        linear: `apiVersion: orgloop/v1alpha1
+kind: ConnectorGroup
+
+sources:
+  - id: linear
+    description: Linear project tracking events
+    connector: "@orgloop/connector-linear"
+    config:
+      team: "\${LINEAR_TEAM_KEY}"
+      api_key: "\${LINEAR_API_KEY}"
+    poll:
+      interval: "5m"
+    emits:
+      - resource.changed`,
+        openclaw: `apiVersion: orgloop/v1alpha1
+kind: ConnectorGroup
+
+actors:
+  - id: openclaw-engineering-agent
+    description: OpenClaw engineering agent
+    connector: "@orgloop/connector-openclaw"
+    config:
+      base_url: "http://127.0.0.1:18789"
+      auth_token_env: "\${OPENCLAW_WEBHOOK_TOKEN}"
+      agent_id: "\${OPENCLAW_AGENT_ID}"`,
+        'claude-code': `apiVersion: orgloop/v1alpha1
+kind: ConnectorGroup
+
+sources:
+  - id: claude-code
+    description: Claude Code session events
+    connector: "@orgloop/connector-claude-code"
+    config:
+      hook_type: post-exit
+    emits:
+      - actor.stopped`,
+        webhook: `apiVersion: orgloop/v1alpha1
+kind: ConnectorGroup
+
+sources:
+  - id: webhook
+    description: Generic webhook receiver
+    connector: "@orgloop/connector-webhook"
+    config:
+      path: "/webhook"
+    emits:
+      - resource.changed
+      - message.received`,
+        slack: `apiVersion: orgloop/v1alpha1
+kind: ConnectorGroup
+
+actors:
+  - id: slack-notify
+    description: Slack notification delivery
+    connector: "@orgloop/connector-webhook"
+    config:
+      url: "\${SLACK_WEBHOOK_URL}"`,
+        pagerduty: `apiVersion: orgloop/v1alpha1
+kind: ConnectorGroup
+
+actors:
+  - id: pagerduty
+    description: PagerDuty incident delivery
+    connector: "@orgloop/connector-webhook"
+    config:
+      url: "\${PAGERDUTY_WEBHOOK_URL}"`,
+    };
+    return configs[name] ?? configs.webhook;
+}
+function generateOrgloopYaml(name, description, connectors) {
+    const connectorRefs = connectors.map((c) => `  - connectors/${c}.yaml`).join('\n');
+    return `apiVersion: orgloop/v1alpha1
+kind: Project
+
+metadata:
+  name: ${name}
+  description: "${description}"
+
+defaults:
+  poll_interval: "5m"
+  event_retention: "30d"
+  log_level: info
+
+connectors:
+${connectorRefs}
+
+transforms:
+  - transforms/transforms.yaml
+
+loggers:
+  - loggers/default.yaml
+`;
+}
+function generateDefaultRouteYaml() {
+    return `apiVersion: orgloop/v1alpha1
+kind: RouteGroup
+
+routes:
+  - name: example-route
+    description: Example route — customize for your setup
+    when:
+      source: github
+      events:
+        - resource.changed
+    transforms:
+      - ref: drop-bot-noise
+    then:
+      actor: openclaw-engineering-agent
+    with:
+      prompt_file: ../sops/example.md
+`;
+}
+function generateDefaultTransformsYaml() {
+    return `apiVersion: orgloop/v1alpha1
+kind: TransformGroup
+
+transforms:
+  - name: drop-bot-noise
+    type: script
+    script: ./drop-bot-noise.sh
+    timeout_ms: 5000
+`;
+}
+function generateDropBotScript() {
+    return `#!/usr/bin/env bash
+# drop-bot-noise.sh — Drop events from known bot authors.
+#
+# Reads OrgLoop event JSON from stdin.
+# Exit 0 = PASS (forward event), Exit 78 = DROP (discard event).
+
+set -euo pipefail
+
+EVENT=$(cat)
+AUTHOR_TYPE=$(echo "$EVENT" | jq -r '.provenance.author_type // "unknown"')
+
+if [ "$AUTHOR_TYPE" = "bot" ]; then
+  exit 78  # DROP
+fi
+
+# PASS — forward the event unchanged
+echo "$EVENT"
+exit 0
+`;
+}
+function generateDefaultLoggerYaml() {
+    return `apiVersion: orgloop/v1alpha1
+kind: LoggerGroup
+
+loggers:
+  - name: file-log
+    type: "@orgloop/logger-file"
+    config:
+      path: "~/.orgloop/logs/orgloop.log"
+      format: jsonl
+      rotate:
+        max_size: "50MB"
+        max_files: 10
+`;
+}
+function generateExampleSop() {
+    return `# Example Launch Prompt
+
+You are receiving an event from the organization pipeline.
+
+## Context
+This event was routed through OrgLoop based on the configured rules.
+
+## Instructions
+1. Review the event payload
+2. Take appropriate action based on the event type
+3. Report completion status
+
+## Constraints
+- Do not modify production infrastructure without approval
+- Follow the organization's coding standards
+- Escalate security-related events immediately
+`;
+}
+// ─── Env var collection ──────────────────────────────────────────────────────
+/**
+ * Scan connector YAML for ${VAR} references and return a map of
+ * var name → connector file that requires it.
+ */
+export function collectEnvVars(connectors) {
+    const envVars = new Map();
+    for (const conn of connectors) {
+        const yamlContent = connectorYaml(conn, ['openclaw', 'slack', 'pagerduty'].includes(conn) ? 'actor' : 'source');
+        const matches = yamlContent.matchAll(/\$\{([^}]+)\}/g);
+        for (const match of matches) {
+            envVars.set(match[1], `connectors/${conn}.yaml`);
+        }
+    }
+    return envVars;
+}
+/**
+ * Build the contents for a .env.example file from collected env vars.
+ */
+export function buildEnvExampleContent(envVars) {
+    const lines = [
+        '# OrgLoop environment variables',
+        '# Copy to .env and fill in values',
+        '',
+    ];
+    for (const [varName] of envVars) {
+        const meta = getEnvVarMeta(varName);
+        if (meta) {
+            lines.push(`# ${meta.description}`);
+            if (meta.help_url)
+                lines.push(`# ${meta.help_url}`);
+        }
+        lines.push(`# ${varName}=`);
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+// ─── File creation ───────────────────────────────────────────────────────────
+async function dirExists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function scaffoldProject(targetDir, name, description, connectors) {
+    const created = [];
+    // Create directories
+    await mkdir(join(targetDir, 'connectors'), { recursive: true });
+    await mkdir(join(targetDir, 'routes'), { recursive: true });
+    await mkdir(join(targetDir, 'transforms'), { recursive: true });
+    await mkdir(join(targetDir, 'loggers'), { recursive: true });
+    await mkdir(join(targetDir, 'sops'), { recursive: true });
+    // orgloop.yaml
+    const orgloopPath = join(targetDir, 'orgloop.yaml');
+    await writeFile(orgloopPath, generateOrgloopYaml(name, description, connectors), 'utf-8');
+    created.push('orgloop.yaml');
+    // Connector files
+    for (const conn of connectors) {
+        const connPath = join(targetDir, 'connectors', `${conn}.yaml`);
+        const role = ['openclaw', 'slack', 'pagerduty'].includes(conn) ? 'actor' : 'source';
+        await writeFile(connPath, connectorYaml(conn, role), 'utf-8');
+        created.push(`connectors/${conn}.yaml`);
+    }
+    // Route files
+    const routePath = join(targetDir, 'routes', 'example.yaml');
+    await writeFile(routePath, generateDefaultRouteYaml(), 'utf-8');
+    created.push('routes/example.yaml');
+    // Logger files
+    const loggerPath = join(targetDir, 'loggers', 'default.yaml');
+    await writeFile(loggerPath, generateDefaultLoggerYaml(), 'utf-8');
+    created.push('loggers/default.yaml');
+    // Transform files
+    const transformsYamlPath = join(targetDir, 'transforms', 'transforms.yaml');
+    await writeFile(transformsYamlPath, generateDefaultTransformsYaml(), 'utf-8');
+    created.push('transforms/transforms.yaml');
+    const scriptPath = join(targetDir, 'transforms', 'drop-bot-noise.sh');
+    await writeFile(scriptPath, generateDropBotScript(), 'utf-8');
+    const { chmod } = await import('node:fs/promises');
+    await chmod(scriptPath, 0o755);
+    created.push('transforms/drop-bot-noise.sh');
+    // SOP files
+    const sopPath = join(targetDir, 'sops', 'example.md');
+    await writeFile(sopPath, generateExampleSop(), 'utf-8');
+    created.push('sops/example.md');
+    // Generate .env.example
+    const envVars = collectEnvVars(connectors);
+    if (envVars.size > 0) {
+        await writeFile(join(targetDir, '.env.example'), buildEnvExampleContent(envVars), 'utf-8');
+        created.push('.env.example');
+    }
+    // Generate .gitignore (only if it doesn't already exist)
+    const gitignorePath = join(targetDir, '.gitignore');
+    if (!(await dirExists(gitignorePath))) {
+        const gitignoreContent = `# Environment variables (contains secrets)
+.env
+.env.local
+
+# OrgLoop runtime
+.orgloop/
+
+# Node
+node_modules/
+dist/
+`;
+        await writeFile(gitignorePath, gitignoreContent, 'utf-8');
+        created.push('.gitignore');
+    }
+    return created;
+}
+// ─── Claude Code hook helpers (exported for testing) ─────────────────────────
+/**
+ * Build a Claude Code Stop hook entry in the object format expected by
+ * Claude Code's settings.json.
+ */
+export function buildClaudeCodeHookEntry(command) {
+    return {
+        matcher: '',
+        hooks: [{ type: 'command', command }],
+    };
+}
+/**
+ * Check whether a Stop hooks array already contains an orgloop hook.
+ * Handles the object format: [{ matcher, hooks: [{ type, command }] }].
+ */
+export function hasExistingOrgloopHook(stopHooks) {
+    return stopHooks.some((entry) => {
+        if (typeof entry !== 'object' || entry === null)
+            return false;
+        const obj = entry;
+        const innerHooks = obj.hooks;
+        return innerHooks?.some((h) => typeof h.command === 'string' && h.command.includes('orgloop'));
+    });
+}
+/**
+ * Merge an orgloop hook into a settings object. Returns the updated settings
+ * and a boolean indicating whether the hook was already present.
+ */
+export function mergeClaudeCodeHook(settings, hookCommand) {
+    const hooks = (settings.hooks ?? {});
+    const stopHooks = (hooks.Stop ?? []);
+    if (hasExistingOrgloopHook(stopHooks)) {
+        return { settings, alreadyInstalled: true };
+    }
+    stopHooks.push(buildClaudeCodeHookEntry(hookCommand));
+    hooks.Stop = stopHooks;
+    settings.hooks = hooks;
+    return { settings, alreadyInstalled: false };
+}
+// ─── Claude Code hook onboarding ──────────────────────────────────────────────
+async function promptClaudeCodeHook() {
+    const { default: inquirer } = await import('inquirer');
+    const { scope } = await inquirer.prompt([
+        {
+            type: 'list',
+            name: 'scope',
+            message: 'Install OrgLoop hook to Claude Code settings?',
+            choices: [
+                { name: 'Global (~/.claude/settings.json)', value: 'global' },
+                { name: 'Project (.claude/settings.json)', value: 'project' },
+                { name: 'Skip', value: 'skip' },
+            ],
+        },
+    ]);
+    if (scope === 'skip')
+        return;
+    const settingsPath = scope === 'global'
+        ? join(homedir(), '.claude', 'settings.json')
+        : join(process.cwd(), '.claude', 'settings.json');
+    const hookCommand = 'orgloop hook claude-code-stop';
+    try {
+        let settings = {};
+        try {
+            const content = await readFile(settingsPath, 'utf-8');
+            settings = JSON.parse(content);
+        }
+        catch {
+            // File doesn't exist yet
+        }
+        const result = mergeClaudeCodeHook(settings, hookCommand);
+        if (result.alreadyInstalled) {
+            output.info('  OrgLoop hook already installed in Claude Code settings.');
+            return;
+        }
+        await mkdir(join(settingsPath, '..'), { recursive: true });
+        await writeFile(settingsPath, `${JSON.stringify(result.settings, null, 2)}\n`, 'utf-8');
+        output.success(`  Installed Claude Code Stop hook → ${chalk.dim(settingsPath)}`);
+    }
+    catch (err) {
+        output.warn(`  Could not install hook: ${err instanceof Error ? err.message : String(err)}`);
+        output.info(`  Manually add to ${settingsPath}:`);
+        output.info(`    "hooks": { "Stop": [{ "matcher": "", "hooks": [{ "type": "command", "command": "${hookCommand}" }] }] }`);
+    }
+}
+// ─── Command registration ────────────────────────────────────────────────────
+export function registerInitCommand(program) {
+    program
+        .command('init')
+        .description('Scaffold a new OrgLoop project')
+        .option('--name <name>', 'Project name')
+        .option('--description <desc>', 'Project description')
+        .option('--connectors <list>', 'Comma-separated connector list')
+        .option('--no-interactive', 'Disable interactive prompts')
+        .option('--dir <path>', 'Target directory (default: current directory)')
+        .action(async (opts) => {
+        try {
+            const targetDir = opts.dir ? resolve(opts.dir) : process.cwd();
+            let name;
+            let description;
+            let connectors;
+            if (opts.interactive === false) {
+                // Non-interactive mode
+                name = opts.name ?? 'my-org';
+                description = opts.description ?? 'OrgLoop project';
+                connectors = opts.connectors
+                    ? opts.connectors.split(',').map((c) => c.trim())
+                    : ['github'];
+            }
+            else {
+                // Interactive mode
+                const { default: inquirer } = await import('inquirer');
+                const answers = await inquirer.prompt([
+                    {
+                        type: 'input',
+                        name: 'name',
+                        message: 'Project name:',
+                        default: opts.name ?? 'my-org',
+                    },
+                    {
+                        type: 'input',
+                        name: 'description',
+                        message: 'Description:',
+                        default: opts.description ?? 'Organization event routing',
+                    },
+                    {
+                        type: 'checkbox',
+                        name: 'connectors',
+                        message: 'Which connectors?',
+                        choices: AVAILABLE_CONNECTORS.map((c) => ({
+                            name: c.charAt(0).toUpperCase() + c.slice(1),
+                            value: c,
+                            checked: ['github', 'linear', 'openclaw', 'claude-code'].includes(c),
+                        })),
+                    },
+                ]);
+                name = answers.name;
+                description = answers.description;
+                connectors = answers.connectors;
+            }
+            // Validate connectors
+            for (const c of connectors) {
+                if (!AVAILABLE_CONNECTORS.includes(c)) {
+                    output.error(`Unknown connector: ${c}`);
+                    output.info(`Available: ${AVAILABLE_CONNECTORS.join(', ')}`);
+                    process.exitCode = 1;
+                    return;
+                }
+            }
+            // Check for existing orgloop.yaml
+            if (await dirExists(join(targetDir, 'orgloop.yaml'))) {
+                output.error('orgloop.yaml already exists in this directory.');
+                output.info('Use a different directory or remove the existing file.');
+                process.exitCode = 1;
+                return;
+            }
+            const created = await scaffoldProject(targetDir, name, description, connectors);
+            output.blank();
+            output.heading('Created:');
+            for (const file of created) {
+                output.info(`  ${file}`);
+            }
+            // Show env var status with ✓/✗ indicators
+            const envVars = collectEnvVars(connectors);
+            if (envVars.size > 0) {
+                output.blank();
+                output.heading('Environment variables:');
+                for (const [varName, file] of envVars) {
+                    const isSet = process.env[varName] !== undefined;
+                    const icon = isSet ? chalk.green('✓') : chalk.red('✗');
+                    output.info(`  ${icon} ${chalk.yellow(varName.padEnd(22))} ${chalk.dim(file)}`);
+                    if (!isSet) {
+                        const meta = getEnvVarMeta(varName);
+                        if (meta) {
+                            output.info(`    ${chalk.dim('\u2192')} ${meta.description}`);
+                            if (meta.help_url) {
+                                output.info(`    ${chalk.dim('\u2192')} ${chalk.cyan(meta.help_url)}`);
+                            }
+                        }
+                    }
+                }
+            }
+            // Claude Code hook onboarding
+            if (connectors.includes('claude-code') && opts.interactive !== false) {
+                output.blank();
+                await promptClaudeCodeHook();
+            }
+            output.blank();
+            output.info(chalk.dim('Next: run `orgloop add module <name>` to install a workflow module, or `orgloop doctor` to check your environment.'));
+        }
+        catch (err) {
+            output.error(`Init failed: ${err instanceof Error ? err.message : String(err)}`);
+            process.exitCode = 1;
+        }
+    });
+}
+//# sourceMappingURL=init.js.map