ai-obs-cli 0.0.0-stage → 0.5.0

package/dist/commands/init.js

@@ -0,0 +1,119 @@
+import { ADAPTERS } from '../adapters/index.js';
+import { hookCommandFactory, isVersionManagedNode } from '../adapters/hook-command.js';
+import { loadConfig, normalizeEndpoint } from '../config.js';
+import { errorMessage } from '../fsutil.js';
+import { gitTopLevel } from '../git.js';
+import { createLogger } from '../log.js';
+import { migrateHome } from '../migrate.js';
+import { installRuntime, isDefaultHome } from '../runtime.js';
+import { nowOf, parseOptions, UsageError, withWriteLock } from './common.js';
+import { checkTokenShape, registerServer, serverOf } from './login.js';
+export const INIT_OPTIONS = {
+    token: { type: 'string' },
+    endpoint: { type: 'string' },
+    label: { type: 'string' },
+    project: { type: 'boolean', default: false },
+    'project-dir': { type: 'string' },
+    harness: { type: 'string' },
+};
+/**
+ * `ai-obs init [--token <t> --endpoint <url> [--label <name>]] [--project] [--project-dir d] [--harness a,b]`:
+ * machine setup: copies the hook runtime and installs the hooks of every detected harness. With --token it is
+ * first the non-interactive form of `ai-obs login --server <url> --token <t>`.
+ */
+export async function initCommand(args, io, deps) {
+    const { values } = parseOptions(args, INIT_OPTIONS);
+    const only = values.harness?.split(',').map((s) => s.trim()).filter(Boolean);
+    const adapters = (deps.adapters ?? ADAPTERS).filter((a) => !only || only.includes(a.name));
+    if (only && !adapters.length)
+        throw new UsageError(`unknown harness: ${values.harness}`);
+    if (!values.token && (values.endpoint !== undefined || values.label !== undefined)) {
+        throw new UsageError('--endpoint and --label need --token (or run `ai-obs login --server <url>` for the browser login)');
+    }
+    const cwd = deps.cwd ?? process.cwd();
+    const scope = values.project ? 'project' : 'user';
+    const projectDir = values['project-dir'] ?? (values.project ? ((await gitTopLevel(cwd)) ?? cwd) : undefined);
+    // 1. Token (non-interactive login), then a fresh runtime for the hooks (C25, under the lock).
+    if (values.token) {
+        const { endpoint: raw } = serverOf(values.endpoint, deps);
+        let endpoint;
+        try {
+            endpoint = normalizeEndpoint(raw);
+        }
+        catch (err) {
+            io.err(`ai-obs: invalid endpoint: ${errorMessage(err)}`);
+            return 2;
+        }
+        if (!checkTokenShape(values.token, io))
+            return 2;
+        const code = await registerServer({ endpoint, token: values.token, source: 'manual', ...(values.label ? { label: values.label } : {}) }, io, deps, { fromInit: true });
+        if (code !== 0)
+            return code;
+    }
+    let runtime = null;
+    const notes = [];
+    const locked = await withWriteLock(deps, io, () => {
+        const refresh = deps.installRuntime ?? installRuntime;
+        runtime = refresh(deps.paths); // first: the hooks' runtime must read the config the migration writes
+        notes.push(...migrateHome(deps.paths, { log: createLogger(deps.paths, 'cli'), now: new Date(nowOf(deps)), refreshRuntime: refresh }));
+    });
+    if (!locked)
+        return 1;
+    for (const n of notes)
+        io.err(`ai-obs: ${n}`);
+    const rt = runtime;
+    if (!rt)
+        throw new Error('the hook runtime was not installed');
+    const home = isDefaultHome(deps.paths) ? undefined : deps.paths.root;
+    const config = loadConfig(deps.paths);
+    if (!values.token) {
+        if (config?.servers.length)
+            io.out(`using the registered servers: ${config.servers.map((s) => s.endpoint).join(', ')}`);
+        else
+            io.out('! not logged in to any ai-obs server yet: nothing is recorded until you run `ai-obs login --server <url>`');
+    }
+    // 2. Harness hooks (re-installed every time, so changes such as the SessionStart timeout reach old installs).
+    let installed = 0;
+    const nextSteps = [];
+    for (const adapter of adapters) {
+        const det = await adapter.detect(projectDir ? { projectDir } : {});
+        if (!det.installed) {
+            io.out(`– ${adapter.displayName}: not found`);
+            continue;
+        }
+        try {
+            await adapter.installHooks({
+                scope,
+                ...(projectDir ? { projectDir } : {}),
+                hookCommand: hookCommandFactory({ node: rt.node, entry: rt.entry, harness: adapter.name, ...(home ? { home } : {}) }),
+            });
+            installed++;
+            const ver = det.version ? ` ${det.version}` : '';
+            const warn = det.versionSupported === false ? ' (version not tested — run `ai-obs doctor`)' : '';
+            io.out(`✓ ${adapter.displayName}${ver}: hooks installed (${scope === 'project' ? `project ${projectDir}` : 'user'})${warn}`);
+            nextSteps.push(...(adapter.nextSteps ?? []).map((s) => `${adapter.displayName}: ${s}`));
+        }
+        catch (err) {
+            io.err(`✗ ${adapter.displayName}: installing hooks failed: ${errorMessage(err)}`);
+        }
+    }
+    if (!installed)
+        io.out('! no supported harness found (Claude Code, Codex); install one and re-run `ai-obs init`');
+    if (installed) {
+        // Hooks bake in the absolute path of the node that ran init.
+        if (isVersionManagedNode(rt.node)) {
+            io.out(`! hooks run ${rt.node}, a version-managed Node (nvm, fnm, Volta, asdf, Homebrew Cellar …): if you remove or upgrade that version the hooks stop working. \`ai-obs doctor\` detects it; run \`ai-obs init\` again then, or init under a stable Node.`);
+        }
+        if (scope === 'project') {
+            io.out(`! project hooks contain absolute paths of this machine (${rt.node}, ${rt.entry}). They do not work for teammates or on CI: keep the file out of git (e.g. in .git/info/exclude) or let each teammate run \`ai-obs init --project\`.`);
+        }
+    }
+    for (const step of nextSteps)
+        io.out(`→ ${step}`);
+    if (installed && config?.servers.length)
+        io.out('ai-obs is set up. Usage appears in the dashboard within minutes; check with `ai-obs doctor`.');
+    else if (installed)
+        io.out('hooks installed. Run `ai-obs login --server <url>` to start recording.');
+    return 0;
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

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

package/dist/commands/link.js

@@ -0,0 +1,171 @@
+import { appendFileSync, existsSync, readFileSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { findServer, loadConfig, tryNormalizeEndpoint } from '../config.js';
+import { DOT_FILE, LOCAL_DOT_FILE, lookupDotFile, parseDotFile } from '../dotfile.js';
+import { errorMessage, writeFileAtomic } from '../fsutil.js';
+import { gitTopLevel } from '../git.js';
+import { defaultSpawnWorker } from '../hook.js';
+import { resolveProjectKey, RESOLVE_TIMEOUT_MS } from '../project-key.js';
+import { TEAM_SLUG_RE } from '../protocol-types.js';
+import { getCollectorConfig, syncServerEntry } from '../sender.js';
+import { openStore, parseOptions, terminalSafe, UsageError, withWriteLock } from './common.js';
+export const LINK_OPTIONS = {
+    team: { type: 'string' },
+    server: { type: 'string' },
+    local: { type: 'boolean', default: false },
+    'project-dir': { type: 'string' },
+};
+const looksLikeToken = (v) => /aiobs_[a-z]_/i.test(v);
+const isObject = (v) => typeof v === 'object' && v !== null && !Array.isArray(v);
+/** Adds `name` to `<dir>/.gitignore` unless a line already ignores it. Returns true when it appended. */
+export function ensureGitignored(dir, name) {
+    const file = join(dir, '.gitignore');
+    let text = '';
+    try {
+        text = readFileSync(file, 'utf8');
+    }
+    catch {
+        text = '';
+    }
+    const lines = text.split(/\r?\n/).map((l) => l.trim());
+    if (lines.includes(name) || lines.includes(`/${name}`))
+        return false;
+    appendFileSync(file, `${text && !text.endsWith('\n') ? '\n' : ''}${name}\n`, { mode: 0o644 });
+    return true;
+}
+/**
+ * `ai-obs link --team <slug> [--server URL] [--local] [--project-dir <dir>]`: writes the repository's dot file
+ * at its git top level (`.ai-obs.json`, to commit; with --local `.ai-obs.local.json`, git-ignored), naming
+ * the server and team its sessions report to. The team is checked against the server's collector-config when
+ * this machine is logged in to that server. Never writes a token. Events of this repository recorded while no
+ * server was chosen move to the linked server.
+ */
+export async function linkCommand(args, io, deps) {
+    const { values } = parseOptions(args, LINK_OPTIONS);
+    const team = values.team;
+    if (!team)
+        throw new UsageError('--team is required (the team slug, see `ai-obs status` or the dashboard)');
+    if (looksLikeToken(team) || (values.server && looksLikeToken(values.server))) {
+        io.err('✗ that looks like a token: tokens never go into a dot file (they stay in ~/.ai-obs/config.json). Nothing was written.');
+        return 2;
+    }
+    if (!TEAM_SLUG_RE.test(team))
+        throw new UsageError('--team must be a team slug: 1–63 characters of a-z, 0-9 and -');
+    const cwd = deps.cwd ?? process.cwd();
+    // the dot file lives at the git top level, also when --project-dir names a subdirectory (the nudge passes the session's cwd)
+    const given = values['project-dir'] ? resolve(values['project-dir']) : null;
+    const dir = given ? ((await gitTopLevel(given)) ?? given) : await gitTopLevel(cwd);
+    if (!dir) {
+        io.err('✗ not inside a git repository: run it in the repository, or pass --project-dir <its root>. Nothing was written.');
+        return 1;
+    }
+    // the server: --server, else the one the repository's dot file names, else the only registered one
+    const config = loadConfig(deps.paths);
+    const current = lookupDotFile(dir);
+    let server;
+    if (values.server) {
+        server = tryNormalizeEndpoint(values.server);
+        if (!server)
+            throw new UsageError(`--server must be an http(s) URL: ${values.server}`);
+    }
+    else {
+        server = current.server ?? (config?.servers.length === 1 ? config.servers[0].endpoint : null);
+        if (!server) {
+            throw new UsageError(config?.servers.length
+                ? `--server is required: ${config.servers.length} servers are registered (${config.servers.map((s) => s.endpoint).join(', ')})`
+                : '--server is required (no server is registered yet: run `ai-obs login --server <url>` first)');
+        }
+    }
+    // check the team on that server
+    const entry = config ? findServer(config, server) : undefined;
+    if (entry) {
+        const cc = await getCollectorConfig({ server: entry, paths: deps.paths, ...(deps.transport ? { transport: deps.transport } : {}), ...(deps.now ? { now: deps.now } : {}) }, { force: true });
+        if (cc.source === 'fresh')
+            syncServerEntry(deps.paths, entry, cc.value);
+        const teams = cc.source !== 'default' ? cc.value.teams : undefined;
+        if (cc.status === 401 || cc.status === 403) {
+            io.out(`! ${server} rejected this machine's token (expired or revoked): the team is not checked. Run \`ai-obs login --server ${server}\``);
+        }
+        else if (!teams) {
+            io.out(`! could not read your teams from ${server} (${cc.error ?? 'older server'}): the team is not checked`);
+        }
+        else if (!teams.some((t) => t.slug === team)) {
+            const list = teams.map((t) => t.slug).join(', ');
+            io.err(`✗ team "${team}" is not one of your teams on ${server}${list ? ` (${terminalSafe(list)})` : ' (you are in no team)'}. Nothing was written.`);
+            return 1;
+        }
+        else {
+            const name = teams.find((t) => t.slug === team).name;
+            io.out(`✓ team ${team} (${terminalSafe(name)}) on ${server}${cc.source === 'cache' ? ' (from the cached server answer)' : ''}`);
+        }
+    }
+    else {
+        io.out(`! this machine is not logged in to ${server}: the team is not checked, and data waits on this machine until you run \`ai-obs login --server ${server}\``);
+    }
+    // write the file, keeping unknown keys of an existing one; never a token
+    const file = join(dir, values.local ? LOCAL_DOT_FILE : DOT_FILE);
+    let obj = {};
+    if (existsSync(file)) {
+        try {
+            const raw = JSON.parse(readFileSync(file, 'utf8'));
+            if (isObject(raw))
+                obj = raw;
+            else
+                io.out(`! ${file} was not a JSON object: replaced`);
+        }
+        catch {
+            io.out(`! ${file} was not valid JSON: replaced`);
+        }
+    }
+    for (const [k, v] of Object.entries(obj)) {
+        if (k === 'token' || (typeof v === 'string' && looksLikeToken(v))) {
+            delete obj[k];
+            io.out(`! removed "${k}" from ${file}: tokens never go into a dot file`);
+        }
+    }
+    obj = { ...obj, server, team };
+    const text = `${JSON.stringify(obj, null, 2)}\n`;
+    if (!parseDotFile(text).ok || looksLikeToken(text)) {
+        io.err(`✗ refusing to write ${file}. Nothing was written.`);
+        return 1;
+    }
+    try {
+        writeFileAtomic(file, text, 0o644);
+    }
+    catch (err) {
+        io.err(`✗ cannot write ${file}: ${errorMessage(err)}`);
+        return 1;
+    }
+    io.out(`✓ wrote ${file}: server ${server}, team ${team}`);
+    if (values.local) {
+        try {
+            if (ensureGitignored(dir, LOCAL_DOT_FILE))
+                io.out(`✓ added ${LOCAL_DOT_FILE} to ${join(dir, '.gitignore')}`);
+        }
+        catch (err) {
+            io.out(`! could not add ${LOCAL_DOT_FILE} to .gitignore (${errorMessage(err)}): keep it out of git yourself`);
+        }
+    }
+    else {
+        io.out(`  commit ${DOT_FILE} so everyone's sessions in this repository report to this team`);
+    }
+    const after = lookupDotFile(dir);
+    if (after.root && (after.server !== server || after.team !== team)) {
+        io.out(`! ${LOCAL_DOT_FILE} overrides it here: sessions report to ${after.server ?? '(no server)'}, team ${after.team ?? '(none)'}`);
+    }
+    io.out('  sessions that are already running keep the server and team they started with');
+    // events recorded while no server was chosen follow the link
+    if (!config?.servers.length || !after.server)
+        return 0;
+    const pk = await (deps.resolveProjectKey ?? ((c, o) => resolveProjectKey(c, o)))(dir, { timeoutMs: RESOLVE_TIMEOUT_MS });
+    if (pk === null)
+        return 0;
+    const target = { endpoint: after.server, team: after.team ?? '' };
+    const locked = await withWriteLock(deps, io, () => openStore(deps.paths).retarget(pk, target));
+    if (locked?.value) {
+        io.out(`✓ ${locked.value} queued events of this repository recorded without a server now go to ${after.server}`);
+        (deps.spawnWorker ?? defaultSpawnWorker)(deps.paths);
+    }
+    return 0;
+}
+//# sourceMappingURL=link.js.map

package/dist/commands/link.js.map

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

package/dist/commands/live.js

@@ -0,0 +1,130 @@
+import { resolve } from 'node:path';
+import { claudeDir } from '../adapters/claude-code/settings.js';
+import { gitTopLevel } from '../git.js';
+import { inScope, LiveMonitor } from '../live/monitor.js';
+import { renderFrame } from '../live/render.js';
+import { nowOf, parseOptions } from './common.js';
+export const LIVE_REFRESH_MS = 1000;
+const ENTER = '\x1b[?1049h\x1b[?25l';
+const LEAVE = '\x1b[?25h\x1b[?1049l';
+/** Output that is not a terminal (a pipe, a script) is not cut to 80 columns. */
+const PIPE_WIDTH = 200;
+function stdTerminal() {
+    const out = process.stdout;
+    const inp = process.stdin;
+    return {
+        isTTY: Boolean(out.isTTY && inp.isTTY),
+        columns: () => out.columns || 80,
+        rows: () => out.rows || 24,
+        write: (s) => void out.write(s),
+        onKey(fn) {
+            const onData = (d) => fn(String(d));
+            try {
+                inp.setRawMode?.(true);
+                inp.setEncoding('utf8');
+                inp.resume();
+            }
+            catch (err) {
+                try {
+                    inp.setRawMode?.(false);
+                }
+                catch {
+                    /* not a usable terminal */
+                }
+                throw err;
+            }
+            inp.on('data', onData);
+            return () => {
+                inp.off('data', onData);
+                inp.setRawMode?.(false);
+                inp.pause();
+            };
+        },
+    };
+}
+/**
+ * `ai-obs live [--cwd] [--once]` (ADR-0027): the sessions running on this machine, redrawn in place about once a
+ * second (q quits). Local only: no network, nothing written. `--cwd` narrows to the current repository; `--once`
+ * (or a stdin / stdout that is not a terminal) prints one frame and exits.
+ */
+export async function liveCommand(args, io, deps) {
+    const { values } = parseOptions(args, { cwd: { type: 'boolean' }, once: { type: 'boolean' } });
+    const cwd = deps.cwd ?? process.cwd();
+    const scope = values.cwd ? ((await gitTopLevel(cwd, 2000)) ?? resolve(cwd)) : null;
+    const terminal = deps.terminal ?? stdTerminal();
+    const monitor = new LiveMonitor({ paths: deps.paths, claudeDir: deps.claudeDir ?? claudeDir(deps.env ?? process.env), now: () => nowOf(deps) });
+    const frame = async (inPlace) => {
+        const all = await monitor.refresh();
+        const rows = scope ? all.filter((r) => inScope(r.cwd, scope)) : all;
+        if (!inPlace)
+            return renderFrame(rows, { now: nowOf(deps), width: terminal.isTTY ? terminal.columns() : PIPE_WIDTH, scope });
+        // Redrawn in place: one column short (a full-width line followed by erase-to-end would lose its last character),
+        // and no taller than the terminal (it would scroll the header away).
+        const height = terminal.rows?.();
+        return renderFrame(rows, { now: nowOf(deps), width: terminal.columns() - 1, scope, ...(height ? { rows: height } : {}) });
+    };
+    if (values.once || !terminal.isTTY) {
+        io.out((await frame(false)).join('\n'));
+        return 0;
+    }
+    terminal.write(ENTER);
+    return new Promise((done, fail) => {
+        let stopped = false;
+        let timer;
+        let off = () => { };
+        const detach = () => {
+            process.off('SIGTERM', stop);
+            process.off('SIGINT', stop);
+            process.off('exit', onExit);
+        };
+        // the terminal is restored whatever happens: a key, a signal, a throw, or the process exiting under us
+        const onExit = () => {
+            if (!stopped)
+                terminal.write(LEAVE);
+        };
+        const stop = () => {
+            if (stopped)
+                return;
+            stopped = true;
+            clearTimeout(timer);
+            try {
+                off();
+            }
+            finally {
+                detach();
+                terminal.write(LEAVE);
+                done(0);
+            }
+        };
+        process.once('SIGTERM', stop);
+        process.once('SIGINT', stop);
+        process.once('exit', onExit);
+        try {
+            off = terminal.onKey((key) => {
+                if (key === 'q' || key === 'Q' || key === '\u0003')
+                    stop();
+            });
+        }
+        catch (err) {
+            stopped = true;
+            detach();
+            terminal.write(LEAVE);
+            fail(err);
+            return;
+        }
+        const tick = async () => {
+            try {
+                const lines = await frame(true);
+                if (!stopped)
+                    terminal.write(`\x1b[H${lines.join('\x1b[K\r\n')}\x1b[J`);
+            }
+            catch {
+                /* a failed read shows the previous frame; the next tick retries */
+            }
+            if (!stopped)
+                timer = setTimeout(() => void tick(), deps.refreshMs ?? LIVE_REFRESH_MS);
+        };
+        void tick();
+    });
+}
+//# sourceMappingURL=live.js.map

package/dist/commands/live.js.map

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