superbee 0.4.4-pre.3 → 0.4.4-pre.4

package/dist/publication-bridge.mjs

@@ -3397,6 +3397,11 @@ function stringifyDoc(frontmatter2, body) {
   return stringifyWithData(frontmatter2, body);
 }
 
+// ../core/src/code-unit-order.ts
+function compareCodeUnits(a, b) {
+  return a < b ? -1 : a > b ? 1 : 0;
+}
+
 // ../core/src/links.ts
 function normalizeSegments(segments) {
   const out = [];
@@ -3857,7 +3862,7 @@ async function scanMatching(backend, filter, onSkip) {
   for (const result of await readManyExisting(backend, ids, onSkip)) {
     if (matchesFilter(result.doc, filter)) results.push(result);
   }
-  results.sort((a, b) => a.doc.id.localeCompare(b.doc.id));
+  results.sort((a, b) => compareCodeUnits(a.doc.id, b.doc.id));
   return results;
 }
 async function query(backend, filter = {}, options = {}) {
@@ -3866,7 +3871,7 @@ async function query(backend, filter = {}, options = {}) {
 async function queryHeads(backend, filter = {}, options = {}) {
   if (backend.queryHeads) {
     const rows = (await backend.queryHeads(filter, options.onSkip ? { onSkip: options.onSkip } : void 0)).filter((row) => matchesFilter(row, filter));
-    rows.sort((a, b) => a.id.localeCompare(b.id));
+    rows.sort((a, b) => compareCodeUnits(a.id, b.id));
     return rows;
   }
   return (await scanMatching(backend, filter, options.onSkip)).map(({ doc, version: version2 }) => ({
@@ -3906,7 +3911,7 @@ async function queryEdges(backend, filter = {}, options = {}) {
       edges.push(link);
     }
   }
-  edges.sort((a, b) => a.from.localeCompare(b.from) || a.to.localeCompare(b.to) || a.text.localeCompare(b.text));
+  edges.sort((a, b) => compareCodeUnits(a.from, b.from) || compareCodeUnits(a.to, b.to) || compareCodeUnits(a.text, b.text));
   return edges;
 }
 
@@ -5458,11 +5463,6 @@ async function queryEdges2(bundle, filter = {}, options = {}) {
 // ../core/src/bundle.ts
 setDefaultBackendFactory((root) => new FilesystemBackend(root));
 
-// ../core/src/code-unit-order.ts
-function compareCodeUnits(a, b) {
-  return a < b ? -1 : a > b ? 1 : 0;
-}
-
 // ../core/src/managed-document-metadata.ts
 var MANAGED_DOCUMENT_METADATA_FIELDS = /* @__PURE__ */ new Set([
   "generated",
@@ -6598,7 +6598,7 @@ function replyWithinLimit(reply) {
 }
 function skippedReply(skipped) {
   if (skipped.length === 0) return {};
-  return { skipped: [...skipped].sort((a, b) => a.id.localeCompare(b.id)).slice(0, MAX_QUERY_ROWS) };
+  return { skipped: [...skipped].sort((a, b) => compareCodeUnits(a.id, b.id)).slice(0, MAX_QUERY_ROWS) };
 }
 function boundedRows(rows, params, kinds) {
   const requested = params.limit === 0 || params.limit === void 0 ? MAX_QUERY_ROWS : Math.min(params.limit, MAX_QUERY_ROWS);
@@ -6713,7 +6713,7 @@ var BridgeService = class {
     for (const id of subscription.baseline.keys()) {
       if (!next.has(id)) removed.push(id);
     }
-    changes.sort((a, b) => a.id.localeCompare(b.id));
+    changes.sort((a, b) => compareCodeUnits(a.id, b.id));
     removed.sort();
     if (changes.length === 0 && removed.length === 0) return { status: "unchanged" };
     if (changes.length > MAX_CHANGE_ROWS || removed.length > MAX_CHANGE_ROWS) {
@@ -6742,7 +6742,7 @@ var BridgeService = class {
       throw new Error("the bundle is too large for the experimental View polling snapshot");
     }
     return new Map(
-      [...rows].sort((a, b) => a.id.localeCompare(b.id)).map((row) => [row.id, row.version])
+      [...rows].sort((a, b) => compareCodeUnits(a.id, b.id)).map((row) => [row.id, row.version])
     );
   }
   /**

package/dist/publication.mjs

@@ -31351,6 +31351,11 @@ function stringifyDoc(frontmatter2, body) {
   return stringifyWithData(frontmatter2, body);
 }
 
+// ../core/src/code-unit-order.ts
+function compareCodeUnits(a, b) {
+  return a < b ? -1 : a > b ? 1 : 0;
+}
+
 // ../core/src/links.ts
 function normalizeSegments(segments) {
   const out = [];
@@ -31811,7 +31816,7 @@ async function scanMatching(backend, filter, onSkip) {
   for (const result of await readManyExisting(backend, ids, onSkip)) {
     if (matchesFilter(result.doc, filter)) results.push(result);
   }
-  results.sort((a, b) => a.doc.id.localeCompare(b.doc.id));
+  results.sort((a, b) => compareCodeUnits(a.doc.id, b.doc.id));
   return results;
 }
 async function query(backend, filter = {}, options = {}) {
@@ -31820,7 +31825,7 @@ async function query(backend, filter = {}, options = {}) {
 async function queryHeads(backend, filter = {}, options = {}) {
   if (backend.queryHeads) {
     const rows = (await backend.queryHeads(filter, options.onSkip ? { onSkip: options.onSkip } : void 0)).filter((row) => matchesFilter(row, filter));
-    rows.sort((a, b) => a.id.localeCompare(b.id));
+    rows.sort((a, b) => compareCodeUnits(a.id, b.id));
     return rows;
   }
   return (await scanMatching(backend, filter, options.onSkip)).map(({ doc, version: version2 }) => ({
@@ -31860,7 +31865,7 @@ async function queryEdges(backend, filter = {}, options = {}) {
       edges.push(link);
     }
   }
-  edges.sort((a, b) => a.from.localeCompare(b.from) || a.to.localeCompare(b.to) || a.text.localeCompare(b.text));
+  edges.sort((a, b) => compareCodeUnits(a.from, b.from) || compareCodeUnits(a.to, b.to) || compareCodeUnits(a.text, b.text));
   return edges;
 }
 
@@ -33442,11 +33447,6 @@ async function queryEdges2(bundle, filter = {}, options = {}) {
 // ../core/src/bundle.ts
 setDefaultBackendFactory((root) => new FilesystemBackend(root));
 
-// ../core/src/code-unit-order.ts
-function compareCodeUnits(a, b) {
-  return a < b ? -1 : a > b ? 1 : 0;
-}
-
 // ../core/src/managed-document-metadata.ts
 var MANAGED_DOCUMENT_METADATA_FIELDS = /* @__PURE__ */ new Set([
   "generated",
@@ -43813,7 +43813,7 @@ function replyWithinLimit(reply) {
 }
 function skippedReply(skipped) {
   if (skipped.length === 0) return {};
-  return { skipped: [...skipped].sort((a, b) => a.id.localeCompare(b.id)).slice(0, MAX_QUERY_ROWS) };
+  return { skipped: [...skipped].sort((a, b) => compareCodeUnits(a.id, b.id)).slice(0, MAX_QUERY_ROWS) };
 }
 function boundedRows(rows, params, kinds) {
   const requested = params.limit === 0 || params.limit === void 0 ? MAX_QUERY_ROWS : Math.min(params.limit, MAX_QUERY_ROWS);
@@ -43928,7 +43928,7 @@ var BridgeService = class {
     for (const id of subscription.baseline.keys()) {
       if (!next.has(id)) removed.push(id);
     }
-    changes.sort((a, b) => a.id.localeCompare(b.id));
+    changes.sort((a, b) => compareCodeUnits(a.id, b.id));
     removed.sort();
     if (changes.length === 0 && removed.length === 0) return { status: "unchanged" };
     if (changes.length > MAX_CHANGE_ROWS || removed.length > MAX_CHANGE_ROWS) {
@@ -43957,7 +43957,7 @@ var BridgeService = class {
       throw new Error("the bundle is too large for the experimental View polling snapshot");
     }
     return new Map(
-      [...rows].sort((a, b) => a.id.localeCompare(b.id)).map((row) => [row.id, row.version])
+      [...rows].sort((a, b) => compareCodeUnits(a.id, b.id)).map((row) => [row.id, row.version])
     );
   }
   /**
@@ -44560,22 +44560,22 @@ function buildSnapshot(first) {
     });
     relationships.push(...parseLinksFromDoc(doc).map((link) => ({ ...link })));
   }
-  documents.sort((a, b) => a.id.localeCompare(b.id));
-  relationships.sort((a, b) => a.from.localeCompare(b.from) || a.to.localeCompare(b.to) || a.text.localeCompare(b.text) || a.href.localeCompare(b.href));
+  documents.sort((a, b) => compareCodeUnits(a.id, b.id));
+  relationships.sort((a, b) => compareCodeUnits(a.from, b.from) || compareCodeUnits(a.to, b.to) || compareCodeUnits(a.text, b.text) || compareCodeUnits(a.href, b.href));
   const reserved = first.reserved.map((row) => ({
     dir: row.dir,
     name: row.name,
     version: row.version,
     object: addObject(objects, row.bytes, "text/markdown; charset=utf-8", "exact")
   }));
-  reserved.sort((a, b) => `${a.dir}/${a.name}`.localeCompare(`${b.dir}/${b.name}`));
+  reserved.sort((a, b) => compareCodeUnits(`${a.dir}/${a.name}`, `${b.dir}/${b.name}`));
   const blobs = first.blobs.map((row) => ({
     key: row.key,
     version: row.version,
     contentType: row.contentType,
     object: addObject(objects, row.bytes, row.contentType, "exact")
   }));
-  blobs.sort((a, b) => a.key.localeCompare(b.key));
+  blobs.sort((a, b) => compareCodeUnits(a.key, b.key));
   const blobsByKey = new Map(blobs.map((row) => [row.key, row]));
   const views = [];
   for (const { doc, version: version2 } of parsedDocs.values()) {
@@ -44617,7 +44617,7 @@ function buildSnapshot(first) {
       entryObject: blob.object
     });
   }
-  views.sort((a, b) => a.id.localeCompare(b.id));
+  views.sort((a, b) => compareCodeUnits(a.id, b.id));
   const withoutDigest = {
     schema: PUBLICATION_SNAPSHOT_V1,
     schemaVersion: 1,

package/dist/superbee.mjs

@@ -44,7 +44,7 @@ var __toESM = (mod, isNodeMode, target3) => (target3 = mod != null ? __create(__
 var define_SUPERBEE_BUILD_IDENTITY_default;
 var init_define_SUPERBEE_BUILD_IDENTITY = __esm({
   "<define:__SUPERBEE_BUILD_IDENTITY__>"() {
-    define_SUPERBEE_BUILD_IDENTITY_default = { schema: "superbee.build-identity.v1", package: { name: "superbee", version: "0.4.4-pre.3" }, source: { commit: "bf9a2a2bb54c7d682853679a4c241533eb8de381", dirty: false }, artifact: { channel: "npm-package" }, compatibility_contracts: { skill: 1, hook: 1, mcp: 1 } };
+    define_SUPERBEE_BUILD_IDENTITY_default = { schema: "superbee.build-identity.v1", package: { name: "superbee", version: "0.4.4-pre.4" }, source: { commit: "128ccfcc43843e6dd97380a124b85e5bfe1d1711", dirty: false }, artifact: { channel: "npm-package" }, compatibility_contracts: { skill: 1, hook: 1, mcp: 1 } };
   }
 });
 
@@ -3582,6 +3582,18 @@ var init_frontmatter = __esm({
   }
 });
 
+// ../core/src/code-unit-order.ts
+function compareCodeUnits(a, b) {
+  return a < b ? -1 : a > b ? 1 : 0;
+}
+var init_code_unit_order = __esm({
+  "../core/src/code-unit-order.ts"() {
+    "use strict";
+    init_define_SUPERBEE_BUILD_IDENTITY();
+    init_define_SUPERBEE_UPDATE_POLICY();
+  }
+});
+
 // ../core/src/links.ts
 function normalizeSegments(segments) {
   const out = [];
@@ -4885,7 +4897,7 @@ async function scanMatching(backend, filter, onSkip) {
   for (const result3 of await readManyExisting(backend, ids, onSkip)) {
     if (matchesFilter(result3.doc, filter)) results.push(result3);
   }
-  results.sort((a, b) => a.doc.id.localeCompare(b.doc.id));
+  results.sort((a, b) => compareCodeUnits(a.doc.id, b.doc.id));
   return results;
 }
 async function query(backend, filter = {}, options = {}) {
@@ -4894,7 +4906,7 @@ async function query(backend, filter = {}, options = {}) {
 async function queryHeads(backend, filter = {}, options = {}) {
   if (backend.queryHeads) {
     const rows = (await backend.queryHeads(filter, options.onSkip ? { onSkip: options.onSkip } : void 0)).filter((row5) => matchesFilter(row5, filter));
-    rows.sort((a, b) => a.id.localeCompare(b.id));
+    rows.sort((a, b) => compareCodeUnits(a.id, b.id));
     return rows;
   }
   return (await scanMatching(backend, filter, options.onSkip)).map(({ doc: doc2, version: version5 }) => ({
@@ -4937,7 +4949,7 @@ async function queryEdges(backend, filter = {}, options = {}) {
       edges.push(link4);
     }
   }
-  edges.sort((a, b) => a.from.localeCompare(b.from) || a.to.localeCompare(b.to) || a.text.localeCompare(b.text));
+  edges.sort((a, b) => compareCodeUnits(a.from, b.from) || compareCodeUnits(a.to, b.to) || compareCodeUnits(a.text, b.text));
   return edges;
 }
 async function backlinks(backend, target3) {
@@ -4985,6 +4997,7 @@ var init_engine = __esm({
     "use strict";
     init_define_SUPERBEE_BUILD_IDENTITY();
     init_define_SUPERBEE_UPDATE_POLICY();
+    init_code_unit_order();
     init_body_replace_guards();
     init_inventory_guard();
     init_version_transport();
@@ -9558,18 +9571,6 @@ var init_remote_error = __esm({
   }
 });
 
-// ../core/src/code-unit-order.ts
-function compareCodeUnits(a, b) {
-  return a < b ? -1 : a > b ? 1 : 0;
-}
-var init_code_unit_order = __esm({
-  "../core/src/code-unit-order.ts"() {
-    "use strict";
-    init_define_SUPERBEE_BUILD_IDENTITY();
-    init_define_SUPERBEE_UPDATE_POLICY();
-  }
-});
-
 // ../core/src/heads-digest.ts
 function sortHeads(heads) {
   return [...heads].sort((a, b) => compareCodeUnits(a.id, b.id));
@@ -32410,7 +32411,7 @@ var init_source_profiles = __esm({
         };
       }
     });
-    SOURCE_PLUGIN_CORE_VERSION = "0.2.0-pre.38";
+    SOURCE_PLUGIN_CORE_VERSION = "0.2.0-pre.39";
     SOURCE_PROFILES = Object.freeze([restJsonProfile].map((profile) => Object.freeze({ id: profile.id, version: profile.version, kind: profile.kind })));
   }
 });
@@ -35565,6 +35566,7 @@ function decodeBlobWriteResult(raw, expected) {
   if (error51.code === "deletions_held") {
     if (operationId !== "blobs.delete.v1" || !count2(error51.deletions) || !Number.isSafeInteger(error51.baseline) || error51.baseline < 0) throw refuse3();
   } else if (error51.deletions !== void 0 || error51.baseline !== void 0) throw refuse3();
+  if (error51.code === "path_collision" && operationId !== "blobs.create.v1") throw refuse3();
   return { ok: false, operationId, error: { ...error51 } };
 }
 function assertBlobKey(key4) {
@@ -35609,7 +35611,7 @@ var init_blob_contract = __esm({
     onlyKeys = (value, allowed) => Object.keys(value).every((key4) => allowed.includes(key4));
     count2 = (value) => Number.isSafeInteger(value) && value >= 1;
     BLOB_OPERATION_IDS = Object.freeze(["blobs.create.v1", "blobs.replace.v1", "blobs.delete.v1"]);
-    BLOB_ERROR_CODES = ["version_conflict", "insufficient_scope", "bundle_not_found", "concurrent_change", "backend_unavailable", "request_capacity", "deletions_held", "write_outcome_unknown"];
+    BLOB_ERROR_CODES = ["version_conflict", "insufficient_scope", "bundle_not_found", "concurrent_change", "backend_unavailable", "request_capacity", "deletions_held", "path_collision", "write_outcome_unknown"];
     BLOB_ERROR_KEYS = ["code", "message", "retryable", "writeState", "expected", "actual", "expectedContentType", "actualContentType", "scope", "resetAt", "deletions", "baseline"];
     BLOB_CONFLICT_KEYS = ["expected", "actual", "expectedContentType", "actualContentType"];
   }
@@ -35832,6 +35834,9 @@ var init_answer_rows = __esm({
       { answer: "429 request_capacity", recorded: "no", outcome: "refused" },
       // The mass-delete hold, refused before dispatch on a delete; not pausing (see DELETIONS_HELD_REFUSAL_CODE).
       { answer: "428 deletions_held", recorded: "no", outcome: "refused" },
+      // A blob create whose path folds onto an existing document or blob path (blob writes only):
+      // refused before anything is written and not recorded under the identity, like the quota.
+      { answer: "200 path_collision", recorded: "no", outcome: "refused" },
       { answer: "200 write_outcome_unknown", recorded: "maybe", outcome: "unknown" },
       { answer: "200 other", recorded: "unknown", outcome: "unknown" },
       { answer: "400", recorded: "no", outcome: "unknown" },
@@ -38280,7 +38285,7 @@ var init_blob_delivery = __esm({
     init_answer_rows();
     init_carrier();
     UNKNOWN5 = Object.freeze({ kind: "unknown" });
-    BLOB_UNRECORDED_REFUSAL_CODES = Object.freeze(["insufficient_scope", "bundle_not_found", "request_capacity"]);
+    BLOB_UNRECORDED_REFUSAL_CODES = Object.freeze(["insufficient_scope", "bundle_not_found", "request_capacity", "path_collision"]);
     UNRECORDED_REFUSALS = new Set(BLOB_UNRECORDED_REFUSAL_CODES);
     sleepTimer = (ms, signal) => new Promise((resolve3) => {
       if (signal?.aborted) {
@@ -40280,6 +40285,7 @@ var init_storage = __esm({
     init_define_SUPERBEE_BUILD_IDENTITY();
     init_define_SUPERBEE_UPDATE_POLICY();
     init_errors();
+    init_code_unit_order();
     init_frontmatter_contract();
     init_paths();
     init_version_transport();
@@ -55574,6 +55580,7 @@ __export(sync_exports2, {
   HOSTED_SYNC_USAGE: () => HOSTED_SYNC_USAGE,
   blobConflictHelp: () => blobConflictHelp,
   blobDeliveryFailure: () => blobDeliveryFailure,
+  blobPathCollisionMessage: () => blobPathCollisionMessage,
   deliverHostedBlobRequests: () => deliverHostedBlobRequests,
   dirArgument: () => dirArgument,
   finishAdmittedBlob: () => finishAdmittedBlob,
@@ -56303,6 +56310,11 @@ async function driveBlobRequests(session2, deps2, options) {
   for (const row5 of out.rows) out.counts[row5.state]++;
   return out;
 }
+async function orphanedArtifactPublication(store, p) {
+  if (p.state !== "blob_admitted" || await store.readBlobIntent(p.blobRequestId)) return false;
+  const snapshot3 = await readBlobSyncState(store, p.entry, p.scope);
+  return !snapshot3.map.entries.find((entry) => entry.key === p.entry)?.head && snapshot3.journal.intents.every((row5) => row5.receipt !== void 0);
+}
 async function queueHostedArtifact(binding2, input, partial2, resume2) {
   const deps2 = hostedDeps(partial2), signal = deps2.write?.signal;
   signal?.throwIfAborted();
@@ -56314,11 +56326,18 @@ async function queueHostedArtifact(binding2, input, partial2, resume2) {
       signal?.throwIfAborted();
       if (!session2.capabilities.operations || session2.capabilities.blobWrites !== "allowed") throw new CliError("CONFLICT", "host does not offer the identified blob/document writes Artifact needs");
       await assertActorAcceptedByBundle(local.bundle, input.actor);
-      const all2 = await publications(store);
+      let all2 = await publications(store);
       const source2 = path44.resolve(deps2.cwd, input.file), rel = path44.relative(binding2.path, source2).split(path44.sep).join("/");
       let publication = all2.find((p) => p.entry === rel);
       if (publication) {
         assertPublicationBinding(publication, binding2);
+        if (await orphanedArtifactPublication(store, publication)) {
+          await store.removeMeta(publicationKey(publication.id), { expected: { present: true, value: publication } });
+          all2 = all2.filter((p) => p.id !== publication.id);
+          publication = void 0;
+        }
+      }
+      if (publication) {
         if (publication.title !== input.title || publication.actor !== input.actor || publication.description !== input.description) throw new CliError("CONFLICT", "Artifact arguments differ from the frozen publication; no new identity was selected");
       } else {
         const heads = await queryHeads2(local.bundle, { prefix: "artifacts/" });
@@ -56350,9 +56369,12 @@ async function queueHostedArtifact(binding2, input, partial2, resume2) {
       assertPublicationSource(publication, binding2.path);
       if (publication.state === "blob_admitted") {
         const declared = declaredHostedSyncGate(binding2.path);
-        await driveBlobRequests(session2, deps2, { requestIds: [publication.blobRequestId], gatePresent: declared.kind !== "none", gate: async (fresh, count6) => {
+        const delivered = await driveBlobRequests(session2, deps2, { requestIds: [publication.blobRequestId], gatePresent: declared.kind !== "none", gate: async (fresh, count6) => {
           await judgeHostedWrites(session2, declared, resume2, fresh, count6);
         } });
+        const collided = delivered.rows.find((row5) => blobRefusalCode(row5) === "path_collision");
+        if (collided) await store.removeMeta(publicationKey(publication.id), { expected: { present: true, value: publication } });
+        if (collided) throw new CliError("CONFLICT", blobPathCollisionMessage(collided.key, "give the Artifact a title whose path differs from existing documents and files by more than letter case or Unicode form"), { details: { reason: "path_collision", entry: collided.key, blob_request_id: collided.request_id } });
         const version5 = await acknowledgedArtifactBlob(store, publication);
         if (!version5) return { artifact: "blob_pending", id: publication.id, entry: publication.entry, blob_request_id: publication.blobRequestId, status: "incomplete", help: String(resume2) };
         assertPublicationSource(publication, binding2.path);
@@ -56438,10 +56460,16 @@ function blobRefusalCode(row5) {
   const result3 = row5.result;
   return row5.state === "refused" && result3?.ok === false && typeof result3.error?.code === "string" ? result3.error.code : void 0;
 }
+function blobPathCollisionMessage(key4, next = "rename the file or its folder to a distinct path, then promote it again") {
+  return `${key4} was not created: another file or document in this bundle differs from this path only by letter case or Unicode form, in its name or a folder, so the two would be one path on a case-insensitive filesystem. Nothing was written; ${next}.`;
+}
 function blobRefusalNote(row5) {
   const result3 = row5.receipt?.result;
-  if (row5.state !== "refused" || !result3 || result3.ok || !BLOB_UNRECORDED.has(result3.error.code)) return void 0;
-  return result3.error.code === "request_capacity" ? `${row5.target} was not sent: the sync quota is used up. Nothing was lost; run sync again later and it is sent again.` : `${row5.target} was not sent: the host refused writes to this bundle for this sign-in. Nothing was lost; it is sent again on a sync once access returns.`;
+  if (row5.state !== "refused" || !result3 || result3.ok) return void 0;
+  if (result3.error.code === "path_collision") return blobPathCollisionMessage(row5.target);
+  if (!BLOB_UNRECORDED.has(result3.error.code)) return void 0;
+  const again = result3.operationId === "blobs.create.v1" ? "promote it again" : "sync sends it again";
+  return result3.error.code === "request_capacity" ? `${row5.target} was not sent: the sync quota is used up. Nothing was lost; later, ${again}.` : `${row5.target} was not sent: the host refused writes to this bundle for this sign-in. Nothing was lost; once access returns, ${again}.`;
 }
 function blobDeliveryFailure(report) {
   if (report.rows.every((row5) => row5.state === "committed") && !report.kept_local_edits?.length) return null;
@@ -57492,7 +57520,7 @@ unless SUPERBEE_VIA says otherwise. SUPERBEE_ACTOR does not set it.
     GIT_ONLY_FLAGS = ["establish", "pull-only", "show-incoming", "yes", "body-out", "migrate"];
     busyRefusal = (row5) => row5.refusal !== void 0 && BUSY_REFUSAL_CODES.has(row5.refusal.code);
     BLOB_ACCESS_REFUSALS = /* @__PURE__ */ new Set(["insufficient_scope", "bundle_not_found"]);
-    BLOB_UNRECORDED = new Set(BLOB_UNRECORDED_REFUSAL_CODES);
+    BLOB_UNRECORDED = new Set(BLOB_UNRECORDED_REFUSAL_CODES.filter((code3) => code3 !== "path_collision"));
   }
 });
 
@@ -97273,7 +97301,7 @@ function buildRouter(options) {
     let page = heads;
     if (cursor) {
       const idx = page.findIndex((r) => r.id === cursor);
-      page = idx >= 0 ? page.slice(idx + 1) : page.filter((r) => r.id.localeCompare(cursor) > 0);
+      page = idx >= 0 ? page.slice(idx + 1) : page.filter((r) => compareCodeUnits(r.id, cursor) > 0);
     }
     const limited = page.slice(0, limit);
     const nextCursor = page.length > limit ? limited[limited.length - 1]?.id ?? null : null;
@@ -98565,7 +98593,7 @@ function projectCandidates(heads) {
       }
     });
   }
-  candidates.sort((a, b) => a.row.id.localeCompare(b.row.id));
+  candidates.sort((a, b) => compareCodeUnits(a.row.id, b.row.id));
   return { candidates, invalidRegistrations };
 }
 function cachedAdmission(admitEntry) {
@@ -98626,7 +98654,7 @@ async function listViewCatalogPage(bundle, options) {
   const { candidates, invalidRegistrations } = projectCandidates(heads);
   const supported = new Set(options.access);
   const compatible = candidates.filter((candidate) => supported.has(candidate.row.access));
-  const offset = options.afterId === void 0 ? 0 : compatible.findIndex((candidate) => candidate.row.id.localeCompare(options.afterId) > 0);
+  const offset = options.afterId === void 0 ? 0 : compatible.findIndex((candidate) => compareCodeUnits(candidate.row.id, options.afterId) > 0);
   let index2 = offset < 0 ? compatible.length : offset;
   let examined = 0;
   let unavailableEntries = 0;
@@ -98889,7 +98917,7 @@ function replyWithinLimit(reply) {
 }
 function skippedReply(skipped) {
   if (skipped.length === 0) return {};
-  return { skipped: [...skipped].sort((a, b) => a.id.localeCompare(b.id)).slice(0, MAX_QUERY_ROWS) };
+  return { skipped: [...skipped].sort((a, b) => compareCodeUnits(a.id, b.id)).slice(0, MAX_QUERY_ROWS) };
 }
 function boundedRows(rows, params, kinds2) {
   const requested = params.limit === 0 || params.limit === void 0 ? MAX_QUERY_ROWS : Math.min(params.limit, MAX_QUERY_ROWS);
@@ -99074,7 +99102,7 @@ var init_bridge = __esm({
         for (const id of subscription.baseline.keys()) {
           if (!next.has(id)) removed.push(id);
         }
-        changes.sort((a, b) => a.id.localeCompare(b.id));
+        changes.sort((a, b) => compareCodeUnits(a.id, b.id));
         removed.sort();
         if (changes.length === 0 && removed.length === 0) return { status: "unchanged" };
         if (changes.length > MAX_CHANGE_ROWS || removed.length > MAX_CHANGE_ROWS) {
@@ -99103,7 +99131,7 @@ var init_bridge = __esm({
           throw new Error("the bundle is too large for the experimental View polling snapshot");
         }
         return new Map(
-          [...rows].sort((a, b) => a.id.localeCompare(b.id)).map((row5) => [row5.id, row5.version])
+          [...rows].sort((a, b) => compareCodeUnits(a.id, b.id)).map((row5) => [row5.id, row5.version])
         );
       }
       /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "superbee",
-  "version": "0.4.4-pre.3",
+  "version": "0.4.4-pre.4",
   "type": "module",
   "description": "Agent-facing Superbee CLI for reading and writing local OKF knowledge bundles: context notes, docs, cross-links, and live bundle Views.",
   "keywords": [

package/references/hosted-checkout.md

@@ -379,7 +379,10 @@ bundle for everyone.
   the `superbee sync --accept-deletes blobs:<count>:<digest>` command it names.
 - **Receipt:** `blobs.rows` has one row per request, keyed by file and request id: `committed`,
   `conflict`, `refused`, `unknown` or `held`. `blobs.counts` totals them. An `unknown` row is
-  looked up by the same request on the next sync; it is never sent twice.
+  looked up by the same request on the next sync; it is never sent twice. A `refused` row whose
+  `result.error.code` is `path_collision` is a new file whose path, or one of its folders, differs
+  from an existing document or file only by letter case or Unicode form; nothing was written, and
+  sync exits 5. Rename the file or folder to a distinct path, then promote it again.
 - **Conflicts:** after a `conflict` row (the host's version changed), the file is held until it is
   resolved. `superbee sync --inspect --doc <key>` shows the recorded versions and MIME types.
   `superbee sync --resolve keep --doc <key>` keeps your file: the next sync sends it as it is over