@onebrain-ai/cli 2.0.1 → 2.0.3

package/src/commands/update.ts

@@ -1,353 +0,0 @@
-/**
- * update — Atomic OneBrain update sequence
- *
- * Steps:
- *   1. Fetch latest release from GitHub (parse tag_name)
- *   2. Sync plugin files (vault-sync)
- *   3. (Handled by vault-sync Step 4 — merge harness files)
- *   4. Install binary (bun install -g / npm install -g on Windows)
- *   4b. Validate binary (ATOMIC GATE — register-hooks blocked if this fails)
- *   5. Register hooks (only if 4b passed)
- *   6. Write onebrain_version to vault.yml
- *
- * TTY:     uses @clack/prompts layout
- * Non-TTY: plain text lines
- *
- * Exit code: 0 on success, 1 on failure.
- */
-
-import { readFile, rename, writeFile } from 'node:fs/promises';
-import { join } from 'node:path';
-import { intro, log, outro } from '@clack/prompts';
-import { parse as parseYaml, stringify as stringifyYaml } from 'yaml';
-
-// ---------------------------------------------------------------------------
-// Types
-// ---------------------------------------------------------------------------
-
-export interface UpdateOptions {
-  /** Vault root directory (default: process.cwd()). */
-  vaultDir?: string;
-  /** Whether stdout is a TTY (default: process.stdout.isTTY). */
-  isTTY?: boolean;
-  /** Dry run — show what would change and exit 0 without making changes. */
-  check?: boolean;
-  /** Override update channel: 'stable' | 'next'. Falls back to vault.yml update_channel. */
-  channel?: 'stable' | 'next';
-  /** Mock fetch for tests. */
-  fetchFn?: typeof fetch;
-  /** Injectable vault-sync function for tests. */
-  vaultSyncFn?: (
-    vaultDir: string,
-    opts: Record<string, unknown>,
-  ) => Promise<{ filesAdded: number; filesRemoved: number }>;
-  /** Injectable binary install function for tests. */
-  installBinaryFn?: (version: string) => Promise<void>;
-  /** Injectable binary validation function for tests. Returns true if binary is valid. */
-  validateBinaryFn?: () => Promise<boolean>;
-  /** Injectable register-hooks function for tests. */
-  registerHooksFn?: (vaultDir: string) => Promise<void>;
-}
-
-export interface UpdateResult {
-  ok: boolean;
-  exitCode: number;
-  latestVersion?: string;
-  currentVersion?: string;
-  error?: string;
-}
-
-// ---------------------------------------------------------------------------
-// Constants
-// ---------------------------------------------------------------------------
-
-const GITHUB_RELEASES_URL = 'https://api.github.com/repos/kengio/onebrain/releases/latest';
-
-// ---------------------------------------------------------------------------
-// Helpers
-// ---------------------------------------------------------------------------
-
-/** Resolve branch name from channel or vault.yml update_channel. */
-function resolveBranch(channel: string | undefined): string {
-  return channel === 'next' ? 'next' : 'main';
-}
-
-/** Read vault.yml as raw object — non-throwing. Returns {} on missing/invalid. */
-async function readVaultYmlRaw(vaultDir: string): Promise<Record<string, unknown>> {
-  try {
-    const text = await readFile(join(vaultDir, 'vault.yml'), 'utf8');
-    return (parseYaml(text) ?? {}) as Record<string, unknown>;
-  } catch {
-    return {};
-  }
-}
-
-/** Write onebrain_version field to vault.yml atomically (in-place merge). */
-async function writeVersionToVaultYml(vaultDir: string, version: string): Promise<void> {
-  const raw = await readVaultYmlRaw(vaultDir);
-  raw.onebrain_version = version;
-  const content = stringifyYaml(raw, { lineWidth: 0 });
-  const vaultYmlPath = join(vaultDir, 'vault.yml');
-  const tmpPath = `${vaultYmlPath}.tmp`;
-  await writeFile(tmpPath, content, 'utf8');
-  await rename(tmpPath, vaultYmlPath);
-}
-
-// ---------------------------------------------------------------------------
-// Step 1: Fetch latest release
-// ---------------------------------------------------------------------------
-
-async function fetchLatestVersion(fetchFn: typeof fetch): Promise<string> {
-  const response = await fetchFn(GITHUB_RELEASES_URL, {
-    headers: { Accept: 'application/vnd.github.v3+json' },
-  });
-  if (!response.ok) {
-    throw new Error(`GitHub API returned HTTP ${response.status}`);
-  }
-  const json = (await response.json()) as Record<string, unknown>;
-  const tagName = json.tag_name;
-  if (typeof tagName !== 'string' || !tagName) {
-    throw new Error('GitHub response missing tag_name');
-  }
-  return tagName;
-}
-
-// ---------------------------------------------------------------------------
-// Step 4: Install binary
-// ---------------------------------------------------------------------------
-
-async function defaultInstallBinary(version: string): Promise<void> {
-  const isWindows = process.platform === 'win32';
-  const cmd = isWindows
-    ? ['npm', 'install', '-g', `@onebrain-ai/cli@${version}`]
-    : ['bun', 'install', '-g', `@onebrain-ai/cli@${version}`];
-
-  const proc = Bun.spawn(cmd, { stdout: 'pipe', stderr: 'pipe' });
-  const exitCode = await proc.exited;
-  if (exitCode !== 0) {
-    const errText = await new Response(proc.stderr).text();
-    throw new Error(`Binary install failed (exit ${exitCode}): ${errText.trim()}`);
-  }
-}
-
-// ---------------------------------------------------------------------------
-// Step 4b: Validate binary
-// ---------------------------------------------------------------------------
-
-async function defaultValidateBinary(): Promise<boolean> {
-  try {
-    const proc = Bun.spawn(['onebrain', '--version'], { stdout: 'pipe', stderr: 'pipe' });
-    const exitCode = await proc.exited;
-    if (exitCode !== 0) return false;
-    const stdout = await new Response(proc.stdout).text();
-    // Expect version-like output (digits)
-    return /^\d+\.\d+/.test(stdout.trim());
-  } catch {
-    return false;
-  }
-}
-
-// ---------------------------------------------------------------------------
-// Main runUpdate
-// ---------------------------------------------------------------------------
-
-export async function runUpdate(opts: UpdateOptions = {}): Promise<UpdateResult> {
-  const vaultDir = opts.vaultDir ?? process.cwd();
-  const isTTY = opts.isTTY ?? process.stdout.isTTY ?? false;
-  const check = opts.check ?? false;
-
-  const fetchFn = opts.fetchFn ?? globalThis.fetch;
-
-  const vaultSyncFn =
-    opts.vaultSyncFn ??
-    (async (dir: string, syncOpts: Record<string, unknown>) => {
-      const { runVaultSync } = await import('../internal/vault-sync.js');
-      const result = await runVaultSync(dir, syncOpts);
-      return { filesAdded: result.filesAdded, filesRemoved: result.filesRemoved };
-    });
-
-  const installBinaryFn = opts.installBinaryFn ?? defaultInstallBinary;
-  const validateBinaryFn = opts.validateBinaryFn ?? defaultValidateBinary;
-
-  const registerHooksFn =
-    opts.registerHooksFn ??
-    (async (dir: string) => {
-      const { runRegisterHooks } = await import('../internal/register-hooks.js');
-      await runRegisterHooks({ vaultDir: dir });
-    });
-
-  const result: UpdateResult = {
-    ok: false,
-    exitCode: 0,
-  };
-
-  // Output helpers
-  function writeLine(msg: string) {
-    process.stdout.write(`${msg}\n`);
-  }
-
-  function noteStep(label: string, detail: string) {
-    if (isTTY) {
-      log.step(`${label}\n│  ${detail}`);
-    } else {
-      writeLine(`${label}: ${detail}`);
-    }
-  }
-
-  // Header
-  if (isTTY) {
-    intro('OneBrain Update');
-  } else {
-    writeLine('OneBrain Update');
-  }
-
-  // ── Step 1: Fetch latest release ──────────────────────────────────────────
-
-  let latestVersion: string;
-  try {
-    latestVersion = await fetchLatestVersion(fetchFn);
-  } catch (err) {
-    const msg = err instanceof Error ? err.message : String(err);
-    result.error = `Fetch failed: ${msg}`;
-    result.exitCode = 1;
-    process.stderr.write(`update: ${result.error}\n`);
-    return result;
-  }
-
-  result.latestVersion = latestVersion;
-
-  // Read current version from vault.yml
-  const vaultYmlRaw = await readVaultYmlRaw(vaultDir);
-  const currentVersion =
-    typeof vaultYmlRaw.onebrain_version === 'string' ? vaultYmlRaw.onebrain_version : 'unknown';
-  result.currentVersion = currentVersion;
-
-  // Resolve channel/branch
-  const channel =
-    opts.channel ??
-    (typeof vaultYmlRaw.update_channel === 'string'
-      ? (vaultYmlRaw.update_channel as 'stable' | 'next')
-      : 'stable');
-  const branch = resolveBranch(channel);
-
-  noteStep('fetching', `${latestVersion} available (current: ${currentVersion})`);
-
-  // ── --check: dry run ──────────────────────────────────────────────────────
-
-  if (check) {
-    if (isTTY) {
-      outro('Dry run complete — no changes made');
-    } else {
-      writeLine('done: dry run complete — no changes made');
-    }
-    result.ok = true;
-    result.exitCode = 0;
-    return result;
-  }
-
-  // ── Step 2: vault-sync ────────────────────────────────────────────────────
-
-  let filesAdded = 0;
-  let filesRemoved = 0;
-  try {
-    const syncResult = await vaultSyncFn(vaultDir, { branch });
-    filesAdded = syncResult.filesAdded;
-    filesRemoved = syncResult.filesRemoved;
-  } catch (err) {
-    const msg = err instanceof Error ? err.message : String(err);
-    result.error = `vault-sync failed: ${msg}`;
-    result.exitCode = 1;
-    process.stderr.write(`update: ${result.error}\n`);
-    return result;
-  }
-
-  noteStep('syncing', `${filesAdded} files synced, ${filesRemoved} removed`);
-
-  // ── Step 4: Install binary ────────────────────────────────────────────────
-
-  try {
-    await installBinaryFn(latestVersion);
-  } catch (err) {
-    const msg = err instanceof Error ? err.message : String(err);
-    result.error = `Binary install failed: ${msg}`;
-    result.exitCode = 1;
-    process.stderr.write(`update: ${result.error}\n`);
-    return result;
-  }
-
-  noteStep('upgrading', `@onebrain-ai/cli ${latestVersion} installed`);
-
-  // ── Step 4b: Validate binary (ATOMIC GATE) ────────────────────────────────
-
-  const binaryValid = await validateBinaryFn();
-  if (!binaryValid) {
-    result.error = 'Binary validation failed. Check PATH. register-hooks NOT called.';
-    result.exitCode = 1;
-    process.stderr.write(`update: ${result.error}\n`);
-    return result;
-  }
-
-  // ── Step 5: Register hooks (only if 4b passed) ────────────────────────────
-
-  let hooksDetail = 'hooks: ✓  PATH: ✓  permissions: ✓';
-  let hooksOk = true;
-  try {
-    await registerHooksFn(vaultDir);
-  } catch (err) {
-    const msg = err instanceof Error ? err.message : String(err);
-    hooksDetail = `warning: ${msg}`;
-    hooksOk = false;
-    process.stderr.write(`update: register-hooks warning: ${msg}\n`);
-  }
-
-  if (isTTY) {
-    log.step(`Registering hooks\n│  ${hooksDetail}`);
-  } else {
-    writeLine(hooksOk ? 'hooks: ok  PATH: ok  permissions: ok' : `hooks: warning — ${hooksDetail}`);
-  }
-
-  // ── Step 6: Write version to vault.yml ───────────────────────────────────
-
-  try {
-    await writeVersionToVaultYml(vaultDir, latestVersion);
-  } catch (err) {
-    const msg = err instanceof Error ? err.message : String(err);
-    process.stderr.write(`update: vault.yml version write warning: ${msg}\n`);
-    if (isTTY) {
-      log.warn(`vault.yml not updated — ${msg}`);
-    } else {
-      writeLine(`warning: vault.yml not updated — ${msg}`);
-    }
-  }
-
-  // ── Done ──────────────────────────────────────────────────────────────────
-
-  result.ok = true;
-  result.exitCode = 0;
-
-  const doneMsg = `OneBrain ${latestVersion}`;
-  if (isTTY) {
-    outro(`Done — ${doneMsg}`);
-  } else {
-    writeLine(`done: ${doneMsg}`);
-  }
-
-  return result;
-}
-
-// ---------------------------------------------------------------------------
-// CLI entry point (called from index.ts)
-// ---------------------------------------------------------------------------
-
-export interface UpdateCommandOptions {
-  vaultDir?: string;
-  check?: boolean;
-  channel?: 'stable' | 'next';
-}
-
-export async function updateCommand(opts: UpdateCommandOptions = {}): Promise<void> {
-  const result = await runUpdate(opts);
-  if (!result.ok) {
-    process.exit(result.exitCode || 1);
-  }
-}

package/src/index.ts

@@ -1,144 +0,0 @@
-#!/usr/bin/env bun
-import { Command } from 'commander';
-import { doctorCommand } from './commands/doctor.js';
-import { initCommand } from './commands/init.js';
-import { updateCommand } from './commands/update.js';
-import { checkpointCommand } from './internal/checkpoint.js';
-import { migrateCommand } from './internal/migrate.js';
-import { orphanScanCommand } from './internal/orphan-scan.js';
-import { qmdReindexCommand } from './internal/qmd-reindex.js';
-import { registerHooksCommand } from './internal/register-hooks.js';
-import { resolveSessionToken, sessionInitCommand } from './internal/session-init.js';
-import { vaultSyncCommand } from './internal/vault-sync.js';
-
-// BUILD_VERSION and BUILD_DATE are injected as string literals at compile time
-// via `bun build --define BUILD_VERSION='"x.y.z"'`. When running without --define
-// (e.g. `bun run src/index.ts` during development), the identifiers are undeclared
-// at runtime, and the typeof guard falls back to the dev placeholder.
-declare const BUILD_VERSION: string;
-declare const BUILD_DATE: string;
-const VERSION = typeof BUILD_VERSION !== 'undefined' ? BUILD_VERSION : '0.0.0-dev';
-const RELEASE_DATE = typeof BUILD_DATE !== 'undefined' ? BUILD_DATE : 'dev';
-
-const VERSION_STRING = `OneBrain v${VERSION} — released ${RELEASE_DATE}`;
-
-// Handle no-args case before commander parses anything.
-if (process.argv.slice(2).length === 0) {
-  console.log(VERSION_STRING);
-  console.log('Run `onebrain help` for available commands.');
-  process.exit(0);
-}
-
-const program = new Command();
-
-program
-  .name('onebrain')
-  .description('OneBrain CLI — personal AI OS for Obsidian')
-  .version(VERSION_STRING, '-v, --version');
-
-// ── User-facing commands ──────────────────────────────────────────────────────
-
-program
-  .command('init')
-  .description('Initialize a new OneBrain vault')
-  .option('--vault-dir <path>', 'vault root directory (default: cwd)')
-  .option('--harness <harness>', 'harness type: claude-code | gemini | direct')
-  .option('--force', 'overwrite existing vault.yml without prompting')
-  .action(async (opts: { vaultDir?: string; harness?: string; force?: boolean }) => {
-    await initCommand({
-      vaultDir: opts.vaultDir,
-      harness: opts.harness as 'claude-code' | 'gemini' | 'direct' | undefined,
-      force: opts.force,
-    });
-  });
-
-program
-  .command('update')
-  .description('Update OneBrain plugin files from GitHub')
-  .option('--check', 'show what would change and exit without making changes')
-  .option('--channel <channel>', 'update channel: stable | next')
-  .action(async (opts: { check?: boolean; channel?: string }) => {
-    await updateCommand({
-      check: opts.check,
-      channel: opts.channel as 'stable' | 'next' | undefined,
-    });
-  });
-
-program
-  .command('doctor')
-  .description('Run vault health checks and report issues')
-  .action(async () => {
-    const vaultRoot = process.cwd();
-    await doctorCommand({ vaultDir: vaultRoot, binaryVersion: VERSION });
-  });
-
-program
-  .command('help')
-  .description('Show this help message')
-  .action(() => {
-    program.help();
-  });
-
-// ── Internal hidden commands (not shown in --help) ────────────────────────────
-
-program
-  .command('session-init', { hidden: true })
-  .description('Emit session token and datetime (called by Claude Code hook)')
-  .action(async () => {
-    const vaultRoot = process.cwd();
-    await sessionInitCommand(vaultRoot);
-  });
-
-program
-  .command('orphan-scan', { hidden: true })
-  .description('Scan for orphaned checkpoint files in logs folder')
-  .argument('<logs_folder>', 'path to logs folder')
-  .argument('<session_token>', 'current session token to exclude')
-  .action(async (logsFolder: string, sessionToken: string) => {
-    await orphanScanCommand(logsFolder, sessionToken);
-  });
-
-program
-  .command('checkpoint', { hidden: true })
-  .description('Handle checkpoint lifecycle (stop/precompact/postcompact/reset)')
-  .argument('<mode>', 'stop | precompact | postcompact | reset')
-  .action(async (mode: string) => {
-    const token = await resolveSessionToken();
-    await checkpointCommand(mode, token, process.cwd());
-  });
-
-program
-  .command('qmd-reindex', { hidden: true })
-  .description('Trigger qmd index rebuild')
-  .action(async () => {
-    const vaultRoot = process.cwd();
-    await qmdReindexCommand(vaultRoot);
-  });
-
-program
-  .command('vault-sync', { hidden: true })
-  .description('Sync plugin files from GitHub to vault')
-  .argument('[vault_root]', 'vault root directory (default: cwd)')
-  .option('--branch <branch>', 'override branch (main | next)')
-  .action(async (vaultRoot: string | undefined, opts: { branch?: string }) => {
-    const root = vaultRoot ?? process.cwd();
-    await vaultSyncCommand(root, { branch: opts.branch });
-  });
-
-program
-  .command('register-hooks', { hidden: true })
-  .description('Install Claude Code hooks into settings.json')
-  .option('--vault-dir <path>', 'vault root directory (default: cwd)')
-  .action(async (opts: { vaultDir?: string }) => {
-    await registerHooksCommand(opts.vaultDir);
-  });
-
-program
-  .command('migrate', { hidden: true })
-  .description('Run one-time migration scripts')
-  .argument('<name>', 'migration name: backfill-recapped')
-  .action(async (name: string) => {
-    await migrateCommand(name);
-  });
-
-program.parse(process.argv);

package/src/internal/__snapshots__/checkpoint.test.ts.snap

@@ -1,12 +0,0 @@
-// Bun Snapshot v1, https://bun.sh/docs/test/snapshots
-
-exports[`handleStop stop block JSON shape matches snapshot { decision: "block", reason: "...-checkpoint-NN.md since ..." } 1`] = `
-[
-  "decision",
-  "reason",
-]
-`;
-
-exports[`handleStop stop block JSON shape matches snapshot { decision: "block", reason: "...-checkpoint-NN.md since ..." } 2`] = `"block"`;
-
-exports[`handleStop stop block JSON shape matches snapshot { decision: "block", reason: "...-checkpoint-NN.md since ..." } 3`] = `"string"`;

package/src/internal/__snapshots__/orphan-scan.test.ts.snap

@@ -1,13 +0,0 @@
-// Bun Snapshot v1, https://bun.sh/docs/test/snapshots
-
-exports[`runOrphanScan output shape matches snapshot { orphan_count: N } 1`] = `
-{
-  "orphan_count": 0,
-}
-`;
-
-exports[`runOrphanScan output shape matches snapshot { orphan_count: N } 2`] = `
-{
-  "orphan_count": 1,
-}
-`;

package/src/internal/__snapshots__/session-init.test.ts.snap

@@ -1,15 +0,0 @@
-// Bun Snapshot v1, https://bun.sh/docs/test/snapshots
-
-exports[`runSessionInit normal payload output shape matches snapshot 1`] = `
-[
-  "datetime",
-  "qmd_unembedded",
-  "session_token",
-]
-`;
-
-exports[`runSessionInit normal payload output shape matches snapshot 2`] = `"string"`;
-
-exports[`runSessionInit normal payload output shape matches snapshot 3`] = `"string"`;
-
-exports[`runSessionInit normal payload output shape matches snapshot 4`] = `"number"`;