mason-context 0.17.1 → 0.17.2

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## 0.17.2 — 2026-09-15
+
+- Show progress during standalone installation, upgrades, and project setup, with native download progress and elapsed-time spinners in interactive terminals. Keep redirected progress on stderr and JSON, MCP, and hook output unchanged.
+- Offer Codex and Claude Code setup instructions without assuming an assistant. Show the previous and installed version after an update and remind users to restart running assistants.
+
+Run `mason upgrade` for standalone installations, or `npm install -g mason-context@0.17.2` for npm installations, then restart running assistants. Existing project integrations do not need setup again for this release. The first upgrade from an older version still uses its bundled downloader; the new download display appears on subsequent upgrades and fresh installations.
+
 ## 0.17.1 — 2026-09-15
 
 - Keep MCP available in fresh clones, with actionable setup instructions and inactive automatic hooks until local setup. Preserve corrupt-setup diagnostics and checkout-specific activation.

package/dist/mason-auto.js

@@ -2996,7 +2996,7 @@ var init_evidence = __esm({
     init_storage();
     init_advisory_review();
     exec7 = promisify9(execFile9);
-    engineVersion = true ? "0.17.1" : "development";
+    engineVersion = true ? "0.17.2" : "development";
     hash = (value) => createHash3("sha256").update(JSON.stringify(value)).digest("hex");
     content = readAuditInput;
     cacheSchema = z8.object({ version: z8.literal(1), entries: z8.record(z8.object({ key: z8.string(), result: checkResultSchema })), digest: z8.string() });
@@ -3650,7 +3650,7 @@ var init_launcher = __esm({
     "use strict";
     init_evidence();
     init_model();
-    executingVersion = () => true ? "0.17.1" : "development";
+    executingVersion = () => true ? "0.17.2" : "development";
     mcpCommand = (host) => globalCommand(["--setup-host", host, "mcp"]);
     hookCommand = (host) => `mason --setup-host ${host} auto`;
   }
@@ -5491,6 +5491,7 @@ async function selectHost(root, explicit) {
   throw new Error("Choose the assistant for setup with --host codex or --host claude.");
 }
 async function setupProject(dir, options = {}) {
+  options.progress?.step("Checking project configuration");
   const ws = await workspace(dir);
   const host = await selectHost(ws.root, options.host);
   return withLock(ws.root, ".mason/reports/setup-lock", async () => {
@@ -5519,11 +5520,14 @@ async function setupProject(dir, options = {}) {
     const revision = !changed && previous ? previous.revision : randomUUID6();
     const setup = existing ?? { version: 2, hosts: {} };
     setup.hosts[host] = { configuredVersion: installed.version, revision, fingerprint, mcpFingerprint, instructions: instructions.map((e) => e.path) };
+    options.progress?.step("Auditing documentation and preserving original findings");
     const initial = await automate(ws.root, { event: "turn_start" });
+    options.progress?.step("Reviewing project context and committed changes");
     const findings = await inspectOnboarding(ws.root, options.base, options.evidence);
     const receiptPath = ws.directory + "/setup-" + host + ".json";
     const initialReportPath = previousReceipt?.initialReportPath ?? initial.report.reportPath;
     const initialBaselinePaths = previousReceipt?.initialBaselinePaths ?? initial.report.baselinePaths;
+    options.progress?.step(`Configuring ${host === "codex" ? "Codex" : "Claude Code"} integration`);
     await writeStoreJson(ws.root, receiptPath, {
       version: 1,
       host,
@@ -5538,6 +5542,7 @@ async function setupProject(dir, options = {}) {
     for (const edit of edits) if (await applyEdit(ws.root, edit)) changedFiles.push(edit.path);
     if (await applyEdit(ws.root, { path: SETUP_PATH, before: setupBefore, after: JSON.stringify(setup, null, 2) + "\n" })) changedFiles.push(SETUP_PATH);
     if (await applyEdit(ws.root, await completedHookOwnership(ws.root, hooks[0].path, configuredHook)) && !changedFiles.includes(ownership.path)) changedFiles.push(ownership.path);
+    options.progress?.step("Checking configuration and retained findings");
     const checked = await automate(ws.root, { event: "turn_start" });
     const configured = await inspectHostConfig(ws.root, host, void 0);
     await writeStoreJson(ws.root, receiptPath, {
@@ -5607,6 +5612,57 @@ init_adapters();
 init_install();
 init_store();
 import { parseArgs } from "util";
+
+// src/utils/progress.ts
+function createProgress(options = {}) {
+  const write = options.write ?? ((text2) => {
+    process.stderr.write(text2);
+  });
+  const interactive = options.interactive ?? (!!process.stderr.isTTY && process.env.TERM !== "dumb" && !process.env.CI);
+  const columns = options.columns ?? (() => process.stderr.columns || 80);
+  const frames = ["\u280B", "\u2819", "\u2839", "\u2838", "\u283C", "\u2834", "\u2826", "\u2827", "\u2807", "\u280F"];
+  let message2 = "", started = 0, frame = 0;
+  let timer;
+  const elapsed = () => {
+    const seconds = Math.floor((Date.now() - started) / 1e3);
+    return seconds ? ` (${seconds}s)` : "";
+  };
+  const render = (prefix) => {
+    const text2 = `${prefix} ${message2}${elapsed()}`;
+    const width = Math.max(1, columns() - 1);
+    write("\r\x1B[2K" + (text2.length > width ? text2.slice(0, width - 1) + "\u2026" : text2));
+  };
+  const stop = (success = true) => {
+    if (timer) clearInterval(timer);
+    timer = void 0;
+    if (message2 && interactive) {
+      render(success ? "\u2713" : "\u2717");
+      write("\n");
+    }
+    message2 = "";
+  };
+  return {
+    step(next) {
+      stop();
+      message2 = next.replace(/[\x00-\x1f\x7f-\x9f]/g, " ");
+      started = Date.now();
+      frame = 0;
+      if (!interactive) {
+        write(`Mason: ${message2}\u2026
+`);
+        return;
+      }
+      render(frames[frame]);
+      timer = setInterval(() => {
+        render(frames[++frame % frames.length]);
+      }, 100);
+      timer.unref();
+    },
+    stop
+  };
+}
+
+// src/automation/cli.ts
 var TEARDOWN_USAGE = `Usage: mason teardown [options]
 
 Disconnect Mason from this Git project. Defaults to all project hosts.
@@ -5655,11 +5711,13 @@ function isHookCommand(argv2) {
     return false;
   }
 }
-async function runAutomationCli(argv2, stdin = "", io = {
+var defaultIo = {
   out: (s) => process.stdout.write(s + "\n"),
   err: (s) => process.stderr.write(s + "\n")
-}, options = {}) {
+};
+async function runAutomationCli(argv2, stdin = "", io = defaultIo, options = {}) {
   let action = "";
+  let progress;
   try {
     const { values, positionals } = parseCli(argv2);
     if (values.help || !positionals.length) {
@@ -5687,7 +5745,13 @@ async function runAutomationCli(argv2, stdin = "", io = {
     if (action === "setup") {
       if (values.command) throw new Error("--command applies to install/config, not managed setup.");
       const { setupProject: setupProject2, summarizeSetup: summarizeSetup2 } = await Promise.resolve().then(() => (init_setup(), setup_exports));
-      const result = await setupProject2(dir, { host: values.host ? hostSchema.parse(values.host) : void 0 });
+      const host = values.host ? hostSchema.parse(values.host) : void 0;
+      if (!values.json) progress = createProgress(io === defaultIo ? {} : {
+        write: (text2) => io.err(text2.replace(/\n$/, "")),
+        interactive: false
+      });
+      const result = await setupProject2(dir, { host, progress });
+      progress?.stop();
       io.out(values.json ? JSON.stringify(result, null, 2) : summarizeSetup2(result));
       return 0;
     }
@@ -5709,6 +5773,7 @@ async function runAutomationCli(argv2, stdin = "", io = {
     io.out(values.json ? JSON.stringify(report, null, 2) : summarize(report));
     return report.status === "verified" ? 0 : report.status === "issues-remain" ? 1 : 2;
   } catch (error) {
+    progress?.stop(false);
     const message2 = action === "setup" ? "Mason setup incomplete: " + automationFailure(error).message + ". Rerun the same setup command to resume; retained audit evidence is preserved." : action === "teardown" ? "Mason teardown incomplete: " + automationFailure(error).message + ". Inspect the reported input, then rerun teardown; knowledge and repair evidence are retained." : failureMessage(error);
     if (action === "hook" || isHookCommand(argv2)) {
       io.out(JSON.stringify({ systemMessage: message2 }));