@balise.dev/cli 0.1.2 → 0.1.3

package/dist/index.js

@@ -548,8 +548,8 @@ var ApiClient = class {
     }
     return res.json();
   }
-  async getJson(path4) {
-    const url = joinUrl(this.opts.apiUrl, path4);
+  async getJson(path5) {
+    const url = joinUrl(this.opts.apiUrl, path5);
     return this.withAuth(async (headers) => {
       const { statusCode, body } = await wrapNetwork(() => request2(url, {
         method: "GET",
@@ -564,8 +564,8 @@ var ApiClient = class {
       };
     });
   }
-  async postJson(path4, payload) {
-    const url = joinUrl(this.opts.apiUrl, path4);
+  async postJson(path5, payload) {
+    const url = joinUrl(this.opts.apiUrl, path5);
     return this.withAuth(async (headers) => {
       const { statusCode, body } = await wrapNetwork(() => request2(url, {
         method: "POST",
@@ -589,10 +589,10 @@ var ApiClient = class {
    * metadata travels in the query string. Matches the FastAPI contract
    * `POST /v1/repos/:owner/:slug/sync?commit_sha=...&branch=...`.
    */
-  async uploadBundle(path4, opts) {
+  async uploadBundle(path5, opts) {
     await this.ensureFreshToken();
     const qs = new URLSearchParams(opts.query).toString();
-    const url = `${joinUrl(this.opts.apiUrl, path4)}${qs ? `?${qs}` : ""}`;
+    const url = `${joinUrl(this.opts.apiUrl, path5)}${qs ? `?${qs}` : ""}`;
     return this.withAuth(async (headers) => {
       const { statusCode, body } = await wrapNetwork(() => request2(url, {
         method: "POST",
@@ -613,9 +613,43 @@ var ApiClient = class {
       };
     });
   }
+  /**
+   * Same wire as `uploadBundle` but returns the raw `(status, text)` pair so
+   * callers can branch on response shape (200 dry-run, 202 happy, 409
+   * idempotency, 422 invalid base) without `ApiError` swallowing the body.
+   *
+   * Token refresh and auth attachment behave identically; we still rely on
+   * `withAuth` for the 401-then-retry plumbing. Non-401 statuses are
+   * returned to the caller verbatim — `withAuth` only treats 401 specially.
+   */
+  async uploadBundleRaw(path5, opts) {
+    await this.ensureFreshToken();
+    const qs = new URLSearchParams(opts.query).toString();
+    const url = `${joinUrl(this.opts.apiUrl, path5)}${qs ? `?${qs}` : ""}`;
+    let tokens = await loadTokens();
+    if (!tokens) throw new NotAuthenticatedError();
+    const exec = async (token) => {
+      const { statusCode, body } = await wrapNetwork(
+        () => request2(url, {
+          method: "POST",
+          headers: {
+            Authorization: `Bearer ${token}`,
+            "Content-Type": "application/octet-stream"
+          },
+          body: opts.bundleStream,
+          dispatcher: this.opts.dispatcher
+        })
+      );
+      const text = await body.text();
+      return { status: statusCode, text };
+    };
+    const first = await exec(tokens.access_token);
+    if (first.status !== 401) return first;
+    throw new NotAuthenticatedError();
+  }
 };
-function joinUrl(base, path4) {
-  return `${base.replace(/\/$/, "")}${path4.startsWith("/") ? path4 : `/${path4}`}`;
+function joinUrl(base, path5) {
+  return `${base.replace(/\/$/, "")}${path5.startsWith("/") ? path5 : `/${path5}`}`;
 }
 
 // src/config.ts
@@ -795,7 +829,6 @@ async function gitBundle(opts) {
 }
 
 // src/auth-ensure.ts
-import readline from "readline/promises";
 import crypto3 from "crypto";
 import open2 from "open";
 var LoginDeclinedError = class extends Error {
@@ -808,6 +841,7 @@ function isInteractive(stdin) {
   const s = stdin ?? process.stdin;
   return Boolean(s.isTTY);
 }
+var LOGIN_AUTOLAUNCH_MESSAGE = "Not logged in, launching balise login...";
 async function ensureAuthenticated(opts) {
   const existing = await loadTokens();
   if (existing) return;
@@ -815,19 +849,8 @@ async function ensureAuthenticated(opts) {
   if (!isInteractive(opts.stdin)) {
     throw new LoginDeclinedError();
   }
-  const rl = readline.createInterface({
-    input: opts.stdin ?? process.stdin,
-    output: opts.stdout ?? process.stdout
-  });
-  let answer;
-  try {
-    answer = (await rl.question("Not logged in. Login now? (Y/n) ")).trim();
-  } finally {
-    rl.close();
-  }
-  if (answer && !/^y(es)?$/i.test(answer)) {
-    throw new LoginDeclinedError();
-  }
+  stderr.write(`${LOGIN_AUTOLAUNCH_MESSAGE}
+`);
   const verifier = generateCodeVerifier();
   const challenge = codeChallengeFor(verifier);
   const state = crypto3.randomBytes(16).toString("hex");
@@ -892,55 +915,81 @@ ${credentialsHelpMessage()}
 // src/ui/InitPicker.tsx
 import React, { useState } from "react";
 import { Box, Text, useApp, useInput } from "ink";
+import { Select, TextInput } from "@inkjs/ui";
+function normalizeSlug(raw) {
+  return raw.toLowerCase().replace(/[^a-z0-9-]/g, "");
+}
 function InitPicker(props) {
   const { exit } = useApp();
-  const [zone, setZone] = useState(
-    props.repos.length > 0 ? "link" : "create"
+  const [field, setField] = useState("slug");
+  const [slug, setSlug] = useState(normalizeSlug(props.defaultSlug));
+  const [ownerId, setOwnerId] = useState(
+    props.ownerships[0]?.id
   );
-  const [slug, setSlug] = useState(props.defaultSlug);
-  const [ownerIdx, setOwnerIdx] = useState(0);
-  const [repoIdx, setRepoIdx] = useState(0);
-  useInput((input, key) => {
+  const [repoId, setRepoId] = useState(
+    props.repos[0]?.id
+  );
+  const submit = () => {
+    if (field === "link") {
+      const repo = props.repos.find((r) => r.id === repoId);
+      if (!repo) return;
+      props.onDone({ action: "link", repo });
+    } else {
+      const owner = props.ownerships.find((o) => o.id === ownerId);
+      if (!owner || !slug) return;
+      props.onDone({ action: "create", slug, owner });
+    }
+    exit();
+  };
+  useInput((_input, key) => {
     if (key.escape) {
       props.onDone({ action: "cancel" });
       exit();
       return;
     }
     if (key.tab) {
-      setZone((z) => z === "create" ? "link" : "create");
+      setField((f) => {
+        if (f === "slug") return "owner";
+        if (f === "owner") return props.repos.length > 0 ? "link" : "slug";
+        return "slug";
+      });
       return;
     }
     if (key.return) {
-      if (zone === "create") {
-        if (!props.ownerships[ownerIdx]) return;
-        props.onDone({
-          action: "create",
-          slug,
-          owner: props.ownerships[ownerIdx]
-        });
-      } else {
-        if (!props.repos[repoIdx]) return;
-        props.onDone({ action: "link", repo: props.repos[repoIdx] });
-      }
-      exit();
-      return;
-    }
-    if (zone === "create") {
-      if (key.upArrow)
-        setOwnerIdx((i) => (i - 1 + props.ownerships.length) % Math.max(1, props.ownerships.length));
-      else if (key.downArrow)
-        setOwnerIdx((i) => (i + 1) % Math.max(1, props.ownerships.length));
-      else if (key.backspace || key.delete) setSlug((s) => s.slice(0, -1));
-      else if (input && /^[a-z0-9-]$/i.test(input))
-        setSlug((s) => (s + input).toLowerCase());
-    } else {
-      if (key.upArrow)
-        setRepoIdx((i) => (i - 1 + props.repos.length) % Math.max(1, props.repos.length));
-      else if (key.downArrow)
-        setRepoIdx((i) => (i + 1) % Math.max(1, props.repos.length));
+      submit();
     }
   });
-  return /* @__PURE__ */ React.createElement(Box, { flexDirection: "column", paddingX: 1 }, /* @__PURE__ */ React.createElement(Text, { bold: true }, "Balise \u2014 link or create a repo"), /* @__PURE__ */ React.createElement(Box, { marginTop: 1, flexDirection: "column" }, /* @__PURE__ */ React.createElement(Text, { color: zone === "create" ? "cyan" : "gray" }, zone === "create" ? "\u25B8 " : "  ", "Create new repo"), zone === "create" && /* @__PURE__ */ React.createElement(Box, { marginLeft: 2, flexDirection: "column" }, /* @__PURE__ */ React.createElement(Text, null, "slug : ", /* @__PURE__ */ React.createElement(Text, { color: "yellow" }, slug)), /* @__PURE__ */ React.createElement(Text, null, "owner: ", /* @__PURE__ */ React.createElement(Text, { color: "yellow" }, props.ownerships[ownerIdx] ? `${props.ownerships[ownerIdx].login} (${props.ownerships[ownerIdx].type})` : "<no ownership>"), " (\u2191/\u2193 to change)"))), /* @__PURE__ */ React.createElement(Box, { marginTop: 1, flexDirection: "column" }, /* @__PURE__ */ React.createElement(Text, { color: zone === "link" ? "cyan" : "gray" }, zone === "link" ? "\u25B8 " : "  ", "Link existing (", props.repos.length, ")"), zone === "link" && props.repos.length > 0 && /* @__PURE__ */ React.createElement(Box, { marginLeft: 2, flexDirection: "column" }, props.repos.map((r, i) => /* @__PURE__ */ React.createElement(Text, { key: r.id, color: i === repoIdx ? "yellow" : void 0 }, i === repoIdx ? "\u25B8 " : "  ", r.owner_login, "/", r.slug)))), /* @__PURE__ */ React.createElement(Box, { marginTop: 1 }, /* @__PURE__ */ React.createElement(Text, { dimColor: true }, "Tab: switch zone \xB7 \u2191/\u2193: navigate \xB7 Enter: confirm \xB7 Esc: cancel")));
+  const ownerOptions = props.ownerships.map((o) => ({
+    label: `${o.login} (${o.type})`,
+    value: o.id
+  }));
+  const repoOptions = props.repos.map((r) => ({
+    label: `${r.owner_login}/${r.slug}`,
+    value: r.id
+  }));
+  return /* @__PURE__ */ React.createElement(Box, { flexDirection: "column", paddingX: 1 }, /* @__PURE__ */ React.createElement(Text, { bold: true }, "Balise \u2014 link or create a repo"), /* @__PURE__ */ React.createElement(Box, { marginTop: 1, flexDirection: "column" }, /* @__PURE__ */ React.createElement(Text, { color: field === "slug" ? "cyan" : "gray" }, field === "slug" ? "\u25B8 " : "  ", "New repo slug"), /* @__PURE__ */ React.createElement(Box, { marginLeft: 2 }, /* @__PURE__ */ React.createElement(
+    TextInput,
+    {
+      defaultValue: slug,
+      placeholder: "repo-slug",
+      isDisabled: field !== "slug",
+      onChange: (v) => setSlug(normalizeSlug(v))
+    }
+  ))), /* @__PURE__ */ React.createElement(Box, { marginTop: 1, flexDirection: "column" }, /* @__PURE__ */ React.createElement(Text, { color: field === "owner" ? "cyan" : "gray" }, field === "owner" ? "\u25B8 " : "  ", "Owner"), /* @__PURE__ */ React.createElement(Box, { marginLeft: 2 }, field === "owner" ? /* @__PURE__ */ React.createElement(
+    Select,
+    {
+      options: ownerOptions,
+      defaultValue: ownerId,
+      onChange: setOwnerId
+    }
+  ) : /* @__PURE__ */ React.createElement(Text, { dimColor: true }, ownerOptions.find((o) => o.value === ownerId)?.label ?? "\u2014"))), props.repos.length > 0 && /* @__PURE__ */ React.createElement(Box, { marginTop: 1, flexDirection: "column" }, /* @__PURE__ */ React.createElement(Text, { color: field === "link" ? "cyan" : "gray" }, field === "link" ? "\u25B8 " : "  ", "Link existing (", props.repos.length, ")"), /* @__PURE__ */ React.createElement(Box, { marginLeft: 2 }, field === "link" ? /* @__PURE__ */ React.createElement(
+    Select,
+    {
+      options: repoOptions,
+      defaultValue: repoId,
+      onChange: setRepoId
+    }
+  ) : /* @__PURE__ */ React.createElement(Text, { dimColor: true }, "tab to browse"))), /* @__PURE__ */ React.createElement(Box, { marginTop: 1 }, /* @__PURE__ */ React.createElement(Text, { dimColor: true }, "Tab: next field \xB7 \u2191/\u2193: navigate \xB7 Enter: confirm \xB7 Esc: cancel")));
 }
 
 // src/commands/init.ts
@@ -1045,13 +1094,55 @@ async function runInit(opts) {
 }
 
 // src/commands/sync.ts
+import readline from "readline/promises";
 import React4 from "react";
 import { render as render2 } from "ink";
 
+// src/logger.ts
+import { promises as fs3 } from "fs";
+import path4 from "path";
+import os2 from "os";
+var APP_DIR2 = ".balise";
+var FILENAME2 = "balise.log";
+function logPath() {
+  const override = process.env.BALISE_LOG_FILE;
+  if (override && override.length > 0) return override;
+  return path4.join(os2.homedir(), APP_DIR2, FILENAME2);
+}
+function formatError(err) {
+  if (err instanceof Error) {
+    const stack = err.stack ?? `${err.name}: ${err.message}`;
+    const extras = [];
+    const cause = err.cause;
+    if (cause) extras.push(`  caused by: ${formatError(cause)}`);
+    return extras.length ? `${stack}
+${extras.join("\n")}` : stack;
+  }
+  if (typeof err === "string") return err;
+  try {
+    return JSON.stringify(err);
+  } catch {
+    return String(err);
+  }
+}
+async function logError(context, err) {
+  try {
+    const p = logPath();
+    await fs3.mkdir(path4.dirname(p), { recursive: true, mode: 448 });
+    const ts = (/* @__PURE__ */ new Date()).toISOString();
+    const line = `[${ts}] ERROR ${context}
+${formatError(err)}
+
+`;
+    await fs3.appendFile(p, line, { mode: 384 });
+  } catch {
+  }
+}
+
 // src/ui/SyncProgress.tsx
 import React3, { useEffect, useState as useState2 } from "react";
 import { Box as Box2, Text as Text2, useApp as useApp2 } from "ink";
-import Spinner from "ink-spinner";
+import { Spinner } from "@inkjs/ui";
 var QUEUED_MESSAGES = [
   "Waiting for an agent willing to accept the job\u2026",
   "Your request is in line. An agent will be assigned once one stops pretending to be busy.",
@@ -1169,7 +1260,7 @@ function SyncProgress(props) {
     return /* @__PURE__ */ React3.createElement(Text2, { color: "red" }, "\u2717 Failed");
   }
   if (!status) {
-    return /* @__PURE__ */ React3.createElement(Box2, null, /* @__PURE__ */ React3.createElement(Text2, { color: "cyan" }, /* @__PURE__ */ React3.createElement(Spinner, { type: "dots" })), /* @__PURE__ */ React3.createElement(Text2, null, " Getting things ready\u2026"));
+    return /* @__PURE__ */ React3.createElement(Spinner, { label: "Getting things ready\u2026" });
   }
   if (status.status === "done") {
     return /* @__PURE__ */ React3.createElement(Text2, { color: "green" }, "\u2713 Done");
@@ -1179,21 +1270,71 @@ function SyncProgress(props) {
   }
   const message = status.status === "queued" ? QUEUED_MESSAGES[queuedIdx] : RUNNING_MESSAGES[runningIdx];
   const { files_processed, files_total, nodes_pushed } = status.progress;
-  const hasCounters = status.status === "running" && (files_total > 0 || nodes_pushed > 0);
-  return /* @__PURE__ */ React3.createElement(Box2, { flexDirection: "column" }, /* @__PURE__ */ React3.createElement(Box2, null, /* @__PURE__ */ React3.createElement(Text2, { color: "cyan" }, /* @__PURE__ */ React3.createElement(Spinner, { type: "dots" })), /* @__PURE__ */ React3.createElement(Text2, null, " ", message)), hasCounters ? /* @__PURE__ */ React3.createElement(Text2, { dimColor: true }, "  ", files_processed, "/", files_total, " files \xB7 ", nodes_pushed, " concepts") : null);
+  const isRunning = status.status === "running";
+  const showFiles = isRunning && files_total > 0;
+  const showNodes = isRunning && nodes_pushed > 0;
+  return /* @__PURE__ */ React3.createElement(Box2, { flexDirection: "column" }, /* @__PURE__ */ React3.createElement(Spinner, { label: message }), showFiles || showNodes ? /* @__PURE__ */ React3.createElement(Text2, { dimColor: true }, "  ", showFiles ? `${files_processed}/${files_total} files` : null, showFiles && showNodes ? " \xB7 " : null, showNodes ? `${nodes_pushed} concepts` : null) : null);
 }
 
 // src/commands/sync.ts
+function buildSyncQuery(opts) {
+  const q = { commit_sha: opts.commitSha };
+  if (opts.branch) q.branch = opts.branch;
+  q.force = opts.force ? "true" : "false";
+  q.dry_run = opts.dryRun ? "true" : "false";
+  if (opts.base) q.base = opts.base;
+  return q;
+}
+var INIT_AUTOLAUNCH_MESSAGE = "Repo not initialized, launching balise init...";
+function drainStdinBuffer(stdin) {
+  if (stdin !== process.stdin) return;
+  const s = stdin;
+  if (typeof s.read !== "function") return;
+  while (s.read() !== null) {
+  }
+}
+async function confirmRetryWithForce(opts) {
+  const stderr = opts.stderr ?? process.stderr;
+  const synced = opts.body.synced_at ?? "unknown time";
+  stderr.write(
+    `commit already synced at tag ${opts.body.tag} (synced at ${synced}), re-run ?
+`
+  );
+  if (opts.autoConfirm) {
+    return false;
+  }
+  const input = opts.stdin ?? process.stdin;
+  drainStdinBuffer(input);
+  const rl = readline.createInterface({
+    input,
+    output: opts.stdout ?? process.stdout
+  });
+  let answer;
+  try {
+    answer = (await rl.question("re-run ? (y/N) ")).trim();
+  } finally {
+    rl.close();
+  }
+  return /^y(es)?$/i.test(answer);
+}
+function formatDryRunSummary(body) {
+  const fromDiff = body.would_be_cold_start ? "cold-start (no prior tag)" : `from-commit=${body.from_commit ?? "?"}` + (body.from_commit_distance !== null ? ` distance=${body.from_commit_distance}` : "");
+  return `Sync would use: base=${body.base_dolt_ref} (${body.base_kind}) / ${fromDiff}`;
+}
 async function runSync(opts) {
   try {
     await runSyncInner(opts);
   } catch (err) {
+    await logError("sync", err);
     if (err instanceof ApiUnreachableError) {
       process.stderr.write(
         "Cannot reach the Balise service. Please try again in a moment.\n"
       );
     } else {
-      process.stderr.write("Something went wrong. Please try again.\n");
+      process.stderr.write(
+        `Something went wrong. Please try again. (details: ${logPath()})
+`
+      );
     }
     process.exit(1);
   }
@@ -1222,7 +1363,8 @@ async function runSyncInner(opts) {
   }
   let cfg = await readConfig(cwd);
   if (!cfg) {
-    process.stderr.write("No .balise/config \u2014 running `balise init` first.\n");
+    process.stderr.write(`${INIT_AUTOLAUNCH_MESSAGE}
+`);
     await runInit({ ...opts, cwd });
     cfg = await readConfig(cwd);
     if (!cfg) {
@@ -1243,32 +1385,52 @@ async function runSyncInner(opts) {
     `Packing ${cfg.repo.owner_login}/${cfg.repo.slug} at HEAD\u2026
 `
   );
-  const { stream, commitSha, branch } = await gitBundle({ cwd });
-  let accepted;
+  const submit = async (force) => {
+    const { stream, commitSha, branch } = await gitBundle({ cwd });
+    const query = buildSyncQuery({
+      commitSha,
+      branch,
+      force,
+      base: opts.base,
+      dryRun: opts.dryRun ?? false
+    });
+    return uploadOnce(client, cfg.repo.owner_login, cfg.repo.slug, stream, query);
+  };
+  let outcome;
   try {
-    accepted = await client.uploadBundle(
-      `/v1/repos/${cfg.repo.owner_login}/${cfg.repo.slug}/sync`,
-      {
-        bundleStream: stream,
-        query: { commit_sha: commitSha, branch }
-      }
-    );
+    outcome = await submit(opts.force ?? false);
   } catch (err) {
-    if (err instanceof NotAuthenticatedError) {
-      process.stderr.write("Not logged in \u2014 run `balise login`.\n");
+    handleUploadError(err);
+    process.exit(1);
+  }
+  if (outcome.kind === "conflict") {
+    const proceedForce = await confirmRetryWithForce({
+      body: outcome.body,
+      autoConfirm: opts.autoConfirm ?? false
+    });
+    if (!proceedForce) {
       process.exit(1);
     }
-    if (err instanceof ApiUnreachableError) {
-      process.stderr.write(
-        "Cannot reach the Balise service. Please try again in a moment.\n"
-      );
+    try {
+      outcome = await submit(true);
+    } catch (err) {
+      handleUploadError(err);
       process.exit(1);
     }
-    process.stderr.write(
-      "Something went wrong while uploading. Please try again.\n"
-    );
+  }
+  if (outcome.kind === "invalid_base") {
+    process.stderr.write(`invalid base ref: ${opts.base}
+`);
+    process.exit(1);
+  }
+  if (outcome.kind === "dry_run") {
+    process.stdout.write(formatDryRunSummary(outcome.body) + "\n");
+    process.exit(0);
+  }
+  if (outcome.kind !== "accepted") {
     process.exit(1);
   }
+  const accepted = outcome.body;
   const result = await new Promise((resolve) => {
     const app = render2(
       React4.createElement(SyncProgress, {
@@ -1283,25 +1445,83 @@ async function runSyncInner(opts) {
   });
   process.exit(result ? 0 : 1);
 }
+async function uploadOnce(client, owner, slug, stream, query) {
+  const raw = await client.uploadBundleRaw(
+    `/v1/repos/${owner}/${slug}/sync`,
+    {
+      bundleStream: stream,
+      query
+    }
+  );
+  if (raw.status === 202) {
+    return { kind: "accepted", body: JSON.parse(raw.text) };
+  }
+  if (raw.status === 200) {
+    return { kind: "dry_run", body: JSON.parse(raw.text) };
+  }
+  if (raw.status === 409) {
+    const parsed = JSON.parse(raw.text);
+    const body = "detail" in parsed && parsed.detail ? parsed.detail : parsed;
+    return { kind: "conflict", body };
+  }
+  if (raw.status === 422) {
+    let detail;
+    try {
+      const parsed = JSON.parse(raw.text);
+      if (typeof parsed.detail === "string") detail = parsed.detail;
+    } catch {
+    }
+    if (detail === "invalid_base_ref") return { kind: "invalid_base" };
+    throw new ApiError(raw.status, raw.text);
+  }
+  throw new ApiError(raw.status, raw.text);
+}
+function handleUploadError(err) {
+  if (err instanceof NotAuthenticatedError) {
+    process.stderr.write("Not logged in \u2014 run `balise login`.\n");
+    return;
+  }
+  if (err instanceof ApiUnreachableError) {
+    process.stderr.write(
+      "Cannot reach the Balise service. Please try again in a moment.\n"
+    );
+    return;
+  }
+  process.stderr.write(
+    "Something went wrong while uploading. Please try again.\n"
+  );
+}
 
 // src/index.ts
+async function withLog(name, fn) {
+  try {
+    await fn();
+  } catch (err) {
+    await logError(name, err);
+    process.stderr.write(
+      `Something went wrong (${name}). Details: ${logPath()}
+`
+    );
+    process.exit(1);
+  }
+}
 var SUPABASE_URL = process.env.BALISE_SUPABASE_URL ?? "https://api.balise.dev";
 var loginCmd = defineCommand({
   meta: { name: "login", description: "Authenticate via OAuth (PKCE loopback)." },
   async run() {
-    await runLogin({ supabaseUrl: SUPABASE_URL });
+    await withLog("login", () => runLogin({ supabaseUrl: SUPABASE_URL }));
   }
 });
 var logoutCmd = defineCommand({
   meta: { name: "logout", description: "Clear stored credentials." },
   async run() {
-    await runLogout();
+    await withLog("logout", () => runLogout());
   }
 });
 var whoamiCmd = defineCommand({
   meta: { name: "whoami", description: "Show current authenticated user." },
   async run() {
-    await runWhoami({ supabaseUrl: SUPABASE_URL });
+    await withLog("whoami", () => runWhoami({ supabaseUrl: SUPABASE_URL }));
   }
 });
 var initCmd = defineCommand({
@@ -1310,7 +1530,7 @@ var initCmd = defineCommand({
     description: "Link or create a Balise repo and write .balise/config."
   },
   async run() {
-    await runInit({ supabaseUrl: SUPABASE_URL });
+    await withLog("init", () => runInit({ supabaseUrl: SUPABASE_URL }));
   }
 });
 var syncCmd = defineCommand({
@@ -1318,8 +1538,36 @@ var syncCmd = defineCommand({
     name: "sync",
     description: "Tarball current repo \u2192 upload \u2192 poll extraction progress."
   },
-  async run() {
-    await runSync({ supabaseUrl: SUPABASE_URL });
+  args: {
+    yes: {
+      type: "boolean",
+      alias: "y",
+      description: "Skip sync confirmations (warning prompt + future 409 retry).",
+      default: false
+    },
+    force: {
+      type: "boolean",
+      description: "Bypass idempotency 409 + resume-reuse: re-tag from scratch and re-resolve base.",
+      default: false
+    },
+    base: {
+      type: "string",
+      description: "Explicit base balise ref (branch/tag/commit) to start from. Validated server-side."
+    },
+    "dry-run": {
+      type: "boolean",
+      description: "Preview the resolution without uploading the bundle or enqueuing the worker.",
+      default: false
+    }
+  },
+  async run({ args }) {
+    await runSync({
+      supabaseUrl: SUPABASE_URL,
+      autoConfirm: Boolean(args.yes),
+      force: Boolean(args.force),
+      base: typeof args.base === "string" && args.base.length > 0 ? args.base : void 0,
+      dryRun: Boolean(args["dry-run"])
+    });
   }
 });
 var main = defineCommand({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@balise.dev/cli",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Balise CLI — push codebase to Balise backend for spec extraction.",
   "type": "module",
   "bin": {
@@ -22,11 +22,10 @@
     "node": ">=20"
   },
   "dependencies": {
+    "@inkjs/ui": "^2.0.0",
     "citty": "^0.2.2",
     "ini": "^5.0.0",
     "ink": "^5.0.1",
-    "ink-progress-bar": "^3.0.0",
-    "ink-spinner": "^5.0.0",
     "open": "^10.1.0",
     "react": "^18.3.1",
     "tar": "^7.4.3",