@polderlabs/bizar 4.8.0 → 5.0.0

package/cli/commands/clip.mjs

@@ -0,0 +1,146 @@
+/**
+ * cli/commands/clip.mjs
+ *
+ * v5.0.0 — Web Clipper CLI subcommand.
+ *
+ * Subcommands:
+ *   bizar clip list              List recent clips
+ *   bizar clip delete <id>       Delete a clip from the log
+ *   bizar clip configure         Show current dashboard URL
+ */
+
+import chalk from 'chalk';
+import { readDashboardConn } from './headroom.mjs';
+
+// ── API helpers ────────────────────────────────────────────────────────────────
+
+async function apiGet(path) {
+  const { port, secret } = readDashboardConn();
+  const baseUrl = `http://127.0.0.1:${port}`;
+  const url = `${baseUrl}${path}`;
+  const headers = { accept: 'application/json' };
+  if (secret) headers.authorization = `Basic ${Buffer.from(`opencode:${secret}`).toString('base64')}`;
+  const res = await fetch(url, { method: 'GET', headers });
+  const text = await res.text();
+  let data = null;
+  try { data = text ? JSON.parse(text) : null; } catch { /* ignore */ }
+  if (!res.ok) throw new Error(`${path}: ${data?.message || data?.error || res.statusText}`);
+  return data;
+}
+
+async function apiDel(path) {
+  const { port, secret } = readDashboardConn();
+  const baseUrl = `http://127.0.0.1:${port}`;
+  const url = `${baseUrl}${path}`;
+  const headers = { accept: 'application/json' };
+  if (secret) headers.authorization = `Basic ${Buffer.from(`opencode:${secret}`).toString('base64')}`;
+  const res = await fetch(url, { method: 'DELETE', headers });
+  const text = await res.text();
+  let data = null;
+  try { data = text ? JSON.parse(text) : null; } catch { /* ignore */ }
+  if (!res.ok) throw new Error(`${path}: ${data?.message || data?.error || res.statusText}`);
+  return data;
+}
+
+// ── Help ──────────────────────────────────────────────────────────────────────
+
+export function showClipHelp() {
+  console.log(`
+  bizar clip — Manage web clips (saved via the browser extension or bookmarklet)
+
+  Usage:
+    bizar clip list               List recent clips
+    bizar clip delete <id>        Delete a clip from the log
+    bizar clip configure          Show the current dashboard connection
+
+  Examples:
+    bizar clip list
+    bizar clip delete my_page_1712345678
+  `);
+}
+
+// ── Subcommand handlers ────────────────────────────────────────────────────────
+
+async function listClips() {
+  try {
+    const data = await apiGet('/api/clipboard/list');
+    const clips = data.clips || [];
+    if (clips.length === 0) {
+      console.log(chalk.dim('  No clips yet.'));
+      return;
+    }
+    console.log('');
+    console.log(chalk.bold('  Recent Clips'));
+    console.log('');
+    for (const c of clips) {
+      const date = c.savedAt ? new Date(c.savedAt).toLocaleString() : '—';
+      console.log(`  ${chalk.bold(c.id)}`);
+      console.log(`    Title: ${c.title || 'Untitled'}`);
+      console.log(`    Saved: ${date}`);
+      console.log(`    Path:  ${c.notePath || '—'}`);
+      console.log('');
+    }
+  } catch (err) {
+    console.error(chalk.red(`  ✗ Failed to list clips: ${err.message}`));
+    process.exit(1);
+  }
+}
+
+async function deleteClip(id) {
+  if (!id) {
+    console.error(chalk.red('  Error: clip ID is required'));
+    console.error('  Usage: bizar clip delete <id>');
+    process.exit(1);
+  }
+  try {
+    await apiDel(`/api/clipboard/${encodeURIComponent(id)}`);
+    console.log(chalk.green(`  ✓ Clip "${id}" deleted from log.`));
+  } catch (err) {
+    if (err.message.includes('404')) {
+      console.error(chalk.red(`  ✗ Clip "${id}" not found.`));
+    } else {
+      console.error(chalk.red(`  ✗ Failed to delete clip: ${err.message}`));
+    }
+    process.exit(1);
+  }
+}
+
+function showConfigure() {
+  const conn = readDashboardConn();
+  console.log('');
+  console.log(chalk.bold('  Dashboard Connection'));
+  console.log('');
+  console.log(`  URL:   http://127.0.0.1:${conn.port}`);
+  console.log(`  Auth:  ${conn.secret ? 'enabled' : 'disabled'}`);
+  console.log('');
+  console.log(chalk.dim('  To change the dashboard URL, use: bizar dash configure'));
+  console.log('');
+}
+
+// ── Main dispatcher ────────────────────────────────────────────────────────────
+
+export async function run(name, args, isHelpRequest) {
+  const sub = args[0];
+  const subArgs = args.slice(1);
+
+  if (!sub || sub === '--help' || sub === '-h' || isHelpRequest) {
+    showClipHelp();
+    return;
+  }
+
+  switch (sub) {
+    case 'list':
+      await listClips();
+      break;
+    case 'delete':
+      await deleteClip(subArgs[0]);
+      break;
+    case 'configure':
+      showConfigure();
+      break;
+    default:
+      console.error(chalk.red(`  ✗ Unknown subcommand: ${sub}`));
+      showClipHelp();
+      process.exit(1);
+  }
+}

package/cli/commands/dash.mjs

@@ -42,6 +42,12 @@ export function showDashHelp() {
   Note:
     \`bizar dashboard\` is a deprecated alias for \`bizar dash\` and still
     works, but new code should use \`bizar dash\`.
+
+  OpenTelemetry (optional, env vars):
+    BIZAR_OTEL=1                       Enable OpenTelemetry tracing (off by default)
+    OTEL_ENABLED=1                     Alias that also opts in
+    OTEL_EXPORTER_OTLP_ENDPOINT        OTLP HTTP traces endpoint
+                                       (default http://localhost:4318/v1/traces)
   `);
 }
 

package/cli/commands/deploy/cloudflare.mjs

@@ -0,0 +1,250 @@
+/**
+ * cli/commands/deploy/cloudflare.mjs
+ *
+ * Cloudflare Pages + Workers deployment via REST API.
+ *
+ * Generates wrangler.toml + functions/ (Workers entry) + public/ (static),
+ * then uploads to Cloudflare Pages API or runs wrangler CLI.
+ */
+import chalk from 'chalk';
+import { existsSync, mkdirSync, writeFileSync, readFileSync, readdirSync, statSync } from 'node:fs';
+import { join } from 'node:path';
+import { execSync } from 'node:child_process';
+
+const API_BASE = 'https://api.cloudflare.com/client/v4';
+
+// ── Scaffold generation ──────────────────────────────────────────────────────
+
+function generateScaffold(outDir, opts) {
+  const scaffoldRoot = join(outDir, 'cloudflare');
+
+  if (!existsSync(scaffoldRoot)) {
+    mkdirSync(scaffoldRoot, { recursive: true });
+  }
+
+  // wrangler.toml
+  const wranglerContent = [
+    'name = "' + (opts.projectName || 'bizar-dash') + '"',
+    'main = "functions/index.js"',
+    'compatibility_date = "2025-01-01"',
+    '',
+    '[site]',
+    '  bucket = "./public"',
+    '',
+    '[env.production]',
+    '  routes = ["' + (opts.projectName || 'bizar-dash') + '.*.pages.dev/*"]',
+    '',
+  ].join('\n');
+  writeFileSync(join(scaffoldRoot, 'wrangler.toml'), wranglerContent);
+
+  // functions/index.js — Workers function entry
+  const fnDir = join(scaffoldRoot, 'functions');
+  if (!existsSync(fnDir)) mkdirSync(fnDir, { recursive: true });
+
+  const functionsIndex = [
+    '// Cloudflare Workers entry — Bizar dashboard',
+    '// Generated by `bizar deploy --to cloudflare`',
+    '',
+    'export async function onRequest(context) {',
+    '  const { request, env } = context;',
+    '  const url = new URL(request.url);',
+    '',
+    '  // Serve static assets from Pages KV',
+    '  if (url.pathname.startsWith("/assets/")) {',
+    '    return env.ASSETS.fetch(request);',
+    '  }',
+    '',
+    '  // SPA fallback',
+    '  return env.ASSETS.fetch(new Request(url.origin + "/index.html", request));',
+    '}',
+    '',
+  ].join('\n');
+  writeFileSync(join(fnDir, 'index.js'), functionsIndex);
+
+  // public/ — placeholder for dashboard build output
+  const publicDir = join(scaffoldRoot, 'public');
+  if (!existsSync(publicDir)) mkdirSync(publicDir, { recursive: true });
+
+  // Build the dashboard
+  console.log(chalk.dim('  Building dashboard bundle\u2026'));
+  try {
+    execSync('npm run build', {
+      cwd: opts.projectRoot,
+      encoding: 'utf8',
+      stdio: 'pipe',
+      timeout: 120000,
+    });
+  } catch (err) {
+    throw new Error('Dashboard build failed: ' + err.message);
+  }
+
+  // Copy built assets into public/
+  const distDir = join(opts.projectRoot, 'dist');
+  if (existsSync(distDir)) {
+    execSync('cp -r "' + distDir + '"/* "' + publicDir + '/"', { stdio: 'pipe' });
+  } else {
+    console.log(chalk.yellow('  \u26a0 No dist/ found \u2014 deploying scaffold only'));
+  }
+
+  console.log(chalk.dim('  \u2713 Scaffold generated at', scaffoldRoot));
+  return scaffoldRoot;
+}
+
+// ── API helpers ──────────────────────────────────────────────────────────────
+
+async function cfPost(path, token, body) {
+  const url = API_BASE + path;
+  const res = await fetch(url, {
+    method: 'POST',
+    headers: {
+      Authorization: 'Bearer ' + token,
+      'Content-Type': 'application/json',
+    },
+    body: JSON.stringify(body),
+  });
+  const json = await res.json();
+  if (!json.success) {
+    const msgs = (json.errors || []).map((e) => e.message).join('; ');
+    throw new Error('Cloudflare API error: ' + msgs || 'HTTP ' + res.status);
+  }
+  return json.result;
+}
+
+async function cfGet(path, token) {
+  const url = API_BASE + path;
+  const res = await fetch(url, {
+    headers: { Authorization: 'Bearer ' + token },
+  });
+  const json = await res.json();
+  if (!json.success) {
+    const msgs = (json.errors || []).map((e) => e.message).join('; ');
+    throw new Error('Cloudflare API error: ' + msgs || 'HTTP ' + res.status);
+  }
+  return json.result;
+}
+
+// ── Deployment ───────────────────────────────────────────────────────────────
+
+export async function deployToCloudflare({ token, projectName, projectRoot, outDir }) {
+  if (!token) {
+    throw new Error('Cloudflare token required. Pass --token or set CLOUDFLARE_API_TOKEN env var.');
+  }
+
+  // 1. Generate scaffold
+  const scaffoldRoot = generateScaffold(outDir, { projectName, projectRoot });
+  const name = projectName || 'bizar-dash';
+
+  // 2. Try wrangler CLI first (most reliable)
+  const hasWrangler = await checkWrangler();
+  if (hasWrangler) {
+    console.log(chalk.dim('  Deploying with wrangler CLI\u2026'));
+    try {
+      const output = execSync('npx wrangler pages deploy "' + scaffoldRoot + '" --project-name "' + name + '"' + (token ? ' --api-token ' + token : ''), {
+        cwd: scaffoldRoot,
+        encoding: 'utf8',
+        stdio: 'pipe',
+        timeout: 120000,
+      });
+      const urlMatch = output.match(/https:\/\/[^\s]+\.pages\.dev/);
+      const url = urlMatch ? urlMatch[0] : null;
+      if (url) {
+        return {
+          url,
+          deploymentId: name,
+          notes: ['Deployed via wrangler CLI.'],
+        };
+      }
+      return {
+        url: 'https://' + name + '.pages.dev',
+        deploymentId: name,
+        notes: ['Deployment complete. Check wrangler output for details.'],
+      };
+    } catch (err) {
+      throw new Error('wrangler deploy failed: ' + err.message);
+    }
+  }
+
+  // 3. Fallback: use Cloudflare Pages API directly
+  console.log(chalk.dim('  Deploying via Cloudflare API\u2026'));
+
+  // List accounts to find the first one
+  const accounts = await cfGet('/accounts', token);
+  if (!accounts || accounts.length === 0) {
+    throw new Error('No Cloudflare account found');
+  }
+  const accountId = accounts[0].id;
+
+  // Create or get the Pages project
+  let project;
+  try {
+    project = await cfPost('/accounts/' + accountId + '/pages/projects', token, {
+      name,
+      production_branch: 'main',
+    });
+  } catch {
+    // Project may already exist — look it up
+    project = await cfGet('/accounts/' + accountId + '/pages/projects/' + name, token);
+  }
+
+  if (!project) {
+    throw new Error('Could not create or find Cloudflare Pages project: ' + name);
+  }
+
+  // Upload files
+  const files = collectFiles(scaffoldRoot);
+  const uploadResult = await cfPost('/accounts/' + accountId + '/pages/projects/' + name + '/upload', token, {
+    files,
+  });
+
+  // Start deployment
+  const deployment = await cfPost('/accounts/' + accountId + '/pages/projects/' + name + '/deployments', token, {
+    manifest: uploadResult.manifest || {},
+  });
+
+  const subdomain = project.subdomain || (name + '.pages.dev');
+  return {
+    url: 'https://' + subdomain,
+    deploymentId: deployment.id || name,
+    notes: [
+      'Cloudflare Pages project: ' + name,
+      'Manage at https://dash.cloudflare.com/?to=/:account/pages/view/' + name,
+    ],
+  };
+}
+
+// ── Helpers ──────────────────────────────────────────────────────────────────
+
+async function checkWrangler() {
+  try {
+    execSync('npx wrangler --version', {
+      encoding: 'utf8',
+      stdio: 'pipe',
+      timeout: 10000,
+    });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function collectFiles(rootDir) {
+  const files = [];
+
+  function walk(dir, prefix) {
+    const entries = readdirSync(dir);
+    for (const entry of entries) {
+      const full = join(dir, entry);
+      const rel = prefix ? prefix + '/' + entry : entry;
+      const stat = statSync(full);
+      if (stat.isDirectory()) {
+        walk(full, rel);
+      } else {
+        const content = readFileSync(full, 'base64');
+        files.push({ file: rel, data: content, encoding: 'base64' });
+      }
+    }
+  }
+
+  walk(rootDir, '');
+  return files;
+}

package/cli/commands/deploy/docker.mjs

@@ -0,0 +1,221 @@
+/**
+ * cli/commands/deploy/docker.mjs
+ *
+ * Docker registry push deployment.
+ *
+ * Builds image: `docker build -t <registry>/<name>:<version> .`
+ * Pushes: `docker push <registry>/<name>:<version>`
+ * Optionally generates docker-compose.yml + .env for self-host.
+ */
+import chalk from 'chalk';
+import { existsSync, mkdirSync, writeFileSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { execSync } from 'node:child_process';
+
+// ── Scaffold generation ──────────────────────────────────────────────────────
+
+function generateComposeScaffold(outDir, opts) {
+  const scaffoldRoot = join(outDir, 'docker');
+
+  if (!existsSync(scaffoldRoot)) {
+    mkdirSync(scaffoldRoot, { recursive: true });
+  }
+
+  // docker-compose.yml
+  const imageRef = (opts.registry || 'ghcr.io') + '/' + (opts.imageName || 'bizar-dash');
+
+  const composeYml = [
+    '# docker-compose.yml — Bizar dashboard',
+    '# Generated by `bizar deploy --to docker --compose`',
+    '',
+    'version: "3.8"',
+    '',
+    'services:',
+    '  bizar-dash:',
+    '    image: ' + imageRef + ':latest',
+    '    container_name: bizar-dash',
+    '    restart: unless-stopped',
+    '    ports:',
+    '      - "4097:4097"',
+    '      - "4098:4098"',
+    '    environment:',
+    '      - BIZAR_DASHBOARD_PORT=4097',
+    '      - BIZAR_DASHBOARD_HOST=0.0.0.0',
+    '      - NODE_ENV=production',
+    '    env_file:',
+    '      - .env',
+    '    volumes:',
+    '      - bizar-config:/home/bizar/.config/bizar',
+    '      - bizar-memory:/home/bizar/.local/share/bizar/memory',
+    '',
+    'volumes:',
+    '  bizar-config:',
+    '  bizar-memory:',
+    '',
+  ].join('\n');
+  writeFileSync(join(scaffoldRoot, 'docker-compose.yml'), composeYml);
+
+  // .env template
+  const envTemplate = [
+    '# .env — Bizar dashboard environment variables',
+    '# Generated by `bizar deploy --to docker --compose`',
+    '#',
+    '# Copy this file to .env and fill in your values.',
+    '',
+    '# Dashboard',
+    '# BIZAR_DASHBOARD_PORT=4097',
+    '# BIZAR_DASHBOARD_HOST=0.0.0.0',
+    '',
+    '# OpenTelemetry (optional)',
+    '# BIZAR_OTEL=1',
+    '# OTEL_EXPORTER_OTLP_ENDPOINT=http://otel-collector:4318',
+    '',
+    '# Tailscale (optional)',
+    '# TAILSCALE_AUTHKEY=tskey-auth-xxxxxxxxxxxxxxxxxxxx',
+    '',
+    '# Headroom context compression (optional)',
+    '# HEADROOM_ENABLED=1',
+    '',
+  ].join('\n');
+  writeFileSync(join(scaffoldRoot, '.env.template'), envTemplate);
+
+  console.log(chalk.dim('  \u2713 Docker Compose scaffold generated at', scaffoldRoot));
+  return scaffoldRoot;
+}
+
+// ── Docker daemon check ──────────────────────────────────────────────────────
+
+function checkDocker() {
+  try {
+    execSync('docker info', {
+      encoding: 'utf8',
+      stdio: 'pipe',
+      timeout: 5000,
+    });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+// ── Deployment ───────────────────────────────────────────────────────────────
+
+export async function deployToDocker({ token, registry, imageName, projectRoot, outDir, compose }) {
+  // Handle --compose only mode
+  if (compose) {
+    const scaffoldRoot = generateComposeScaffold(outDir, { registry, imageName });
+    return {
+      url: null,
+      deploymentId: null,
+      notes: [
+        'Docker Compose files generated at ' + scaffoldRoot,
+        'To run: cd ' + scaffoldRoot + ' && docker compose up -d',
+        'To customize, edit docker-compose.yml and .env',
+      ],
+    };
+  }
+
+  // Full build + push
+  if (!checkDocker()) {
+    throw new Error(
+      'Docker daemon is not running. Start Docker and try again.\n' +
+      '  systemctl start docker   (Linux)\n' +
+      '  open -a Docker           (macOS)',
+    );
+  }
+
+  const reg = registry || 'ghcr.io';
+  const imgName = imageName || 'bizar-dash';
+  const version = getPackageVersion(projectRoot);
+  const imageRef = reg + '/' + imgName;
+  const tag = imageRef + ':' + version;
+  const latestTag = imageRef + ':latest';
+
+  // 1. Build the image
+  console.log(chalk.dim('  Building Docker image\u2026'));
+  try {
+    execSync('docker build -t "' + tag + '" -t "' + latestTag + '" .', {
+      cwd: projectRoot,
+      encoding: 'utf8',
+      stdio: 'pipe',
+      timeout: 300000, // 5 minutes
+    });
+  } catch (err) {
+    throw new Error('Docker build failed: ' + err.message);
+  }
+
+  // 2. Login if token provided
+  if (token) {
+    console.log(chalk.dim('  Authenticating with registry\u2026'));
+    const loginCmd = 'docker login ' + reg + ' --username=oauth --password-stdin';
+    try {
+      execSync(loginCmd, {
+        input: token,
+        encoding: 'utf8',
+        stdio: ['pipe', 'pipe', 'pipe'],
+        timeout: 15000,
+      });
+    } catch (err) {
+      throw new Error('Docker login failed: ' + err.message);
+    }
+  }
+
+  // 3. Push the image
+  console.log(chalk.dim('  Pushing image to ' + reg + '\u2026'));
+  try {
+    execSync('docker push "' + tag + '"', {
+      encoding: 'utf8',
+      stdio: 'pipe',
+      timeout: 300000,
+    });
+    execSync('docker push "' + latestTag + '"', {
+      encoding: 'utf8',
+      stdio: 'pipe',
+      timeout: 300000,
+    });
+  } catch (err) {
+    throw new Error('Docker push failed: ' + err.message);
+  }
+
+  const digest = getDigest(imageRef);
+  return {
+    url: null,
+    deploymentId: tag,
+    notes: [
+      'Image: ' + tag,
+      'Latest: ' + latestTag,
+      (digest ? 'Digest: ' + digest : ''),
+      '',
+      'To pull: docker pull ' + tag,
+      'To run:  docker run -p 4097:4097 ' + tag,
+      'To compose: bizar deploy --to docker --compose',
+    ].filter(Boolean),
+  };
+}
+
+// ── Helpers ──────────────────────────────────────────────────────────────────
+
+function getPackageVersion(projectRoot) {
+  try {
+    const pkg = JSON.parse(readFileSync(join(projectRoot, 'package.json'), 'utf8'));
+    return pkg.version || 'latest';
+  } catch {
+    return 'latest';
+  }
+}
+
+function getDigest(imageRef) {
+  try {
+    const output = execSync('docker inspect --format="{{.RepoDigests}}" "' + imageRef + '"', {
+      encoding: 'utf8',
+      stdio: 'pipe',
+      timeout: 5000,
+    });
+    const match = output.match(/sha256:[a-f0-9]{64}/);
+    return match ? match[0] : null;
+  } catch {
+    return null;
+  }
+}
+
+