mason-context 0.17.0 → 0.17.2

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # 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.
+- Resolve hook setup and evidence from the host payload's checkout before using a launch/project fallback. Keep ambiguous roots and outside-repository events with multiple worktrees explicitly unverified.
+- Avoid aborting audits on references below regular files. Report `.git/` references as skipped metadata and share the same path observations with automation caches.
+- Ignore unexpected `.mason/` contents by default while allowing shared knowledge. Emit Claude's explicit stdio transport, recognize compatible older hook commands in status, and retain clone teardown support.
+- Exercise fresh-clone MCP, worktree setup, directory changes, original pre-edit evidence, and repeated setup in focused adoption regressions.
+
+Run `mason upgrade` for standalone installations, or `npm install -g mason-context@0.17.1` for npm installations, then restart running assistants. Existing PATH-based integrations receive the audit, MCP and hook fixes on their next launch. Rerun `mason setup --host codex` or `--host claude` to refresh the shared Git ignore rules and Claude's explicit stdio entry; review and commit those configuration changes. Fresh clones and linked worktrees still need their own local setup to activate automatic hooks. Decisions and retained repair evidence are preserved.
+
 ## 0.17.0 — 2026-09-11
 
 Mason can now retain an authorized advisory assessment through later sessions and commits, then reopen it when relevant evidence changes. Documentation audits cover nested instructions and README files with more precise reference and command scope.

package/dist/mason-audit.js

@@ -800,7 +800,7 @@ async function readAuditInput(root, file) {
     if (value === null) throw new Error(`Unreadable or oversized audit input: ${file}`);
     return value;
   } catch (error) {
-    if (error.code === "ENOENT") return null;
+    if (["ENOENT", "ENOTDIR"].includes(error.code ?? "")) return null;
     throw error;
   }
 }
@@ -1066,15 +1066,17 @@ function pathClaimScope(doc, claim) {
   };
 }
 async function pathExists(root, file) {
-  const absolute = await auditInputPath(root, file);
   try {
-    await fs6.access(absolute);
+    await fs6.access(await auditInputPath(root, file));
     return true;
   } catch (error) {
-    if (error.code === "ENOENT") return false;
+    if (["ENOENT", "ENOTDIR"].includes(error.code ?? "")) return false;
     throw error;
   }
 }
+function gitMetadataPath(file) {
+  return file.split("/").includes(".git");
+}
 function optionalMasonPath(file) {
   return file.split("/").includes(".mason");
 }
@@ -1104,6 +1106,14 @@ async function checkDeletedReferences(ctx) {
         continue;
       }
       if (scope.candidates.some(optionalMasonPath)) continue;
+      if (scope.candidates.some(gitMetadataPath)) {
+        result.skipped.push({
+          check: "deleted-reference",
+          doc: doc.path,
+          reason: `Reference ${claim.path} names Git metadata, whose layout varies between checkouts; it was not verified as a repository file.`
+        });
+        continue;
+      }
       if ((await Promise.all(scope.candidates.map((file) => pathExists(ctx.root, file)))).some(Boolean)) continue;
       const candidates = await Promise.all(scope.candidates.map(async (file) => ({
         file,