@use-aistack/cli 0.10.2 → 0.12.0

package/README.md

@@ -20,17 +20,19 @@ npx @use-aistack/cli sync
 
 On an unlinked machine, `sync` starts the login flow inline - your browser opens to approve the machine, then the sync continues. One command is the whole onboarding.
 
+After a manual sync, the CLI offers auto-sync with three choices: Enable, Maybe later, and Never ask again. Maybe later asks again after your next manual sync. Existing declines from older CLI versions are treated as Maybe later.
+
 ### `npx @use-aistack/cli sync --auto on` / `off`
 
-Optional: keep your stack fresh without manual syncs. `on` asks your stack for the permission, then writes a `SessionStart` hook into the harnesses you actually use - `~/.claude/settings.json` for Claude Code, `~/.codex/hooks.json` for Codex. The hook runs a silent sync at most once per day when a session starts. `off` removes the hooks and takes the permission back.
+Optional: keep your stack fresh without manual syncs. `on` asks your stack for the permission, then writes a `SessionStart` hook into the harnesses you actually use - `~/.claude/settings.json` for Claude Code, `~/.codex/hooks.json` for Codex. The hook runs a silent sync at most once every 6 hours when a session starts. `off` removes the hooks and takes the permission back.
 
 ```sh
-npx @use-aistack/cli sync --auto on            # enable, default every 24h
+npx @use-aistack/cli sync --auto on            # enable, default every 6h
 npx @use-aistack/cli sync --auto on --every 12 # custom frequency in hours
 npx @use-aistack/cli sync --auto off           # revoke
 ```
 
-**Your stack owns the permission, not this machine.** The silent run asks aistack.to before it publishes anything, so the switch on your stack page is a complete revoke: it stops every machine, even one whose hooks are still installed. It works the other way too - turn the switch on, run one `sync`, and that machine installs its own triggers. A harness you adopt months later gets its trigger the same way.
+**Your stack owns the permission, not this machine.** The silent run asks aistack.to before it publishes anything, so the switch above the first section on your stack page is a complete revoke: it stops every machine, even one whose hooks are still installed. The switch defaults to every 6 hours. Run the enable command shown beside it on each machine that should install triggers. A harness you adopt months later gets its trigger the same way.
 
 The silent run (`sync --auto`) never prompts and never installs a hook. Each run appends one line to `~/.config/aistack/sync.log` (capped at 200 lines). The next interactive `sync` reports the last result. After 3 failures in a row, one visible message appears in Claude Code and names the fix. No email, no dialogs.
 

package/dist/index.js

@@ -348,7 +348,7 @@ function apiEquivalentCost(modelKey, t, atMs) {
 }
 
 // src/version.ts
-var CLI_VERSION = true ? "0.10.2" : "0.0.0-dev";
+var CLI_VERSION = true ? "0.12.0" : "0.0.0-dev";
 
 // src/api.ts
 var BASE_URL = process.env.AISTACK_URL || "https://aistack.to";
@@ -6202,7 +6202,7 @@ ${e instanceof Error ? e.message : String(e)}`
   }
   return {
     ok: true,
-    message: `Installed. Say ${limeBold('"sync my stack"')} in any Claude Code session.`
+    message: `Installed the user-scoped aistack MCP server and Skill. Say ${limeBold('"sync my stack"')} in any Claude Code session. Every send still requires your confirmation. Remove it with: claude mcp remove --scope user aistack`
   };
 }
 async function connectCommand(harness) {
@@ -6238,17 +6238,17 @@ async function offerConnectUpsell(deps = {}) {
   if (!await (deps.claudeActiveImpl ?? claudeRecentlyActive)()) return;
   if (!(deps.claudeOnPathImpl ?? claudeOnPath)()) return;
   const answer = await p3.select({
-    message: "Sync from inside Claude Code too?",
+    message: "Add AI Stack commands to Claude Code? Every send still asks first.",
     options: [
       {
         value: "later",
-        label: "Not now",
-        hint: "this question will not come back"
+        label: "No, don't ask again",
+        hint: "you can install later with aistack connect claude"
       },
       {
         value: "install",
-        label: "Install",
-        hint: "adds the aistack MCP server + Skill to Claude Code"
+        label: "Install MCP + Skill",
+        hint: "user scope; enables preview and confirmed send commands"
       }
     ],
     initialValue: "later"
@@ -6781,7 +6781,8 @@ async function settleAutoSync(permission, deps = {}) {
   return offerAutoSyncOptIn(deps);
 }
 async function offerAutoSyncOptIn(deps = {}) {
-  if (getSettings(deps.settingsFile).autoSyncAnswered === true) return false;
+  if (getSettings(deps.settingsFile).autoSyncNeverAskAgain === true)
+    return false;
   const detected = await (deps.detectedImpl ?? detectedAdapters)();
   if (detected.length === 0) return false;
   const answer = await p6.select({
@@ -6794,8 +6795,13 @@ async function offerAutoSyncOptIn(deps = {}) {
       },
       {
         value: "later",
-        label: "No thanks",
-        hint: "you can enable it later"
+        label: "Maybe later",
+        hint: "ask again after your next manual sync"
+      },
+      {
+        value: "never",
+        label: "Never ask again",
+        hint: "you can still enable it with sync --auto on"
       }
     ],
     initialValue: "enable"
@@ -6813,7 +6819,9 @@ async function offerAutoSyncOptIn(deps = {}) {
     }
     return true;
   }
-  saveSettings({ autoSyncAnswered: true }, deps.settingsFile);
+  if (answer === "never") {
+    saveSettings({ autoSyncNeverAskAgain: true }, deps.settingsFile);
+  }
   p6.log.message(
     `If you change your mind: ${limeBold("npx @use-aistack/cli sync --auto on")} ${dim(
       "(and --auto off to revoke)"
@@ -6982,7 +6990,7 @@ function selectDaysToPublish(input) {
 }
 
 // src/workflow/git.ts
-import { execFileSync as execFileSync2 } from "child_process";
+import { execFile, execFileSync as execFileSync2 } from "child_process";
 import path6 from "path";
 var TEST_FILE_RULE_VERSION = "test-files/v2";
 var FILE_TYPE_RULE_VERSION = "file-types/v2";
@@ -6999,6 +7007,18 @@ var defaultRunner = (cwd, args) => {
     return null;
   }
 };
+var defaultAsyncRunner = (cwd, args) => new Promise((resolve) => {
+  execFile(
+    "git",
+    [...args],
+    {
+      cwd,
+      encoding: "utf8",
+      maxBuffer: 64 * 1024 * 1024
+    },
+    (error, stdout) => resolve(error ? null : stdout)
+  );
+});
 var emptyGitDay = () => ({
   testFileRuleVersion: TEST_FILE_RULE_VERSION,
   fileTypeRuleVersion: FILE_TYPE_RULE_VERSION,
@@ -7153,6 +7173,39 @@ function extractGitWorkflow(options) {
     const root = run(directory, ["rev-parse", "--show-toplevel"])?.trim();
     if (root) roots.add(root);
   }
+  const histories = [];
+  for (const root of roots) {
+    const history = run(root, gitLogArgs());
+    if (history) histories.push(history);
+  }
+  return reduceGitHistories(histories, options);
+}
+async function extractGitWorkflowAsync(options) {
+  const run = options.run ?? defaultAsyncRunner;
+  const roots = /* @__PURE__ */ new Set();
+  for (const directory of options.workingDirectories) {
+    const root = (await run(directory, ["rev-parse", "--show-toplevel"]))?.trim();
+    if (root) roots.add(root);
+  }
+  const histories = await Promise.all(
+    [...roots].map((root) => run(root, gitLogArgs()))
+  );
+  return reduceGitHistories(
+    histories.filter((history) => history !== null),
+    options
+  );
+}
+function gitLogArgs() {
+  return [
+    "log",
+    "--all",
+    "--no-merges",
+    `--format=%x00${COMMIT_MARKER}%x00%H%x00%aI%x00`,
+    "--numstat",
+    "-z"
+  ];
+}
+function reduceGitHistories(histories, options) {
   const days = /* @__PURE__ */ new Map();
   const dayOf = (date) => {
     let day = days.get(date);
@@ -7173,16 +7226,7 @@ function extractGitWorkflow(options) {
     return day;
   };
   const seenCommits = /* @__PURE__ */ new Set();
-  for (const root of roots) {
-    const history = run(root, [
-      "log",
-      "--all",
-      "--no-merges",
-      `--format=%x00${COMMIT_MARKER}%x00%H%x00%aI%x00`,
-      "--numstat",
-      "-z"
-    ]);
-    if (!history) continue;
+  for (const history of histories) {
     let current;
     const finishCommit = () => {
       if (!current?.included || !current.authored) return;
@@ -7292,6 +7336,18 @@ function extractLocalWorkflow(options) {
   });
   return buildWorkflowExtraction(options.harnesses, git, utcOffsetMinutes);
 }
+async function extractLocalWorkflowAsync(options) {
+  const utcOffsetMinutes = options.utcOffsetMinutes ?? machineUtcOffsetMinutes();
+  const git = await extractGitWorkflowAsync({
+    workingDirectories: options.harnesses.flatMap(({ local }) => [
+      ...local.projectWorkspaces
+    ]),
+    fromMs: options.fromMs,
+    toMs: options.toMs,
+    utcOffsetMinutes
+  });
+  return buildWorkflowExtraction(options.harnesses, git, utcOffsetMinutes);
+}
 function machineUtcOffsetMinutes(now = /* @__PURE__ */ new Date()) {
   return -now.getTimezoneOffset();
 }
@@ -7378,20 +7434,21 @@ function buildGateDialog(ctx) {
   const days = payloads[0]?.window.days ?? 0;
   const facts = [
     `${fmtTokens(tokens)} tokens`,
-    `${days} days`,
+    `${days}-day profile`,
+    ...ctx.body.measuredDays && ctx.body.measuredDays.days.length !== days ? [`${ctx.body.measuredDays.days.length} historical days`] : [],
     ...usd === null ? [] : [fmtUSD(usd)]
   ].join(" \xB7 ");
   const n = payloads.reduce((a, p8) => a + withheldCount(p8), 0);
   const lines2 = [`Publish to aistack? ${facts}`];
   if (n > 0) {
     lines2.push(
-      keptPrivate === void 0 ? `${n} name${n === 1 ? "" : "s"} stay${n === 1 ? "s" : ""} on this machine` : `${n} name${n === 1 ? "" : "s"} go${n === 1 ? "es" : ""} up for you to review`
+      keptPrivate === void 0 ? `${n} name${n === 1 ? "" : "s"} stay${n === 1 ? "s" : ""} on this machine` : `${n} private review name${n === 1 ? "" : "s"} will be stored`
     );
   }
   return lines2.join("\n");
 }
 var CATEGORY_LABEL = {
-  builtinTools: "tools",
+  builtinTools: "actions",
   mcpServers: "mcp",
   skills: "skills",
   subagents: "agents",
@@ -7421,6 +7478,24 @@ function wrapRow(head, continuation, text, width) {
   if (line !== "") lines2.push(line);
   return lines2.map((l, i) => (i === 0 ? head : continuation) + l);
 }
+function wrapEntries(head, continuation, entries, width) {
+  const limit = Math.max(24, width - continuation.length);
+  const lines2 = [];
+  let line = "";
+  for (const entry of entries) {
+    const next = line ? `${line} \xB7 ${entry}` : entry;
+    if (line && next.length > limit) {
+      lines2.push(line);
+      line = entry;
+    } else {
+      line = next;
+    }
+  }
+  if (line) lines2.push(line);
+  return lines2.map(
+    (line2, index) => `${index === 0 ? head : continuation}${line2}`
+  );
+}
 function keptPrivateRows(keptPrivate) {
   const groups = /* @__PURE__ */ new Map();
   const singles = [];
@@ -7516,23 +7591,20 @@ function payloadBlock(payload, width, ownWindow, stats) {
   }
   if (entries.length > 0) {
     out.push(
-      ...wrapRow(
-        "models    ",
-        " ".repeat(LABEL_WIDTH),
-        entries.join(" \xB7 "),
-        width
-      )
+      ...wrapEntries("models    ", " ".repeat(LABEL_WIDTH), entries, width)
     );
   }
   const filled = NAME_CATEGORIES.filter(
     (category) => payload.inventory[category].length > 0
   );
   if (filled.length === 0) {
-    out.push(`${"publishes".padEnd(LABEL_WIDTH)}no names from this harness`);
+    out.push(
+      `${"sends".padEnd(LABEL_WIDTH)}no inventory names from this harness`
+    );
     return out;
   }
   out.push(
-    `${"publishes".padEnd(LABEL_WIDTH)}${filled.map(
+    `${"sends".padEnd(LABEL_WIDTH)}${filled.map(
       (category) => `${payload.inventory[category].length} ${CATEGORY_LABEL[category]}`
     ).join(" \xB7 ")}`
   );
@@ -7648,6 +7720,14 @@ function buildGateSummary(ctx) {
     out.push(`prices    ${origin} \xB7 cites ${cited.join(", ")}`);
   }
   const width = wrapWidth(ctx.width);
+  out.push(
+    ...wrapRow(
+      "privacy   ",
+      " ".repeat(LABEL_WIDTH),
+      "raw conversation text, paths, repo names, and command arguments stay local",
+      width
+    )
+  );
   for (const payload of payloads) {
     const stats = ctx.scanStats?.[payload.harness.name];
     out.push("", DIVIDER, "");
@@ -7675,10 +7755,12 @@ function buildGateSummary(ctx) {
     const shown = rows.slice(0, KEPT_PRIVATE_ROWS_SHOWN);
     const examples = shown.map((r) => r.names > 1 ? `${r.label} \xD7${r.names}` : r.label).join(", ");
     const more = rows.length > shown.length ? `, ...${rows.length - shown.length} more` : "";
-    out.push(`private   ${n} name${n === 1 ? "" : "s"} \xB7 ${examples}${more}`);
+    out.push(
+      `private   ${n} review name${n === 1 ? "" : "s"} \xB7 ${examples}${more}`
+    );
     if (body.keptPrivate !== void 0 && config.stack !== null) {
       out.push(
-        `          they go up for you to review at ${host}/stacks/${config.stack.slug}/changes`
+        `          stored privately for your review at ${host}/stacks/${config.stack.slug}/changes`
       );
       out.push(
         "          (turn off: Review kept-private names, on your stack)"
@@ -7718,10 +7800,13 @@ async function stageSync(deps) {
   const projectWorkspaceId = deps.getProjectWorkspaceIdImpl ?? getProjectWorkspaceId;
   const fetchManifest = deps.fetchManifestImpl ?? fetchDayManifest;
   const fetchPrices = deps.fetchPricesImpl ?? fetchPriceTable;
+  const progress = deps.onProgress ?? (() => {
+  });
   let prices = {
     id: BUNDLED_PRICE_TABLE_ID,
     origin: "bundled"
   };
+  progress("Checking prices and stack settings");
   try {
     const table = await fetchPrices(deps.baseUrl);
     if (table) {
@@ -7757,7 +7842,11 @@ async function stageSync(deps) {
   const daysSinceMs = windowStartMs(now, retentionDays);
   const active2 = await adapters(sinceMs);
   for (const adapter of active2) {
-    const { aggregate, stats } = await adapter.scan({ sinceMs });
+    progress(`Scanning recent ${adapter.name} usage`);
+    const { aggregate, stats } = await adapter.scan({
+      sinceMs,
+      onProgress: (files) => progress(`Scanning recent ${adapter.name} usage \xB7 ${files} files`)
+    });
     scanStats[adapter.name] = stats;
     built.push(
       buildPayload({
@@ -7773,8 +7862,10 @@ async function stageSync(deps) {
     );
   }
   for (const adapter of active2) {
+    progress(`Reading historical ${adapter.name} days`);
     const { aggregate, workflow: workflow2, workflowLocal } = await adapter.scan({
-      sinceMs: daysSinceMs
+      sinceMs: daysSinceMs,
+      onProgress: (files) => progress(`Reading historical ${adapter.name} days \xB7 ${files} files`)
     });
     workflowScans.push({ aggregate: workflow2, local: workflowLocal });
     usageScans.push(
@@ -7787,12 +7878,20 @@ async function stageSync(deps) {
     );
   }
   const settings = (deps.getSettingsImpl ?? getSettings)();
-  const workflow = workflowScans.length > 0 && config.publishWorkflow ? extractLocalWorkflow({
-    harnesses: workflowScans,
-    fromMs: daysSinceMs,
-    toMs: now,
-    ...deps.gitRunnerImpl ? { run: deps.gitRunnerImpl } : {}
-  }) : void 0;
+  let workflow;
+  if (workflowScans.length > 0 && config.publishWorkflow) {
+    progress("Reading Git history");
+    workflow = deps.gitRunnerImpl ? extractLocalWorkflow({
+      harnesses: workflowScans,
+      fromMs: daysSinceMs,
+      toMs: now,
+      run: deps.gitRunnerImpl
+    }) : await extractLocalWorkflowAsync({
+      harnesses: workflowScans,
+      fromMs: daysSinceMs,
+      toMs: now
+    });
+  }
   const localDays = applyDayConsent(
     buildMeasuredDays({
       usage: mergeUsageDays(usageScans),
@@ -7819,6 +7918,7 @@ async function stageSync(deps) {
     } : void 0,
     CLI_VERSION
   );
+  progress("Preparing review");
   const bodyJson = JSON.stringify(body);
   const keptPrivate = mergeKeptPrivate(built.map((b) => b.keptPrivate));
   const ctx = {
@@ -8090,7 +8190,8 @@ async function syncCommand(options = {}) {
     staged = await stageSync({
       baseUrl: BASE_URL,
       getTokenImpl: () => destinationToken,
-      loadConfigImpl: async () => destinationConfig
+      loadConfigImpl: async () => destinationConfig,
+      onProgress: (message) => s.message(message)
     });
   } catch (e) {
     s.stop("Scan failed");
@@ -8133,7 +8234,12 @@ async function syncCommand(options = {}) {
       );
     } else if (res.keptPrivate.stored > 0) {
       lines2.push(
-        `${res.keptPrivate.stored} kept-private names went up for your review at ${res.url}/changes`
+        `${res.keptPrivate.stored} private review name${res.keptPrivate.stored === 1 ? "" : "s"} stored at ${res.url}/changes`
+      );
+    }
+    if (res.keptPrivate.machineStored > 0) {
+      lines2.push(
+        "This machine's private label was stored for the same review."
       );
     }
     p7.log.message(lines2.join("\n"));
@@ -8162,6 +8268,26 @@ function styleSummaryLine(line) {
   return line;
 }
 
+// src/node-version.ts
+var MINIMUM_NODE_VERSION = "22.5.0";
+function versionParts(version) {
+  const match = /^(?:v)?(\d+)\.(\d+)\.(\d+)/.exec(version);
+  if (!match) return null;
+  return [Number(match[1]), Number(match[2]), Number(match[3])];
+}
+function supportsNodeVersion(version) {
+  const actual = versionParts(version);
+  const minimum = versionParts(MINIMUM_NODE_VERSION);
+  if (!actual || !minimum) return false;
+  for (let i = 0; i < actual.length; i++) {
+    if (actual[i] !== minimum[i]) return actual[i] > minimum[i];
+  }
+  return true;
+}
+function unsupportedNodeMessage(version) {
+  return `aistack requires Node.js ${MINIMUM_NODE_VERSION} or newer. You are running ${version}. Upgrade Node.js so sync can read OpenCode's SQLite usage database.`;
+}
+
 // src/sync/server.ts
 var SERVER_NAME = "aistack";
 var SERVER_VERSION = "0.3.0";
@@ -8332,7 +8458,12 @@ function createSyncServer(deps, send) {
               );
             } else if (res.keptPrivate.stored > 0) {
               lines2.push(
-                `${res.keptPrivate.stored} kept-private names went up for your review at ${res.url}/changes`
+                `${res.keptPrivate.stored} private review name${res.keptPrivate.stored === 1 ? "" : "s"} stored at ${res.url}/changes`
+              );
+            }
+            if (res.keptPrivate.machineStored > 0) {
+              lines2.push(
+                "This machine's private label was stored for the same review."
               );
             }
             ok(id, textResult(lines2.join("\n")));
@@ -8436,5 +8567,11 @@ program.command("sync").description("Scan, preview, and publish measured usage (
   "with --auto on: hours between auto-syncs (default 6)"
 ).action((options) => syncCommand(options));
 program.command("connect").description("Install the in-session sync surface (MCP server + Skill)").argument("<harness>", 'the harness to connect ("claude")').action(connectCommand);
-program.parse();
+if (!supportsNodeVersion(process.versions.node)) {
+  process.stderr.write(`${unsupportedNodeMessage(process.versions.node)}
+`);
+  process.exitCode = 1;
+} else {
+  program.parse();
+}
 //# sourceMappingURL=index.js.map