@superbee/core 0.2.0-pre.19 → 0.2.0-pre.20

package/dist/recipe-lifecycle/stamp.js

@@ -1,8 +1,9 @@
-// Recipe install stamps. Every convention a recipe installs or evolves carries one `x_recipe`
-// record, written in the same compare-and-swap write as the convention, so the stamp exists
-// exactly when the convention does. A stamp holds only deterministic facts: two clones that apply
+// Recipe install stamps. Every convention and Connector a recipe installs or evolves carries one
+// `x_recipe` record, written in the same compare-and-swap write as the document, so the stamp
+// exists exactly when the document does. A stamp holds only deterministic facts: two clones that apply
 // the same evolve write identical stamps. The read side derives each recipe's state from the
 // stamps alone, without the recipe source. Storage-neutral: no Node globals or builtins.
+import { CONNECTOR_TYPE, CONNECTORS_PREFIX } from "../connectors.js";
 import { normalizeDocumentBodyForStorage } from "../frontmatter.js";
 import { CONVENTION_TYPE } from "../kinds.js";
 import { sha256Hex } from "../versioning.js";
@@ -61,8 +62,10 @@ function digest(value) {
 }
 /**
  * Digest of a recipe's parsed content, taken before edition materialization: its id, version,
- * conventions, View pairs and References, each sorted by id, bodies with CRLF read as LF. Equal
- * across editions, independent of how the recipe was acquired, and blind to README files.
+ * conventions, View pairs, References and (only when it carries any) Connectors, each sorted by id,
+ * bodies with CRLF read as LF. Equal across editions, independent of how the recipe was acquired,
+ * and blind to README files. A recipe without connectors digests exactly as it did before
+ * connectors existed, so every stamp written earlier stays current.
  */
 export function recipeSourceDigest(recipe) {
     const docs = [...recipe.docs]
@@ -74,7 +77,17 @@ export function recipeSourceDigest(recipe) {
     const references = [...recipe.references]
         .sort((a, b) => byCodeUnit(a.doc.id, b.doc.id))
         .map((reference) => [reference.doc.id, reference.doc.frontmatter, lf(reference.doc.body)]);
-    return digest({ id: recipe.id, version: recipe.version, docs, pages, references });
+    const connectors = [...(recipe.connectors ?? [])]
+        .sort((a, b) => byCodeUnit(a.doc.id, b.doc.id))
+        .map((connector) => [connector.doc.id, connector.doc.frontmatter, lf(connector.doc.body)]);
+    return digest({
+        id: recipe.id,
+        version: recipe.version,
+        docs,
+        pages,
+        references,
+        ...(connectors.length > 0 ? { connectors } : {}),
+    });
 }
 /**
  * Digest of a convention as written, rules version 1: its frontmatter without the stripped keys
@@ -90,7 +103,11 @@ export function definitionDigest(doc) {
 function nonNegativeInteger(value) {
     return typeof value === "number" && Number.isInteger(value) && value >= 0;
 }
-/** The convention's stamp, or null unless it is a mapping whose every field has its type. */
+/**
+ * The document's stamp, or null unless it is a mapping whose every required field has its type.
+ * The optional `connectors` count is kept when it is a non-negative integer and otherwise read as
+ * absent.
+ */
 export function readRecipeStamp(doc) {
     const value = doc.frontmatter[RECIPE_STAMP_KEY];
     if (value === null || typeof value !== "object" || Array.isArray(value))
@@ -107,6 +124,7 @@ export function readRecipeStamp(doc) {
         id: stamp.id,
         version: stamp.version,
         of: stamp.of,
+        ...(nonNegativeInteger(stamp.connectors) ? { connectors: stamp.connectors } : {}),
         source_digest: stamp.source_digest,
         definition: stamp.definition,
         digest_rules: stamp.digest_rules,
@@ -114,10 +132,12 @@ export function readRecipeStamp(doc) {
 }
 /** The recipe-level stamp facts for `recipe`; `materialized` supplies the declared count. */
 export function recipeStampIdentity(recipe, materialized) {
+    const connectors = (recipe.connectors ?? []).length;
     return {
         id: recipe.id,
         version: recipe.version,
         of: materialized.docs.length,
+        ...(connectors > 0 ? { connectors } : {}),
         source_digest: recipeSourceDigest(recipe),
     };
 }
@@ -128,20 +148,29 @@ export function withRecipeStamp(doc, identity) {
         id: identity.id,
         version: identity.version,
         of: identity.of,
+        ...(identity.connectors !== undefined ? { connectors: identity.connectors } : {}),
         source_digest: identity.source_digest,
         definition: definitionDigest({ frontmatter: frontmatter, body: doc.body }),
         digest_rules: DEFINITION_DIGEST_RULES,
     };
     return { ...doc, frontmatter: { ...frontmatter, [RECIPE_STAMP_KEY]: stamp } };
 }
-/** How the stamp on `doc` (null: no convention) relates to the recipe `identity` describes. */
+/**
+ * How the stamp on `doc` (null: no document) relates to the recipe `identity` describes. The
+ * Connector count must match too: for a recipe that carries connectors a stamp without it is
+ * `stale`, and since no release writes the key for a recipe without connectors, every stamp such a
+ * recipe wrote reads as it did before the key existed.
+ */
 export function recipeStampState(doc, identity) {
     const stamp = doc === null ? null : readRecipeStamp(doc);
     if (stamp === null)
         return "missing";
     if (stamp.id !== identity.id)
         return "foreign";
-    return stamp.version === identity.version && stamp.of === identity.of && stamp.source_digest === identity.source_digest
+    return stamp.version === identity.version
+        && stamp.of === identity.of
+        && stamp.source_digest === identity.source_digest
+        && stamp.connectors === identity.connectors
         ? "current"
         : "stale";
 }
@@ -152,7 +181,7 @@ export function worstRecipeStampState(states) {
         worst = Math.max(worst, STAMP_STATE_SEVERITY.indexOf(state));
     return STAMP_STATE_SEVERITY[worst];
 }
-/** One stamped convention's state: rules this release reads, and whether its digest still matches. */
+/** One stamped document's state: rules this release reads, and whether its digest still matches. */
 export function conventionStampState(doc) {
     const stamp = readRecipeStamp(doc);
     if (stamp === null || stamp.digest_rules !== DEFINITION_DIGEST_RULES)
@@ -163,71 +192,94 @@ export function conventionStampState(doc) {
 function declarationFree(doc) {
     return !["fields", "sections", "links", "expects_inbound"].some((key) => Object.hasOwn(doc.frontmatter, key));
 }
+/** A Connector declaration: the type core's connector parser owns, at the one place it reads it. */
+function isConnectorDoc(doc) {
+    return doc.frontmatter.type === CONNECTOR_TYPE && doc.id.startsWith(CONNECTORS_PREFIX);
+}
 /**
- * Each recipe's install state, derived from the stamps on `conventions` (documents of any other
- * type are ignored), and the conventions no recipe stamped. `known` recipes (their declared ids
- * are visible to the caller) also report a declared id that does not carry their stamp, and get
- * a row when an unstamped convention that declares something sits at one of their ids: a bundle
- * written before stamps. A declined Kind (a declaration-free record) or another recipe's stamp
- * at their ids alone is no evidence they were installed.
+ * Each recipe's install state, derived from the stamps on `docs` (conventions, and Connector
+ * documents under `connectors/`; documents of any other type are ignored), and the documents no
+ * recipe stamped. `known` recipes (their declared ids are visible to the caller) also report a
+ * declared id that does not carry their stamp, and get a row when an unstamped convention that
+ * declares something, or an unstamped Connector, sits at one of their ids: a bundle written before
+ * stamps. A declined Kind (a declaration-free record) or another recipe's stamp at their ids alone
+ * is no evidence they were installed.
  *
- * States, the first match winning: `unknown` when no convention carries the recipe's stamp;
- * `partial` when the stamps record more than one version or source digest, disagree on the
- * declared count, fall short of it, or (known recipes) a declared id is present without this
- * recipe's stamp; `diverged` when a stamped convention changed since the recipe wrote it;
- * `unknown` when a stamp uses digest rules this release does not read; otherwise `installed`.
+ * States, the first match winning: `unknown` when no document carries the recipe's stamp;
+ * `partial` when the stamps record more than one version or source digest, disagree on a declared
+ * count, fall short of the convention or Connector count, or (known recipes) a declared id is
+ * present without this recipe's stamp; `diverged` when a stamped document changed since the recipe
+ * wrote it; `unknown` when a stamp uses digest rules this release does not read; otherwise
+ * `installed`. A row carries the Connector keys only for a recipe whose stamps record connectors,
+ * so every other row reads as it did before connectors existed.
  */
-export function installedRecipes(conventions, known = []) {
+export function installedRecipes(docs, known = []) {
     const present = new Map();
     const stampedByRecipe = new Map();
     const unstamped = [];
-    for (const doc of conventions) {
-        if (doc.frontmatter.type !== CONVENTION_TYPE)
+    for (const doc of docs) {
+        const connector = isConnectorDoc(doc);
+        if (doc.frontmatter.type !== CONVENTION_TYPE && !connector)
             continue;
         present.set(doc.id, doc);
         const stamp = readRecipeStamp(doc);
         if (stamp === null) {
-            if (!declarationFree(doc))
+            if (connector || !declarationFree(doc))
                 unstamped.push(doc.id);
             continue;
         }
         const group = stampedByRecipe.get(stamp.id) ?? [];
-        group.push({ doc, stamp });
+        group.push({ doc, stamp, connector });
         stampedByRecipe.set(stamp.id, group);
     }
     const knownById = new Map(known.map((recipe) => [recipe.id, recipe]));
+    const declaredDocs = (recipe) => [...recipe.docs, ...(recipe.connectors ?? []).map((connector) => connector.doc)];
     const ids = new Set(stampedByRecipe.keys());
     const unstampedIds = new Set(unstamped);
     for (const recipe of known) {
-        if (recipe.docs.some((declared) => unstampedIds.has(declared.id)))
+        if (declaredDocs(recipe).some((declared) => unstampedIds.has(declared.id)))
             ids.add(recipe.id);
     }
     const rows = [...ids].sort(byCodeUnit).map((id) => {
-        const stamped = (stampedByRecipe.get(id) ?? []).sort((a, b) => byCodeUnit(a.doc.id, b.doc.id));
+        const all = (stampedByRecipe.get(id) ?? []).sort((a, b) => byCodeUnit(a.doc.id, b.doc.id));
+        const stamped = all.filter((entry) => !entry.connector);
+        const stampedConnectors = all.filter((entry) => entry.connector);
         const recipe = knownById.get(id);
         const conventionIds = stamped.map(({ doc }) => doc.id);
-        const stampedIds = new Set(conventionIds);
+        const stampedIds = new Set(all.map(({ doc }) => doc.id));
         const records = new Map();
-        for (const { stamp } of stamped) {
+        for (const { stamp, connector } of all) {
             const key = `${stamp.version}\u0000${stamp.source_digest}`;
             const record = records.get(key) ?? { version: stamp.version, source_digest: stamp.source_digest, conventions: 0 };
-            record.conventions += 1;
+            if (connector)
+                record.connectors = (record.connectors ?? 0) + 1;
+            else
+                record.conventions += 1;
             records.set(key, record);
         }
         const recordRows = [...records.values()].sort((a, b) => byCodeUnit(a.version, b.version) || byCodeUnit(a.source_digest, b.source_digest));
-        const declaredCounts = new Set(stamped.map(({ stamp }) => stamp.of));
+        const declaredCounts = new Set(all.map(({ stamp }) => stamp.of));
         const of = declaredCounts.size === 1 ? [...declaredCounts][0] : recipe ? recipe.docs.length : null;
-        const diverged = stamped.filter(({ doc }) => conventionStampState(doc) === "diverged").map(({ doc }) => doc.id);
-        const unknownRules = stamped.filter(({ stamp }) => stamp.digest_rules !== DEFINITION_DIGEST_RULES).map(({ doc }) => doc.id);
-        const declaredIds = recipe ? recipe.docs.map((doc) => doc.id).sort(byCodeUnit) : [];
+        // A stamp without the key records no connectors; a disagreement among stamps is partial.
+        const connectorCounts = new Set(all.map(({ stamp }) => stamp.connectors));
+        const declaredConnectors = recipe && (recipe.connectors ?? []).length > 0 ? recipe.connectors.length : undefined;
+        const connectorsOf = connectorCounts.size === 1
+            ? [...connectorCounts][0]
+            : connectorCounts.size === 0 ? declaredConnectors : declaredConnectors ?? null;
+        const carriesConnectors = stampedConnectors.length > 0 || connectorsOf !== undefined;
+        const diverged = all.filter(({ doc }) => conventionStampState(doc) === "diverged").map(({ doc }) => doc.id);
+        const unknownRules = all.filter(({ stamp }) => stamp.digest_rules !== DEFINITION_DIGEST_RULES).map(({ doc }) => doc.id);
+        const declaredIds = recipe ? declaredDocs(recipe).map((doc) => doc.id).sort(byCodeUnit) : [];
         const missingIds = declaredIds.filter((declared) => !stampedIds.has(declared));
         const presentWithoutStamp = missingIds.filter((declared) => present.has(declared));
         let state;
-        if (stamped.length === 0)
+        if (all.length === 0)
             state = "unknown";
         else if (recordRows.length > 1
             || declaredCounts.size > 1
+            || connectorCounts.size > 1
             || stamped.length !== of
+            || stampedConnectors.length !== (connectorsOf ?? 0)
             || presentWithoutStamp.length > 0
             || (recipe !== undefined && missingIds.length > 0))
             state = "partial";
@@ -247,9 +299,17 @@ export function installedRecipes(conventions, known = []) {
             of,
             convention_ids: conventionIds,
         };
+        if (carriesConnectors) {
+            row.connectors = stampedConnectors.length;
+            row.connectors_of = connectorsOf ?? null;
+            row.connector_ids = stampedConnectors.map(({ doc }) => doc.id);
+        }
         if (state === "partial") {
             row.records = recordRows;
-            const missing = recipe ? missingIds.length : of === null ? 0 : Math.max(0, of - stamped.length);
+            const missing = recipe
+                ? missingIds.length
+                : (of === null ? 0 : Math.max(0, of - stamped.length))
+                    + (typeof connectorsOf === "number" ? Math.max(0, connectorsOf - stampedConnectors.length) : 0);
             if (missing > 0)
                 row.missing = missing;
             if (recipe && missingIds.length > 0)

package/dist/recipe-lifecycle/stamp.js.map

@@ -1 +1 @@
-{"version":3,"file":"stamp.js","sourceRoot":"","sources":["../../src/recipe-lifecycle/stamp.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,4FAA4F;AAC5F,kGAAkG;AAClG,6FAA6F;AAC7F,yFAAyF;AACzF,OAAO,EAAE,+BAA+B,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAG9C,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,oEAAoE;AACpE,MAAM,CAAC,MAAM,gBAAgB,GAAG,UAAU,CAAC;AAE3C,qEAAqE;AACrE,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC;AAqDzC;;;GAGG;AACH,MAAM,oBAAoB,GAAsB;IAC9C,gBAAgB;IAChB,WAAW;IACX,OAAO;IACP,WAAW;IACX,UAAU;IACV,qBAAqB;IACrB,aAAa;IACb,OAAO;CACR,CAAC;AAEF,MAAM,oBAAoB,GAAgC,CAAC,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;AAErG,SAAS,EAAE,CAAC,IAAY;IACtB,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AACvC,CAAC;AAED,8DAA8D;AAC9D,SAAS,UAAU,CAAC,CAAS,EAAE,CAAS;IACtC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACpC,CAAC;AAED;;;GAGG;AACH,SAAS,aAAa,CAAC,KAAc;IACnC,IAAI,KAAK,YAAY,IAAI;QAAE,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;IACtE,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC;IACxF,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IAC3F,MAAM,MAAM,GAAG,KAAgC,CAAC;IAChD,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;SAC3B,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC;SAC1C,IAAI,CAAC,UAAU,CAAC;SAChB,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;SACpE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;AAClB,CAAC;AAED;;;;GAIG;AACH,OAAO,EAAE,aAAa,IAAI,uBAAuB,EAAE,CAAC;AAEpD,SAAS,MAAM,CAAC,KAAc;IAC5B,OAAO,UAAU,SAAS,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;AACrD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAoB;IACrD,MAAM,IAAI,GAAG,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC;SAC1B,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;SACtC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,WAAW,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACzD,MAAM,KAAK,GAAG,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC;SAC5B,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;SACxD,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACnH,MAAM,UAAU,GAAG,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC;SACtC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;SAC9C,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,EAAE,SAAS,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC7F,OAAO,MAAM,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;AACrF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAA8C;IAC7E,MAAM,WAAW,GAA4B,EAAE,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;IACpE,KAAK,MAAM,GAAG,IAAI,oBAAoB;QAAE,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC;IAChE,OAAO,MAAM,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,+BAA+B,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;AAC5F,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAc;IACxC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AAC5E,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,eAAe,CAAC,GAAqC;IACnE,MAAM,KAAK,GAAG,GAAG,CAAC,WAAW,CAAC,gBAAgB,CAAC,CAAC;IAChD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACrF,MAAM,KAAK,GAAG,KAAgC,CAAC;IAC/C,IACE,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ,IAAI,KAAK,CAAC,EAAE,KAAK,EAAE;WAC5C,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ;WACjC,CAAC,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC;WAC7B,OAAO,KAAK,CAAC,aAAa,KAAK,QAAQ;WACvC,OAAO,KAAK,CAAC,UAAU,KAAK,QAAQ;WACpC,CAAC,kBAAkB,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,KAAK,CAAC,YAAY,KAAK,CAAC;QACtE,OAAO,IAAI,CAAC;IACd,OAAO;QACL,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,YAAY,EAAE,KAAK,CAAC,YAAY;KACjC,CAAC;AACJ,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,mBAAmB,CAAC,MAAoB,EAAE,YAA0B;IAClF,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,EAAE,EAAE,YAAY,CAAC,IAAI,CAAC,MAAM;QAC5B,aAAa,EAAE,kBAAkB,CAAC,MAAM,CAAC;KAC1C,CAAC;AACJ,CAAC;AAED,iGAAiG;AACjG,MAAM,UAAU,eAAe,CAAsD,GAAM,EAAE,QAA6B;IACxH,MAAM,EAAE,CAAC,gBAAgB,CAAC,EAAE,SAAS,EAAE,GAAG,WAAW,EAAE,GAAG,GAAG,CAAC,WAAW,CAAC;IAC1E,MAAM,KAAK,GAAgB;QACzB,EAAE,EAAE,QAAQ,CAAC,EAAE;QACf,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,EAAE,EAAE,QAAQ,CAAC,EAAE;QACf,aAAa,EAAE,QAAQ,CAAC,aAAa;QACrC,UAAU,EAAE,gBAAgB,CAAC,EAAE,WAAW,EAAE,WAAyC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC;QACxG,YAAY,EAAE,uBAAuB;KACtC,CAAC;IACF,OAAO,EAAE,GAAG,GAAG,EAAE,WAAW,EAAE,EAAE,GAAG,WAAW,EAAE,CAAC,gBAAgB,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC;AAChF,CAAC;AAED,+FAA+F;AAC/F,MAAM,UAAU,gBAAgB,CAAC,GAA4C,EAAE,QAA6B;IAC1G,MAAM,KAAK,GAAG,GAAG,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;IACzD,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IACrC,IAAI,KAAK,CAAC,EAAE,KAAK,QAAQ,CAAC,EAAE;QAAE,OAAO,SAAS,CAAC;IAC/C,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,CAAC,OAAO,IAAI,KAAK,CAAC,EAAE,KAAK,QAAQ,CAAC,EAAE,IAAI,KAAK,CAAC,aAAa,KAAK,QAAQ,CAAC,aAAa;QACrH,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,OAAO,CAAC;AACd,CAAC;AAED,iGAAiG;AACjG,MAAM,UAAU,qBAAqB,CAAC,MAAkC;IACtE,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,KAAK,IAAI,MAAM;QAAE,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,oBAAoB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;IACzF,OAAO,oBAAoB,CAAC,KAAK,CAAE,CAAC;AACtC,CAAC;AAED,sGAAsG;AACtG,MAAM,UAAU,oBAAoB,CAAC,GAA8C;IACjF,MAAM,KAAK,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;IACnC,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,YAAY,KAAK,uBAAuB;QAAE,OAAO,SAAS,CAAC;IACvF,OAAO,gBAAgB,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC;AAC7E,CAAC;AAED,yFAAyF;AACzF,SAAS,eAAe,CAAC,GAAgB;IACvC,OAAO,CAAC,CAAC,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,iBAAiB,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC;AAChH,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,gBAAgB,CAC9B,WAAkC,EAClC,QAAiC,EAAE;IAEnC,MAAM,OAAO,GAAG,IAAI,GAAG,EAA0B,CAAC;IAClD,MAAM,eAAe,GAAG,IAAI,GAAG,EAA2D,CAAC;IAC3F,MAAM,SAAS,GAAgB,EAAE,CAAC;IAClC,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;QAC9B,IAAI,GAAG,CAAC,WAAW,CAAC,IAAI,KAAK,eAAe;YAAE,SAAS;QACvD,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;QACzB,MAAM,KAAK,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACnB,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC;gBAAE,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAClD,SAAS;QACX,CAAC;QACD,MAAM,KAAK,GAAG,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;QAClD,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;QAC3B,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IACvC,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IACtE,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC,CAAC;IAC5C,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC;IACxC,KAAK,MAAM,MAAM,IAAI,KAAK,EAAE,CAAC;QAC3B,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YAAE,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACxF,CAAC;IAED,MAAM,IAAI,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAsB,EAAE;QACpE,MAAM,OAAO,GAAG,CAAC,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;QAC/F,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACjC,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACvD,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,aAAa,CAAC,CAAC;QAE1C,MAAM,OAAO,GAAG,IAAI,GAAG,EAA2E,CAAC;QACnG,KAAK,MAAM,EAAE,KAAK,EAAE,IAAI,OAAO,EAAE,CAAC;YAChC,MAAM,GAAG,GAAG,GAAG,KAAK,CAAC,OAAO,SAAS,KAAK,CAAC,aAAa,EAAE,CAAC;YAC3D,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,aAAa,EAAE,KAAK,CAAC,aAAa,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC;YAClH,MAAM,CAAC,WAAW,IAAI,CAAC,CAAC;YACxB,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAC3B,CAAC;QACD,MAAM,UAAU,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACrD,UAAU,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,UAAU,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC;QACpF,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;QACrE,MAAM,EAAE,GAAG,cAAc,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;QAEpG,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,oBAAoB,CAAC,GAAG,CAAC,KAAK,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChH,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,YAAY,KAAK,uBAAuB,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC5H,MAAM,WAAW,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACpF,MAAM,UAAU,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC/E,MAAM,mBAAmB,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;QAEnF,IAAI,KAAyB,CAAC;QAC9B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,KAAK,GAAG,SAAS,CAAC;aACvC,IACH,UAAU,CAAC,MAAM,GAAG,CAAC;eAClB,cAAc,CAAC,IAAI,GAAG,CAAC;eACvB,OAAO,CAAC,MAAM,KAAK,EAAE;eACrB,mBAAmB,CAAC,MAAM,GAAG,CAAC;eAC9B,CAAC,MAAM,KAAK,SAAS,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;YAClD,KAAK,GAAG,SAAS,CAAC;aACf,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;YAAE,KAAK,GAAG,UAAU,CAAC;aAC5C,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC;YAAE,KAAK,GAAG,SAAS,CAAC;;YAC/C,KAAK,GAAG,WAAW,CAAC;QAEzB,MAAM,MAAM,GAAG,KAAK,KAAK,WAAW,IAAI,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QACrF,MAAM,GAAG,GAAuB;YAC9B,EAAE;YACF,KAAK;YACL,OAAO,EAAE,MAAM,EAAE,OAAO,IAAI,IAAI;YAChC,aAAa,EAAE,MAAM,EAAE,aAAa,IAAI,IAAI;YAC5C,WAAW,EAAE,OAAO,CAAC,MAAM;YAC3B,EAAE;YACF,cAAc,EAAE,aAAa;SAC9B,CAAC;QACF,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,GAAG,CAAC,OAAO,GAAG,UAAU,CAAC;YACzB,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;YAChG,IAAI,OAAO,GAAG,CAAC;gBAAE,GAAG,CAAC,OAAO,GAAG,OAAO,CAAC;YACvC,IAAI,MAAM,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC;gBAAE,GAAG,CAAC,WAAW,GAAG,UAAU,CAAC;QACpE,CAAC;QACD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;YAAE,GAAG,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACjD,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC;YAAE,GAAG,CAAC,aAAa,GAAG,YAAY,CAAC;QAC9D,OAAO,GAAG,CAAC;IACb,CAAC,CAAC,CAAC;IAEH,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;AACzD,CAAC"}
+{"version":3,"file":"stamp.js","sourceRoot":"","sources":["../../src/recipe-lifecycle/stamp.ts"],"names":[],"mappings":"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"}

package/dist/recipes.d.ts

@@ -1,3 +1,4 @@
+import { type Connector, type ConnectorErrorCode } from "./connectors.js";
 import type { OkfDocument } from "./types.js";
 import type { ValidationWarning } from "./validation.js";
 /** One recipe file: a path relative to the recipe root (posix), with its UTF-8 text. */
@@ -19,6 +20,13 @@ export interface RecipeReference {
     /** A `type: Reference` document installed under `references/`. */
     doc: OkfDocument;
 }
+/** One Connector declaration carried by a recipe package: a definition, never an instance. */
+export interface RecipeConnector {
+    /** The `type: Connector` document installed under `connectors/`. */
+    doc: OkfDocument;
+    /** The declaration as `parseConnectorDoc` read it. */
+    connector: Connector;
+}
 /** Parsed recipe definitions. Parsing does not install, authorize or execute these assets. */
 export interface LoadedRecipe {
     id: string;
@@ -35,6 +43,12 @@ export interface LoadedRecipe {
     pages: RecipePage[];
     /** Optional operating references installed with the definitions; never project instances. */
     references: RecipeReference[];
+    /**
+     * Connector declarations the manifest's `connectors:` list carries, installed and evolved as
+     * definitions. Absent when the manifest declares none, so a recipe without connectors parses to
+     * the same value it always did.
+     */
+    connectors?: RecipeConnector[];
     /** Present only for packages opting into the strict portable definitions-only contract. */
     contentPolicy?: "definitions-only";
     /** The `type` values this recipe's conventions govern (derived at parse, for the receipt). */
@@ -47,11 +61,20 @@ export interface LoadedRecipe {
  * with the target edition's storage field. Part of the recipe format, so every client reads it here.
  */
 export declare const RECIPE_PROGRESS_STATUS_TOKEN = "{{superbee:progress_status}}";
-export type RecipeErrorCode = "RECIPE_NOT_FOUND" | "RECIPE_MALFORMED" | "RECIPE_EMPTY" | "RECIPE_UNSAFE_PATH";
+export type RecipeErrorCode = "RECIPE_NOT_FOUND" | "RECIPE_MALFORMED" | "RECIPE_EMPTY" | "RECIPE_UNSAFE_PATH" | "RECIPE_CONNECTOR_INVALID";
 export interface RecipeError {
     code: RecipeErrorCode;
     message: string;
+    /** `RECIPE_CONNECTOR_INVALID`: the first refusal of the connector named, and how many it had. */
+    connector?: {
+        id: string;
+        code: ConnectorErrorCode;
+        path: string;
+        count: number;
+    };
 }
+/** The connectors a recipe carries; empty when its manifest declares none. */
+export declare function recipeConnectors(recipe: Pick<LoadedRecipe, "connectors">): readonly RecipeConnector[];
 export type LoadResult = {
     ok: true;
     recipe: LoadedRecipe;

package/dist/recipes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"recipes.d.ts","sourceRoot":"","sources":["../src/recipes.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAYzD,wFAAwF;AACxF,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,mEAAmE;AACnE,MAAM,WAAW,UAAU;IACzB,uHAAuH;IACvH,QAAQ,EAAE,WAAW,CAAC;IACtB,0EAA0E;IAC1E,KAAK,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;CACd;AAED,kFAAkF;AAClF,MAAM,WAAW,eAAe;IAC9B,kEAAkE;IAClE,GAAG,EAAE,WAAW,CAAC;CAClB;AAED,8FAA8F;AAC9F,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,iGAAiG;IACjG,KAAK,EAAE,MAAM,CAAC;IACd,iFAAiF;IACjF,MAAM,EAAE,MAAM,CAAC;IACf,4FAA4F;IAC5F,IAAI,EAAE,WAAW,EAAE,CAAC;IACpB,sFAAsF;IACtF,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,6FAA6F;IAC7F,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,2FAA2F;IAC3F,aAAa,CAAC,EAAE,kBAAkB,CAAC;IACnC,8FAA8F;IAC9F,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,+FAA+F;IAC/F,QAAQ,EAAE,iBAAiB,EAAE,CAAC;CAC/B;AAED;;;GAGG;AACH,eAAO,MAAM,4BAA4B,iCAAiC,CAAC;AAE3E,MAAM,MAAM,eAAe,GAAE,kBAAkB,GAAG,kBAAkB,GAAG,cAAc,GAAG,oBAAoB,CAAC;AAE7G,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,UAAU,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,YAAY,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,WAAW,CAAA;CAAE,CAAC;AA6LhG;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,UAAU,EAAE,EACnB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAO,GACpC,UAAU,CAwSZ"}
+{"version":3,"file":"recipes.d.ts","sourceRoot":"","sources":["../src/recipes.ts"],"names":[],"mappings":"AAGA,OAAO,EAAwD,KAAK,SAAS,EAAE,KAAK,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAIhI,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAYzD,wFAAwF;AACxF,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,mEAAmE;AACnE,MAAM,WAAW,UAAU;IACzB,uHAAuH;IACvH,QAAQ,EAAE,WAAW,CAAC;IACtB,0EAA0E;IAC1E,KAAK,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;CACd;AAED,kFAAkF;AAClF,MAAM,WAAW,eAAe;IAC9B,kEAAkE;IAClE,GAAG,EAAE,WAAW,CAAC;CAClB;AAED,8FAA8F;AAC9F,MAAM,WAAW,eAAe;IAC9B,oEAAoE;IACpE,GAAG,EAAE,WAAW,CAAC;IACjB,sDAAsD;IACtD,SAAS,EAAE,SAAS,CAAC;CACtB;AAED,8FAA8F;AAC9F,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,iGAAiG;IACjG,KAAK,EAAE,MAAM,CAAC;IACd,iFAAiF;IACjF,MAAM,EAAE,MAAM,CAAC;IACf,4FAA4F;IAC5F,IAAI,EAAE,WAAW,EAAE,CAAC;IACpB,sFAAsF;IACtF,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,6FAA6F;IAC7F,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B;;;;OAIG;IACH,UAAU,CAAC,EAAE,eAAe,EAAE,CAAC;IAC/B,2FAA2F;IAC3F,aAAa,CAAC,EAAE,kBAAkB,CAAC;IACnC,8FAA8F;IAC9F,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,+FAA+F;IAC/F,QAAQ,EAAE,iBAAiB,EAAE,CAAC;CAC/B;AAED;;;GAGG;AACH,eAAO,MAAM,4BAA4B,iCAAiC,CAAC;AAE3E,MAAM,MAAM,eAAe,GACvB,kBAAkB,GAClB,kBAAkB,GAClB,cAAc,GACd,oBAAoB,GACpB,0BAA0B,CAAC;AAE/B,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,iGAAiG;IACjG,SAAS,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,kBAAkB,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CACnF;AAED,8EAA8E;AAC9E,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,YAAY,CAAC,GAAG,SAAS,eAAe,EAAE,CAErG;AAED,MAAM,MAAM,UAAU,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,YAAY,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,WAAW,CAAA;CAAE,CAAC;AAgRhG;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,UAAU,EAAE,EACnB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAO,GACpC,UAAU,CA2VZ"}

package/dist/recipes.js

@@ -1,8 +1,9 @@
 // The ONE pure recipe parse+validate+materialize pipeline. Sources only acquire RecipeFile[];
 // everything downstream of that byte boundary is distribution-neutral and branches on content,
 // never on whether the files came from built-in constants, a folder, or a future source adapter.
+import { CONNECTOR_TYPE, CONNECTORS_PREFIX, parseConnectorDoc } from "./connectors.js";
 import { parseMarkdown } from "./frontmatter.js";
-import { parseConventionDoc, CONVENTIONS_PREFIX, CONVENTION_TYPE } from "./kinds.js";
+import { buildKindRegistry, parseConventionDoc, CONVENTIONS_PREFIX, CONVENTION_TYPE } from "./kinds.js";
 import { conceptIdFromPath, assertSafeConceptId, isReservedFile } from "./paths.js";
 import { declaredAccessValue, isAnyEntryKey, isAnyRegistryId, isPageTypeName, PAGE_ENTRY_PREFIX, PAGE_REGISTRY_PREFIX, VIEW_ENTRY_PREFIX, VIEW_REGISTRY_PREFIX, } from "./page.js";
 /**
@@ -10,6 +11,10 @@ import { declaredAccessValue, isAnyEntryKey, isAnyRegistryId, isPageTypeName, PA
  * with the target edition's storage field. Part of the recipe format, so every client reads it here.
  */
 export const RECIPE_PROGRESS_STATUS_TOKEN = "{{superbee:progress_status}}";
+/** The connectors a recipe carries; empty when its manifest declares none. */
+export function recipeConnectors(recipe) {
+    return recipe.connectors ?? [];
+}
 /** Reserved manifest keys are surfaced as warnings, not applied or silently ignored. */
 const RESERVED_MANIFEST_KEYS = ["composes", "seeds", "requires"];
 function nonEmptyString(v) {
@@ -93,6 +98,81 @@ function parseReferenceDeclarations(manifest, recipeId, source) {
     }
     return { ok: true, references };
 }
+function isSafeRecipeConnectorPath(value) {
+    if (!value.startsWith(CONNECTORS_PREFIX) || !value.endsWith(".md") || /[\\%?#]/.test(value))
+        return false;
+    const segments = value.slice(CONNECTORS_PREFIX.length).split("/");
+    return segments.every((segment) => !segment.startsWith(".") && REFERENCE_SEGMENT.test(segment));
+}
+/** The manifest's `connectors:` list, under the grammar `references:` uses. */
+function parseConnectorDeclarations(manifest, recipeId, source) {
+    if (manifest.connectors === undefined)
+        return { ok: true, connectors: [] };
+    if (manifest.content_policy !== "definitions-only") {
+        return {
+            ok: false,
+            error: {
+                code: "RECIPE_MALFORMED",
+                message: `recipe '${recipeId}' at '${source}' declares connectors but does not declare ` +
+                    "'content_policy: definitions-only', which is required for portable assets",
+            },
+        };
+    }
+    if (!Array.isArray(manifest.connectors)) {
+        return {
+            ok: false,
+            error: { code: "RECIPE_MALFORMED", message: `recipe '${recipeId}': 'connectors' must be a list` },
+        };
+    }
+    const connectors = [];
+    const targets = new Set();
+    for (const [index, value] of manifest.connectors.entries()) {
+        if (typeof value !== "string" || value === "") {
+            return {
+                ok: false,
+                error: {
+                    code: "RECIPE_MALFORMED",
+                    message: `recipe '${recipeId}': connectors[${index}] must be a non-empty path`,
+                },
+            };
+        }
+        if (!isSafeRecipeConnectorPath(value)) {
+            return {
+                ok: false,
+                error: {
+                    code: "RECIPE_UNSAFE_PATH",
+                    message: `recipe '${recipeId}': Connector '${value}' must be a .md file under '${CONNECTORS_PREFIX}'`,
+                },
+            };
+        }
+        const id = conceptIdFromPath(value);
+        try {
+            assertSafeConceptId(id);
+        }
+        catch {
+            return {
+                ok: false,
+                error: { code: "RECIPE_UNSAFE_PATH", message: `recipe '${recipeId}' contains an unsafe Connector path` },
+            };
+        }
+        if (isReservedFile(value)) {
+            return {
+                ok: false,
+                error: { code: "RECIPE_UNSAFE_PATH", message: `recipe '${recipeId}' contains a reserved filename: '${value}'` },
+            };
+        }
+        const target = id.toLowerCase();
+        if (targets.has(target)) {
+            return {
+                ok: false,
+                error: { code: "RECIPE_MALFORMED", message: `recipe '${recipeId}' declares duplicate Connector '${value}'` },
+            };
+        }
+        targets.add(target);
+        connectors.push({ path: value, id });
+    }
+    return { ok: true, connectors };
+}
 function parsePageDeclarations(manifest, recipeId, source) {
     if (manifest.pages === undefined)
         return { ok: true, pages: [] };
@@ -233,8 +313,12 @@ export function parseRecipeFiles(files, source, options = {}) {
     const referenceDeclarations = parseReferenceDeclarations(manifest, id, source);
     if (!referenceDeclarations.ok)
         return referenceDeclarations;
+    const connectorDeclarations = parseConnectorDeclarations(manifest, id, source);
+    if (!connectorDeclarations.ok)
+        return connectorDeclarations;
     const declaredPageFiles = new Set(pageDeclarations.pages.flatMap((page) => [page.registry, page.entry]));
     const declaredReferenceFiles = new Set(referenceDeclarations.references.map((reference) => reference.path));
+    const declaredConnectorFiles = new Set(connectorDeclarations.connectors.map((connector) => connector.path));
     const warnings = [];
     for (const key of RESERVED_MANIFEST_KEYS) {
         if (key in manifest) {
@@ -257,6 +341,8 @@ export function parseRecipeFiles(files, source, options = {}) {
                 continue;
             if (declaredReferenceFiles.has(file.path))
                 continue;
+            if (declaredConnectorFiles.has(file.path))
+                continue;
             if (contentPolicy === "definitions-only") {
                 return {
                     ok: false,
@@ -324,6 +410,16 @@ export function parseRecipeFiles(files, source, options = {}) {
             });
             continue;
         }
+        // A Connector is a document type core's connector parser owns, never a recipe-declared Kind.
+        if (governs === CONNECTOR_TYPE) {
+            return {
+                ok: false,
+                error: {
+                    code: "RECIPE_MALFORMED",
+                    message: `recipe '${id}': '${doc.id}' governs '${CONNECTOR_TYPE}'; declare connectors in the manifest's 'connectors:' list instead`,
+                },
+            };
+        }
         if (contentPolicy === "definitions-only") {
             const parsed = parseConventionDoc(doc);
             if (!parsed.ok || parsed.warnings.length > 0) {
@@ -448,6 +544,39 @@ export function parseRecipeFiles(files, source, options = {}) {
         }
         references.push({ doc: { id: declaration.id, frontmatter, body } });
     }
+    const connectors = [];
+    // The recipe's own Kinds check the sources that target them now; a source whose Kind another
+    // recipe declares is checked against the bundle when the recipe is installed or evolved.
+    const ownKinds = connectorDeclarations.connectors.length > 0 ? buildKindRegistry(docs, [], options) : undefined;
+    for (const declaration of connectorDeclarations.connectors) {
+        const connectorFile = files.find((file) => file.path === declaration.path);
+        if (!connectorFile) {
+            return {
+                ok: false,
+                error: {
+                    code: "RECIPE_MALFORMED",
+                    message: `recipe '${id}' is missing declared Connector file '${declaration.path}'`,
+                },
+            };
+        }
+        const { frontmatter, body } = parseMarkdown(connectorFile.bytes, undefined, options);
+        const doc = { id: declaration.id, frontmatter, body };
+        const parsed = parseConnectorDoc(doc, { kinds: ownKinds });
+        if (!parsed.ok) {
+            const first = parsed.errors[0];
+            const more = parsed.errors.length - 1;
+            return {
+                ok: false,
+                error: {
+                    code: "RECIPE_CONNECTOR_INVALID",
+                    message: `recipe '${id}': invalid Connector '${declaration.path}': ${first.code} at '${first.path || "/"}': ${first.message}` +
+                        (more > 0 ? ` (and ${more} more)` : ""),
+                    connector: { id: declaration.id, code: first.code, path: first.path, count: parsed.errors.length },
+                },
+            };
+        }
+        connectors.push({ doc, connector: parsed.connector });
+    }
     const recipe = {
         id,
         title,
@@ -461,6 +590,8 @@ export function parseRecipeFiles(files, source, options = {}) {
         governs: governsList,
         warnings,
     };
+    if (connectorDeclarations.connectors.length > 0)
+        recipe.connectors = connectors;
     if (contentPolicy === "definitions-only")
         recipe.contentPolicy = contentPolicy;
     return { ok: true, recipe };