@prism-d1/cli 1.2.0 → 1.3.0

package/dist/src/commands/_top/version.js

@@ -0,0 +1,175 @@
+/**
+ * `prism-cli version`: this CLI's version, whether npm has a newer one, and
+ * any other prism-cli on PATH that shadows this one or differs from it (an old
+ * /usr/bin/prism-cli under a system Node is the usual case).
+ *
+ * The npm check never fails the command: a timeout, no network or no npm is
+ * reported as "not checked". `--offline` skips it. `prism-cli --version` stays
+ * the bare version string from commander.
+ */
+import { spawnSync } from 'node:child_process';
+import { existsSync, readFileSync, realpathSync, statSync } from 'node:fs';
+import { delimiter, dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+export const PACKAGE_NAME = '@prism-d1/cli';
+const BIN_NAME = 'prism-cli';
+/** Short: this runs on every `version` call and must not stall a terminal. */
+const NPM_TIMEOUT_MS = 5000;
+/** Walks up from `start` to the package.json of @prism-d1/cli, at most 6 levels. */
+export function findPackageDir(start) {
+    let dir = start;
+    for (let i = 0; i < 6; i++) {
+        const pkg = join(dir, 'package.json');
+        if (existsSync(pkg)) {
+            try {
+                if (JSON.parse(readFileSync(pkg, 'utf8')).name === PACKAGE_NAME)
+                    return dir;
+            }
+            catch { /* not ours */ }
+        }
+        const parent = dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return null;
+}
+function packageVersion(dir) {
+    if (!dir)
+        return null;
+    try {
+        return String(JSON.parse(readFileSync(join(dir, 'package.json'), 'utf8')).version);
+    }
+    catch {
+        return null;
+    }
+}
+/** -1, 0 or 1, comparing dotted numeric versions; pre-release tags are ignored. */
+export function compareVersions(a, b) {
+    const pa = a.split(/[.-]/).slice(0, 3).map((n) => parseInt(n, 10) || 0);
+    const pb = b.split(/[.-]/).slice(0, 3).map((n) => parseInt(n, 10) || 0);
+    for (let i = 0; i < 3; i++)
+        if (pa[i] !== pb[i])
+            return pa[i] > pb[i] ? 1 : -1;
+    return 0;
+}
+/**
+ * Every prism-cli on PATH, in PATH order, deduplicated by real path (e.g.
+ * /bin -> /usr/bin).
+ *
+ * shortcut: on Windows, npm's .cmd shims do not resolve to their package, so
+ * other installs there show version unknown; parse the shim if that matters.
+ */
+export function installsOnPath(pathEnv, ownPackageDir) {
+    const seen = new Set();
+    const out = [];
+    const exts = process.platform === 'win32' ? ['.cmd', ''] : [''];
+    const own = realOrSelf(ownPackageDir);
+    for (const dir of pathEnv.split(delimiter)) {
+        if (!dir)
+            continue;
+        for (const ext of exts) {
+            const p = join(dir, BIN_NAME + ext);
+            try {
+                if (!statSync(p).isFile())
+                    continue;
+            }
+            catch {
+                continue;
+            }
+            const real = realOrSelf(p);
+            if (seen.has(real))
+                continue;
+            seen.add(real);
+            const pkgDir = findPackageDir(dirname(real));
+            out.push({ path: p, realpath: real, version: packageVersion(pkgDir), isThis: !!pkgDir && realOrSelf(pkgDir) === own });
+        }
+    }
+    return out;
+}
+function realOrSelf(p) {
+    try {
+        return realpathSync(p);
+    }
+    catch {
+        return resolve(p);
+    }
+}
+export function buildReport(opts, d) {
+    const version = packageVersion(d.ownPackageDir) ?? 'unknown';
+    const warnings = [];
+    const onPath = installsOnPath(d.pathEnv, d.ownPackageDir);
+    const first = onPath[0];
+    if (!first) {
+        warnings.push(`${BIN_NAME} is not on PATH; this copy runs only by its full path.`);
+    }
+    else if (!first.isThis) {
+        warnings.push(`"${BIN_NAME}" on PATH runs ${first.path} (${first.version ?? 'version unknown'}), not this CLI (${version}, ${d.ownPackageDir}).`);
+    }
+    const others = onPath.filter((i, n) => !i.isThis && n > 0 && i.version !== version);
+    for (const o of others) {
+        warnings.push(`Another ${BIN_NAME} on PATH: ${o.path} (${o.version ?? 'version unknown'}), shadowed by ${first.path}. A different Node or shell may run it; remove it with that Node's "npm uninstall -g ${PACKAGE_NAME}".`);
+    }
+    let latest = null;
+    let latestNote = null;
+    if (opts.offline) {
+        latestNote = 'offline';
+    }
+    else {
+        const r = d.npmLatest();
+        latest = r.version;
+        if (!latest)
+            latestNote = r.error || 'npm returned no version';
+    }
+    const updateAvailable = latest && version !== 'unknown' ? compareVersions(latest, version) > 0 : null;
+    return { schema: 'prism.version.v1', version, node: process.version, latest, updateAvailable, latestNote, onPath, warnings };
+}
+function realNpmLatest() {
+    const o = { encoding: 'utf8', timeout: NPM_TIMEOUT_MS, stdio: ['ignore', 'pipe', 'pipe'] };
+    // Windows resolves npm.cmd only through a shell. The command is a constant
+    // with no user input, so the shell parses nothing it was given.
+    const r = process.platform === 'win32'
+        ? spawnSync(`npm view ${PACKAGE_NAME} version`, { ...o, shell: true })
+        : spawnSync('npm', ['view', PACKAGE_NAME, 'version'], o);
+    if (r.error)
+        return { version: null, error: r.error.code === 'ETIMEDOUT' ? `npm did not answer within ${NPM_TIMEOUT_MS / 1000}s` : r.error.message };
+    if (r.status !== 0)
+        return { version: null, error: (r.stderr || '').trim().split('\n')[0] || `npm exited ${r.status}` };
+    const v = (r.stdout || '').trim();
+    return /^\d+\.\d+\.\d+/.test(v) ? { version: v } : { version: null, error: 'unexpected npm output' };
+}
+export function defaultDeps() {
+    return {
+        ownPackageDir: findPackageDir(dirname(fileURLToPath(import.meta.url))) ?? process.cwd(),
+        pathEnv: process.env.PATH || '',
+        npmLatest: realNpmLatest,
+    };
+}
+export function printReport(r, log = console.log) {
+    log(`${BIN_NAME} ${r.version} (Node ${r.node})`);
+    if (r.updateAvailable)
+        log(`Update available: ${r.latest}. Run: npm install -g ${PACKAGE_NAME}`);
+    else if (r.latest)
+        log(`Up to date (latest on npm: ${r.latest}).`);
+    else if (r.latestNote === 'offline')
+        log('Update check skipped (--offline).');
+    else
+        log(`Update check: not checked (${r.latestNote}).`);
+    for (const w of r.warnings)
+        log(`⚠  ${w}`);
+}
+export default {
+    description: 'Print the CLI version, check npm for a newer release, and warn about other prism-cli copies on PATH',
+    options: [
+        { flags: '--json', description: 'Print the report as JSON' },
+        { flags: '--offline', description: 'Skip the npm check' },
+    ],
+    async action(opts) {
+        const report = buildReport(opts, defaultDeps());
+        if (opts.json)
+            console.log(JSON.stringify(report, null, 2));
+        else
+            printReport(report);
+    },
+};
+//# sourceMappingURL=version.js.map

package/dist/src/commands/_top/version.js.map

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

package/dist/src/commands/bootstrapper/setup-otel-sync.d.ts

@@ -1,15 +1,21 @@
+import { type CodeburnHooks, type CodeburnOptions } from '../enable/codeburn.js';
+/**
+ * DEPRECATED alias for `prism-cli enable codeburn`.
+ *
+ * `enable codeburn` is this command under its new name: the same flags, sync
+ * setup and schedule, plus a codeburn install when it is missing (after a
+ * confirmation), --dry-run, and re-runs that report what is already done. The
+ * command is kept so existing scripts and docs keep working.
+ */
+export declare const DEPRECATION: string[];
 declare const _default: {
     description: string;
     options: {
         flags: string;
         description: string;
     }[];
-    action(opts: {
-        url?: string;
-        interval?: string;
-        status?: boolean;
-        remove?: boolean;
-    }): Promise<void>;
+    /** Errors are handled once, in runEnableCodeburn, for this alias too. `hooks` is for tests. */
+    action(opts: CodeburnOptions, hooks?: CodeburnHooks): Promise<void>;
 };
 export default _default;
 //# sourceMappingURL=setup-otel-sync.d.ts.map

package/dist/src/commands/bootstrapper/setup-otel-sync.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"setup-otel-sync.d.ts","sourceRoot":"","sources":["../../../../src/commands/bootstrapper/setup-otel-sync.ts"],"names":[],"mappings":";;;;;;iBAySqB;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE;;AAR5F,wBAqJE"}
+{"version":3,"file":"setup-otel-sync.d.ts","sourceRoot":"","sources":["../../../../src/commands/bootstrapper/setup-otel-sync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuC,KAAK,aAAa,EAAE,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAEtH;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,UAGvB,CAAC;;;;;;;IAKA,+FAA+F;iBAC5E,eAAe,UAAU,aAAa;;AAJ3D,wBASE"}

package/dist/src/commands/bootstrapper/setup-otel-sync.js

@@ -1,416 +1,25 @@
-import { createInterface } from 'node:readline';
-import { platform, homedir } from 'node:os';
-import { existsSync, mkdirSync, writeFileSync, readFileSync, unlinkSync } from 'node:fs';
-import { join } from 'node:path';
-import { run, runInteractive } from '../../utils/exec.js';
-import { withPrivateTemp } from '../../utils/tempfile.js';
-import { CRON_MARKER, PLIST_LABEL, SCHTASK_NAME, otelLogDir, codeburnSyncConfigPath, linuxCrontabAvailable, darwinPlistPath, scheduleExists, schedulerName, } from '../../utils/otel-sync-schedule.js';
-function prompt(question, defaultValue) {
-    const rl = createInterface({ input: process.stdin, output: process.stdout });
-    const suffix = defaultValue ? ` [${defaultValue}]` : '';
-    return new Promise((resolve) => {
-        rl.question(`${question}${suffix}: `, (answer) => {
-            rl.close();
-            resolve(answer.trim() || defaultValue || '');
-        });
-    });
-}
-// ---- Constants ----
-// Marker, label and task name are shared with the dashboard's setup check.
-const LOG_DIR = otelLogDir();
-/** Window the recurring sync pushes on every run. */
-const SYNC_SINCE = '7d';
-// ---- Scheduler helpers per OS ----
-function getCodeburnPath() {
-    const result = platform() === 'win32'
-        ? run('where', ['codeburn'])
-        : run('which', ['codeburn']);
-    return result.ok ? result.stdout.split('\n')[0].trim() : null;
-}
+import { CODEBURN_OPTIONS, runEnableCodeburn } from '../enable/codeburn.js';
 /**
- * The argv of the recurring sync, shared by every platform.
+ * DEPRECATED alias for `prism-cli enable codeburn`.
  *
- * This is the single source of truth on purpose. It previously existed only as
- * a Linux helper, and the Windows branch open-coded its own command string
- * that omitted --attribution. That silently reduced Windows machines to usage
- * telemetry with no commit attribution, so those developers counted toward the
- * Attribution Coverage denominator (CI sees their commits) while contributing
- * nothing to the numerator -- indistinguishable on the dashboard from someone
- * who never onboarded. Any new platform branch must call this.
+ * `enable codeburn` is this command under its new name: the same flags, sync
+ * setup and schedule, plus a codeburn install when it is missing (after a
+ * confirmation), --dry-run, and re-runs that report what is already done. The
+ * command is kept so existing scripts and docs keep working.
  */
-function syncArgs(since) {
-    return ['sync', 'push', '--since', since, '--attribution'];
-}
-// ---- Linux: user crontab ----
-/**
- * Single-quotes a value for the crontab line.
- *
- * A crontab entry is interpreted by /bin/sh, so unlike our argv call sites
- * this one genuinely does need quoting -- the shell is the scheduler's, not
- * ours, and we cannot pass it argv. Wrapping in single quotes and encoding any
- * embedded single quote as '\'' is the only form with no escape sequences to
- * get wrong. Paths under a home directory containing a space would otherwise
- * split into two arguments.
- */
-function shQuote(value) {
-    return `'${value.replace(/'/g, `'\\''`)}'`;
-}
-function linuxInstallSchedule(codeburnPath, intervalHours) {
-    if (!linuxCrontabAvailable()) {
-        console.warn('\n⚠️  crontab not found — skipping automatic schedule installation.');
-        console.warn('   Run "codeburn sync push --since 7d" manually, or install cronie:');
-        console.warn('   sudo yum install cronie -y  # then re-run this command\n');
-        return false;
-    }
-    const existing = run('crontab', ['-l']);
-    const lines = existing.ok ? existing.stdout.split('\n').filter(l => !l.includes(CRON_MARKER)) : [];
-    const logFile = join(LOG_DIR, 'otel-sync.log');
-    const cronExpr = `0 */${intervalHours} * * *`;
-    const command = [shQuote(codeburnPath), ...syncArgs(SYNC_SINCE)].join(' ');
-    lines.push(`${CRON_MARKER}`);
-    lines.push(`${cronExpr} ${command} >> ${shQuote(logFile)} 2>&1`);
-    const result = withPrivateTemp('crontab', lines.join('\n') + '\n', f => run('crontab', [f]));
-    if (!result.ok)
-        throw new Error(`Failed to install crontab: ${result.stderr}`);
-    return true;
-}
-function linuxRemoveSchedule() {
-    if (!linuxCrontabAvailable())
-        return;
-    const existing = run('crontab', ['-l']);
-    if (!existing.ok)
-        return;
-    const lines = existing.stdout.split('\n').filter(l => !l.includes(CRON_MARKER) && !l.includes('codeburn sync push'));
-    withPrivateTemp('crontab', lines.join('\n') + '\n', f => run('crontab', [f]));
-}
-// ---- macOS: LaunchAgent ----
-/**
- * Escapes a value for use inside a plist <string> element.
- *
- * The plist is generated XML, so a path containing `&` or `<` -- both legal in
- * macOS filenames -- would otherwise produce a malformed document that
- * launchctl refuses to load, reported only as a generic load failure.
- */
-function xmlEscape(value) {
-    return value
-        .replace(/&/g, '&amp;')
-        .replace(/</g, '&lt;')
-        .replace(/>/g, '&gt;');
-}
-function darwinInstallSchedule(codeburnPath, intervalHours) {
-    const logFile = join(LOG_DIR, 'otel-sync.log');
-    const argElements = [codeburnPath, ...syncArgs(SYNC_SINCE)]
-        .map(a => `    <string>${xmlEscape(a)}</string>`)
-        .join('\n');
-    const plist = `<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
-<plist version="1.0">
-<dict>
-  <key>Label</key>
-  <string>${PLIST_LABEL}</string>
-  <key>ProgramArguments</key>
-  <array>
-${argElements}
-  </array>
-  <key>StartInterval</key>
-  <integer>${intervalHours * 3600}</integer>
-  <key>StandardOutPath</key>
-  <string>${xmlEscape(logFile)}</string>
-  <key>StandardErrorPath</key>
-  <string>${xmlEscape(logFile)}</string>
-  <key>RunAtLoad</key>
-  <true/>
-</dict>
-</plist>`;
-    const plistPath = darwinPlistPath();
-    mkdirSync(join(homedir(), 'Library', 'LaunchAgents'), { recursive: true });
-    writeFileSync(plistPath, plist);
-    // Unload first so a reinstall replaces rather than conflicts. A missing
-    // agent makes this fail, which is expected and ignored -- run() captures
-    // stderr rather than leaking it, so no shell redirect is needed.
-    run('launchctl', ['unload', plistPath]);
-    const result = run('launchctl', ['load', plistPath]);
-    if (!result.ok)
-        throw new Error(`Failed to load LaunchAgent: ${result.stderr}`);
-}
-function darwinRemoveSchedule() {
-    const plistPath = darwinPlistPath();
-    if (existsSync(plistPath)) {
-        run('launchctl', ['unload', plistPath]);
-        unlinkSync(plistPath);
-    }
-}
-// ---- Windows: schtasks ----
-/** Path of the generated batch wrapper the scheduled task invokes. */
-function windowsWrapperPath() {
-    return join(homedir(), '.prism', 'otel-sync.cmd');
-}
-/**
- * Installs the Windows scheduled task via a generated .cmd wrapper.
- *
- * The previous version nested the whole command inside schtasks' /tr argument:
- *
- *   /tr "cmd /c <codeburnPath> sync push ... >> "<logFile>" 2>&1"
- *
- * and tried to make that legal with cmd.replace(/"/g, '\\"'). That is three
- * quoting layers deep -- our shell, schtasks' own /tr parser, then cmd.exe --
- * and the replacement handled exactly one metacharacter of one of them. It did
- * not escape backslashes, which is not a corner case on Windows: every path
- * here is backslash-separated, so a trailing separator turns the closing \"
- * into an escaped quote and unbalances the argument. cmd.exe also does not
- * treat \" the way that replacement assumes, so the escaping was aimed at the
- * wrong grammar to begin with.
- *
- * Writing the command to a file removes every one of those layers. The task
- * runs one fixed argument -- the wrapper path -- and the redirection lives in
- * a batch file where it needs no escaping at all. This also sidesteps the
- * documented 261-character limit on /tr, which the inlined form could exceed
- * with a long install path.
- */
-function windowsInstallSchedule(codeburnPath, intervalHours) {
-    const logFile = join(LOG_DIR, 'otel-sync.log');
-    const args = syncArgs(SYNC_SINCE).join(' ');
-    const wrapper = [
-        '@echo off',
-        'REM Generated by prism-cli bootstrapper setup-otel-sync. Do not edit.',
-        `"${codeburnPath}" ${args} >> "${logFile}" 2>&1`,
-        '',
-    ].join('\r\n');
-    mkdirSync(join(homedir(), '.prism'), { recursive: true });
-    writeFileSync(windowsWrapperPath(), wrapper);
-    const result = run('schtasks', [
-        '/create',
-        '/tn', SCHTASK_NAME,
-        '/sc', 'hourly',
-        '/mo', String(intervalHours),
-        '/tr', windowsWrapperPath(),
-        '/f',
-    ]);
-    if (!result.ok)
-        throw new Error(`Failed to create scheduled task: ${result.stderr}`);
-}
-function windowsRemoveSchedule() {
-    run('schtasks', ['/delete', '/tn', SCHTASK_NAME, '/f']);
-    const wrapper = windowsWrapperPath();
-    if (existsSync(wrapper))
-        unlinkSync(wrapper);
-}
-// ---- Unified scheduler interface ----
-function installSchedule(codeburnPath, intervalHours) {
-    mkdirSync(LOG_DIR, { recursive: true });
-    switch (platform()) {
-        case 'darwin':
-            darwinInstallSchedule(codeburnPath, intervalHours);
-            return true;
-        case 'win32':
-            windowsInstallSchedule(codeburnPath, intervalHours);
-            return true;
-        default: return linuxInstallSchedule(codeburnPath, intervalHours);
-    }
-}
-function removeSchedule() {
-    switch (platform()) {
-        case 'darwin': return darwinRemoveSchedule();
-        case 'win32': return windowsRemoveSchedule();
-        default: return linuxRemoveSchedule();
-    }
-}
-// ---- Status ----
-function showStatus(codeburnPath) {
-    console.log('\n📊 OTEL Sync Status\n');
-    // Codeburn installed?
-    if (codeburnPath) {
-        console.log(`  ✓ codeburn found: ${codeburnPath}`);
-        const ver = run(codeburnPath, ['--version']);
-        if (ver.ok)
-            console.log(`    version: ${ver.stdout}`);
-    }
-    else {
-        console.log('  ✗ codeburn not found in PATH');
-    }
-    // Sync configured?
-    const configPath = codeburnSyncConfigPath();
-    if (existsSync(configPath)) {
-        try {
-            const cfg = JSON.parse(readFileSync(configPath, 'utf8'));
-            console.log(`  ✓ sync configured: ${cfg.baseUrl || cfg.endpoint || cfg.url || '(configured)'}`);
-        }
-        catch {
-            console.log(`  ✓ sync config exists: ${configPath}`);
-        }
-    }
-    else {
-        console.log('  ✗ sync not configured (run setup first)');
-    }
-    // Schedule exists?
-    if (scheduleExists()) {
-        console.log(`  ✓ ${schedulerName()} schedule active`);
-    }
-    else {
-        console.log(`  ✗ no ${schedulerName()} schedule found`);
-    }
-    // Last log?
-    const logFile = join(LOG_DIR, 'otel-sync.log');
-    if (existsSync(logFile)) {
-        // Read in process rather than shelling out to tail, which does not exist
-        // on Windows -- the platform this command explicitly supports. The old
-        // `tail -5` silently produced no output there, making a working schedule
-        // look like it had never run.
-        const tail = readFileSync(logFile, 'utf8').split('\n').filter(Boolean).slice(-5);
-        if (tail.length) {
-            console.log(`  Last sync output (${logFile}):`);
-            for (const line of tail) {
-                console.log(`    ${line}`);
-            }
-        }
-    }
-    console.log('');
-}
-// ---- Main ----
+export const DEPRECATION = [
+    '⚠  "prism-cli bootstrapper setup-otel-sync" is deprecated; use "prism-cli enable codeburn".',
+    '   It takes the same flags, and also installs codeburn when missing (asks first; --yes skips the prompt).',
+];
 export default {
-    description: 'Set up automated codeburn OTEL sync (pushes AI usage telemetry every 12h)',
-    options: [
-        { flags: '--url <url>', description: 'OTEL collector URL (from CDK deploy output OtelCollectorUrl)' },
-        { flags: '--interval <hours>', description: 'Sync interval in hours (default: 12)' },
-        { flags: '--status', description: 'Show current sync schedule status' },
-        { flags: '--remove', description: 'Remove the sync schedule' },
-    ],
-    async action(opts) {
-        const codeburnPath = getCodeburnPath();
-        // --status
-        if (opts.status) {
-            showStatus(codeburnPath);
-            return;
-        }
-        // --remove
-        if (opts.remove) {
-            if (scheduleExists()) {
-                removeSchedule();
-                console.log(`\n  ✓ ${schedulerName()} schedule removed.\n`);
-            }
-            else {
-                console.log(`\n  No ${schedulerName()} schedule found — nothing to remove.\n`);
-            }
-            return;
-        }
-        // ---- Setup flow ----
-        console.log('\n🔄 OTEL Sync Setup\n');
-        console.log('This will configure automated codeburn telemetry sync to your PRISM');
-        console.log('OTEL collector. Runs every 12 hours to keep dashboards fresh.\n');
-        // 1. Check codeburn version
-        if (!codeburnPath) {
-            console.error('Error: codeburn not found. Install with: npm install -g codeburn');
-            process.exit(1);
-        }
-        const verResult = run(codeburnPath, ['--version']);
-        if (verResult.ok) {
-            const ver = verResult.stdout.replace(/[^0-9.]/g, '');
-            const parts = ver.split('.').map(Number);
-            if (parts[0] === 0 && parts[1] < 9 || (parts[1] === 9 && parts[2] < 16)) {
-                console.error(`Error: codeburn >= 0.9.16 required (found ${ver}). Run: npm update -g codeburn`);
-                process.exit(1);
-            }
-            console.log(`  ✓ codeburn ${ver}`);
-        }
-        // 2. Get the OTEL collector URL
-        const otelUrl = opts.url || await prompt('OTEL collector URL (from CDK deploy output OtelCollectorUrl)');
-        if (!otelUrl) {
-            console.error('Error: OTEL collector URL is required.');
-            process.exit(1);
-        }
-        // Reject anything that is not a real http(s) URL before it is persisted
-        // into codeburn's sync config, where a malformed value surfaces later as an
-        // opaque push failure from the scheduled job rather than here.
-        try {
-            const parsed = new URL(otelUrl);
-            if (parsed.protocol !== 'https:' && parsed.protocol !== 'http:') {
-                throw new Error('unsupported protocol');
-            }
-        }
-        catch {
-            console.error(`Error: "${otelUrl}" is not a valid http(s) URL.`);
-            console.error('  Expected the OtelCollectorUrl value from the CDK stack outputs.');
-            process.exit(1);
-        }
-        // 3. Check if codeburn sync is already configured for this URL
-        const configPath = codeburnSyncConfigPath();
-        let needsSetup = true;
-        if (existsSync(configPath)) {
-            try {
-                const cfg = JSON.parse(readFileSync(configPath, 'utf8'));
-                const existingUrl = cfg.baseUrl || cfg.endpoint || cfg.url || '';
-                if (existingUrl === otelUrl || existingUrl.startsWith(otelUrl)) {
-                    console.log(`  ✓ codeburn sync already configured for this endpoint.`);
-                    needsSetup = false;
-                }
-                else {
-                    console.log(`  ⚠ codeburn sync configured for different endpoint: ${existingUrl}`);
-                    const override = await prompt('Reconfigure for the new URL? (y/N)', 'N');
-                    if (override.toLowerCase() !== 'y') {
-                        console.log('  Keeping existing configuration.');
-                        needsSetup = false;
-                    }
-                }
-            }
-            catch {
-                // Corrupt config — re-setup
-            }
-        }
-        // 4. Run codeburn sync setup (opens browser for OIDC)
-        if (needsSetup) {
-            console.log('\n  Running: codeburn sync setup ' + otelUrl);
-            console.log('  (This will open a browser for OIDC authentication)\n');
-            // argv, not a command string: otelUrl comes straight from prompt() and
-            // previously reached execSync as shell source.
-            if (runInteractive(codeburnPath, ['sync', 'setup', otelUrl])) {
-                console.log('\n  ✓ codeburn sync configured.');
-            }
-            else {
-                console.error(`\n  ✗ codeburn sync setup failed. Ensure Cognito user exists and try again.`);
-                process.exit(1);
-            }
-        }
-        // 5. Initial backfill push (30d — server drops >14d from CloudWatch, keeps in DDB/S3)
-        console.log('\n  Pushing initial backfill (last 30 days of telemetry)...');
-        const backfill = run(codeburnPath, syncArgs('30d'));
-        if (backfill.ok) {
-            console.log('  ✓ Backfill push complete.');
-            if (backfill.stdout)
-                console.log(`    ${backfill.stdout.split('\n').slice(-1)[0]}`);
-        }
-        else {
-            console.log(`  ⚠ Backfill push failed (non-fatal): ${backfill.stderr.split('\n')[0]}`);
-            console.log('    The schedule will retry. Check ~/.prism/logs/otel-sync.log');
-        }
-        // 6. Install OS schedule
-        const intervalHours = opts.interval ? parseInt(opts.interval, 10) : 12;
-        if (isNaN(intervalHours) || intervalHours < 1) {
-            console.error('Error: --interval must be a positive integer (hours).');
-            process.exit(1);
-        }
-        if (scheduleExists()) {
-            console.log(`\n  ✓ ${schedulerName()} schedule already exists — updating.`);
-            removeSchedule();
-        }
-        const scheduled = installSchedule(codeburnPath, intervalHours);
-        if (scheduled) {
-            console.log(`  ✓ ${schedulerName()} schedule installed (every ${intervalHours}h).`);
-        }
-        // Summary
-        console.log('\n════════════════════════════════════════════════');
-        console.log('  ✅ OTEL sync setup complete!');
-        console.log('════════════════════════════════════════════════');
-        console.log(`\n  Endpoint:  ${otelUrl}`);
-        if (scheduled) {
-            console.log(`  Schedule:  every ${intervalHours}h via ${schedulerName()}`);
-        }
-        else {
-            console.log(`  Schedule:  ⚠️  not installed (run manually: codeburn sync push --since 7d)`);
-        }
-        console.log(`  Backfill:  last 30d pushed (dashboard shows last 14d)`);
-        console.log(`  Logs:      ${join(LOG_DIR, 'otel-sync.log')}`);
-        console.log(`\n  Run \`prism-cli bootstrapper setup-otel-sync --status\` to check health.`);
-        console.log(`  Run \`prism-cli bootstrapper setup-otel-sync --remove\` to uninstall.\n`);
+    description: '[deprecated] Alias for "prism-cli enable codeburn"',
+    options: CODEBURN_OPTIONS,
+    /** Errors are handled once, in runEnableCodeburn, for this alias too. `hooks` is for tests. */
+    async action(opts, hooks) {
+        for (const l of DEPRECATION)
+            console.warn(l);
+        console.warn('');
+        await runEnableCodeburn(opts, hooks);
     },
 };
 //# sourceMappingURL=setup-otel-sync.js.map