superbee 0.4.4-pre.1 → 0.4.4-pre.2

package/dist/portable-export.mjs

@@ -3,6 +3,11 @@ import { createHash } from "node:crypto";
 import { mkdir, mkdtemp, realpath, rm, writeFile } from "node:fs/promises";
 import path from "node:path";
 
+// ../core/src/path-fold.ts
+function foldPath(path2) {
+  return path2.normalize("NFC").toLowerCase().toUpperCase().toLowerCase().normalize("NFC");
+}
+
 // ../core/src/errors.ts
 var InvalidInputError = class extends Error {
   constructor(message) {
@@ -175,7 +180,6 @@ function readStoredZip(archive) {
   return entries;
 }
 var WINDOWS_DEVICE_NAMES = /* @__PURE__ */ new Set(["CON", "PRN", "AUX", "NUL", ...Array.from({ length: 9 }, (_, i) => `COM${i + 1}`), ...Array.from({ length: 9 }, (_, i) => `LPT${i + 1}`)]);
-var fold = (segment) => segment.normalize("NFC").toLowerCase();
 function classifyEntryPath(entryPath) {
   const unsafe = (why) => new ExportArchiveError("unsafe_path", `the archive holds a path a bundle cannot keep (${why}): ${JSON.stringify(entryPath.slice(0, 200))}`);
   if (entryPath === "" || entryPath.length > 4096) throw unsafe("empty or too long");
@@ -209,13 +213,13 @@ function findEntryCollision(paths) {
   const dirs = /* @__PURE__ */ new Map();
   for (const entryPath of paths) {
     const segments = entryPath.split("/");
-    const key = segments.map(fold).join("/");
+    const key = segments.map(foldPath).join("/");
     const file = files.get(key) ?? dirs.get(key)?.by;
     if (file !== void 0) return [file, entryPath];
     files.set(key, entryPath);
     for (let depth = 1; depth < segments.length; depth += 1) {
       const spelling = segments.slice(0, depth).join("/");
-      const dirKey = segments.slice(0, depth).map(fold).join("/");
+      const dirKey = segments.slice(0, depth).map(foldPath).join("/");
       const asFile = files.get(dirKey);
       if (asFile !== void 0) return [asFile, entryPath];
       const seen = dirs.get(dirKey);

package/dist/publication-bridge.mjs

@@ -5440,6 +5440,11 @@ 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",
@@ -6328,7 +6333,7 @@ function compareByMeaningfulChange(a, b) {
   } else if (b.timestampMs !== null) {
     return 1;
   }
-  return a.id < b.id ? -1 : a.id > b.id ? 1 : 0;
+  return compareCodeUnits(a.id, b.id);
 }
 function sortByMeaningfulChange(rows, okfVersion) {
   return rows.map((row) => ({ row, key: meaningfulChangeOrderKey(row.id, row.frontmatter, okfVersion) })).sort((a, b) => compareByMeaningfulChange(a.key, b.key)).map(({ row }) => row);

package/dist/publication.mjs

@@ -33424,6 +33424,11 @@ 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",
@@ -43543,7 +43548,7 @@ function compareByMeaningfulChange(a, b) {
   } else if (b.timestampMs !== null) {
     return 1;
   }
-  return a.id < b.id ? -1 : a.id > b.id ? 1 : 0;
+  return compareCodeUnits(a.id, b.id);
 }
 function sortByMeaningfulChange(rows, okfVersion) {
   return rows.map((row) => ({ row, key: meaningfulChangeOrderKey(row.id, row.frontmatter, okfVersion) })).sort((a, b) => compareByMeaningfulChange(a.key, b.key)).map(({ row }) => row);

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.1" }, source: { commit: "6eb9c66ad2b6ba73122b5431ffe50a194c0e844f", 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.2" }, source: { commit: "008e00fa04d0ff726dfa3d6da80343cbcf230309", dirty: false }, artifact: { channel: "npm-package" }, compatibility_contracts: { skill: 1, hook: 1, mcp: 1 } };
   }
 });
 
@@ -9508,9 +9508,21 @@ 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) => a.id < b.id ? -1 : a.id > b.id ? 1 : 0);
+  return [...heads].sort((a, b) => compareCodeUnits(a.id, b.id));
 }
 function headsDigest(heads) {
   let input = "";
@@ -9528,6 +9540,7 @@ var init_heads_digest = __esm({
     "use strict";
     init_define_SUPERBEE_BUILD_IDENTITY();
     init_define_SUPERBEE_UPDATE_POLICY();
+    init_code_unit_order();
     init_sha256();
     HEADS_DIGEST_RE = /^sha256:[0-9a-f]{64}$/;
   }
@@ -12567,8 +12580,9 @@ function onceNow(now) {
 }
 function prepareDocumentMutationCandidate(existing, rawCandidate, opts) {
   const persistActor = resolvePersistActor(opts);
+  const mode = opts.mode ?? "patch";
   const decisionNow = onceNow(opts.now ?? (() => (/* @__PURE__ */ new Date()).toISOString()));
-  const comparison = withV02Metadata(
+  const withMetadata = withV02Metadata(
     structuredClone(rawCandidate),
     existing,
     opts.okfVersion,
@@ -12579,19 +12593,23 @@ function prepareDocumentMutationCandidate(existing, rawCandidate, opts) {
     opts.compareTimestamp ?? false,
     opts.producer
   );
-  assertDeprecation(opts.id, comparison, opts.registry, existing);
-  if (existing && isNoopMutation(
+  const comparison = mode === "overwrite" ? attributeCandidate(withMetadata, opts.actor, persistActor, opts.okfVersion, opts.registry) : withMetadata;
+  if (mode !== "create-only") assertDeprecation(opts.id, comparison, opts.registry, existing);
+  if (mode !== "create-only" && existing && isNoopMutation(
     existing,
     comparison,
     opts.compareTimestamp ?? false,
     opts.okfVersion,
-    opts.okfVersion === "0.2" && persistActor && opts.actor !== void 0,
+    (mode === "overwrite" || opts.okfVersion === "0.2") && persistActor && opts.actor !== void 0,
     opts.registry.kinds.get(String(comparison.frontmatter.type))?.fields.required.includes("actor") ?? false
   )) {
     return { candidate: { frontmatter: structuredClone(existing.frontmatter), body: existing.body }, changed: false, warnings: validateUnchangedDocument(existing, opts.registry, opts.strict, opts.okfVersion), guidance: [] };
   }
-  const candidate = attributeCandidate(comparison, opts.actor, persistActor, opts.okfVersion, opts.registry);
-  const { warnings } = validateCandidate(opts.id, candidate, opts.registry, opts.strict, opts.okfVersion, decisionNow, existing);
+  const candidate = mode === "overwrite" ? comparison : attributeCandidate(comparison, opts.actor, persistActor, opts.okfVersion, opts.registry);
+  const { warnings, kind: kind2 } = validateCandidate(opts.id, candidate, opts.registry, opts.strict, opts.okfVersion, decisionNow, existing);
+  if (mode === "overwrite" && !opts.strict && existing && warnings.length > 0 && conforms(existing, opts.registry)) {
+    throw new KindConformanceError(opts.id, kind2.governs, warnings, opts.okfVersion);
+  }
   return { candidate, changed: true, warnings, guidance: writeGuidance(opts.registry, opts.okfVersion, existing, candidate) };
 }
 function conforms(existing, registry2) {
@@ -12603,6 +12621,9 @@ function resolvePersistActor(opts) {
   return opts.persistActor ?? opts.actor !== void 0;
 }
 async function mutateDocument(opts) {
+  if (opts.expectedVersion !== void 0 && opts.mode !== "patch" && opts.mode !== "replace-document") {
+    throw new InvalidInputError("expectedVersion requires patch or replace-document mode.");
+  }
   opts = { ...opts, bundle: { ...opts.bundle, backend: backendFor(opts.bundle) } };
   if (opts.inventoryGuard !== void 0) {
     if (opts.mode !== "replace-document" || opts.onAbsent !== "fail" || typeof opts.expectedVersion !== "string" || opts.maxAttempts !== void 0 && opts.maxAttempts !== 1) {
@@ -12682,6 +12703,19 @@ async function mutateDocument(opts) {
     await opts.assertCandidate?.(existing === void 0 ? void 0 : structuredClone(existing), structuredClone(candidate), context3);
     return candidate;
   };
+  const prepare = async (existing, decisionNow) => prepareDocumentMutationCandidate(existing, await build2(existing, decisionNow), {
+    mode: opts.mode,
+    id: opts.id,
+    registry: opts.registry,
+    strict: opts.strict,
+    okfVersion,
+    now: decisionNow,
+    actor: opts.actor,
+    producer: opts.producer,
+    persistActor,
+    compareTimestamp,
+    seedGenerationClock: seedClock
+  });
   if (opts.mode === "create-only") {
     if (opts.preconditions !== void 0 && opts.preconditions.length > 0) {
       throw new InvalidInputError(
@@ -12689,25 +12723,7 @@ async function mutateDocument(opts) {
       );
     }
     const decisionNow = onceNow(now);
-    const withMetadata = withV02Metadata(
-      await build2(void 0, decisionNow),
-      void 0,
-      okfVersion,
-      opts.registry,
-      decisionNow,
-      seedClock,
-      opts.actor,
-      compareTimestamp,
-      opts.producer
-    );
-    const candidate = attributeCandidate(
-      withMetadata,
-      opts.actor,
-      persistActor,
-      okfVersion,
-      opts.registry
-    );
-    const { warnings } = validateCandidate(opts.id, candidate, opts.registry, opts.strict, okfVersion, decisionNow);
+    const { candidate, warnings } = await prepare(void 0, decisionNow);
     const { doc: doc2, version: version5 } = await writeDocVersionedForEdition2(opts.bundle, { id: opts.id, ...candidate }, okfVersion, {
       expectedVersion: null,
       actor: opts.actor,
@@ -12739,49 +12755,12 @@ async function mutateDocument(opts) {
         const decisionNow = onceNow(now);
         decidedExisting = existing;
         assertFieldPreconditions(opts.id, existing?.frontmatter, opts.preconditions, lastReadVersion);
-        const withMetadata = withV02Metadata(
-          await build2(existing, decisionNow),
-          existing,
-          okfVersion,
-          opts.registry,
-          decisionNow,
-          seedClock,
-          opts.actor,
-          compareTimestamp,
-          opts.producer
-        );
-        const candidate = attributeCandidate(
-          withMetadata,
-          opts.actor,
-          persistActor,
-          okfVersion,
-          opts.registry
-        );
-        assertDeprecation(opts.id, candidate, opts.registry, existing);
-        if (existing && isNoopMutation(
-          existing,
-          candidate,
-          compareTimestamp,
-          okfVersion,
-          persistActor && opts.actor !== void 0,
-          opts.registry.kinds.get(String(candidate.frontmatter.type))?.fields.required.includes("actor") ?? false
-        )) {
-          warnings = validateUnchangedDocument(existing, opts.registry, opts.strict, okfVersion);
+        const prepared2 = await prepare(existing, decisionNow);
+        const { candidate, changed } = prepared2;
+        warnings = prepared2.warnings;
+        if (!changed) {
           return { action: "done", result: { doc: existing } };
         }
-        const validated = validateCandidate(
-          opts.id,
-          candidate,
-          opts.registry,
-          opts.strict,
-          okfVersion,
-          decisionNow,
-          existing
-        );
-        warnings = validated.warnings;
-        if (!opts.strict && existing && warnings.length > 0 && conforms(existing, opts.registry)) {
-          throw new KindConformanceError(opts.id, validated.kind.governs, warnings, okfVersion);
-        }
         return { action: "write", next: { id: opts.id, ...candidate }, result: {} };
       },
       write: async (next, expectedVersion) => {
@@ -12811,19 +12790,7 @@ async function mutateDocument(opts) {
       if (hardCas && lastReadVersion !== opts.expectedVersion) {
         throw new VersionConflict(opts.id, opts.expectedVersion, lastReadVersion);
       }
-      const rawCandidate = await build2(existing, decisionNow);
-      const { candidate, changed, warnings, guidance } = prepareDocumentMutationCandidate(existing, rawCandidate, {
-        id: opts.id,
-        registry: opts.registry,
-        strict: opts.strict,
-        okfVersion,
-        now: decisionNow,
-        actor: opts.actor,
-        producer: opts.producer,
-        persistActor,
-        compareTimestamp,
-        seedGenerationClock: seedClock
-      });
+      const { candidate, changed, warnings, guidance } = await prepare(existing, decisionNow);
       if (!changed && opts.inventoryGuard) throw new InvalidInputError("Inventory-guarded replacement requires a meaningful change.");
       if (!changed) return { action: "done", result: { doc: existing, warnings, guidance } };
       return { action: "write", next: { id: opts.id, ...candidate }, result: { warnings, guidance } };
@@ -13387,6 +13354,18 @@ var init_code_point_order = __esm({
   }
 });
 
+// ../core/src/path-fold.ts
+function foldPath(path71) {
+  return path71.normalize("NFC").toLowerCase().toUpperCase().toLowerCase().normalize("NFC");
+}
+var init_path_fold = __esm({
+  "../core/src/path-fold.ts"() {
+    "use strict";
+    init_define_SUPERBEE_BUILD_IDENTITY();
+    init_define_SUPERBEE_UPDATE_POLICY();
+  }
+});
+
 // ../core/src/governed-body-write.ts
 function fail2(message) {
   throw new Error(`Invalid body delivery: ${message}`);
@@ -13917,6 +13896,7 @@ __export(src_exports, {
   claimCoordinates: () => claimCoordinates,
   collectLinkDeclarations: () => collectLinkDeclarations,
   compareCodePoints: () => compareCodePoints,
+  compareCodeUnits: () => compareCodeUnits,
   compareReadingOrder: () => compareReadingOrder,
   compareStorageKeys: () => compareStorageKeys,
   computeDroppedLinks: () => computeDroppedLinks,
@@ -13938,6 +13918,7 @@ __export(src_exports, {
   extensionOfDocKey: () => extensionOfDocKey,
   extractMarkdownLinks: () => extractMarkdownLinks,
   filesystemMutationLockPath: () => filesystemMutationLockPath,
+  foldPath: () => foldPath,
   freshness: () => freshness,
   freshnessHorizonMs: () => freshnessHorizonMs,
   guardBodyReplace: () => guardBodyReplace,
@@ -14112,6 +14093,8 @@ var init_src = __esm({
     init_kinds();
     init_kinds_load();
     init_code_point_order();
+    init_code_unit_order();
+    init_path_fold();
     init_content_type();
     init_okf_timestamps();
     init_okf_lifecycle();
@@ -23471,11 +23454,11 @@ var init_evolution = __esm({
 // ../core/src/recipe-set-preflight.ts
 function canonicalJson2(value) {
   if (Array.isArray(value)) {
-    const ordered = value.every((v) => record5(v) && typeof v.path === "string") ? [...value].sort((a, b) => compareCodeUnits(a.path, b.path)) : value;
+    const ordered = value.every((v) => record5(v) && typeof v.path === "string") ? [...value].sort((a, b) => compareCodeUnits2(a.path, b.path)) : value;
     return "[" + ordered.map(canonicalJson2).join(",") + "]";
   }
   if (record5(value)) {
-    return "{" + Object.keys(value).sort(compareCodeUnits).map((key4) => JSON.stringify(key4) + ":" + canonicalJson2(value[key4])).join(",") + "}";
+    return "{" + Object.keys(value).sort(compareCodeUnits2).map((key4) => JSON.stringify(key4) + ":" + canonicalJson2(value[key4])).join(",") + "}";
   }
   return JSON.stringify(value);
 }
@@ -23648,7 +23631,7 @@ async function preflightRecipeSet(value) {
     malformed6 = ["input"];
   }
   if (malformed6.length)
-    return { schema: "recipe-set-preflight-result/v1", verdict: "refused", structuralComplete: false, scope: "declared-structural-input-only", digestScheme: RECIPE_PREFLIGHT_DIGEST_SCHEME, inputs: { selected: [], consumers: [], observations: [], placementInventories: [] }, externalConsumers: "unknown-out-of-scope", issues: malformed6.sort(compareCodeUnits).map((at) => ({ level: "refused", code: "INPUT_SHAPE", at })), parserWarnings: [] };
+    return { schema: "recipe-set-preflight-result/v1", verdict: "refused", structuralComplete: false, scope: "declared-structural-input-only", digestScheme: RECIPE_PREFLIGHT_DIGEST_SCHEME, inputs: { selected: [], consumers: [], observations: [], placementInventories: [] }, externalConsumers: "unknown-out-of-scope", issues: malformed6.sort(compareCodeUnits2).map((at) => ({ level: "refused", code: "INPUT_SHAPE", at })), parserWarnings: [] };
   const input = value;
   const issues = [], parserWarnings = [];
   const recipes2 = /* @__PURE__ */ new Map();
@@ -23865,7 +23848,7 @@ async function preflightRecipeSet(value) {
     const c = input.consumers.find((x) => x.id === consumer);
     const requirements = c?.requirements?.filter((r) => r.provider === provider && r.kind === kind2) ?? [];
     const targets = requirements.flatMap((r) => endpoint2(consumer, r.id)).map((e) => e.placement === "local" ? kind2 : `${e.alias}:${kind2}`);
-    return [...new Set(targets)].sort(compareCodeUnits);
+    return [...new Set(targets)].sort(compareCodeUnits2);
   };
   for (const s of input.selected)
     if (s.role === "extension" && !input.consumers.some((c) => c.owner === s.key))
@@ -23948,11 +23931,11 @@ async function preflightRecipeSet(value) {
     if (!c?.requirements?.some((r) => r.id === e.requirement))
       issue2("refused", "ORPHAN_ENDPOINT", e.id);
   }
-  const dedup = [...new Map(issues.map((i) => [JSON.stringify(i), i])).values()].sort((a, b) => compareCodeUnits(JSON.stringify(a), JSON.stringify(b)));
+  const dedup = [...new Map(issues.map((i) => [JSON.stringify(i), i])).values()].sort((a, b) => compareCodeUnits2(JSON.stringify(a), JSON.stringify(b)));
   const verdict = dedup.some((i) => i.level === "refused") ? "refused" : dedup.length ? "partial" : "valid";
-  return { schema: "recipe-set-preflight-result/v1", verdict, structuralComplete: verdict === "valid", scope: "declared-structural-input-only", digestScheme: "fixture-envelope-v1/utf16-code-unit-sorted-keys-and-file-paths/sha256", inputs: { selected: input.selected.map(({ key: key4, publisher, recipeId, release: release2, artifactDigest }) => ({ key: key4, publisher, recipeId, release: release2, artifactDigest })), consumers: input.consumers.map(({ id, descriptorDigest }) => ({ id, descriptorDigest })), observations: input.observations.map(({ id, observedVersion }) => ({ id, ...observedVersion ? { observedVersion } : {} })), placementInventories: (input.placementInventories ?? []).map(({ id, observedVersion }) => ({ id, ...observedVersion ? { observedVersion } : {} })) }, externalConsumers: "unknown-out-of-scope", issues: dedup, parserWarnings: parserWarnings.sort((a, b) => compareCodeUnits(JSON.stringify(a), JSON.stringify(b))) };
+  return { schema: "recipe-set-preflight-result/v1", verdict, structuralComplete: verdict === "valid", scope: "declared-structural-input-only", digestScheme: "fixture-envelope-v1/utf16-code-unit-sorted-keys-and-file-paths/sha256", inputs: { selected: input.selected.map(({ key: key4, publisher, recipeId, release: release2, artifactDigest }) => ({ key: key4, publisher, recipeId, release: release2, artifactDigest })), consumers: input.consumers.map(({ id, descriptorDigest }) => ({ id, descriptorDigest })), observations: input.observations.map(({ id, observedVersion }) => ({ id, ...observedVersion ? { observedVersion } : {} })), placementInventories: (input.placementInventories ?? []).map(({ id, observedVersion }) => ({ id, ...observedVersion ? { observedVersion } : {} })) }, externalConsumers: "unknown-out-of-scope", issues: dedup, parserWarnings: parserWarnings.sort((a, b) => compareCodeUnits2(JSON.stringify(a), JSON.stringify(b))) };
 }
-var RECIPE_PREFLIGHT_DIGEST_SCHEME, MALFORMED_MODEL_DIAGNOSTICS, modelDiagnosticLevel, compareCodeUnits, text, pin, strings;
+var RECIPE_PREFLIGHT_DIGEST_SCHEME, MALFORMED_MODEL_DIAGNOSTICS, modelDiagnosticLevel, compareCodeUnits2, text, pin, strings;
 var init_recipe_set_preflight = __esm({
   "../core/src/recipe-set-preflight.ts"() {
     "use strict";
@@ -23985,7 +23968,7 @@ var init_recipe_set_preflight = __esm({
       "OKF_WORKFLOW_STATUS_COLLISION"
     ]);
     modelDiagnosticLevel = (code3) => MALFORMED_MODEL_DIAGNOSTICS.has(code3) ? "refused" : "partial";
-    compareCodeUnits = (a, b) => a < b ? -1 : a > b ? 1 : 0;
+    compareCodeUnits2 = (a, b) => a < b ? -1 : a > b ? 1 : 0;
     text = (v) => typeof v === "string" && v.trim().length > 0;
     pin = (v) => typeof v === "string" && /^sha256:[0-9a-f]{64}$/.test(v);
     strings = (v) => Array.isArray(v) && v.every(text);
@@ -27497,7 +27480,7 @@ var init_command_spec = __esm({
           {
             id: "docDelete",
             leaves: [publicLeaf("docDelete", "doc delete", one, void 0, DIR_SURFACE)],
-            usage: "doc delete <id> [--expected-version <v>] [--dir <path>] [--remote <url>]",
+            usage: "doc delete <id> [--expected-version <v>] [--actor <name>] [--dir <path>] [--remote <url>]",
             summary: "Hard-delete a doc (idempotent: absent -> deleted:false, exit 0)"
           },
           {
@@ -27554,7 +27537,7 @@ var init_command_spec = __esm({
           {
             id: "delete",
             leaves: [publicLeaf("delete", "delete", zero, 8, DIR_SURFACE)],
-            usage: "delete --doc-key <key> [--expected-version <v>] [--dir <path>] [--remote <url>]",
+            usage: "delete --doc-key <key> [--expected-version <v>] [--actor <name>] [--dir <path>] [--remote <url>]",
             summary: "Hard-delete a doc or blob by key (outside a hosted checkout, idempotent: absent -> deleted:false, exit 0). Hosted ordinary files require clean preserved version+MIME pins and frozen exact-request delivery; they may remain incomplete"
           }
         ]
@@ -31366,7 +31349,7 @@ var init_source_profiles = __esm({
         };
       }
     });
-    SOURCE_PLUGIN_CORE_VERSION = "0.2.0-pre.36";
+    SOURCE_PLUGIN_CORE_VERSION = "0.2.0-pre.37";
     SOURCE_PROFILES = Object.freeze([restJsonProfile].map((profile) => Object.freeze({ id: profile.id, version: profile.version, kind: profile.kind })));
   }
 });
@@ -32413,6 +32396,8 @@ stops resolving on the next graph walk) and does NOT append a log.md entry.
 Options:
   --expected-version <v>  Compare-and-swap token from a prior read/write receipt (a stale token is a
                           CONFLICT, exit 5; omit for an unconditional delete)
+  --actor <name>          Advisory board attribution (flag > actor environment). v0.2 requires an
+                          OKF actor; invalid configured attribution refuses before deletion.
 ${COMMON_OPTIONS}
 
 Examples:
@@ -32548,6 +32533,20 @@ async function firePostPersist(hook2) {
   } catch {
   }
 }
+async function deleteMutatedDoc(opts) {
+  try {
+    const deleted = await deleteDoc2(
+      opts.bundle,
+      opts.id,
+      opts.expectedVersion === void 0 ? void 0 : { expectedVersion: opts.expectedVersion }
+    );
+    if (deleted) await firePostPersist(opts.onPersisted);
+    return deleted;
+  } catch (error51) {
+    if (error51 instanceof VersionConflict) throw opts.staleHead(error51);
+    throw classifyBundleError(error51, opts.remoteUrl);
+  }
+}
 async function docExistsForMode(bundle, id, mode) {
   if (mode === "patch") return true;
   if (mode === "create-only") return false;
@@ -38885,13 +38884,13 @@ function findEntryCollision(paths) {
   const dirs = /* @__PURE__ */ new Map();
   for (const entryPath of paths) {
     const segments = entryPath.split("/");
-    const key4 = segments.map(fold3).join("/");
+    const key4 = segments.map(foldPath).join("/");
     const file2 = files.get(key4) ?? dirs.get(key4)?.by;
     if (file2 !== void 0) return [file2, entryPath];
     files.set(key4, entryPath);
     for (let depth2 = 1; depth2 < segments.length; depth2 += 1) {
       const spelling = segments.slice(0, depth2).join("/");
-      const dirKey = segments.slice(0, depth2).map(fold3).join("/");
+      const dirKey = segments.slice(0, depth2).map(foldPath).join("/");
       const asFile = files.get(dirKey);
       if (asFile !== void 0) return [asFile, entryPath];
       const seen = dirs.get(dirKey);
@@ -39050,12 +39049,13 @@ function exportProvenance(verified3) {
     manifests: state.provenance.manifests.map((manifest2) => ({ ...manifest2 }))
   };
 }
-var EXPORT_MANIFEST, EXPORT_FORMAT, MAX_EXPORT_ENTRIES, MAX_EXPORT_BYTES, LOCAL, CENTRAL, END, UTF8_NAMES, ExportArchiveError, CRC_TABLE, sha256Hex2, utf8, WINDOWS_DEVICE_NAMES, fold3, ExportPageChain, verifiedStates;
+var EXPORT_MANIFEST, EXPORT_FORMAT, MAX_EXPORT_ENTRIES, MAX_EXPORT_BYTES, LOCAL, CENTRAL, END, UTF8_NAMES, ExportArchiveError, CRC_TABLE, sha256Hex2, utf8, WINDOWS_DEVICE_NAMES, ExportPageChain, verifiedStates;
 var init_portable_export = __esm({
   "../core/src/portable-export.ts"() {
     "use strict";
     init_define_SUPERBEE_BUILD_IDENTITY();
     init_define_SUPERBEE_UPDATE_POLICY();
+    init_path_fold();
     init_paths();
     EXPORT_MANIFEST = "superbee-export.json";
     EXPORT_FORMAT = "superbee-export/1";
@@ -39085,7 +39085,6 @@ var init_portable_export = __esm({
     sha256Hex2 = (bytes2) => createHash8("sha256").update(bytes2).digest("hex");
     utf8 = new TextDecoder("utf-8", { fatal: true, ignoreBOM: true });
     WINDOWS_DEVICE_NAMES = /* @__PURE__ */ new Set(["CON", "PRN", "AUX", "NUL", ...Array.from({ length: 9 }, (_, i) => `COM${i + 1}`), ...Array.from({ length: 9 }, (_, i) => `LPT${i + 1}`)]);
-    fold3 = (segment) => segment.normalize("NFC").toLowerCase();
     ExportPageChain = class {
       #pages = [];
       #from = 0;
@@ -39277,7 +39276,7 @@ async function replaceGuarded(file2, expected, next) {
   await syncDir(path21.dirname(file2));
   return { placed: true };
 }
-function fold4(segment) {
+function fold3(segment) {
   return segment.normalize("NFKD").toLowerCase().toUpperCase().toLowerCase();
 }
 async function projectionPathExact(folder, rel) {
@@ -39296,7 +39295,7 @@ function findFilePathCollision(files) {
     const segments = file2.split("/");
     for (let depth2 = 1; depth2 <= segments.length; depth2 += 1) {
       const spelling = segments.slice(0, depth2).join("/") + (depth2 < segments.length ? "/" : "");
-      const key4 = segments.slice(0, depth2).map(fold4).join("/");
+      const key4 = segments.slice(0, depth2).map(fold3).join("/");
       const seen = spelled.get(key4);
       if (seen !== void 0 && seen !== spelling) return { first: seen, second: spelling };
       spelled.set(key4, spelling);
@@ -48903,7 +48902,7 @@ function sameAsStored(bytes2, id, doc2, okfVersion) {
   }
 }
 function foldedPath(id) {
-  return id.split("/").map(fold4).join("/");
+  return id.split("/").map(fold3).join("/");
 }
 function documentInputBound(stated) {
   return stated ?? WHOLE_DOCUMENT_BOUNDS.payloadBytes;
@@ -54821,12 +54820,12 @@ async function caseCollidingCreates(store) {
   if (creates.length === 0) return [];
   const byFold = /* @__PURE__ */ new Map();
   for (const id of await store.readHeads({ project: (head2) => head2.id })) {
-    const key4 = id.split("/").map(fold4).join("/");
+    const key4 = id.split("/").map(fold3).join("/");
     byFold.set(key4, [...byFold.get(key4) ?? [], id]);
   }
   const out = [];
   for (const row5 of creates) {
-    const twin = byFold.get(row5.target.split("/").map(fold4).join("/"))?.find((id) => id !== row5.target);
+    const twin = byFold.get(row5.target.split("/").map(fold3).join("/"))?.find((id) => id !== row5.target);
     if (twin !== void 0) {
       out.push({ id: row5.target, path: `${row5.target}.md`, reason: "case_collision", message: `'${row5.target}' differs only in letter case from the host's '${twin}', which a case-insensitive disk treats as the same file; rename your file` });
     }
@@ -95245,6 +95244,7 @@ async function docDelete(argv2, deps2) {
       args: argv2,
       options: {
         "expected-version": { type: "string" },
+        actor: { type: "string" },
         dir: { type: "string" },
         remote: { type: "string" },
         json: { type: "boolean" },
@@ -95280,7 +95280,10 @@ async function docDelete(argv2, deps2) {
       { help: `${cliInvocation()} doc delete ${commandToken(id)} --expected-version <v>` }
     );
   }
-  const bundle = await openBundle(values.dir, await resolveRemoteFlag(values.remote, values.dir));
+  const remote = await resolveRemoteFlag(values.remote, values.dir);
+  const route = remote === void 0 ? await resolveLocalBundleRoute(values.dir) : void 0;
+  const bundle = route?.bundle ?? await openBundle(values.dir, remote);
+  if (route) await assertResolvedLocalRouteIdentity(route);
   id = await resolveConceptIdCliArgument(bundle, rawId);
   if (isReservedFile(pathFromConceptId(id))) {
     throw new CliError(
@@ -95291,22 +95294,29 @@ async function docDelete(argv2, deps2) {
   }
   const mode = resolveMode(values);
   const expectedVersion = rawExpected?.trim();
-  let deleted;
+  const actor = resolveActor(values.actor, { help: `${cliInvocation()} doc delete ${commandToken(id)} --actor <name>` });
   try {
-    deleted = await deleteDoc2(bundle, id, expectedVersion ? { expectedVersion } : void 0);
-  } catch (err) {
-    if (err instanceof VersionConflict) {
-      throw new CliError(
-        "STALE_HEAD",
-        `'${id}' has moved since --expected-version ${commandToken(String(err.expected))} was read (current: ${err.actual ?? "absent"}) \u2014 re-read and retry with the current version.`,
-        {
-          help: `${cliInvocation()} doc read ${commandToken(id)}`,
-          details: { expected: err.expected, actual: err.actual }
-        }
-      );
-    }
-    throw classifyBundleError(err, values.remote);
+    await assertActorAcceptedByBundle(bundle, actor);
+  } catch (error51) {
+    throw classifyBundleError(error51, values.remote);
   }
+  const onPersisted = boardPostPersistHook(route ? boardAttributionForRoute(route) : { kind: "none" }, actor);
+  if (route) await assertResolvedLocalRouteIdentity(route);
+  const deleted = await deleteMutatedDoc({
+    bundle,
+    id,
+    expectedVersion,
+    remoteUrl: values.remote,
+    onPersisted,
+    staleHead: (err) => new CliError(
+      "STALE_HEAD",
+      `'${id}' has moved since --expected-version ${commandToken(String(err.expected))} was read (current: ${err.actual ?? "absent"}) \u2014 re-read and retry with the current version.`,
+      {
+        help: `${cliInvocation()} doc read ${commandToken(id)}`,
+        details: { expected: err.expected, actual: err.actual }
+      }
+    )
+  });
   const receipt5 = { doc: "deleted", id, deleted };
   receipt5.help = [`${cliInvocation()} list`];
   stdout(render(receipt5, mode));
@@ -95320,6 +95330,9 @@ var init_delete = __esm({
     init_src();
     init_bundle2();
     init_errors6();
+    init_actor();
+    init_board_attribution();
+    init_mutate();
     init_args();
     init_command_spec();
     init_output2();
@@ -97556,7 +97569,7 @@ function compareByMeaningfulChange(a, b) {
   } else if (b.timestampMs !== null) {
     return 1;
   }
-  return a.id < b.id ? -1 : a.id > b.id ? 1 : 0;
+  return compareCodeUnits(a.id, b.id);
 }
 function sortByMeaningfulChange(rows, okfVersion) {
   return rows.map((row5) => ({ row: row5, key: meaningfulChangeOrderKey(row5.id, row5.frontmatter, okfVersion) })).sort((a, b) => compareByMeaningfulChange(a.key, b.key)).map(({ row: row5 }) => row5);
@@ -97566,6 +97579,7 @@ var init_query_order = __esm({
     "use strict";
     init_define_SUPERBEE_BUILD_IDENTITY();
     init_define_SUPERBEE_UPDATE_POLICY();
+    init_code_unit_order();
     init_freshness();
     init_meaningful_change_time();
   }
@@ -101922,6 +101936,7 @@ async function deleteCommand(argv2, deps2 = {}) {
       options: {
         "doc-key": { type: "string" },
         "expected-version": { type: "string" },
+        actor: { type: "string" },
         dir: { type: "string" },
         remote: { type: "string" },
         json: { type: "boolean" },
@@ -101961,16 +101976,29 @@ async function deleteCommand(argv2, deps2 = {}) {
       return;
     }
   }
-  const bundle = await openBundle(values.dir, remote);
+  const docRoute = isDocRouteKey3(key4);
+  const route = docRoute && remote === void 0 ? await resolveLocalBundleRoute(values.dir) : void 0;
+  const bundle = route?.bundle ?? await openBundle(values.dir, remote);
+  if (route) await assertResolvedLocalRouteIdentity(route);
   const mode = resolveMode(values);
   const expectedVersion = rawExpected?.trim();
-  const docRoute = isDocRouteKey3(key4);
   let deleted;
   try {
     if (docRoute) {
       const canonicalPath = key4.slice(0, -3) + ".md";
       const id = conceptIdFromPath(canonicalPath);
-      deleted = await deleteDoc2(bundle, id, expectedVersion ? { expectedVersion } : void 0);
+      const actor = resolveActor(values.actor, { help: `${cliInvocation()} delete --doc-key ${commandToken(key4)} --actor <name>` });
+      await assertActorAcceptedByBundle(bundle, actor);
+      const onPersisted = boardPostPersistHook(route ? boardAttributionForRoute(route) : { kind: "none" }, actor);
+      if (route) await assertResolvedLocalRouteIdentity(route);
+      deleted = await deleteMutatedDoc({
+        bundle,
+        id,
+        expectedVersion,
+        remoteUrl: values.remote,
+        onPersisted,
+        staleHead: (error51) => deleteErrorToCliError(error51, key4, values.remote)
+      });
     } else {
       deleted = await deleteBlob2(bundle, key4, expectedVersion ? { expectedVersion } : void 0);
     }
@@ -102011,6 +102039,9 @@ var init_delete2 = __esm({
     init_output2();
     init_src();
     init_bundle2();
+    init_actor();
+    init_board_attribution();
+    init_mutate();
     init_errors6();
     init_args();
     init_command_spec();
@@ -102048,6 +102079,8 @@ Options:
   --expected-version <v>   Compare-and-swap token from a prior read/write/pull receipt (a stale
                             token is a CONFLICT, exit 5; outside a hosted checkout omit for an
                             unconditional delete; hosted blobs always use preserved version+MIME pins)
+  --actor <name>            Document route only: advisory board attribution (flag > actor environment).
+                            v0.2 requires an OKF actor; blob deletion ignores this option/environment.
   --dir <path>              Bundle directory (default: discovered from the cwd)
   --remote <url>            Talk to a wire-protocol server instead of a local bundle (mutually
                             exclusive with --dir; remote access is always explicit)
@@ -154051,7 +154084,7 @@ async function planPublish(folder, options) {
   } else {
     const claimed = /* @__PURE__ */ new Map();
     for (const file2 of [...documents.map((doc2) => `${doc2.id}.md`), ...reserved.map((r) => r.dir === "" ? r.name : `${r.dir}/${r.name}`), ...blobs2.map((b) => b.key)]) {
-      const key4 = file2.split("/").map(fold4).join("/");
+      const key4 = file2.split("/").map(fold3).join("/");
       const other = claimed.get(key4);
       if (other !== void 0) {
         blockers.push({ path: file2, reason: "path_collision", message: `'${other}' and '${file2}' would be one file on a case-insensitive disk` });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "superbee",
-  "version": "0.4.4-pre.1",
+  "version": "0.4.4-pre.2",
   "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": [