archctx 0.11.0 → 0.11.2

package/assets/catalog.yaml

@@ -1,7 +1,7 @@
 {
   "schemaVersion": "archcontext.practice-catalog-manifest/v1",
   "catalogVersion": "2026.06.0",
-  "productVersion": "0.11.0",
+  "productVersion": "0.11.2",
   "generatedAt": "1970-01-01T00:00:00.000Z",
   "entries": [
     {
@@ -389,5 +389,5 @@
     "structurizr.dsl",
     "twelve-factor"
   ],
-  "catalogDigest": "sha256:855b3458f393a75cbfd43190be8996ada23b3a96f803df5fe5ed88ad69ba3ef4"
+  "catalogDigest": "sha256:63bc69e4666afac5fb5a94ba71582acfa9af9a8bb9240b3ee327faf59435c4b7"
 }

package/bin/archctx.mjs

@@ -2707,6 +2707,10 @@ function localFactValue(rule, value) {
       return value;
     if (rule === "head" && /^[a-f0-9]{40}$/.test(value))
       return value;
+    if (rule === "repoPath" && isRepoRelativePosixPath(value))
+      return value;
+    if (rule === "exportsSubpath" && value.startsWith("."))
+      return value;
     if (localEnums[rule]?.includes(value))
       return value;
   }
@@ -3041,7 +3045,7 @@ var init_failure = __esm(() => {
     "history-shallow-repository": { code: "AC_PRECONDITION_FAILED", message: "Architecture history requires a complete Git repository.", action: "unshallow-repository" },
     "code-facts-read-not-ready": { code: "AC_CODE_FACTS_UNAVAILABLE", message: "The existing CodeGraph index does not attest to the current source population.", facts: { issues: "codeFactsIssues" }, action: "codegraph-sync", retryable: false },
     "code-facts-snapshot-changed": { code: "AC_CODE_FACTS_UNAVAILABLE", message: "Source or index inputs changed while reading the private snapshot.", action: "retry-read", retryable: true, facts: {} },
-    "code-facts-snapshot-limit-exceeded": { code: "AC_CODE_FACTS_UNAVAILABLE", message: "The private CodeGraph snapshot exceeds its 512 MiB or 100000 entry limit.", action: "reduce-snapshot-size", retryable: false, facts: {} },
+    "code-facts-snapshot-limit-exceeded": { code: "AC_CODE_FACTS_UNAVAILABLE", message: "The private CodeGraph snapshot copy exceeds its 512 MiB or 100000 entry limit.", action: "reduce-snapshot-size", retryable: false, facts: { limit: "snapshotLimit", maxBytes: "uint", maxEntries: "uint", sourceBytes: "uint", sourceEntries: "uint", gitBytes: "uint", gitEntries: "uint", gitObjectEntries: "uint", indexBytes: "uint", indexEntries: "uint" } },
     "code-facts-snapshot-layout-unsupported": { code: "AC_CODE_FACTS_UNAVAILABLE", message: "The repository layout cannot be safely isolated for a zero-write CodeGraph read.", action: "inspect-repository-layout", retryable: false, facts: {} },
     "daemon-root-missing": { code: "AC_RUNTIME_UNAVAILABLE", message: "The daemon start worktree no longer exists. Stop this daemon using its workspace state directory.", action: "stop-targeted-daemon", retryable: false, facts: {} },
     "changeset-receipt-journal-unavailable": { code: "AC_PRECONDITION_FAILED", message: "No committed ChangeSet journal exists for this repository and journal id.", action: "select-committed-journal" },
@@ -3174,6 +3178,7 @@ var init_failure = __esm(() => {
     "changeset-rollback-conflict": { code: "AC_PRECONDITION_FAILED", message: "ChangeSet rollback is incomplete because the projection manifest changed externally. Preserve the pending journal and backup for manual recovery.", facts: { journalId: "optional:id", changeSetId: "id", manualRecoveryRequired: "boolean" } },
     "deps-input-invalid": { code: "AC_SCHEMA_INVALID", message: "Deps input invalid.", facts: { field: "optional:depsField", issue: "optional:depsIssue" } },
     "deps-workspace-invalid": { code: "AC_SCHEMA_INVALID", message: "Deps workspace invalid.", facts: {} },
+    "workspace-exports-unsupported": { code: "AC_SCHEMA_INVALID", message: "A workspace package.json exports value has an unsupported shape.", facts: { manifestPath: "repoPath", subpath: "exportsSubpath" } },
     "deps-model-unreadable": { code: "AC_MODEL_ADOPTION_REQUIRED", message: "Deps model unreadable.", facts: {} },
     "code-facts-unavailable": { code: "AC_CODE_FACTS_UNAVAILABLE", message: "Code facts unavailable.", facts: {} },
     "projection-check-mode-invalid": { code: "AC_SCHEMA_INVALID", message: "Projection check mode invalid.", facts: {} },
@@ -3321,6 +3326,7 @@ var init_failure = __esm(() => {
     depsField: ["from", "into", "importNodeLimit", "edgeLimit"],
     depsIssue: ["unknown-node", "invalid-limit", "missing-value"],
     snapshotField: ["repositoryId", "workspaceId", "headSha", "worktreeDigest"],
+    snapshotLimit: ["bytes", "entries"],
     jobsField: ["workerId"],
     observedDomain: ["observed"],
     inputAvailability: ["unavailable"],
@@ -4119,7 +4125,7 @@ function compareVersionTriples(left, right) {
   }
   return 0;
 }
-var ARCHCONTEXT_PRODUCT_NAME = "archctx", ARCHCONTEXT_PRODUCT_VERSION = "0.11.0", ARCHCONTEXT_PACKAGE_MANAGER = "bun@1.4.3", ARCHCONTEXT_NODE_RANGE = ">=22.22 <26", LOCAL_RUNTIME_RPC_SCHEMA_VERSION = "archcontext.runtime-rpc/v2", ARCHCONTEXT_SCHEMA_SET_VERSION = "2026-07-11.explorer-view-v2";
+var ARCHCONTEXT_PRODUCT_NAME = "archctx", ARCHCONTEXT_PRODUCT_VERSION = "0.11.2", ARCHCONTEXT_PACKAGE_MANAGER = "bun@1.4.3", ARCHCONTEXT_NODE_RANGE = ">=22.22 <26", LOCAL_RUNTIME_RPC_SCHEMA_VERSION = "archcontext.runtime-rpc/v2", ARCHCONTEXT_SCHEMA_SET_VERSION = "2026-07-11.explorer-view-v2";
 
 // packages/contracts/src/refactor.ts
 function refactorNamespaceIssues(value, label = "product.id") {
@@ -23616,9 +23622,43 @@ function readWorkspacePackages(root) {
   return (manifest.workspaces ?? []).flatMap((entry) => expandWorkspaceEntry(root, entry)).map((directory) => {
     const path = join2(root, ...directory.split("/"), "package.json");
     const packageManifest = JSON.parse(readFileSync6(path, "utf8"));
-    return { name: packageManifest.name, root: directory, exports: packageManifest.exports ?? {} };
+    return { name: packageManifest.name, root: directory, exports: normalizePackageExports(packageManifest.exports, `${directory}/package.json`) };
   }).sort((left, right) => left.name < right.name ? -1 : left.name > right.name ? 1 : 0);
 }
+var EXPORT_CONDITIONS = ["types", "import", "default", "require"];
+function normalizePackageExports(exportsField, manifestPath) {
+  if (exportsField === undefined)
+    return {};
+  const unsupported = (subpath) => new FailureError("AC_SCHEMA_INVALID", "workspace-exports-unsupported", { manifestPath, subpath });
+  const target = (value, subpath) => {
+    if (typeof value === "string")
+      return value;
+    if (value === null)
+      return;
+    if (typeof value !== "object")
+      throw unsupported(subpath);
+    const candidates = Array.isArray(value) ? value : EXPORT_CONDITIONS.filter((condition) => Object.hasOwn(value, condition)).map((condition) => value[condition]);
+    for (const candidate of candidates) {
+      const resolved = target(candidate, subpath);
+      if (resolved !== undefined)
+        return resolved;
+    }
+    return;
+  };
+  const keys = exportsField !== null && typeof exportsField === "object" && !Array.isArray(exportsField) ? Object.keys(exportsField) : [];
+  const subpathKeys = keys.filter((key) => key.startsWith("."));
+  if (subpathKeys.length === 0) {
+    const root = target(exportsField, ".");
+    return root === undefined ? {} : { ".": root };
+  }
+  if (subpathKeys.length !== keys.length)
+    throw unsupported(".");
+  const entries = subpathKeys.flatMap((subpath) => {
+    const resolved = target(exportsField[subpath], subpath);
+    return resolved === undefined ? [] : [[subpath, resolved]];
+  });
+  return Object.fromEntries(entries);
+}
 function expandWorkspaceEntry(root, entry) {
   if (!entry.includes("*"))
     return [entry];
@@ -25935,9 +25975,6 @@ function withExistingCodeGraphSnapshot(root, queries, callback, options = {}) {
   const gitDir = gitPath("--git-dir");
   const commonDir = gitPath("--git-common-dir");
   assertSnapshotGitReadSafety(originalRoot);
-  if (existsSync6(join3(commonDir, "objects/info/alternates"))) {
-    throw new FailureError("AC_CODE_FACTS_UNAVAILABLE", "code-facts-snapshot-layout-unsupported");
-  }
   const temporaryParent = realpathSync3.native(tmpdir2());
   const temporaryRelative = relative4(originalRoot, temporaryParent);
   if (!temporaryRelative || temporaryRelative !== ".." && !temporaryRelative.startsWith(`..${process.platform === "win32" ? "\\" : "/"}`) && !isAbsolute4(temporaryRelative)) {
@@ -26007,28 +26044,50 @@ function assertSnapshotGitReadSafety(root) {
     }
   }
 }
+function pinSnapshotHooks(snapshotRepository) {
+  const gitDir = join3(snapshotRepository, ".git");
+  const hooks = join3(gitDir, "archctx-empty-hooks");
+  mkdirSync4(hooks);
+  const path = process.platform === "win32" ? hooks.replaceAll("\\", "/") : hooks;
+  const options = { cwd: snapshotRepository, encoding: "utf8", stdio: "pipe", timeout: 5000 };
+  const pinned = spawnSync4("git", ["config", "--file", join3(gitDir, "config"), "--replace-all", "core.hooksPath", path], options);
+  const effective = spawnSync4("git", ["config", "--get", "core.hooksPath"], options);
+  if (pinned.status !== 0 || effective.status !== 0 || effective.stdout.replace(/\r?\n$/, "") !== path) {
+    throw new FailureError("AC_CODE_FACTS_UNAVAILABLE", "code-facts-snapshot-layout-unsupported");
+  }
+}
 function mirrorCodeGraphInputs(root, gitDir, commonDir, destination) {
   const hash = createHash5("sha256");
+  const measured = { sourceBytes: 0, sourceEntries: 0, gitBytes: 0, gitEntries: 0, gitObjectEntries: 0, indexBytes: 0, indexEntries: 0 };
   let bytes = 0;
   let entries = 0;
-  const visit = (source, target, skip = new Set) => {
+  let limit;
+  const fingerprint = (source, target) => {
     const stat = lstatSync4(source, { bigint: true });
     if (++entries > CODEGRAPH_SNAPSHOT_MAX_ENTRIES)
-      throw new FailureError("AC_CODE_FACTS_UNAVAILABLE", "code-facts-snapshot-limit-exceeded");
+      limit ??= "entries";
     hash.update(JSON.stringify([source, target, String(stat.ino), String(stat.size), String(stat.mtimeNs), String(stat.ctimeNs)]));
+    return stat;
+  };
+  const visit = (part, source, target, skip = new Set) => {
+    const stat = fingerprint(source, target);
+    measured[`${part}Entries`]++;
     if (stat.isDirectory()) {
-      if (destination)
+      if (destination && !limit)
         mkdirSync4(join3(destination, target), { recursive: true });
       for (const name of readdirSync4(source).sort()) {
         if (!skip.has(name))
-          visit(join3(source, name), join3(target, name));
+          visit(part, join3(source, name), join3(target, name));
       }
     } else if (stat.isFile()) {
       if (basename3(target) === ".git")
         throw new FailureError("AC_CODE_FACTS_UNAVAILABLE", "code-facts-snapshot-layout-unsupported");
+      measured[`${part}Bytes`] += Number(stat.size);
       bytes += Number(stat.size);
       if (bytes > CODEGRAPH_SNAPSHOT_MAX_BYTES)
-        throw new FailureError("AC_CODE_FACTS_UNAVAILABLE", "code-facts-snapshot-limit-exceeded");
+        limit ??= "bytes";
+      if (limit)
+        return;
       const data = Buffer.alloc(Number(stat.size));
       const fd = openSync3(source, "r");
       try {
@@ -26053,6 +26112,33 @@ function mirrorCodeGraphInputs(root, gitDir, commonDir, destination) {
       throw new FailureError("AC_CODE_FACTS_UNAVAILABLE", "code-facts-snapshot-layout-unsupported");
     }
   };
+  const visitObjects = (source, target) => {
+    const stat = fingerprint(source, target);
+    measured.gitObjectEntries++;
+    if (stat.isDirectory()) {
+      for (const name of readdirSync4(source).sort())
+        visitObjects(join3(source, name), join3(target, name));
+    } else if (!stat.isFile()) {
+      throw new FailureError("AC_CODE_FACTS_UNAVAILABLE", "code-facts-snapshot-layout-unsupported");
+    }
+  };
+  const visitRepository = (source, target, skip) => {
+    const objects = join3(source, "objects");
+    if (existsSync6(join3(objects, "info/alternates")))
+      throw new FailureError("AC_CODE_FACTS_UNAVAILABLE", "code-facts-snapshot-layout-unsupported");
+    visit("git", source, target, new Set([...skip, "objects", "hooks", "archctx-empty-hooks"]));
+    visitObjects(objects, join3(target, "objects"));
+    const original = realpathSync3.native(objects);
+    const alternate = process.platform === "win32" ? original.replaceAll("\\", "/") : original;
+    if (/[\r\n]/.test(alternate))
+      throw new FailureError("AC_CODE_FACTS_UNAVAILABLE", "code-facts-snapshot-layout-unsupported");
+    if (destination && !limit) {
+      mkdirSync4(join3(destination, target, "objects/pack"), { recursive: true });
+      mkdirSync4(join3(destination, target, "objects/info"), { recursive: true });
+      writeFileSync3(join3(destination, target, "objects/info/alternates"), `${alternate}
+`);
+    }
+  };
   const sourceFiles = codeGraphSourceScanner()(root);
   const files = new Set([...sourceFiles, ...listGitVisibleFiles(root)]);
   const directories = new Set(["."]);
@@ -26073,7 +26159,7 @@ function mirrorCodeGraphInputs(root, gitDir, commonDir, destination) {
         files.add(path);
     }
     if (directory !== "." && existsSync6(join3(root, directory, ".git"))) {
-      visit(join3(root, directory, ".git"), join3(directory, ".git"));
+      visitRepository(join3(root, directory, ".git"), join3(directory, ".git"), new Set);
       assertSnapshotGitReadSafety(join3(root, directory));
       repositories.add(directory);
     }
@@ -26083,20 +26169,30 @@ function mirrorCodeGraphInputs(root, gitDir, commonDir, destination) {
     if (file.split(/[\\/]/).some((part) => part === ".git" || part === ".codegraph")) {
       throw new FailureError("AC_CODE_FACTS_UNAVAILABLE", "code-facts-snapshot-layout-unsupported");
     }
-    visit(join3(root, file), file);
+    visit("source", join3(root, file), file);
   }
-  visit(commonDir, ".git", new Set(["worktrees"]));
+  visitRepository(commonDir, ".git", new Set(["worktrees"]));
   if (gitDir !== commonDir)
-    visit(gitDir, ".git", new Set(["commondir", "gitdir"]));
+    visit("git", gitDir, ".git", new Set(["commondir", "gitdir"]));
   for (const suffix of ["", "-wal"]) {
     const source = join3(root, ".codegraph", `codegraph.db${suffix}`);
     hash.update(JSON.stringify([suffix, existsSync6(source)]));
     if (existsSync6(source))
-      visit(source, join3(".codegraph", `codegraph.db${suffix}`));
+      visit("index", source, join3(".codegraph", `codegraph.db${suffix}`));
+  }
+  if (limit) {
+    throw new FailureError("AC_CODE_FACTS_UNAVAILABLE", "code-facts-snapshot-limit-exceeded", {
+      limit,
+      maxBytes: CODEGRAPH_SNAPSHOT_MAX_BYTES,
+      maxEntries: CODEGRAPH_SNAPSHOT_MAX_ENTRIES,
+      ...measured
+    });
   }
   if (destination)
-    for (const repository of repositories)
+    for (const repository of repositories) {
+      pinSnapshotHooks(join3(destination, repository));
       assertSnapshotGitReadSafety(join3(destination, repository));
+    }
   return hash.digest("hex");
 }
 var CODEGRAPH_NO_DOWNLOAD_ENV = { CODEGRAPH_NO_DOWNLOAD: "1" };
@@ -32887,8 +32983,7 @@ function reviewWorkspacePackages(root) {
       const packageManifest = JSON.parse(readFileSync10(join7(root, ...directory.split("/"), "package.json"), "utf8"));
       if (typeof packageManifest.name !== "string")
         return [];
-      const exports = typeof packageManifest.exports === "string" ? { ".": packageManifest.exports } : Object.fromEntries(Object.entries(packageManifest.exports ?? {}).filter((entry) => typeof entry[1] === "string"));
-      return [{ name: packageManifest.name, root: directory, exports }];
+      return [{ name: packageManifest.name, root: directory, exports: normalizePackageExports(packageManifest.exports, `${directory}/package.json`) }];
     });
     return { packages: packages.sort((left, right) => left.name < right.name ? -1 : left.name > right.name ? 1 : 0), resolved: true };
   } catch {
@@ -54646,6 +54741,8 @@ function readWorkspaces2(root) {
   try {
     return declaredWorkspacePackages(root);
   } catch (error) {
+    if (error instanceof FailureError)
+      throw error;
     throw new CapabilityDependenciesError("AC_SCHEMA_INVALID", `workspace packages are unreadable: ${error instanceof Error ? error.message : String(error)}`, "deps-workspace-invalid");
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "archctx",
-  "version": "0.11.0",
+  "version": "0.11.2",
   "description": "Local architecture context CLI for agentic coding workflows.",
   "private": false,
   "type": "module",