superbee 0.4.3-pre.10 → 0.4.3-pre.11

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.3-pre.10" }, source: { commit: "d5af6d38ba7c1eb5e47541925a6922606c36bd1a", 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.3-pre.11" }, source: { commit: "747849f327a718d1d5bc11d87450efd90ad9efca", dirty: false }, artifact: { channel: "npm-package" }, compatibility_contracts: { skill: 1, hook: 1, mcp: 1 } };
   }
 });
 
@@ -18068,15 +18068,17 @@ function materializeRecipeForEdition(recipe2, okfVersion) {
 function recipeDocumentForApply(doc2, okfVersion, now) {
   return okfVersion === "0.1" ? { ...doc2, frontmatter: { ...doc2.frontmatter, timestamp: now } } : { ...doc2, frontmatter: { ...doc2.frontmatter } };
 }
-async function createRecipeDocument(bundle, doc2, okfVersion, now) {
+async function createRecipeDocument(bundle, doc2, okfVersion, now, actor) {
   const result3 = await mutateDocument({
     bundle,
     id: doc2.id,
     mode: "create-only",
     registry: RECIPE_WRITE_REGISTRY,
     strict: false,
+    actor,
     // Installed definitions must stay byte-comparable to their recipe source (sameInstalledDoc
-    // strips generated.at but not an engine-seeded generated.by), so never seed a clock here.
+    // preserves upstream generated.by). Record the installer separately as mutation attribution,
+    // without manufacturing content provenance or replacing the recipe producer.
     seedGenerationClock: false,
     now: () => now,
     buildCandidate: (_existing, context) => {
@@ -18091,6 +18093,9 @@ async function createRecipeDocument(bundle, doc2, okfVersion, now) {
 async function installRecipe(bundle, recipe2, options = {}) {
   const now = options.now ?? (/* @__PURE__ */ new Date()).toISOString();
   const okfVersion = await readBundleOkfVersion2(bundle) ?? "0.1";
+  if (okfVersion === "0.2" && options.actor !== void 0 && !isOkfActor(options.actor)) {
+    throw new OkfActorError(options.actor, `OKF v0.2 mutation actor '${options.actor}' must be human:<id>, process:<id>, or <producer>/<version>`);
+  }
   const source = recipe2;
   recipe2 = materializeRecipeForEdition(recipe2, okfVersion);
   const identity = recipeStampIdentity(source, recipe2);
@@ -18126,7 +18131,7 @@ async function installRecipe(bundle, recipe2, options = {}) {
     let changed = true;
     let sourceDiffers2 = false;
     try {
-      doc2 = await createRecipeDocument(bundle, doc2, okfVersion, now);
+      doc2 = await createRecipeDocument(bundle, doc2, okfVersion, now, options.actor);
       stamps.push("current");
     } catch (err) {
       if (err instanceof VersionConflict) {
@@ -18156,7 +18161,7 @@ async function installRecipe(bundle, recipe2, options = {}) {
     let changed = true;
     let sourceDiffers2 = false;
     try {
-      await createRecipeDocument(bundle, doc2, okfVersion, now);
+      await createRecipeDocument(bundle, doc2, okfVersion, now, options.actor);
       stamps.push("current");
     } catch (err) {
       if (!(err instanceof VersionConflict)) throw err;
@@ -18228,7 +18233,7 @@ async function installRecipe(bundle, recipe2, options = {}) {
     let registry2 = recipeDocumentForApply(page.registry, okfVersion, now);
     let registryChanged = true;
     try {
-      registry2 = await createRecipeDocument(bundle, registry2, okfVersion, now);
+      registry2 = await createRecipeDocument(bundle, registry2, okfVersion, now, options.actor);
     } catch (err) {
       if (!(err instanceof VersionConflict)) throw err;
       const existing = await readDoc2(bundle, registry2.id);
@@ -18245,10 +18250,10 @@ async function installRecipe(bundle, recipe2, options = {}) {
   }
   const references = [];
   for (const reference of recipe2.references) {
-    let desired = recipeDocumentForApply(reference.doc, okfVersion, now);
+    let desired = withRecipeStamp(recipeDocumentForApply(reference.doc, okfVersion, now), identity);
     let changed = true;
     try {
-      desired = await createRecipeDocument(bundle, desired, okfVersion, now);
+      desired = await createRecipeDocument(bundle, desired, okfVersion, now, options.actor);
     } catch (err) {
       if (!(err instanceof VersionConflict)) throw err;
       const existing = await readDoc2(bundle, desired.id);
@@ -18361,6 +18366,9 @@ async function assertPortableTargetsCompatible(bundle, recipe2, now, okfVersion)
     for (const doc2 of referenceDocs) installedReferences.set(doc2.id, doc2);
   }
   for (const reference of recipe2.references) {
+    if (reference.doc.frontmatter.type !== "Reference") {
+      throw new RecipeInputError(`recipe '${recipe2.id}' asset '${reference.doc.id}' must have type 'Reference'`);
+    }
     const existing = installedReferences.get(reference.doc.id);
     if (!existing) continue;
     const desired = recipeDocumentForApply(reference.doc, okfVersion, now);
@@ -18379,6 +18387,9 @@ function sameBytes(a, b) {
 function sameInstalledDoc(existing, desired, okfVersion) {
   const { timestamp: _existingTimestamp, [RECIPE_STAMP_KEY]: _existingStamp, ...existingFrontmatter } = existing.frontmatter;
   const { timestamp: _desiredTimestamp, [RECIPE_STAMP_KEY]: _desiredStamp, ...desiredFrontmatter } = desired.frontmatter;
+  const actorField = okfVersion === "0.2" ? "superbee_updated_by" : "actor";
+  delete existingFrontmatter[actorField];
+  delete desiredFrontmatter[actorField];
   if (desiredFrontmatter.order === void 0) delete existingFrontmatter.order;
   if (okfVersion === "0.2") {
     for (const frontmatter of [existingFrontmatter, desiredFrontmatter]) {
@@ -18419,6 +18430,7 @@ var init_install = __esm({
     init_content_type();
     init_document_mutation();
     init_errors();
+    init_okf_actor();
     init_kinds();
     init_okf_authored_values();
     init_okf_standard_fields();
@@ -18457,8 +18469,9 @@ function setOwn3(record9, key2, value) {
     writable: true
   });
 }
-function additiveConventionCandidate(existing, desired, blockers) {
+function additiveConventionCandidate(existing, desired, blockers, canReplaceDescriptions) {
   const addedPaths = [];
+  const descriptionReplacements = [];
   const merge2 = (current, next, pointer2) => {
     if (current === void 0) {
       addedPaths.push(pointer2);
@@ -18475,6 +18488,10 @@ function additiveConventionCandidate(existing, desired, blockers) {
       return current;
     }
     if (okfValuesEqual(current, next)) return current;
+    if (canReplaceDescriptions && /^\/frontmatter\/fields\/descriptions\/[^/]+$/.test(pointer2) && typeof current === "string" && typeof next === "string") {
+      descriptionReplacements.push({ path: pointer2, old: current, new: next });
+      return next;
+    }
     if (Array.isArray(current) && Array.isArray(next)) {
       const merged = [...current];
       for (const value of current) {
@@ -18544,10 +18561,11 @@ function additiveConventionCandidate(existing, desired, blockers) {
   }
   return {
     candidate: { id: desired.id, frontmatter: candidateFrontmatter, body },
-    addedPaths: [...new Set(addedPaths)].sort()
+    addedPaths: [...new Set(addedPaths)].sort(),
+    descriptionReplacements: descriptionReplacements.sort((a, b) => a.path.localeCompare(b.path))
   };
 }
-function connectorReplacement(existing, desired) {
+function ownedAssetReplacement(existing, desired) {
   const frontmatter = {};
   for (const [key2, value] of Object.entries(desired.frontmatter)) {
     if (!PRESERVED_ROOT_METADATA.has(key2)) setOwn3(frontmatter, key2, value);
@@ -18751,6 +18769,7 @@ async function prepareRecipeEvolution(bundle, sourceRecipe) {
     ...warning.field ? { field: warning.field } : {}
   }));
   const definitions = [];
+  const references = [];
   const writes = /* @__PURE__ */ new Map();
   const proofs = [];
   const desiredKinds = /* @__PURE__ */ new Map();
@@ -18844,7 +18863,9 @@ async function prepareRecipeEvolution(bundle, sourceRecipe) {
         "governs"
       );
     }
-    const merged = additiveConventionCandidate(existing.doc, target3, blockers);
+    const identityState = recipeStampState(existing.doc, identity);
+    const canReplaceDescriptions = (identityState === "current" || identityState === "stale") && conventionStampState(existing.doc) === "current";
+    const merged = additiveConventionCandidate(existing.doc, target3, blockers, canReplaceDescriptions);
     let candidate = merged.candidate;
     if (okfVersion === "0.2") {
       try {
@@ -18883,7 +18904,6 @@ async function prepareRecipeEvolution(bundle, sourceRecipe) {
     }
     const desiredVersion = contentVersion(comparableRecipeDoc(candidate, okfVersion));
     const unchanged2 = sameInstalledDoc(existing.doc, candidate, okfVersion);
-    const identityState = recipeStampState(existing.doc, identity);
     const stamp = unchanged2 && identityState === "current" && conventionStampState(existing.doc) === "diverged" && definitionDigest(existing.doc) === definitionDigest(target3) ? "stale" : identityState;
     definitions.push({
       id: target3.id,
@@ -18892,7 +18912,8 @@ async function prepareRecipeEvolution(bundle, sourceRecipe) {
       stamp,
       expected_version: existing.version,
       desired_version: desiredVersion,
-      added_paths: unchanged2 ? [] : merged.addedPaths
+      added_paths: unchanged2 ? [] : merged.addedPaths,
+      ...merged.descriptionReplacements.length > 0 ? { description_replacements: merged.descriptionReplacements } : {}
     });
     if (!unchanged2) writes.set(target3.id, withRecipeStamp(candidate, identity));
     else if (stamp === "stale" || stamp === "missing") writes.set(target3.id, withRecipeStamp(existing.doc, identity));
@@ -18958,7 +18979,7 @@ async function prepareRecipeEvolution(bundle, sourceRecipe) {
       );
       continue;
     }
-    let candidate = connectorReplacement(existing.doc, target3);
+    let candidate = ownedAssetReplacement(existing.doc, target3);
     if (okfVersion === "0.2") {
       try {
         const withMetadata = applyV02MutationMetadata({
@@ -19016,11 +19037,53 @@ async function prepareRecipeEvolution(bundle, sourceRecipe) {
         blockers,
         "RECIPE_EVOLUTION_ASSET_CHANGE_UNSUPPORTED",
         target3.id,
-        `recipe evolution does not replace an existing ${kind2 === "reference" ? "Reference" : "View registry"} asset`
+        "recipe evolution does not replace an existing View registry asset"
       );
     }
   };
-  for (const reference of recipe2.references) await assetDocProof("reference", reference.doc);
+  for (const reference of recipe2.references) {
+    const target3 = recipeDocumentForApply({ ...reference.doc, body: normalizeDocumentBodyForStorage(reference.doc.body) }, okfVersion, "1970-01-01T00:00:00.000Z");
+    const existing = await readRecipeDocIfPresent(bundle, target3.id);
+    let candidate = existing ? ownedAssetReplacement(existing.doc, target3) : target3;
+    if (existing && okfVersion === "0.2") {
+      const producer = plainRecord2(existing.doc.frontmatter.generated)?.by;
+      try {
+        candidate = { id: target3.id, ...applyV02MutationMetadata({
+          existing: existing.doc,
+          candidate: { frontmatter: candidate.frontmatter, body: candidate.body },
+          ...typeof producer === "string" ? { producer } : {},
+          meaningfulChangeAt: "1970-01-01T00:00:00.000Z",
+          allowGeneratedProvenanceSeed: false
+        }) };
+      } catch (error51) {
+        if (!(error51 instanceof InvalidInputError)) throw error51;
+        evolutionBlocker(blockers, "RECIPE_EVOLUTION_WRITE_POLICY_INVALID", target3.id, `prospective Reference cannot satisfy the OKF v0.2 write policy: ${error51.message}`);
+      }
+    }
+    const wanted = contentVersion(comparableRecipeDoc(candidate, okfVersion));
+    const stamp = recipeStampState(existing?.doc ?? null, identity);
+    const unchanged2 = existing !== null && sameInstalledDoc(existing.doc, candidate, okfVersion);
+    references.push({ id: target3.id, action: !existing ? "missing" : unchanged2 ? "unchanged" : "update", stamp, expected_version: existing?.version ?? null, desired_version: wanted });
+    proofs.push({ kind: "reference", id: target3.id, current_version: existing?.version ?? null, desired_version: wanted });
+    if (!existing) {
+      evolutionBlocker(blockers, "RECIPE_EVOLUTION_ASSET_MISSING", target3.id, `recipe asset '${target3.id}' is not installed; install the complete recipe with 'recipe add' first`);
+      continue;
+    }
+    let reason;
+    if (existing.doc.frontmatter.type !== "Reference" || target3.frontmatter.type !== "Reference") reason = "is not a Reference";
+    else if (stamp === "foreign") reason = "belongs to another recipe";
+    else if (stamp === "missing") {
+      if (Object.hasOwn(existing.doc.frontmatter, RECIPE_STAMP_KEY)) reason = "has an unreadable recipe stamp";
+      else if (!sameInstalledDoc(existing.doc, target3, okfVersion)) reason = "has no ownership stamp and differs from the selected source";
+    } else if (conventionStampState(existing.doc) !== "current") reason = "has locally changed content or unreadable digest rules";
+    if (reason) {
+      evolutionBlocker(blockers, "RECIPE_EVOLUTION_REFERENCE_UNPROVEN", target3.id, `Reference '${target3.id}' ${reason}; evolution cannot prove recipe ownership and leaves it untouched`);
+      continue;
+    }
+    if (!unchanged2) writes.set(target3.id, withRecipeStamp(candidate, identity));
+    else if (stamp === "missing" || stamp === "stale") writes.set(target3.id, withRecipeStamp(existing.doc, identity));
+  }
+  references.sort((a, b) => a.id.localeCompare(b.id));
   for (const page of recipe2.pages) {
     await assetDocProof("view-registry", page.registry);
     const existing = await readBlob2(bundle, page.entry);
@@ -19120,6 +19183,7 @@ async function prepareRecipeEvolution(bundle, sourceRecipe) {
     recipe: { id: recipe2.id, version: recipe2.version, source: recipe2.source, source_digest: identity.source_digest },
     okfVersion,
     definitions,
+    ...references.length > 0 ? { references } : {},
     proofs,
     blockers
   });
@@ -19135,10 +19199,19 @@ async function prepareRecipeEvolution(bundle, sourceRecipe) {
       source: recipe2.source,
       okf_version: okfVersion,
       ready: blockers.length === 0,
-      changed: updates > 0,
+      changed: updates > 0 || references.some((row5) => row5.action === "update"),
       writes: writes.size,
       plan_token: token,
       definitions,
+      ...references.length > 0 ? { reference_assets: {
+        rows: references,
+        counts: {
+          updates: references.filter((row5) => row5.action === "update").length,
+          stamp_writes: references.filter((row5) => writes.has(row5.id) && row5.action !== "update").length,
+          unchanged: references.filter((row5) => row5.action === "unchanged").length,
+          missing: references.filter((row5) => row5.action === "missing").length
+        }
+      } } : {},
       counts: {
         definitions: definitions.length,
         updates,
@@ -19167,15 +19240,18 @@ async function applyRecipeEvolution(bundle, recipe2, expectedPlanToken, options
     throw new RecipeEvolutionBlocked(plan.id, plan.blockers);
   }
   const completed = [];
-  const pending = plan.definitions.filter((definition2) => prepared.writes.has(definition2.id)).map((definition2) => definition2.id);
-  for (const definition2 of plan.definitions) {
+  const targets = [...plan.definitions, ...(plan.reference_assets?.rows ?? []).map((row5) => ({ ...row5, asset_kind: "reference" }))];
+  const pending = targets.filter((definition2) => prepared.writes.has(definition2.id)).map((definition2) => definition2.id);
+  for (const definition2 of targets) {
+    const asset = "asset_kind" in definition2 ? { asset_kind: definition2.asset_kind } : {};
     const planned = prepared.writes.get(definition2.id);
     if (planned === void 0) {
-      completed.push({ id: definition2.id, changed: false, stamped: false, version: definition2.expected_version });
+      completed.push({ id: definition2.id, ...asset, changed: false, stamped: false, version: definition2.expected_version });
       continue;
     }
     const now = (/* @__PURE__ */ new Date()).toISOString();
     const desired = recipeDocumentForApply(planned, plan.okf_version, now);
+    const sourceProducer = "asset_kind" in definition2 ? plainRecord2(desired.frontmatter.generated)?.by : void 0;
     try {
       const result3 = await mutateDocument({
         bundle,
@@ -19190,7 +19266,9 @@ async function applyRecipeEvolution(bundle, recipe2, expectedPlanToken, options
         // explicitly opts out of seeding provenance when the installed definition has none.
         seedGenerationClock: false,
         // Evolution preserves source-comparable attribution; the backend still records its writer.
-        persistActor: false,
+        persistActor: "asset_kind" in definition2,
+        // Reference replacement retains its existing content producer; actor is advisory.
+        ...typeof sourceProducer === "string" ? { producer: sourceProducer } : {},
         actor,
         now: () => now,
         buildCandidate: (_existing, context) => {
@@ -19202,6 +19280,7 @@ async function applyRecipeEvolution(bundle, recipe2, expectedPlanToken, options
       });
       completed.push({
         id: definition2.id,
+        ...asset,
         changed: definition2.action === "update" && result3.changed,
         stamped: true,
         version: result3.version
@@ -19247,7 +19326,7 @@ async function applyRecipeEvolution(bundle, recipe2, expectedPlanToken, options
   } catch (error51) {
     throw new RecipeEvolutionPostcondition(
       "unverifiable",
-      `recipe evolution wrote ${written} definition(s), but its postcondition could not be verified: ${error51 instanceof Error ? error51.message : String(error51)}`,
+      `recipe evolution wrote ${written} ${plan.reference_assets ? "target(s)" : "definition(s)"}, but its postcondition could not be verified: ${error51 instanceof Error ? error51.message : String(error51)}`,
       completed,
       { cause: error51 }
     );
@@ -19255,7 +19334,7 @@ async function applyRecipeEvolution(bundle, recipe2, expectedPlanToken, options
   if (!postcondition.plan.ready || postcondition.plan.changed || postcondition.plan.writes > 0) {
     throw new RecipeEvolutionPostcondition(
       "changed",
-      `recipe evolution wrote ${written} definition(s), but the bundle changed (a definition or its stamp) before the postcondition check; a fresh recipe evolve plan shows the current state`,
+      `recipe evolution wrote ${written} ${plan.reference_assets ? "target(s)" : "definition(s)"}, but the bundle changed (${plan.reference_assets ? "a target" : "a definition"} or its stamp) before the postcondition check; a fresh recipe evolve plan shows the current state`,
       completed,
       { blockers: postcondition.plan.blockers, postcondition_plan: postcondition.plan.plan_token }
     );
@@ -19267,8 +19346,20 @@ async function applyRecipeEvolution(bundle, recipe2, expectedPlanToken, options
     source: plan.source,
     changed: written > 0,
     plan_token: plan.plan_token,
-    definitions: completed,
-    counts: { updated, stamped, unchanged: completed.length - written }
+    definitions: completed.filter((row5) => row5.asset_kind !== "reference"),
+    ...plan.reference_assets ? { reference_assets: {
+      rows: completed.filter((row5) => row5.asset_kind === "reference"),
+      counts: {
+        updated: completed.filter((row5) => row5.asset_kind === "reference" && row5.changed).length,
+        stamped: completed.filter((row5) => row5.asset_kind === "reference" && row5.stamped && !row5.changed).length,
+        unchanged: completed.filter((row5) => row5.asset_kind === "reference" && !row5.stamped).length
+      }
+    } } : {},
+    counts: {
+      updated: completed.filter((row5) => row5.asset_kind !== "reference" && row5.changed).length,
+      stamped: completed.filter((row5) => row5.asset_kind !== "reference" && row5.stamped && !row5.changed).length,
+      unchanged: completed.filter((row5) => row5.asset_kind !== "reference" && !row5.stamped).length
+    }
   };
 }
 var RECIPE_EVOLUTION_WRITE_REGISTRY, PRESERVED_ROOT_METADATA, BUNDLE_LOCAL_PLACEMENT, RESTRICTION_BLOCKER_DOC_CAP;
@@ -19283,6 +19374,7 @@ var init_evolution = __esm({
     init_document_mutation();
     init_document_write_policy();
     init_errors();
+    init_frontmatter();
     init_kinds();
     init_link_types();
     init_links();
@@ -22372,7 +22464,7 @@ var init_command_spec = __esm({
           {
             id: "recipeAdd",
             leaves: [publicLeaf("recipeAdd", "recipe add", one, 17, DIR_RECIPE_ROOT_SURFACE)],
-            usage: "recipe add <name-or-path> [--dir <path>] [--remote <url>]",
+            usage: "recipe add <name-or-path> [--actor <name>] [--dir <path>] [--remote <url>]",
             summary: "Apply a recipe's content-free definitions \u2014 Kinds plus optional declared References and Views \u2014 idempotently"
           },
           {
@@ -96861,6 +96953,7 @@ async function recipeAdd(argv2, stdout) {
       options: {
         dir: { type: "string" },
         remote: { type: "string" },
+        actor: { type: "string" },
         json: { type: "boolean" },
         help: { type: "boolean", short: "h" }
       },
@@ -96878,6 +96971,7 @@ async function recipeAdd(argv2, stdout) {
       help: `${cliInvocation()} recipes`
     });
   }
+  const actor = resolveActor(values.actor);
   const loaded = await resolveRecipe(ref);
   if (!loaded.ok) {
     throw new CliError("USAGE", loaded.error.message, {
@@ -96888,9 +96982,10 @@ async function recipeAdd(argv2, stdout) {
   if (values.remote === void 0) await assertRecipeAllowedInHostedCheckout("recipe add", values.dir, loaded.recipe);
   const remote = await resolveRemoteFlag(values.remote, values.dir);
   const bundle = await openBundle(values.dir, remote);
+  await assertActorAcceptedByBundle(bundle, actor);
   let result3;
   try {
-    result3 = await installRecipe(bundle, loaded.recipe);
+    result3 = await installRecipe(bundle, loaded.recipe, { actor });
   } catch (error51) {
     throw classifyBundleError(error51);
   }
@@ -96949,7 +97044,7 @@ var init_recipe = __esm({
     RECIPE_USAGE = `superbee recipe \u2014 apply a recipe to this bundle
 
 Usage:
-  superbee recipe add <name-or-path> [--dir <path>] [--remote <url>]
+  superbee recipe add <name-or-path> [--actor <name>] [--dir <path>] [--remote <url>]
   superbee recipe evolve <name-or-path> [--apply <plan-token>] [--actor <name>] [options]
 
 Applies a recipe's definitions to the bundle. <name-or-path> is a built-in name (e.g.
@@ -96991,7 +97086,9 @@ Options:
   --remote <url>        Talk to a wire-protocol server instead of a local bundle
                          (mutually exclusive with --dir; remote access is always explicit)
   --apply <plan-token>  Apply the exact ready token returned by 'recipe evolve' (evolve only)
-  --actor <name>        Attribute evolved convention writes (evolve only). OKF v0.2 bundles accept
+  --actor <name>        Attribute installed or evolved document writes. Add resolves --actor over
+                        SUPERBEE_ACTOR, legacy AGENTSTATE_LITE_ACTOR, then absent; conflicting
+                        environment values refuse. OKF v0.2 bundles accept
                         only an OKF actor: human:<id>, process:<id>, or <producer>/<version>
                         (e.g. openai/codex)
   --json                Emit compact JSON instead of TOON

package/package.json

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