@ultimat3/manifest 10.0.0 → 11.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ultimat3/manifest",
-  "version": "10.0.0",
+  "version": "11.0.0",
   "description": "x.manifest.json: deterministic generated facts, contract diff, AGENTS.md budget",
   "license": "MIT",
   "type": "module",
@@ -31,10 +31,10 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@ultimat3/action": "10.0.0",
-    "@ultimat3/core": "10.0.0",
-    "@ultimat3/entity": "10.0.0",
-    "@ultimat3/jobs": "10.0.0",
-    "@ultimat3/query": "10.0.0"
+    "@ultimat3/action": "11.0.0",
+    "@ultimat3/core": "11.0.0",
+    "@ultimat3/entity": "11.0.0",
+    "@ultimat3/jobs": "11.0.0",
+    "@ultimat3/query": "11.0.0"
   }
 }

package/src/docs-scan.ts

@@ -242,9 +242,12 @@ export async function scanPackageDocs(dir: string): Promise<readonly DocEntry[]>
   // alphabetically would reorder an argument its author sequenced on purpose, and prose read out
   // of order is prose an agent has to reassemble. Both halves are deterministic, which is what
   // "two scans of one tree agree" actually requires.
+  // Code units, never `localeCompare`, which answers from the runtime's ICU default and collation
+  // version: `jobs.Cache` sorted before `jobs.cache` on one machine and after it on the next, for
+  // one installed tree. `@ultimat3/jobs`' `job.ts` states the same rule.
   const moduleEntries = scanned
     .filter((entry) => entry !== undefined)
-    .sort((a, b) => a.topic.localeCompare(b.topic));
+    .sort((a, b) => (a.topic < b.topic ? -1 : a.topic > b.topic ? 1 : 0));
   return [...moduleEntries, ...(await guideEntries(dir, name, version))];
 }
 

package/src/docs-search.ts

@@ -3,6 +3,15 @@
 
 import type { DocEntry } from './docs-scan';
 
+/**
+ * The tie-break, in CODE UNITS. Never `localeCompare`: with no locale argument it answers from the
+ * runtime's ICU default and collation version, so one corpus ranks two ways on two machines and
+ * this file's header — "the order it produces is a function of its input alone" — stops being
+ * true. `@ultimat3/jobs`' `job.ts` states the same rule for the manifest it emits; the comparator
+ * is restated rather than imported because that package is not below this one on the tier table.
+ */
+const byTopic = (a: string, b: string): number => (a < b ? -1 : a > b ? 1 : 0);
+
 /**
  * Words that carry no signal in a question about an API. Deliberately tiny: every word removed
  * here is a word an agent cannot search for, and `get`, `set`, `run` and `new` are all real
@@ -194,7 +203,7 @@ export function searchDocs(
     const hit = scoreEntry(entry, tokens, rationale);
     if (hit !== undefined && hit.covered >= required) hits.push(hit);
   }
-  hits.sort((a, b) => b.score - a.score || a.entry.topic.localeCompare(b.entry.topic));
+  hits.sort((a, b) => b.score - a.score || byTopic(a.entry.topic, b.entry.topic));
   return hits.slice(0, limit);
 }
 
@@ -220,6 +229,6 @@ export function nearestTopics(
     }
     if (score > 0) scored.push({ topic: entry.topic, score });
   }
-  scored.sort((a, b) => b.score - a.score || a.topic.localeCompare(b.topic));
+  scored.sort((a, b) => b.score - a.score || byTopic(a.topic, b.topic));
   return [...new Set(scored.map((item) => item.topic))].slice(0, limit);
 }