@superbee/core 0.2.0-pre.3 → 0.2.0-pre.31

package/dist/body-replace-guards.d.ts

@@ -0,0 +1,52 @@
+import { InvalidInputError } from "./errors.js";
+import type { KindConvention } from "./kinds.js";
+import type { Bundle, Link, OkfDocument } from "./types.js";
+export declare const BODY_PREVIEW_LIMIT = 1000;
+export declare const BODY_PREVIEW_TRUNCATION_MARKER = "[superbee:body-preview-truncated]";
+export declare const BODY_PREVIEW_TRUNCATION_SIGNATURE: RegExp;
+export declare const BODY_PREVIEW_KEY = "body_preview";
+export declare const BODY_PREVIEW_RESERVED_KEYS: readonly string[];
+export declare function attachBodyPreview(rec: Record<string, unknown>, body: string, fullBodyHelp: readonly string[]): void;
+export type BodyPreviewFinding = {
+    reason: "preview_marker";
+    marker: string;
+    notice: string;
+} | {
+    reason: "stored_body_preview";
+    preview_limit: number;
+    supplied_body_chars: number;
+    stored_body_chars: number;
+};
+/** Unchanged serialized bodies and stored notices carried by a preserving append are safe. */
+export declare function bodyPreviewFinding(existing: OkfDocument, nextBody: string): BodyPreviewFinding | undefined;
+export type BodyReplaceFinding = BodyPreviewFinding | {
+    reason: "dropped_links";
+    dropped_links: Link[];
+};
+export declare class BodyReplaceError extends InvalidInputError {
+    readonly id: string;
+    readonly finding: BodyReplaceFinding;
+    readonly storedCarriesNotice: boolean;
+    constructor(id: string, finding: BodyReplaceFinding, storedCarriesNotice?: boolean);
+}
+export interface BodyReplacePosture {
+    acceptTruncatedBody?: boolean;
+    replaceLinks?: boolean;
+}
+/** Capture explicit per-write intent; truthy values and unknown flags never grant an override. */
+export declare function captureBodyReplacePosture(value: unknown): BodyReplacePosture | undefined;
+/** Exact pairs consume first; target mode then admits retext while preserving occurrence counts.
+ * Exact-edge mode is available to authorities that protect relationship text as well. */
+export declare function computeDroppedLinks(existingLinks: readonly Link[], nextLinks: readonly Link[], mode?: "target" | "exact-edge"): Link[];
+export declare function droppedLinks(_bundle: Bundle, existing: OkfDocument, nextBody: string): Link[];
+export declare function guardTruncatedBodyPreview(existing: OkfDocument, nextBody: string, acceptTruncatedBody: boolean): void;
+export declare function guardDroppedLinks(bundle: Bundle, existing: OkfDocument, nextBody: string, replaceLinks: boolean): void;
+export declare function guardBodyReplace(bundle: Bundle, existing: OkfDocument, nextBody: string, posture?: BodyReplacePosture): void;
+/** A scalar patch cannot replace a declared list, even when the stored field is absent. */
+export declare class TypedListPatchError extends InvalidInputError {
+    readonly field: string;
+    readonly fieldType: "string-list" | "https-url-list";
+    constructor(field: string, fieldType: "string-list" | "https-url-list");
+}
+export declare function assertTypedListPatch(kind: KindConvention, storageField: string): void;
+//# sourceMappingURL=body-replace-guards.d.ts.map

package/dist/body-replace-guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"body-replace-guards.d.ts","sourceRoot":"","sources":["../src/body-replace-guards.ts"],"names":[],"mappings":"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"}

package/dist/body-replace-guards.js

@@ -0,0 +1,176 @@
+/** Storage-neutral body replacement policy and portable preview identity. */
+import { normalizeDocumentBodyForStorage } from "./frontmatter.js";
+import { parseLinksFromDoc } from "./links.js";
+import { InvalidInputError } from "./errors.js";
+export const BODY_PREVIEW_LIMIT = 1000;
+export const BODY_PREVIEW_TRUNCATION_MARKER = "[superbee:body-preview-truncated]";
+function previewTruncationNotice(omitted) {
+    return `${BODY_PREVIEW_TRUNCATION_MARKER} ${omitted} more character(s) are NOT shown`;
+}
+export const BODY_PREVIEW_TRUNCATION_SIGNATURE = /\[superbee:body-preview-truncated\]\s+\d+\s+more\s+characters?\(?s?\)?\s+are\s+NOT\s+shown/i;
+export const BODY_PREVIEW_KEY = "body_preview";
+export const BODY_PREVIEW_RESERVED_KEYS = [
+    "body",
+    BODY_PREVIEW_KEY,
+    "body_truncated",
+    "body_chars",
+    "help",
+];
+export function attachBodyPreview(rec, body, fullBodyHelp) {
+    if (body.length <= BODY_PREVIEW_LIMIT) {
+        rec.body = body;
+        return;
+    }
+    const omitted = body.length - BODY_PREVIEW_LIMIT;
+    rec[BODY_PREVIEW_KEY] =
+        `${body.slice(0, BODY_PREVIEW_LIMIT)}\n\n${previewTruncationNotice(omitted)} — this value is a ` +
+            `preview, not the document body; use this record's help to read the complete body before ` +
+            `rewriting it.`;
+    rec.body_truncated = true;
+    rec.body_chars = body.length;
+    rec.help = [...fullBodyHelp];
+}
+function matchesPreviewSlice(candidate, preview) {
+    if (candidate === preview)
+        return true;
+    const trimmed = preview.trimEnd();
+    return trimmed !== "" && candidate.trimEnd() === trimmed;
+}
+function firstForeignNotice(storedBody, nextBody) {
+    const preservesStoredBody = nextBody.includes(storedBody.trimEnd());
+    const every = new RegExp(BODY_PREVIEW_TRUNCATION_SIGNATURE.source, `${BODY_PREVIEW_TRUNCATION_SIGNATURE.flags}g`);
+    for (const match of nextBody.matchAll(every)) {
+        if (!(preservesStoredBody && storedBody.includes(match[0])))
+            return match[0];
+    }
+    return undefined;
+}
+function isSameStoredBody(nextBody, existingBody) {
+    return normalizeDocumentBodyForStorage(nextBody) === normalizeDocumentBodyForStorage(existingBody);
+}
+/** Unchanged serialized bodies and stored notices carried by a preserving append are safe. */
+export function bodyPreviewFinding(existing, nextBody) {
+    if (isSameStoredBody(nextBody, existing.body))
+        return;
+    const notice = firstForeignNotice(existing.body, nextBody);
+    if (notice !== undefined)
+        return { reason: "preview_marker", marker: BODY_PREVIEW_TRUNCATION_MARKER, notice };
+    if (existing.body.length > BODY_PREVIEW_LIMIT && matchesPreviewSlice(nextBody, existing.body.slice(0, BODY_PREVIEW_LIMIT))) {
+        return { reason: "stored_body_preview", preview_limit: BODY_PREVIEW_LIMIT, supplied_body_chars: nextBody.length, stored_body_chars: existing.body.length };
+    }
+}
+export class BodyReplaceError extends InvalidInputError {
+    id;
+    finding;
+    storedCarriesNotice;
+    constructor(id, finding, storedCarriesNotice = false) {
+        super(`Body replacement of '${id}' refused: ${finding.reason}.`);
+        this.name = "BodyReplaceError";
+        this.id = id;
+        this.finding = finding;
+        this.storedCarriesNotice = storedCarriesNotice;
+    }
+}
+/** Capture explicit per-write intent; truthy values and unknown flags never grant an override. */
+export function captureBodyReplacePosture(value) {
+    if (value === undefined)
+        return;
+    if (value === null || typeof value !== "object" || Array.isArray(value) || ![Object.prototype, null].includes(Object.getPrototypeOf(value))) {
+        throw new InvalidInputError("bodyReplace must be an object with boolean acceptTruncatedBody and/or replaceLinks fields.");
+    }
+    const captured = {};
+    for (const key of Reflect.ownKeys(value)) {
+        if (key !== "acceptTruncatedBody" && key !== "replaceLinks")
+            throw new InvalidInputError("Unknown bodyReplace field.");
+        const descriptor = Object.getOwnPropertyDescriptor(value, key);
+        if (!("value" in descriptor) || typeof descriptor.value !== "boolean")
+            throw new InvalidInputError(`bodyReplace.${key} must be a boolean.`);
+        captured[key] = descriptor.value;
+    }
+    return captured;
+}
+/** Exact pairs consume first; target mode then admits retext while preserving occurrence counts.
+ * Exact-edge mode is available to authorities that protect relationship text as well. */
+export function computeDroppedLinks(existingLinks, nextLinks, mode = "target") {
+    const nextByTarget = new Map();
+    for (const l of nextLinks) {
+        const key = mode === "exact-edge" ? JSON.stringify([l.from, l.to]) : l.to;
+        const bucket = nextByTarget.get(key);
+        if (bucket)
+            bucket.push(l);
+        else
+            nextByTarget.set(key, [l]);
+    }
+    const existingByTarget = new Map();
+    for (const l of existingLinks) {
+        const key = mode === "exact-edge" ? JSON.stringify([l.from, l.to]) : l.to;
+        const bucket = existingByTarget.get(key);
+        if (bucket)
+            bucket.push(l);
+        else
+            existingByTarget.set(key, [l]);
+    }
+    const dropped = [];
+    for (const [target, oldOccurrences] of existingByTarget) {
+        const available = [...(nextByTarget.get(target) ?? [])]; // mutable, consumed as occurrences pair off
+        const unmatchedExact = [];
+        // Pass 1: exact (target,text) — consume one matching new occurrence per old occurrence.
+        for (const old of oldOccurrences) {
+            const idx = available.findIndex((n) => n.text === old.text);
+            if (idx >= 0)
+                available.splice(idx, 1);
+            else
+                unmatchedExact.push(old);
+        }
+        // Pass 2: retext — any leftover old occurrence pairs with any leftover same-target occurrence,
+        // regardless of text; anything still left over after that is a real drop.
+        for (const old of unmatchedExact) {
+            if (mode === "target" && available.length > 0)
+                available.shift();
+            else
+                dropped.push(old);
+        }
+    }
+    return dropped;
+}
+export function droppedLinks(_bundle, existing, nextBody) {
+    return computeDroppedLinks(parseLinksFromDoc(existing), parseLinksFromDoc({ ...existing, body: nextBody }));
+}
+export function guardTruncatedBodyPreview(existing, nextBody, acceptTruncatedBody) {
+    if (acceptTruncatedBody)
+        return;
+    const finding = bodyPreviewFinding(existing, nextBody);
+    if (finding)
+        throw new BodyReplaceError(existing.id, finding, BODY_PREVIEW_TRUNCATION_SIGNATURE.test(existing.body));
+}
+export function guardDroppedLinks(bundle, existing, nextBody, replaceLinks) {
+    if (replaceLinks || isSameStoredBody(nextBody, existing.body))
+        return;
+    const dropped = droppedLinks(bundle, existing, nextBody);
+    if (dropped.length)
+        throw new BodyReplaceError(existing.id, { reason: "dropped_links", dropped_links: dropped });
+}
+export function guardBodyReplace(bundle, existing, nextBody, posture) {
+    if (isSameStoredBody(nextBody, existing.body))
+        return;
+    guardTruncatedBodyPreview(existing, nextBody, Boolean(posture?.acceptTruncatedBody));
+    guardDroppedLinks(bundle, existing, nextBody, Boolean(posture?.replaceLinks));
+}
+/** A scalar patch cannot replace a declared list, even when the stored field is absent. */
+export class TypedListPatchError extends InvalidInputError {
+    field;
+    fieldType;
+    constructor(field, fieldType) {
+        super(`'${field}' is a ${fieldType} field; use an explicit whole-list replacement.`);
+        this.name = "TypedListPatchError";
+        this.field = field;
+        this.fieldType = fieldType;
+    }
+}
+export function assertTypedListPatch(kind, storageField) {
+    const types = kind.fields.types ?? {};
+    const type = Object.hasOwn(types, storageField) ? types[storageField] : undefined;
+    if (type === "string-list" || type === "https-url-list")
+        throw new TypedListPatchError(storageField, type);
+}
+//# sourceMappingURL=body-replace-guards.js.map

package/dist/body-replace-guards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"body-replace-guards.js","sourceRoot":"","sources":["../src/body-replace-guards.ts"],"names":[],"mappings":"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"}

package/dist/builtin-recipes/content.d.ts

@@ -0,0 +1,93 @@
+/** Optional shipped recipe content; generic bundle creation never imports this module. */
+import { type KindConvention } from "../kinds.js";
+/**
+ * The `Context Note` kind convention (moved VERBATIM from core's `CONTEXT_NOTE_KIND`, Recipes Unit
+ * A). `governs`/`title` are stamped from the locally-defined `CONTEXT_NOTE_TYPE` above — the type
+ * this recipe governs, authored via the GENERIC path (`new "Context Note" <id>` + `doc read`/`doc
+ * update`/`doc write`; there is no bespoke note command or codec anymore). `description` is
+ * declared OPTIONAL (not required) because a `new "Context Note"` instance can legitimately carry
+ * an empty one, and a kind must not fail its own convention's producer. `sections` declares ONLY
+ * `Summary` — the one heading the recipe SCAFFOLDS on every `new "Context Note"` create — for the
+ * same producer-must-pass reason: a summary-only note is the most common legitimate shape, and
+ * declaring additional headings would make `status` flag every minimal note with
+ * KIND_SECTION_MISSING noise — alert fatigue on the primary path. The seed's BODY carries a worked
+ * multi-section/`fields.values` example for authors of OTHER kinds to copy.
+ */
+export declare const CONTEXT_NOTE_KIND: KindConvention;
+/**
+ * The seed's prose body (`conventions/context-note.md`) is deliberately doubled up as the
+ * IN-BUNDLE authoring reference for kind conventions: every produced bundle that applies this
+ * recipe (via `init`'s default, or an explicit `recipe add context-notes`) ships one worked
+ * example of the ONE correct shape, right where an agent discovering `conventions/` will find it —
+ * not just in a doc an agent may never read. Bodies are prose (the registry only parses
+ * frontmatter, per `parseConventionDoc`), so a fenced YAML example here is inert to the parser
+ * and purely illustrative. The source uses one explicit logical-field token so the recipe
+ * materializer (core's `materializeRecipeForEdition`, which owns the token's interpretation) can
+ * teach the physical workflow coordinate appropriate to the target OKF edition; `recipes.test.ts`
+ * pins that an installed body equals `CONTEXT_NOTE_SEED_BODY` and carries no token.
+ */
+export declare const CONTEXT_NOTE_SEED_BODY_LOGICAL: string;
+/** V0.1 materialization retained for tests and direct recipe-content consumers. */
+export declare const CONTEXT_NOTE_SEED_BODY: string;
+/** One-line description, shown by `recipes` and the command reference — the built-in `context-notes`
+ * recipe's `recipe.md` manifest `summary:`. */
+export declare const CONTEXT_NOTES_SUMMARY = "Declares the built-in Context Note kind convention (title/timestamp required, 24h freshness horizon)";
+/** The prose body of the built-in `context-notes` recipe's `recipe.md` manifest doc — NOT parsed by
+ * `parseRecipeFiles` (only the manifest's frontmatter is read), purely descriptive for a human or
+ * agent who reads the recipe folder directly (built-in or, via a future `eject`, on disk). */
+export declare const RECIPE_DESC_BODY: string;
+/**
+ * The `Task` kind convention — the first DOMAIN recipe on the pluggable-recipe foundation
+ * (Recipes Unit B was the plumbing; this is the first thing built on it). The built-in now carries
+ * agent-readable purpose and field guidance; recipe application remains expect-absent, so an
+ * existing hand-authored Task convention is preserved rather than upgraded in place. No `sections`
+ * — unlike Context Note, a Task instance is not scaffolded around a fixed body shape; its body is
+ * free-form task description, and declaring expected headings here would just be lint noise on
+ * the common one-line task.
+ */
+export declare const TASK_KIND: KindConvention;
+/**
+ * The seed's prose body (`conventions/task.md`) explains how the generic primitives compose into
+ * task tracking. Composed entirely from EXISTING lite primitives (link graph as DAG, CAS write as claim,
+ * `list --type`/`status` as query/lint) — no bespoke task engine, no new verb. The CLI's task-aware
+ * columns, claim, and runnable/blocked projections are a separate concern, not part of this recipe.
+ */
+export declare const TASK_SEED_BODY: string;
+/** One-line description, shown by `recipes` and the command reference — the built-in
+ * `work-tracking` recipe's `recipe.md` manifest `summary:`. */
+export declare const WORK_TRACKING_SUMMARY = "Declares the built-in Task kind convention (title/progress_status required, workflow enum, 'depends on' link type, 30d freshness horizon)";
+/** The prose body of the built-in `work-tracking` recipe's `recipe.md` manifest doc — NOT parsed
+ * by `parseRecipeFiles` (only the manifest's frontmatter is read), purely descriptive. */
+export declare const WORK_TRACKING_DESC_BODY: string;
+/**
+ * The `Roadmap` kind convention — the SPINE: a single top-level roadmap doc that `contains` the
+ * bundle's Roadmap Items via typed links. Frontmatter faithful to the board's hand-authored
+ * `conventions/roadmap` (no `path` — the spine is one doc, conventionally the bundle-root
+ * `roadmap`, not a scaffolded family; no freshness horizon; `title` is the only required field).
+ */
+export declare const ROADMAP_KIND: KindConvention;
+/** The `conventions/roadmap.md` prose body. */
+export declare const ROADMAP_SEED_BODY: string;
+/**
+ * The `Roadmap Item` kind convention — a durable line of work spanning multiple tasks.
+ * Frontmatter faithful to the board's hand-authored `conventions/roadmap-item`: scaffolded under
+ * `roadmap-items/`, `contains` its Tasks, `status` is the three-state item lifecycle (coarser than
+ * Task's five-state enum on purpose — an item's granular progress is the derived task rollup, not
+ * a stored field).
+ */
+export declare const ROADMAP_ITEM_KIND: KindConvention;
+/** The `conventions/roadmap-item.md` prose body. */
+export declare const ROADMAP_ITEM_SEED_BODY: string;
+/** One-line description, shown by `recipes` and the command reference — the built-in `roadmap`
+ * recipe's `recipe.md` manifest `summary:`. */
+export declare const ROADMAP_SUMMARY = "Declares the Roadmap + Roadmap Item kind conventions (typed 'contains' links, roadmap \u2192 item \u2192 task; item progress_status enum queued/active/done) \u2014 work-tracking's companion";
+/** The prose body of the built-in `roadmap` recipe's `recipe.md` manifest doc — NOT parsed by
+ * `parseRecipeFiles` (only the manifest's frontmatter is read), purely descriptive. Its "Pairing
+ * the Task kind" section is the RECORDED resolution of this unit's expects_inbound design
+ * question: recipes apply via expect-absent CAS and can never patch an EXISTING `conventions/task`
+ * doc, and `kind field` edits only `fields.{required,optional,values}` — so the Task-side
+ * `expects_inbound` pairing is a documented one-step opt-in (pull → edit → promote, the
+ * CLI's one sanctioned convention-schema edit route), not a silent recipe patch. The chain below
+ * is pinned by a test that literally executes it (recipes.test.ts). */
+export declare const ROADMAP_DESC_BODY: string;
+//# sourceMappingURL=content.d.ts.map

package/dist/builtin-recipes/content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../../src/builtin-recipes/content.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAC1F,OAAO,EAAyB,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAMzE;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,iBAAiB,EAAE,cAmB/B,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,8BAA8B,QA+ClC,CAAC;AAMV,mFAAmF;AACnF,eAAO,MAAM,sBAAsB,QAGlC,CAAC;AAEF;+CAC+C;AAC/C,eAAO,MAAM,qBAAqB,yGACsE,CAAC;AAEzG;;8FAE8F;AAC9F,eAAO,MAAM,gBAAgB,QAMI,CAAC;AAMlC;;;;;;;;GAQG;AACH,eAAO,MAAM,SAAS,EAAE,cAkCvB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,cAAc,QAQe,CAAC;AAE3C;+DAC+D;AAC/D,eAAO,MAAM,qBAAqB,8IAC2G,CAAC;AAE9I;0FAC0F;AAC1F,eAAO,MAAM,uBAAuB,QAQb,CAAC;AAQxB;;;;;GAKG;AACH,eAAO,MAAM,YAAY,EAAE,cAW1B,CAAC;AAEF,+CAA+C;AAC/C,eAAO,MAAM,iBAAiB,QAMgB,CAAC;AAE/C;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,EAAE,cAiB/B,CAAC;AAEF,oDAAoD;AACpD,eAAO,MAAM,sBAAsB,QAOmB,CAAC;AAEvD;+CAC+C;AAC/C,eAAO,MAAM,eAAe,kMACsJ,CAAC;AAEnL;;;;;;;uEAOuE;AACvE,eAAO,MAAM,iBAAiB,QAyBd,CAAC"}

package/dist/builtin-recipes/content.js

@@ -0,0 +1,288 @@
+/** Optional shipped recipe content; generic bundle creation never imports this module. */
+import { PROGRESS_STATUS_FIELD } from "../kinds.js";
+import { RECIPE_PROGRESS_STATUS_TOKEN } from "../recipes.js";
+/** The recipe defines the type it governs; generic engine operations do not special-case it. */
+const CONTEXT_NOTE_TYPE = "Context Note";
+/**
+ * The `Context Note` kind convention (moved VERBATIM from core's `CONTEXT_NOTE_KIND`, Recipes Unit
+ * A). `governs`/`title` are stamped from the locally-defined `CONTEXT_NOTE_TYPE` above — the type
+ * this recipe governs, authored via the GENERIC path (`new "Context Note" <id>` + `doc read`/`doc
+ * update`/`doc write`; there is no bespoke note command or codec anymore). `description` is
+ * declared OPTIONAL (not required) because a `new "Context Note"` instance can legitimately carry
+ * an empty one, and a kind must not fail its own convention's producer. `sections` declares ONLY
+ * `Summary` — the one heading the recipe SCAFFOLDS on every `new "Context Note"` create — for the
+ * same producer-must-pass reason: a summary-only note is the most common legitimate shape, and
+ * declaring additional headings would make `status` flag every minimal note with
+ * KIND_SECTION_MISSING noise — alert fatigue on the primary path. The seed's BODY carries a worked
+ * multi-section/`fields.values` example for authors of OTHER kinds to copy.
+ */
+export const CONTEXT_NOTE_KIND = {
+    id: "conventions/context-note",
+    title: CONTEXT_NOTE_TYPE,
+    governs: CONTEXT_NOTE_TYPE,
+    path: "context-notes/",
+    fields: {
+        required: ["title", "timestamp"],
+        optional: ["description", "tags"],
+        values: {},
+        valueDescriptions: {},
+        terminal: {},
+        descriptions: {},
+    },
+    sections: ["Summary"],
+    freshnessHorizon: "24h",
+    // Context Notes are transient cross-session scratch — collapse them by default in browse listings
+    // so they never swamp durable knowledge (designs/document-discovery Decision 1). Per-bundle
+    // overridable by dropping the key; every other kind stays expanded.
+    browseCollapsed: true,
+};
+/**
+ * The seed's prose body (`conventions/context-note.md`) is deliberately doubled up as the
+ * IN-BUNDLE authoring reference for kind conventions: every produced bundle that applies this
+ * recipe (via `init`'s default, or an explicit `recipe add context-notes`) ships one worked
+ * example of the ONE correct shape, right where an agent discovering `conventions/` will find it —
+ * not just in a doc an agent may never read. Bodies are prose (the registry only parses
+ * frontmatter, per `parseConventionDoc`), so a fenced YAML example here is inert to the parser
+ * and purely illustrative. The source uses one explicit logical-field token so the recipe
+ * materializer (core's `materializeRecipeForEdition`, which owns the token's interpretation) can
+ * teach the physical workflow coordinate appropriate to the target OKF edition; `recipes.test.ts`
+ * pins that an installed body equals `CONTEXT_NOTE_SEED_BODY` and carries no token.
+ */
+export const CONTEXT_NOTE_SEED_BODY_LOGICAL = "# Context Note\n\n" +
+    "An agent's cross-session orientation note: what happened, what was decided, and what's " +
+    "still open. Create one with `new \"Context Note\" <id>` (scaffolds the `# Summary` section " +
+    "under `context-notes/`), read it with `doc read`, and edit it with `doc update` / `doc " +
+    "write`. This recipe retains `timestamp` as an explicit compatibility field and uses the " +
+    "Superbee-specific `freshness_horizon` Kind extension so `superbee status` can surface notes " +
+    "older than 24h. In an OKF v0.2 bundle, `generated.at` remains the standard meaningful-change " +
+    "clock when provenance is present.\n\n" +
+    "## Declaring a kind convention\n\n" +
+    "A kind convention is a plain OKF doc (`type: Convention`) living under `conventions/`. Its " +
+    "FRONTMATTER is the only part core parses (this prose is not). Supported frontmatter keys:\n\n" +
+    "- `governs` (required, non-empty) — the `type` value this convention governs.\n" +
+    "- `title` (optional) — display title; defaults to `governs`.\n" +
+    "- `description` (optional) — the kind's purpose and intended use.\n" +
+    "- `path` (optional) — canonical bundle-relative path prefix instances are scaffolded under " +
+    "(e.g. `roadmap/`).\n" +
+    "- `fields.required` — list of field names an instance MUST carry (non-empty).\n" +
+    "- `fields.optional` — list of field names an instance MAY carry.\n" +
+    "- `fields.descriptions` — a MAP of `field name -> human guidance` for declared fields.\n" +
+    "- `fields.values` — a MAP of `field name -> list of allowed values`. This is the ONLY place " +
+    "an enum constraint goes — never a top-level `enum:`/`enums:`/`values:`/`constraints:` key, " +
+    "and never a field named directly at the top level either.\n" +
+    "- `sections` — list of expected level-1 (`# Heading`) body-section names. Declare only the " +
+    "headings EVERY instance must carry (this Context Note kind declares just `Summary`, the one " +
+    "section `new \"Context Note\"` scaffolds and every instance carries).\n" +
+    "- `freshness_horizon` — a Superbee Kind extension using `<n>(m|h|d)`, e.g. `24h`, `30d`, `15m`.\n\n" +
+    "Worked example (a `Roadmap Item` kind, with an enum-restricted field and expected sections):\n\n" +
+    "```yaml\n" +
+    "---\n" +
+    "type: Convention\n" +
+    "title: Roadmap Item\n" +
+    "governs: Roadmap Item\n" +
+    "description: A durable line of work that groups related tasks.\n" +
+    "path: roadmap/\n" +
+    "fields:\n" +
+    `  required: [title, ${RECIPE_PROGRESS_STATUS_TOKEN}]\n` +
+    "  optional: [horizon]\n" +
+    "  values:\n" +
+    `    ${RECIPE_PROGRESS_STATUS_TOKEN}: [planned, active, done]\n` +
+    "  descriptions:\n" +
+    "    title: A concise summary of the outcome.\n" +
+    `    ${RECIPE_PROGRESS_STATUS_TOKEN}: The roadmap item's current workflow progress.\n` +
+    "    horizon: The expected delivery window.\n" +
+    "sections: [Why, \"Done when\"]\n" +
+    "freshness_horizon: 30d\n" +
+    "---\n" +
+    "```\n";
+function materializeRecipeBody(body, storageField) {
+    return body.replaceAll(RECIPE_PROGRESS_STATUS_TOKEN, storageField);
+}
+/** V0.1 materialization retained for tests and direct recipe-content consumers. */
+export const CONTEXT_NOTE_SEED_BODY = materializeRecipeBody(CONTEXT_NOTE_SEED_BODY_LOGICAL, "status");
+/** One-line description, shown by `recipes` and the command reference — the built-in `context-notes`
+ * recipe's `recipe.md` manifest `summary:`. */
+export const CONTEXT_NOTES_SUMMARY = "Declares the built-in Context Note kind convention (title/timestamp required, 24h freshness horizon)";
+/** The prose body of the built-in `context-notes` recipe's `recipe.md` manifest doc — NOT parsed by
+ * `parseRecipeFiles` (only the manifest's frontmatter is read), purely descriptive for a human or
+ * agent who reads the recipe folder directly (built-in or, via a future `eject`, on disk). */
+export const RECIPE_DESC_BODY = "# Context Notes\n\n" +
+    "Installs the `Context Note` kind convention: a lightweight cross-session orientation note — " +
+    "what happened, what was decided, what's still open. Declares the `Context Note` type's " +
+    "required fields, the `# Summary` scaffold section, and a 24h freshness horizon.\n\n" +
+    "Applied by default on `init` (opt out with `init --recipe none`), or on demand with " +
+    "`recipe add context-notes`.\n";
+/** The `type` value the work-tracking recipe governs — mirrors `CONTEXT_NOTE_TYPE`'s pattern (a
+ * recipe is exactly the thing that DEFINES the type it governs). */
+const TASK_TYPE = "Task";
+/**
+ * The `Task` kind convention — the first DOMAIN recipe on the pluggable-recipe foundation
+ * (Recipes Unit B was the plumbing; this is the first thing built on it). The built-in now carries
+ * agent-readable purpose and field guidance; recipe application remains expect-absent, so an
+ * existing hand-authored Task convention is preserved rather than upgraded in place. No `sections`
+ * — unlike Context Note, a Task instance is not scaffolded around a fixed body shape; its body is
+ * free-form task description, and declaring expected headings here would just be lint noise on
+ * the common one-line task.
+ */
+export const TASK_KIND = {
+    id: "conventions/task",
+    title: TASK_TYPE,
+    governs: TASK_TYPE,
+    description: "A concrete unit of work that can be claimed, prioritized, assigned, and completed.",
+    path: "tasks/",
+    // The typed-edge vocabulary (decisions/typed-links-carrier): a task's dependency edge is a
+    // link whose display text is exactly "depends on", targeting another Task. Declared here so
+    // `kinds` teaches the vocabulary to any agent that orients — discovery shipped; validation
+    // is a future consumer.
+    links: { "depends on": TASK_TYPE },
+    // The claim coordinates (research/atomic-shared-task-claim-design): declaring them is what
+    // lets sync's converge report a lost claim as ownership and withdraw the re-apply route,
+    // instead of presenting the race as an ordinary content conflict. Logical names; the
+    // edition's coordinate policy resolves them onto storage keys.
+    claim: { ownerField: "assignee", stateField: "progress_status" },
+    fields: {
+        required: ["title", PROGRESS_STATUS_FIELD],
+        optional: ["priority", "assignee", "description"],
+        values: { [PROGRESS_STATUS_FIELD]: ["todo", "in_progress", "blocked", "done", "canceled"] },
+        valueDescriptions: {},
+        // The terminal declaration (tasks/status-terminal-declaration.md): done/canceled are the
+        // states past which a Task is no longer open — machinery (list --open, the status sweep's
+        // exclusion + sort) ships together with the declaration for every new bundle.
+        terminal: { [PROGRESS_STATUS_FIELD]: ["done", "canceled"] },
+        descriptions: {
+            title: "A concise human-readable summary of the work.",
+            [PROGRESS_STATUS_FIELD]: "The task's current workflow state.",
+            priority: "Relative urgency used to order the work; follow the bundle's adopted priority scale.",
+            assignee: "The person or agent currently responsible for the task.",
+            description: "The task's scope, context, acceptance criteria, and other working details.",
+        },
+    },
+    freshnessHorizon: "30d",
+};
+/**
+ * The seed's prose body (`conventions/task.md`) explains how the generic primitives compose into
+ * task tracking. Composed entirely from EXISTING lite primitives (link graph as DAG, CAS write as claim,
+ * `list --type`/`status` as query/lint) — no bespoke task engine, no new verb. The CLI's task-aware
+ * columns, claim, and runnable/blocked projections are a separate concern, not part of this recipe.
+ */
+export const TASK_SEED_BODY = "# Task\n\n" +
+    "A unit of work, composed entirely from lite primitives — no bespoke task engine.\n" +
+    "A task is a `type: Task` doc; its logical `progress_status` is a validated enum; its DEPENDENCIES are\n" +
+    "typed `depends on` cross-links to prerequisite task docs (the declared link type —\n" +
+    "the link graph IS the DAG, and `link show <id> --text \"depends on\"` shows both\n" +
+    "directions); an atomic CLAIM is a compare-and-swap write flipping `progress_status` to\n" +
+    "`in_progress` (a second claimer gets a VersionConflict). Query with `list --type Task`;\n" +
+    "lint/orphans/staleness via `status`.\n";
+/** One-line description, shown by `recipes` and the command reference — the built-in
+ * `work-tracking` recipe's `recipe.md` manifest `summary:`. */
+export const WORK_TRACKING_SUMMARY = "Declares the built-in Task kind convention (title/progress_status required, workflow enum, 'depends on' link type, 30d freshness horizon)";
+/** The prose body of the built-in `work-tracking` recipe's `recipe.md` manifest doc — NOT parsed
+ * by `parseRecipeFiles` (only the manifest's frontmatter is read), purely descriptive. */
+export const WORK_TRACKING_DESC_BODY = "# Work Tracking\n\n" +
+    "Installs the `Task` kind convention: a unit of work with a validated logical `progress_status` enum " +
+    "(todo/in_progress/blocked/done/canceled), scaffolded under `tasks/`. Status/priority/assignee " +
+    "are FIELDS of Task, not separate conventions or a bespoke task verb — dependencies, claiming, " +
+    "and querying all compose from existing generic primitives (`link add`, CAS `doc update`, " +
+    "`list --type Task`, `status`).\n\n" +
+    "Applied on demand with `recipe add work-tracking` (not part of `init`'s default — that stays " +
+    "`context-notes`).\n";
+/** The `type` values the roadmap recipe governs — extracted from the project's own board (the
+ * hand-authored `conventions/roadmap` + `conventions/roadmap-item` docs), the same
+ * dogfood-then-package path work-tracking took. */
+const ROADMAP_TYPE = "Roadmap";
+const ROADMAP_ITEM_TYPE = "Roadmap Item";
+/**
+ * The `Roadmap` kind convention — the SPINE: a single top-level roadmap doc that `contains` the
+ * bundle's Roadmap Items via typed links. Frontmatter faithful to the board's hand-authored
+ * `conventions/roadmap` (no `path` — the spine is one doc, conventionally the bundle-root
+ * `roadmap`, not a scaffolded family; no freshness horizon; `title` is the only required field).
+ */
+export const ROADMAP_KIND = {
+    id: "conventions/roadmap",
+    title: ROADMAP_TYPE,
+    governs: ROADMAP_TYPE,
+    // The typed-edge vocabulary: the spine's ownership edge is a link whose display text is exactly
+    // "contains", targeting a Roadmap Item — declared so `kinds` teaches it and `link add`'s graph
+    // lint validates it.
+    links: { contains: ROADMAP_ITEM_TYPE },
+    // No status field on the spine, so nothing to declare terminal (Brian's ruling on the
+    // task board's `tasks/status-terminal-declaration.md`).
+    fields: { required: ["title"], optional: [], values: {}, valueDescriptions: {}, terminal: {}, descriptions: {} },
+};
+/** The `conventions/roadmap.md` prose body. */
+export const ROADMAP_SEED_BODY = "# Roadmap\n\n" +
+    "The spine document: a single top-level roadmap doc that CONTAINS the bundle's Roadmap\n" +
+    "Items via typed links carrying the text `contains` (`link add <roadmap> <item> --text\n" +
+    "contains`), making the whole roadmap → item → task chain one filtered query per hop\n" +
+    "(`link show <id> --text contains`). Progress is DERIVED, never stored: list the\n" +
+    "contained items and read their statuses.\n";
+/**
+ * The `Roadmap Item` kind convention — a durable line of work spanning multiple tasks.
+ * Frontmatter faithful to the board's hand-authored `conventions/roadmap-item`: scaffolded under
+ * `roadmap-items/`, `contains` its Tasks, `status` is the three-state item lifecycle (coarser than
+ * Task's five-state enum on purpose — an item's granular progress is the derived task rollup, not
+ * a stored field).
+ */
+export const ROADMAP_ITEM_KIND = {
+    id: "conventions/roadmap-item",
+    title: ROADMAP_ITEM_TYPE,
+    governs: ROADMAP_ITEM_TYPE,
+    path: "roadmap-items/",
+    links: { contains: "Task" },
+    linkDescriptions: { contains: "Tasks whose delivery is governed by this roadmap commitment." },
+    fields: {
+        required: ["title", PROGRESS_STATUS_FIELD],
+        optional: ["description", "sequence"],
+        values: { [PROGRESS_STATUS_FIELD]: ["queued", "active", "done"] },
+        valueDescriptions: {},
+        // Brian's ruling (task board `tasks/status-terminal-declaration.md`): a done Roadmap Item
+        // hides from `list --open`, consistent with Task's done/canceled.
+        terminal: { [PROGRESS_STATUS_FIELD]: ["done"] },
+        descriptions: {},
+    },
+};
+/** The `conventions/roadmap-item.md` prose body. */
+export const ROADMAP_ITEM_SEED_BODY = "# Roadmap Item\n\n" +
+    "A durable line of work spanning multiple tasks — the granular form of the single\n" +
+    "roadmap spine doc. An item CONTAINS its tasks via links carrying the text `contains`;\n" +
+    "backlinks from a task answer \"which item owns this\". An item's progress is DERIVED,\n" +
+    "never stored: list its contained tasks and read their workflow states (the rollup). `progress_status`\n" +
+    "tracks the item itself: `queued` (not started) → `active` (any contained task moving)\n" +
+    "→ `done` (all contained tasks done or canceled).\n";
+/** One-line description, shown by `recipes` and the command reference — the built-in `roadmap`
+ * recipe's `recipe.md` manifest `summary:`. */
+export const ROADMAP_SUMMARY = "Declares the Roadmap + Roadmap Item kind conventions (typed 'contains' links, roadmap → item → task; item progress_status enum queued/active/done) — work-tracking's companion";
+/** The prose body of the built-in `roadmap` recipe's `recipe.md` manifest doc — NOT parsed by
+ * `parseRecipeFiles` (only the manifest's frontmatter is read), purely descriptive. Its "Pairing
+ * the Task kind" section is the RECORDED resolution of this unit's expects_inbound design
+ * question: recipes apply via expect-absent CAS and can never patch an EXISTING `conventions/task`
+ * doc, and `kind field` edits only `fields.{required,optional,values}` — so the Task-side
+ * `expects_inbound` pairing is a documented one-step opt-in (pull → edit → promote, the
+ * CLI's one sanctioned convention-schema edit route), not a silent recipe patch. The chain below
+ * is pinned by a test that literally executes it (recipes.test.ts). */
+export const ROADMAP_DESC_BODY = "# Roadmap\n\n" +
+    "Installs the `Roadmap` and `Roadmap Item` kind conventions: roadmap-items-as-docs. A single\n" +
+    "`Roadmap` spine doc CONTAINS `Roadmap Item` docs; each item CONTAINS its `Task` docs — all\n" +
+    "via typed links carrying the text `contains`, so the whole roadmap → item → task chain is\n" +
+    "one filtered query per hop (`link show <id> --text contains`). An item's progress is derived\n" +
+    "from its contained tasks' statuses, never stored.\n\n" +
+    "Applied on demand with `recipe add roadmap` (not part of `init`'s default — that stays\n" +
+    "`context-notes`). Composes with the `work-tracking` recipe (the `Task` kind this recipe's\n" +
+    "`contains` vocabulary points at) — apply both for the full chain.\n\n" +
+    "## Pairing the Task kind (opt-in, one documented step)\n\n" +
+    "The graph lint that answers \"which tasks have no owning Roadmap Item\" reads\n" +
+    "`expects_inbound` on the TASK kind's convention (`status` then reports\n" +
+    "`missing_expected_links`). A recipe applies via expect-absent CAS and never touches a doc\n" +
+    "that already exists, so this recipe cannot patch your bundle's `conventions/task` — the\n" +
+    "pairing is a deliberate one-step opt-in on the adopting bundle:\n\n" +
+    "```\n" +
+    "superbee pull --doc-key conventions/task.md --out task.md\n" +
+    "# edit task.md — add to the frontmatter:\n" +
+    "#   expects_inbound:\n" +
+    "#     contains: Roadmap Item\n" +
+    "superbee promote task.md --doc-key conventions/task.md --expected-version <version from the pull receipt>\n" +
+    "```\n\n" +
+    "Without this step everything else still works (the `contains` vocabulary and its link-type\n" +
+    "validation come from THIS recipe's conventions); only the \"task lacks an owning item\" lint\n" +
+    "stays off.\n";
+//# sourceMappingURL=content.js.map