superbee 0.4.4-pre.7 → 0.4.4-pre.8

package/dist/publication/index.d.ts

@@ -7,4 +7,7 @@ export { PUBLICATION_BRIDGE_V0, PUBLICATION_SNAPSHOT_V1, type CapturePublication
 export type { CapturePublicationRuntimeOptions } from "./capture.js";
 export { assertPublicationSourceExclusions } from "./source-exclusions.js";
 export type { PublicationSourceInventory, PublicationSourceExclusions } from "./source-exclusions.js";
+export { parseSiteManifestDoc, isSiteLabel, SITE_LABEL, SITE_TYPE, SITES_PREFIX, SITE_DOCUMENT_KEYS } from "./site-manifest-core.js";
+export type { SiteManifest, SiteManifestError, SiteManifestParseResult, SitePresentationReference } from "./site-manifest-core.js";
+export { readPublicationSiteManifest } from "./site-manifest.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/publication/site-manifest-core.d.ts

@@ -0,0 +1,49 @@
+export declare const SITE_TYPE = "Site";
+export declare const SITES_PREFIX = "sites/";
+/** One site label leaves room for its workspace label in a combined DNS name. */
+export declare const SITE_LABEL: RegExp;
+export declare const isSiteLabel: (value: unknown) => value is string;
+export declare const SITE_DOCUMENT_KEYS: readonly ["type", "title", "description", "presentation", "landing", "views", "audience", "capabilities", "options", "brand"];
+export type SitePresentationReference = {
+    readonly kind: "package";
+    readonly name: string;
+    readonly version: string;
+} | {
+    readonly kind: "repository";
+    readonly repository: string;
+};
+export interface SiteManifest {
+    readonly id: string;
+    readonly site: string;
+    readonly title: string;
+    readonly description?: string;
+    readonly presentation: SitePresentationReference;
+    readonly landing?: string;
+    readonly views: readonly string[];
+    readonly audience: "restricted";
+    readonly capabilities: readonly string[];
+    readonly options: Readonly<Record<string, unknown>>;
+    readonly brand?: {
+        readonly logo?: string;
+        readonly fonts?: readonly string[];
+    };
+}
+export interface SiteManifestError {
+    readonly code: "SITE_MANIFEST_INVALID";
+    readonly path: string;
+    readonly message: string;
+}
+export type SiteManifestParseResult = {
+    readonly ok: true;
+    readonly manifest: SiteManifest;
+} | {
+    readonly ok: false;
+    readonly errors: readonly SiteManifestError[];
+};
+/** Standard OKF and managed metadata survive on the document; only Site fields enter this value.
+ * Presentation owners validate option semantics. Builders separately admit trusted resolved code. */
+export declare function parseSiteManifestDoc(doc: {
+    readonly id: string;
+    readonly frontmatter: Readonly<Record<string, unknown>>;
+}): SiteManifestParseResult;
+//# sourceMappingURL=site-manifest.d.ts.map

package/dist/publication/site-manifest-entry.d.ts

@@ -0,0 +1,5 @@
+/** Portable declaration surface, with no filesystem capture or credential handling. */
+export { parseSiteManifestDoc, isSiteLabel, SITE_LABEL, SITE_TYPE, SITES_PREFIX, SITE_DOCUMENT_KEYS } from "./site-manifest-core.js";
+export type { SiteManifest, SiteManifestError, SiteManifestParseResult, SitePresentationReference } from "./site-manifest-core.js";
+export { readPublicationSiteManifest } from "./site-manifest.js";
+//# sourceMappingURL=site-manifest-entry.d.ts.map

package/dist/publication/site-manifest.d.ts

@@ -0,0 +1,5 @@
+import { type SiteManifestParseResult } from "./site-manifest-core.js";
+import type { PublicationSnapshotV1 } from "./types.js";
+/** Resolve only declarations and references in the frozen publication. This never resolves code. */
+export declare function readPublicationSiteManifest(snapshot: Pick<PublicationSnapshotV1, "documents" | "views" | "blobs">, site: string): SiteManifestParseResult;
+//# sourceMappingURL=site-manifest.d.ts.map

package/dist/publication-site-manifest.mjs

@@ -0,0 +1,212 @@
+// ../core/src/errors.ts
+var InvalidInputError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "InvalidInputError";
+  }
+};
+
+// ../core/src/paths.ts
+function assertPortablePath(value, label) {
+  if (/[\u0000-\u001f\u007f]/u.test(value) || /^[a-z]:/i.test(value)) {
+    throw new InvalidInputError(`${label} must not contain controls or start with a drive prefix.`);
+  }
+  if (value.includes("\\") || value.split("/").some((segment) => segment === "" || segment === "." || segment === "..")) {
+    throw new InvalidInputError(`${label} must be canonical and bundle-relative.`);
+  }
+}
+function assertSafeConceptId(id) {
+  if (typeof id !== "string" || id.trim() === "") {
+    throw new InvalidInputError("Concept id must be a non-empty string.");
+  }
+  assertPortablePath(id, "Concept id");
+  const segments = id.split("/");
+  if (segments.slice(0, -1).some((seg) => seg.toLowerCase().endsWith(".md"))) {
+    throw new InvalidInputError(
+      `Concept id must not contain a non-final segment ending in '.md': '${id}' (it collides with a concept file at that path).`
+    );
+  }
+}
+var FORMAT_AT_EDGE = /^\p{Cf}|\p{Cf}$/u;
+var FORMAT_INSIDE = /(?![\u200c\u200d])\p{Cf}/u;
+function nonCanonicalDocumentId(id) {
+  const segments = id.split("/");
+  if (segments.some((segment) => segment !== segment.trim())) return "segment_whitespace";
+  if (segments.some((segment) => FORMAT_AT_EDGE.test(segment) || FORMAT_INSIDE.test(segment))) return "format_character";
+  if (id !== id.normalize("NFC")) return "not_nfc";
+  return null;
+}
+function assertSafeBlobKey(key) {
+  if (typeof key !== "string" || key.trim() === "") {
+    throw new InvalidInputError("Blob key must be a non-empty string.");
+  }
+  assertPortablePath(key, "Blob key");
+  const segments = key.split("/");
+  if (segments.some((seg) => seg.startsWith("."))) {
+    throw new InvalidInputError(`Blob key must not contain dot-prefixed segments: '${key}'.`);
+  }
+  if (segments.some((seg) => seg.toLowerCase().endsWith(".md"))) {
+    throw new InvalidInputError(
+      `Blob key '${key}' has a path segment ending in '.md' (checked case-insensitively, at any depth), which collides with the concept-document namespace \u2014 write it as a doc instead.`
+    );
+  }
+}
+
+// ../core/src/json-data.ts
+function isJsonData(value, depth = 0) {
+  if (depth > 32) return false;
+  if (value === null || typeof value === "string" || typeof value === "boolean") return true;
+  if (typeof value === "number") return Number.isFinite(value);
+  if (Array.isArray(value)) return value.every((item) => isJsonData(item, depth + 1));
+  if (value === null || typeof value !== "object") return false;
+  const proto = Object.getPrototypeOf(value);
+  if (proto !== null && Object.getPrototypeOf(proto) !== null) return false;
+  return Object.values(value).every((item) => item !== void 0 && isJsonData(item, depth + 1));
+}
+
+// ../core/src/okf-standard-fields.ts
+var OKF_STANDARD_FIELD_NAMES = ["type", "title", "description", "resource", "tags", "status", "sources", "generated", "verified", "stale_after", "usage_window", "runtime", "computation", "parameters", "executor", "attester", "okf_version"];
+function isOkfStandardField(field) {
+  return OKF_STANDARD_FIELD_NAMES.includes(field);
+}
+
+// ../core/src/managed-document-metadata.ts
+var MANAGED_DOCUMENT_METADATA_FIELDS = /* @__PURE__ */ new Set([
+  "generated",
+  "verified",
+  "superbee_updated_by",
+  "actor",
+  "timestamp"
+]);
+function isManagedDocumentMetadataField(field) {
+  return MANAGED_DOCUMENT_METADATA_FIELDS.has(field);
+}
+
+// ../core/src/site-manifest.ts
+var SITE_TYPE = "Site";
+var SITES_PREFIX = "sites/";
+var SITE_LABEL = /^[a-z][a-z0-9-]{1,30}[a-z0-9]$/;
+var isSiteLabel = (value) => typeof value === "string" && SITE_LABEL.test(value) && !value.includes("--");
+var SITE_DOCUMENT_KEYS = ["type", "title", "description", "presentation", "landing", "views", "audience", "capabilities", "options", "brand"];
+var record = (v) => v !== null && typeof v === "object" && !Array.isArray(v);
+var packageName = /^(?:@[a-z0-9][a-z0-9._-]*\/)?[a-z0-9][a-z0-9._-]*$/;
+var exactVersion = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-([0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?(?:\+([0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?$/;
+var encoder = new TextEncoder();
+function presentationReference(raw) {
+  if (typeof raw !== "string" || raw.length > 512) return void 0;
+  if (raw.startsWith("repo:")) {
+    const repository = raw.slice(5);
+    return /^[A-Za-z0-9][A-Za-z0-9-]{0,38}\/[A-Za-z0-9][A-Za-z0-9._-]{0,99}$/.test(repository) && !repository.endsWith(".git") ? { kind: "repository", repository } : void 0;
+  }
+  const at = raw.lastIndexOf("@");
+  if (at < 1) return void 0;
+  const name = raw.slice(0, at), version = raw.slice(at + 1), match = exactVersion.exec(version);
+  if (name.length > 214 || !packageName.test(name) || !match || !match.slice(1, 4).every((part) => Number.isSafeInteger(Number(part))) || match[4]?.split(".").some((part) => /^\d+$/.test(part) && (part.length > 1 && part.startsWith("0") || !Number.isSafeInteger(Number(part))))) return void 0;
+  return { kind: "package", name, version };
+}
+var concept = (raw) => {
+  if (typeof raw !== "string") return false;
+  try {
+    assertSafeConceptId(raw);
+    return nonCanonicalDocumentId(raw) === null;
+  } catch {
+    return false;
+  }
+};
+var blob = (raw) => {
+  if (typeof raw !== "string") return false;
+  try {
+    assertSafeBlobKey(raw);
+    return true;
+  } catch {
+    return false;
+  }
+};
+function parseSiteManifestDoc(doc) {
+  const errors = [];
+  const fail = (path, message) => {
+    errors.push({ code: "SITE_MANIFEST_INVALID", path, message });
+  };
+  const fm = record(doc?.frontmatter) ? doc.frontmatter : {};
+  const site = typeof doc?.id === "string" && doc.id.startsWith(SITES_PREFIX) ? doc.id.slice(SITES_PREFIX.length) : "";
+  if (!isSiteLabel(site)) fail("/id", "a Site lives at sites/<site>, using one site label");
+  if (fm.type !== SITE_TYPE) fail("/type", "type must be Site");
+  if (Object.keys(fm).some((key) => !SITE_DOCUMENT_KEYS.includes(key) && !isOkfStandardField(key) && !isManagedDocumentMetadataField(key)))
+    fail("", "unrecognized Site fields");
+  if (typeof fm.title !== "string" || fm.title.trim() === "" || encoder.encode(fm.title).byteLength > 512)
+    fail("/title", "title must be a nonempty string of at most 512 bytes");
+  if (fm.description !== void 0 && (typeof fm.description !== "string" || encoder.encode(fm.description).byteLength > 8192))
+    fail("/description", "description must be a string of at most 8192 bytes");
+  const presentation = presentationReference(fm.presentation);
+  if (!presentation) fail("/presentation", "presentation must name an exact npm version or repo:owner/name");
+  if (fm.audience !== "restricted") fail("/audience", "only the restricted audience is supported");
+  const list = (raw, path, maximum, valid) => {
+    if (!Array.isArray(raw) || raw.length > maximum || !raw.every(valid) || new Set(raw).size !== raw.length) {
+      fail(path, "expected a bounded list of unique valid references");
+      return [];
+    }
+    return [...raw];
+  };
+  const views = list(fm.views, "/views", 64, concept);
+  const capability = (v) => typeof v === "string" && /^[a-z][a-z0-9-]{0,63}$/.test(v);
+  const capabilities = list(fm.capabilities ?? [], "/capabilities", 16, capability);
+  if (fm.landing !== void 0 && !concept(fm.landing)) fail("/landing", "landing must be a canonical document or View id");
+  const options = fm.options ?? {};
+  if (!record(options) || !isJsonData(options) || encoder.encode(JSON.stringify(options)).byteLength > 16384)
+    fail("/options", "options must be JSON data of at most 16384 bytes");
+  let brand;
+  if (fm.brand !== void 0) {
+    if (!record(fm.brand) || Object.keys(fm.brand).some((key) => key !== "logo" && key !== "fonts")) fail("/brand", "brand may only name a logo and fonts");
+    else {
+      if (fm.brand.logo !== void 0 && !blob(fm.brand.logo)) fail("/brand/logo", "logo must be a bundle blob reference");
+      const fonts = fm.brand.fonts === void 0 ? void 0 : list(fm.brand.fonts, "/brand/fonts", 16, blob);
+      brand = { ...typeof fm.brand.logo === "string" ? { logo: fm.brand.logo } : {}, ...fonts ? { fonts } : {} };
+    }
+  }
+  if (errors.length) return { ok: false, errors };
+  return { ok: true, manifest: {
+    id: doc.id,
+    site,
+    title: fm.title,
+    presentation,
+    audience: "restricted",
+    views,
+    capabilities,
+    options: JSON.parse(JSON.stringify(options)),
+    ...fm.description === void 0 ? {} : { description: fm.description },
+    ...fm.landing === void 0 ? {} : { landing: fm.landing },
+    ...brand ? { brand } : {}
+  } };
+}
+
+// ../publication/src/site-manifest.ts
+function readPublicationSiteManifest(snapshot, site) {
+  const declarations = snapshot.documents.filter((doc) => doc.frontmatter.type === SITE_TYPE);
+  if (declarations.length !== 1 || declarations[0].id !== `${SITES_PREFIX}${site}`)
+    return { ok: false, errors: [{ code: "SITE_MANIFEST_INVALID", path: "/id", message: "the publication requires exactly one Site at sites/<site>" }] };
+  const parsed = parseSiteManifestDoc(declarations[0]);
+  if (!parsed.ok) return parsed;
+  const { manifest } = parsed;
+  const views = new Set(snapshot.views.map((view) => view.id));
+  const documents = new Set(snapshot.documents.map((doc) => doc.id));
+  const blobs = new Set(snapshot.blobs.map((blob2) => blob2.key));
+  const errors = [];
+  const fail = (path, message) => {
+    errors.push({ code: "SITE_MANIFEST_INVALID", path, message });
+  };
+  if (manifest.views.some((id) => !views.has(id))) fail("/views", "every declared View must be registered in this publication");
+  if (manifest.landing !== void 0 && !documents.has(manifest.landing)) fail("/landing", "landing must name a document or View in this publication");
+  if (manifest.landing !== void 0 && views.has(manifest.landing) && !manifest.views.includes(manifest.landing)) fail("/landing", "a landing View must be declared by this Site");
+  if (manifest.brand?.logo !== void 0 && !blobs.has(manifest.brand.logo)) fail("/brand/logo", "the logo must be a blob in this publication");
+  if (manifest.brand?.fonts?.some((key) => !blobs.has(key))) fail("/brand/fonts", "every font must be a blob in this publication");
+  return errors.length ? { ok: false, errors } : parsed;
+}
+export {
+  SITES_PREFIX,
+  SITE_DOCUMENT_KEYS,
+  SITE_LABEL,
+  SITE_TYPE,
+  isSiteLabel,
+  parseSiteManifestDoc,
+  readPublicationSiteManifest
+};

package/dist/publication.mjs

@@ -30978,6 +30978,13 @@ function assertSafeConceptId(id) {
 }
 var FORMAT_AT_EDGE = new RegExp("^\\p{Cf}|\\p{Cf}$", "u");
 var FORMAT_INSIDE = new RegExp("(?![\\u200c\\u200d])\\p{Cf}", "u");
+function nonCanonicalDocumentId(id) {
+  const segments = id.split("/");
+  if (segments.some((segment) => segment !== segment.trim())) return "segment_whitespace";
+  if (segments.some((segment) => FORMAT_AT_EDGE.test(segment) || FORMAT_INSIDE.test(segment))) return "format_character";
+  if (id !== id.normalize("NFC")) return "not_nfc";
+  return null;
+}
 function assertSafeBlobKey(key) {
   if (typeof key !== "string" || key.trim() === "") {
     throw new InvalidInputError("Blob key must be a non-empty string.");
@@ -32074,14 +32081,14 @@ async function readOwnerRecord(lockPath) {
 }
 async function resolveOwnerRecord(lockPath, started, waitMs, pollMs) {
   while (true) {
-    const record2 = await readOwnerRecord(lockPath);
-    if (record2.state !== "unreadable" || Date.now() - started >= waitMs) return record2;
+    const record3 = await readOwnerRecord(lockPath);
+    if (record3.state !== "unreadable" || Date.now() - started >= waitMs) return record3;
     await delay(pollMs);
   }
 }
 async function readOwner(lockPath) {
-  const record2 = await readOwnerRecord(lockPath);
-  return record2.state === "record" ? record2.owner : null;
+  const record3 = await readOwnerRecord(lockPath);
+  return record3.state === "record" ? record3.owner : null;
 }
 function processExists(pid) {
   try {
@@ -32276,12 +32283,12 @@ async function claimLockPath(lockPath, owner, waitMs, pollMs, policy) {
 }
 async function rollBackOwnClaim(lockPath, owner, claimed, waitMs, pollMs, policy) {
   const started = Date.now();
-  const record2 = await resolveOwnerRecord(lockPath, started, waitMs, pollMs);
-  if (record2.state === "record") {
-    if (record2.owner.token === owner.token) await removeReleasedLock(lockPath, owner, started, waitMs, pollMs, policy);
+  const record3 = await resolveOwnerRecord(lockPath, started, waitMs, pollMs);
+  if (record3.state === "record") {
+    if (record3.owner.token === owner.token) await removeReleasedLock(lockPath, owner, started, waitMs, pollMs, policy);
     return;
   }
-  if (record2.state === "unreadable" || !await isClaimedDirectory(lockPath, claimed)) return;
+  if (record3.state === "unreadable" || !await isClaimedDirectory(lockPath, claimed)) return;
   const remnant = releasedLockRemnantPath(lockPath, owner);
   await fs.rename(lockPath, remnant);
   await fs.rm(remnant, { recursive: true, force: true });
@@ -33662,11 +33669,11 @@ function isPlainObject(value) {
   const prototype = Object.getPrototypeOf(value);
   return prototype === Object.prototype || prototype === null;
 }
-function hasOwn(record2, key) {
-  return Object.prototype.hasOwnProperty.call(record2, key);
+function hasOwn(record3, key) {
+  return Object.prototype.hasOwnProperty.call(record3, key);
 }
-function setOwn(record2, key, value) {
-  Object.defineProperty(record2, key, { value, enumerable: true, configurable: true, writable: true });
+function setOwn(record3, key, value) {
+  Object.defineProperty(record3, key, { value, enumerable: true, configurable: true, writable: true });
 }
 function isScalar(value) {
   return typeof value === "string" || typeof value === "number" || typeof value === "boolean";
@@ -44584,15 +44591,15 @@ function buildSnapshot(first) {
     if (!registration) {
       throw new PublicationError("INVALID_VIEW_REGISTRATION", "a View registration is invalid", { subject: doc.id });
     }
-    const blob = blobsByKey.get(registration.entry);
-    if (!blob) {
+    const blob2 = blobsByKey.get(registration.entry);
+    if (!blob2) {
       throw new PublicationError("VIEW_ENTRY_MISSING", "a registered View entry is missing", { subject: doc.id });
     }
-    if (registration.entryVersion && registration.entryVersion !== blob.version) {
+    if (registration.entryVersion && registration.entryVersion !== blob2.version) {
       throw new PublicationError("VIEW_ENTRY_VERSION_MISMATCH", "a registered View entry no longer matches its pin", {
         subject: doc.id,
         expected: registration.entryVersion,
-        actual: blob.version
+        actual: blob2.version
       });
     }
     const rawBlob = first.blobs.find((candidate) => candidate.key === registration.entry);
@@ -44613,8 +44620,8 @@ function buildSnapshot(first) {
       ...presentation === "workspace" || presentation === "inline" || presentation === "adaptive" ? { presentation } : {},
       access: resolveDeclaredAccess(doc.frontmatter),
       entry: registration.entry,
-      entryVersion: blob.version,
-      entryObject: blob.object
+      entryVersion: blob2.version,
+      entryObject: blob2.object
     });
   }
   views.sort((a, b) => compareCodeUnits(a.id, b.id));
@@ -45043,18 +45050,157 @@ function assertPublicationSourceExclusions(source, exclusions) {
     return slash > 0 && directories.has(fold(path6.slice(0, slash)));
   };
   const excludedType = (type) => type !== void 0 && type !== null && (types.has(kind(type)) || Array.isArray(type) && type.flat(Infinity).some((value) => types.has(kind(value))));
-  const count = source.documents.filter((document3) => excludedPath(document3.id) || excludedType(document3.frontmatter.type)).length + source.reserved.filter((file) => excludedPath(`${file.dir}/${file.name}`)).length + source.blobs.filter((blob) => excludedPath(blob.key)).length;
+  const count = source.documents.filter((document3) => excludedPath(document3.id) || excludedType(document3.frontmatter.type)).length + source.reserved.filter((file) => excludedPath(`${file.dir}/${file.name}`)).length + source.blobs.filter((blob2) => excludedPath(blob2.key)).length;
   if (count > 0) throw new PublicationError("INVALID_BUNDLE", "the publication source contains excluded content", { details: { excludedEntries: count } });
 }
+
+// ../core/src/json-data.ts
+function isJsonData(value, depth = 0) {
+  if (depth > 32) return false;
+  if (value === null || typeof value === "string" || typeof value === "boolean") return true;
+  if (typeof value === "number") return Number.isFinite(value);
+  if (Array.isArray(value)) return value.every((item) => isJsonData(item, depth + 1));
+  if (value === null || typeof value !== "object") return false;
+  const proto = Object.getPrototypeOf(value);
+  if (proto !== null && Object.getPrototypeOf(proto) !== null) return false;
+  return Object.values(value).every((item) => item !== void 0 && isJsonData(item, depth + 1));
+}
+
+// ../core/src/site-manifest.ts
+var SITE_TYPE = "Site";
+var SITES_PREFIX = "sites/";
+var SITE_LABEL = /^[a-z][a-z0-9-]{1,30}[a-z0-9]$/;
+var isSiteLabel = (value) => typeof value === "string" && SITE_LABEL.test(value) && !value.includes("--");
+var SITE_DOCUMENT_KEYS = ["type", "title", "description", "presentation", "landing", "views", "audience", "capabilities", "options", "brand"];
+var record2 = (v) => v !== null && typeof v === "object" && !Array.isArray(v);
+var packageName = /^(?:@[a-z0-9][a-z0-9._-]*\/)?[a-z0-9][a-z0-9._-]*$/;
+var exactVersion = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-([0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?(?:\+([0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?$/;
+var encoder2 = new TextEncoder();
+function presentationReference(raw) {
+  if (typeof raw !== "string" || raw.length > 512) return void 0;
+  if (raw.startsWith("repo:")) {
+    const repository = raw.slice(5);
+    return /^[A-Za-z0-9][A-Za-z0-9-]{0,38}\/[A-Za-z0-9][A-Za-z0-9._-]{0,99}$/.test(repository) && !repository.endsWith(".git") ? { kind: "repository", repository } : void 0;
+  }
+  const at = raw.lastIndexOf("@");
+  if (at < 1) return void 0;
+  const name = raw.slice(0, at), version2 = raw.slice(at + 1), match = exactVersion.exec(version2);
+  if (name.length > 214 || !packageName.test(name) || !match || !match.slice(1, 4).every((part) => Number.isSafeInteger(Number(part))) || match[4]?.split(".").some((part) => /^\d+$/.test(part) && (part.length > 1 && part.startsWith("0") || !Number.isSafeInteger(Number(part))))) return void 0;
+  return { kind: "package", name, version: version2 };
+}
+var concept = (raw) => {
+  if (typeof raw !== "string") return false;
+  try {
+    assertSafeConceptId(raw);
+    return nonCanonicalDocumentId(raw) === null;
+  } catch {
+    return false;
+  }
+};
+var blob = (raw) => {
+  if (typeof raw !== "string") return false;
+  try {
+    assertSafeBlobKey(raw);
+    return true;
+  } catch {
+    return false;
+  }
+};
+function parseSiteManifestDoc(doc) {
+  const errors = [];
+  const fail2 = (path6, message) => {
+    errors.push({ code: "SITE_MANIFEST_INVALID", path: path6, message });
+  };
+  const fm = record2(doc?.frontmatter) ? doc.frontmatter : {};
+  const site = typeof doc?.id === "string" && doc.id.startsWith(SITES_PREFIX) ? doc.id.slice(SITES_PREFIX.length) : "";
+  if (!isSiteLabel(site)) fail2("/id", "a Site lives at sites/<site>, using one site label");
+  if (fm.type !== SITE_TYPE) fail2("/type", "type must be Site");
+  if (Object.keys(fm).some((key) => !SITE_DOCUMENT_KEYS.includes(key) && !isOkfStandardField(key) && !isManagedDocumentMetadataField(key)))
+    fail2("", "unrecognized Site fields");
+  if (typeof fm.title !== "string" || fm.title.trim() === "" || encoder2.encode(fm.title).byteLength > 512)
+    fail2("/title", "title must be a nonempty string of at most 512 bytes");
+  if (fm.description !== void 0 && (typeof fm.description !== "string" || encoder2.encode(fm.description).byteLength > 8192))
+    fail2("/description", "description must be a string of at most 8192 bytes");
+  const presentation = presentationReference(fm.presentation);
+  if (!presentation) fail2("/presentation", "presentation must name an exact npm version or repo:owner/name");
+  if (fm.audience !== "restricted") fail2("/audience", "only the restricted audience is supported");
+  const list3 = (raw, path6, maximum, valid) => {
+    if (!Array.isArray(raw) || raw.length > maximum || !raw.every(valid) || new Set(raw).size !== raw.length) {
+      fail2(path6, "expected a bounded list of unique valid references");
+      return [];
+    }
+    return [...raw];
+  };
+  const views = list3(fm.views, "/views", 64, concept);
+  const capability = (v) => typeof v === "string" && /^[a-z][a-z0-9-]{0,63}$/.test(v);
+  const capabilities = list3(fm.capabilities ?? [], "/capabilities", 16, capability);
+  if (fm.landing !== void 0 && !concept(fm.landing)) fail2("/landing", "landing must be a canonical document or View id");
+  const options = fm.options ?? {};
+  if (!record2(options) || !isJsonData(options) || encoder2.encode(JSON.stringify(options)).byteLength > 16384)
+    fail2("/options", "options must be JSON data of at most 16384 bytes");
+  let brand;
+  if (fm.brand !== void 0) {
+    if (!record2(fm.brand) || Object.keys(fm.brand).some((key) => key !== "logo" && key !== "fonts")) fail2("/brand", "brand may only name a logo and fonts");
+    else {
+      if (fm.brand.logo !== void 0 && !blob(fm.brand.logo)) fail2("/brand/logo", "logo must be a bundle blob reference");
+      const fonts = fm.brand.fonts === void 0 ? void 0 : list3(fm.brand.fonts, "/brand/fonts", 16, blob);
+      brand = { ...typeof fm.brand.logo === "string" ? { logo: fm.brand.logo } : {}, ...fonts ? { fonts } : {} };
+    }
+  }
+  if (errors.length) return { ok: false, errors };
+  return { ok: true, manifest: {
+    id: doc.id,
+    site,
+    title: fm.title,
+    presentation,
+    audience: "restricted",
+    views,
+    capabilities,
+    options: JSON.parse(JSON.stringify(options)),
+    ...fm.description === void 0 ? {} : { description: fm.description },
+    ...fm.landing === void 0 ? {} : { landing: fm.landing },
+    ...brand ? { brand } : {}
+  } };
+}
+
+// ../publication/src/site-manifest.ts
+function readPublicationSiteManifest(snapshot, site) {
+  const declarations = snapshot.documents.filter((doc) => doc.frontmatter.type === SITE_TYPE);
+  if (declarations.length !== 1 || declarations[0].id !== `${SITES_PREFIX}${site}`)
+    return { ok: false, errors: [{ code: "SITE_MANIFEST_INVALID", path: "/id", message: "the publication requires exactly one Site at sites/<site>" }] };
+  const parsed = parseSiteManifestDoc(declarations[0]);
+  if (!parsed.ok) return parsed;
+  const { manifest } = parsed;
+  const views = new Set(snapshot.views.map((view) => view.id));
+  const documents = new Set(snapshot.documents.map((doc) => doc.id));
+  const blobs = new Set(snapshot.blobs.map((blob2) => blob2.key));
+  const errors = [];
+  const fail2 = (path6, message) => {
+    errors.push({ code: "SITE_MANIFEST_INVALID", path: path6, message });
+  };
+  if (manifest.views.some((id) => !views.has(id))) fail2("/views", "every declared View must be registered in this publication");
+  if (manifest.landing !== void 0 && !documents.has(manifest.landing)) fail2("/landing", "landing must name a document or View in this publication");
+  if (manifest.landing !== void 0 && views.has(manifest.landing) && !manifest.views.includes(manifest.landing)) fail2("/landing", "a landing View must be declared by this Site");
+  if (manifest.brand?.logo !== void 0 && !blobs.has(manifest.brand.logo)) fail2("/brand/logo", "the logo must be a blob in this publication");
+  if (manifest.brand?.fonts?.some((key) => !blobs.has(key))) fail2("/brand/fonts", "every font must be a blob in this publication");
+  return errors.length ? { ok: false, errors } : parsed;
+}
 export {
   PUBLICATION_BRIDGE_V0,
   PUBLICATION_SNAPSHOT_SCHEMA_V1,
   PUBLICATION_SNAPSHOT_V1,
   PublicationError,
+  SITES_PREFIX,
+  SITE_DOCUMENT_KEYS,
+  SITE_LABEL,
+  SITE_TYPE,
   assertPublicationSourceExclusions,
   capturePublicationSnapshot,
   createPublicationBridge,
-  isPublicationError
+  isPublicationError,
+  isSiteLabel,
+  parseSiteManifestDoc,
+  readPublicationSiteManifest
 };
 /*! Bundled license information:
 

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.7" }, source: { commit: "abebce5cd3309cd154955cd6d56ac8edeee23e2c", 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.8" }, source: { commit: "670181d64d565efbc9506cf5a6e6d46a03186abf", dirty: false }, artifact: { channel: "npm-package" }, compatibility_contracts: { skill: 1, hook: 1, mcp: 1 } };
   }
 });
 
@@ -30554,6 +30554,25 @@ var init_machine_state = __esm({
   }
 });
 
+// ../core/src/json-data.ts
+function isJsonData(value, depth2 = 0) {
+  if (depth2 > 32) return false;
+  if (value === null || typeof value === "string" || typeof value === "boolean") return true;
+  if (typeof value === "number") return Number.isFinite(value);
+  if (Array.isArray(value)) return value.every((item) => isJsonData(item, depth2 + 1));
+  if (value === null || typeof value !== "object") return false;
+  const proto = Object.getPrototypeOf(value);
+  if (proto !== null && Object.getPrototypeOf(proto) !== null) return false;
+  return Object.values(value).every((item) => item !== void 0 && isJsonData(item, depth2 + 1));
+}
+var init_json_data = __esm({
+  "../core/src/json-data.ts"() {
+    "use strict";
+    init_define_SUPERBEE_BUILD_IDENTITY();
+    init_define_SUPERBEE_UPDATE_POLICY();
+  }
+});
+
 // ../core/src/document-codec.ts
 var init_document_codec = __esm({
   "../core/src/document-codec.ts"() {
@@ -30584,16 +30603,6 @@ var init_target_consumer = __esm({
 });
 
 // ../core/src/source-engine/driver.ts
-function isJsonData(value, depth2 = 0) {
-  if (depth2 > 32) return false;
-  if (value === null || typeof value === "string" || typeof value === "boolean") return true;
-  if (typeof value === "number") return Number.isFinite(value);
-  if (Array.isArray(value)) return value.every((item) => isJsonData(item, depth2 + 1));
-  if (!record9(value)) return false;
-  const proto = Object.getPrototypeOf(value);
-  if (proto !== null && Object.getPrototypeOf(proto) !== null) return false;
-  return Object.values(value).every((item) => item !== void 0 && isJsonData(item, depth2 + 1));
-}
 function pageProblem(page) {
   if (!record9(page)) return "page_invalid";
   if (!Array.isArray(page.records) || typeof page.more !== "boolean" || typeof page.complete !== "boolean") return "page_invalid";
@@ -31035,6 +31044,8 @@ var init_driver = __esm({
     "use strict";
     init_define_SUPERBEE_BUILD_IDENTITY();
     init_define_SUPERBEE_UPDATE_POLICY();
+    init_json_data();
+    init_json_data();
     init_connectors();
     init_canonical();
     init_verification();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "superbee",
-  "version": "0.4.4-pre.7",
+  "version": "0.4.4-pre.8",
   "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": [
@@ -41,6 +41,10 @@
     "./portable-export": {
       "types": "./dist/portable-export.d.ts",
       "default": "./dist/portable-export.mjs"
+    },
+    "./publication/site-manifest": {
+      "types": "./dist/publication/site-manifest-entry.d.ts",
+      "default": "./dist/publication-site-manifest.mjs"
     }
   },
   "files": [