@intentius/chant 0.46.0 → 0.50.0

package/dist/lifecycle/unobserved-gate.d.ts

@@ -0,0 +1,67 @@
+/**
+ * The unobserved gate predicate (#1568): a plan containing unobserved
+ * entities must not pass as clean.
+ *
+ * `buildChangeSet` (./change-set.ts) already refuses to guess when a lexicon
+ * could not look (#1089) — entries land as `action: "unobserved"`, carrying a
+ * total `unobservedReason` (`read-failed`, `no-credentials`, `no-binding`,
+ * `unsupported-kind`, `filtered`; see ../observation.ts). But nothing
+ * downstream is *required* to look: a gate that checks lint-clean,
+ * owned-only, and a blast-radius budget can walk right past a change set
+ * whose live read partially failed and call it clean, because none of those
+ * checks reads `unobserved` at all. A gate over an incomplete read is a gate
+ * over a guess.
+ *
+ * This is a reusable predicate, not a runtime — evaluate a `ChangeSet`
+ * against a policy and get back a verdict; the caller (a `lint.policies`
+ * check routed through `policyGate`, an Op step, #1487's gate-as-fact once it
+ * lands) decides what to do with a refusal (throw, diagnostic, a durable
+ * gated-run fact). Same instinct #1484 already adopts for `unknown` in the
+ * operating loop ("`unknown` never remediates"), surfaced here as something
+ * any gate can declare rather than a property of one runtime.
+ */
+import type { ChangeSet } from "./change-set.js";
+import { type UnobservedReason } from "../observation.js";
+/**
+ * How the gate treats the change set's unobserved set.
+ *
+ * - `"refuse"` (the default) — any unobserved entry not covered by `allow`
+ *   fails the gate outright. Fail-closed, the right default for a policy set
+ *   aimed at agent-proposed change sets: a hole must never launder into a
+ *   clean verdict just because nobody configured otherwise.
+ * - `"escalate"` — the gate does not fail here; instead the verdict reports
+ *   `escalate: true` so a caller can route the plan to a stricter gate class
+ *   rather than the ordinary path (the same shape of routing decision #1569
+ *   makes for pipeline changes).
+ * - `{ allow: [...] }` — the listed reasons are tolerated (e.g. `"filtered"`,
+ *   intentional in a scoped run) and never fail or escalate the gate; any
+ *   reason NOT in the list still refuses. `no-credentials` — a hole that must
+ *   never launder into a clean verdict — should never appear in an `allow`
+ *   list for a policy aimed at agent-proposed change sets.
+ */
+export type UnobservedGatePolicy = "refuse" | "escalate" | {
+    allow: UnobservedReason[];
+};
+/** One unobserved hole the gate found, carried into the refusal. */
+export interface UnobservedGateFinding {
+    name: string;
+    type?: string;
+    reason: UnobservedReason;
+    detail?: string;
+}
+export interface UnobservedGateVerdict {
+    /** False when the policy is `"refuse"` (default) and an unallowed unobserved entry exists. */
+    pass: boolean;
+    /** True when the policy is `"escalate"` and an unallowed unobserved entry exists — route to a stricter gate instead of failing here. */
+    escalate: boolean;
+    /** Every unobserved entry the policy did not allow. Empty when `pass` is true and `escalate` is false. */
+    findings: UnobservedGateFinding[];
+    /** Human-readable summary carrying the reasons into a refusal — the message a caller can surface as-is. Undefined when `findings` is empty. */
+    detail?: string;
+}
+/**
+ * Evaluate a `ChangeSet`'s unobserved set against `policy`. Pure — reads only
+ * `cs.entries`, no I/O. Defaults to `"refuse"`.
+ */
+export declare function evaluateUnobservedGate(cs: ChangeSet, policy?: UnobservedGatePolicy): UnobservedGateVerdict;
+//# sourceMappingURL=unobserved-gate.d.ts.map

package/dist/lifecycle/unobserved-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unobserved-gate.d.ts","sourceRoot":"","sources":["../../src/lifecycle/unobserved-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAwB,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAE7E;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,oBAAoB,GAAG,QAAQ,GAAG,UAAU,GAAG;IAAE,KAAK,EAAE,gBAAgB,EAAE,CAAA;CAAE,CAAC;AAEzF,oEAAoE;AACpE,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,gBAAgB,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC,8FAA8F;IAC9F,IAAI,EAAE,OAAO,CAAC;IACd,wIAAwI;IACxI,QAAQ,EAAE,OAAO,CAAC;IAClB,0GAA0G;IAC1G,QAAQ,EAAE,qBAAqB,EAAE,CAAC;IAClC,+IAA+I;IAC/I,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,EAAE,EAAE,SAAS,EACb,MAAM,GAAE,oBAA+B,GACtC,qBAAqB,CA+BvB"}

package/dist/lint/knowledge-checks.d.ts

@@ -0,0 +1,48 @@
+import type { PostSynthCheck } from "./post-synth.js";
+import type { OkfBundle } from "../okf-read.js";
+/**
+ * COR026: Stale Knowledge Binding (#1865, design #1059, epic #1057)
+ *
+ * A concept's `binds` frontmatter key names a discovered entity's logical
+ * name (#1864, `../okf-read.ts`'s `bindConcepts`). A name that resolves to
+ * nothing is a stale binding — the entity was renamed or removed, or the
+ * concept was authored against a name that never existed — and per #1059's
+ * stated failure posture ("the spec permits broken links, which argues for
+ * warn") that is a warning, never a build failure: knowledge is deliberately
+ * softer than the typed graph it describes, and OKF itself tolerates broken
+ * links (epic #1057).
+ *
+ * The converse is deliberately silent: a concept with no `binds` at all is
+ * orphaned knowledge, not an omission (a runbook, a decision about the
+ * project as a whole), and `bindConcepts` never reports it as unresolved in
+ * the first place — see its own doc comment. A project with no knowledge
+ * bundle loads an empty one (`loadOkfBundle`), so this check produces no
+ * diagnostics either.
+ *
+ * Wired into `chant build` (`../cli/commands/build.ts`) alongside
+ * `coreReceiptChecks` — same reasons COR023/COR024 are build-owned rather
+ * than a per-file `LintRule`: the check needs the full discovered entity map
+ * (`ctx.entities`), not one `ts.SourceFile`, and that map only exists after
+ * discovery has run. Unlike COR023/024 it never reads `ctx.outputs` — the
+ * bundle is loaded once, up front (async — `loadOkfBundle` reads the
+ * filesystem), and closed over here so the check itself stays the same sync
+ * shape every other `PostSynthCheck` has.
+ */
+export declare const STALE_KNOWLEDGE_BINDING_CHECK_ID = "COR026";
+/**
+ * Build the COR026 check for one loaded bundle. A factory, not a bare
+ * constant, because — unlike `coreReceiptChecks`, which needs nothing but
+ * `ctx.entities` — this check needs the bundle loaded from disk, and
+ * `loadOkfBundle` is async while `PostSynthCheck#check` is not. The caller
+ * loads the bundle once (`resolveKnowledgeDir` + `loadOkfBundle`) and passes
+ * it in; see `../cli/commands/build.ts`.
+ */
+export declare function staleKnowledgeBindingCheck(bundle: OkfBundle): PostSynthCheck;
+/**
+ * Core's own post-synth check over knowledge bindings, run by `chant build`
+ * over the full build result — unscoped, like `coreReceiptChecks`, since a
+ * concept's `binds` can name any discovered entity regardless of which
+ * lexicon owns it.
+ */
+export declare function coreKnowledgeChecks(bundle: OkfBundle): PostSynthCheck[];
+//# sourceMappingURL=knowledge-checks.d.ts.map

package/dist/lint/knowledge-checks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-checks.d.ts","sourceRoot":"","sources":["../../src/lint/knowledge-checks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAuB,MAAM,cAAc,CAAC;AACxE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAG7C;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,eAAO,MAAM,gCAAgC,WAAW,CAAC;AAEzD;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,GAAG,cAAc,CAoB5E;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,GAAG,cAAc,EAAE,CAEvE"}

package/dist/lint/output-checks.d.ts

@@ -0,0 +1,5 @@
+import type { PostSynthCheck } from "./post-synth.js";
+export declare const STRINGIFIED_REFERENCE_CHECK_ID = "COR025";
+/** Core-owned post-synth checks over serialized output text (#1526). */
+export declare function coreOutputChecks(): PostSynthCheck[];
+//# sourceMappingURL=output-checks.d.ts.map

package/dist/lint/output-checks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-checks.d.ts","sourceRoot":"","sources":["../../src/lint/output-checks.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAuB,MAAM,cAAc,CAAC;AAoCxE,eAAO,MAAM,8BAA8B,WAAW,CAAC;AA0DvD,wEAAwE;AACxE,wBAAgB,gBAAgB,IAAI,cAAc,EAAE,CAEnD"}

package/dist/lint/output-docs.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Parsed-output view for post-synth checks (chant #975).
+ *
+ * `PostSynthContext.outputs` carries raw serialized strings — a `chant build`
+ * consumer has to parse YAML/JSON itself before it can reason about
+ * structure. Every lexicon that needs this today rolls its own splitter
+ * (`parseK8sManifests` in k8s, hand-rolled `JSON.parse` in aws's
+ * `cf-refs.ts`), and each of the ~30 k8s post-synth checks reparses the same
+ * output independently. This module is the shared, parse-once primitive:
+ * `parseOutputDocs` turns `ctx.outputs` into a flat list of `OutputDoc`s,
+ * and `PostSynthContext.docs` (see `./post-synth.ts`) memoizes one call to it
+ * per build so every check — lexicon-shipped or project-authored policy —
+ * shares the same parse.
+ *
+ * `pick`/`get` are the "look at only the fields you care about" ergonomic
+ * from the issue's `,remain`-style framing — a partial, unvalidated view of
+ * an already-parsed tree, not a query DSL. Selector languages over the
+ * *source* AST stay in `./declarative.ts`; this module is output-side only.
+ */
+import type { SerializerResult } from "../serializer.js";
+/**
+ * One parsed document from a build's serialized output.
+ *
+ * A single `ctx.outputs` entry can yield more than one `OutputDoc`: a
+ * multi-document YAML stream (`---`-separated) yields one per document, and
+ * a `SerializerResult` with `files` yields further docs for each nested
+ * file (a CloudFormation nested stack template, a sidecar manifest).
+ */
+export interface OutputDoc {
+    /** The `ctx.outputs` map key this document came from. */
+    lexicon: string;
+    /** Position of this document within its source (primary output or one
+     *  `files` entry) — 0 for a single-document source, 0..n-1 for a
+     *  multi-document YAML stream. */
+    index: number;
+    /** Whether this document was decoded as YAML or as whole-content JSON. */
+    format: "yaml" | "json";
+    /** The parsed tree. `undefined` when parsing failed — see `error`. */
+    value: unknown;
+    /**
+     * Set when this document came from a `SerializerResult.files` entry rather
+     * than the primary output — the file's key in that map (e.g. a nested
+     * stack template's filename).
+     */
+    file?: string;
+    /**
+     * Set when this document could not be parsed into a usable tree. The
+     * document is still returned (a marker, not a throw) so a caller can see
+     * that something in the build output failed to parse, rather than the
+     * failure disappearing silently the way `parseK8sManifests` has always
+     * swallowed it. `value` is `undefined` on an errored document. Filter with
+     * `ctx.docs.filter((d) => !d.error)` to get only usable documents.
+     */
+    error?: string;
+}
+/**
+ * Parse every output in `outputs` into a flat list of `OutputDoc`s: one call,
+ * shared by every post-synth check via `PostSynthContext.docs`.
+ *
+ * Format detection is whole-source, not per-document: if the entire source
+ * parses as JSON, it is one `"json"` document (CloudFormation, most non-k8s
+ * serializers). Otherwise the source is treated as a YAML stream — split on
+ * `---` document separators — and each resulting document is parsed as YAML
+ * (`format: "yaml"`), even one that happens to also be valid JSON, since
+ * JSON is a YAML subset. `SerializerResult.files` entries (nested templates,
+ * sidecar manifests) are parsed the same way, tagged with `file`.
+ *
+ * A document that fails to parse into a non-null object/array — malformed
+ * input, or a bare scalar where a manifest was expected — is not thrown:
+ * it is included with `error` set and `value: undefined`. See `OutputDoc`.
+ */
+export declare function parseOutputDocs(outputs: Map<string, string | SerializerResult>): OutputDoc[];
+/**
+ * Partial typed decode — the `,remain`-style ergonomic from `ma91n/tfpolicy`:
+ * decode the fields you care about, leave everything else in place,
+ * unvalidated. Returns a shallow, top-level view of `value` narrowed to the
+ * keys named in `shape`. A key absent from `value` (or `value` not being a
+ * plain object) is simply absent from the result — no default is invented.
+ *
+ * This is NOT runtime validation: a key that IS present is copied as-is,
+ * whatever its actual shape, and cast to `T`'s declared type for that key.
+ * Use `get` for a deeper walk into one of the picked values.
+ */
+export declare function pick<T extends object>(value: unknown, shape: (keyof T)[]): Partial<T>;
+/**
+ * Dotted-path getter for the common walk over a parsed doc, e.g.
+ * `get(doc.value, "spec.template.spec")`. Not a query DSL — no wildcards,
+ * no predicates, no array-flattening. An array index is just a numeric path
+ * segment (`get(value, "items.0.name")`), since JS indexes arrays by string
+ * key underneath. Returns `undefined` as soon as any segment is missing or
+ * the value at that point isn't indexable — it never throws on a bad path.
+ */
+export declare function get(value: unknown, path: string): unknown;
+//# sourceMappingURL=output-docs.d.ts.map

package/dist/lint/output-docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-docs.d.ts","sourceRoot":"","sources":["../../src/lint/output-docs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAGtD;;;;;;;GAOG;AACH,MAAM,WAAW,SAAS;IACxB,yDAAyD;IACzD,OAAO,EAAE,MAAM,CAAC;IAChB;;sCAEkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,0EAA0E;IAC1E,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,sEAAsE;IACtE,KAAK,EAAE,OAAO,CAAC;IACf;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;;;OAOG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,CAAC,GAAG,SAAS,EAAE,CAY5F;AA4ED;;;;;;;;;;GAUG;AACH,wBAAgB,IAAI,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAWrF;AAED;;;;;;;GAOG;AACH,wBAAgB,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAQzD"}

package/dist/lint/pipeline-change-gate.d.ts

@@ -0,0 +1,101 @@
+/**
+ * The pipeline-change gate class (#1569): changes to the pipeline itself
+ * route to a stricter gate.
+ *
+ * The honest concession in the PR-flow teardown (rubric-product-research,
+ * 06-objections §1): chant Ops have a `shell` step, so a governed plane is
+ * not automatically immune to "the change edits the machinery that applies
+ * changes." What chant *can* claim — and a plain PR flow structurally cannot
+ * — is that pipeline changes are distinguishable: a composition is data over
+ * a bounded verb registry, and the COMP rules already police the escape
+ * hatches (COMP006 — every `shell` step carries a declared reason;
+ * COMP005 — no noun-shaped escape hatches, `./rules/comp/`). What was missing
+ * was the routing: nothing classified a change as "touches the pipeline" and
+ * required a stricter gate for it, so a change to a composition rode through
+ * the same gate as a replica-count bump.
+ *
+ * This is the cheap first cut #1569 asks for: the registry-only predicate.
+ * A composition that contains only registry verbs is ordinary; a `shell`
+ * step (the deliberate escape hatch) or a change to the set of verbs a
+ * composition invokes trips the stricter class. comp005/comp006 already make
+ * both decidable from the text — this module reuses the same walk
+ * (`./rules/comp/support.ts`) rather than re-deriving it.
+ *
+ * Like #1568's `evaluateUnobservedGate`
+ * (../lifecycle/unobserved-gate.ts), this is a reusable predicate, not a
+ * runtime: classify a change and get back a verdict; the caller (a
+ * `lint.policies` check routed through `policyGate`, an Op step, #1487's
+ * gate-as-fact once it lands) decides what "stricter" means in its own
+ * context. The stricter class composes with #1487's principle that
+ * destructive verbs always wait for a person — pipeline changes are the
+ * second category that should never free-run, because they change what
+ * "gated" means for everything after them. That is why the default policy
+ * below is `"human-always"`, not `"stricter-gate"`.
+ */
+import type { Component } from "../components/component.js";
+/** Why a composition (or a change to one) tripped the pipeline-change class. */
+export type PipelineChangeReason = {
+    kind: "shell-step";
+    phaseName: string;
+} | {
+    kind: "unregistered-verb";
+    stepKind: string;
+    phaseName: string;
+} | {
+    kind: "verb-set-changed";
+    added: string[];
+    removed: string[];
+};
+export interface PipelineChangeClassification {
+    /** True when any reason below applies. */
+    pipelineChange: boolean;
+    reasons: PipelineChangeReason[];
+}
+/** Every non-gate step kind a component's composition invokes, across `deploy` and `rollback` (nested fan-out phases included, via `walkComponent`). `gate` steps are excluded — they are not a capability verb. */
+export declare function componentVerbSet(component: Component): Set<string>;
+/**
+ * Classify a single component's composition (the "cheap first cut", no
+ * before/after needed): a `shell` step trips the class unconditionally — it
+ * is the escape hatch by construction (COMP006) — and any step whose `kind`
+ * is outside `knownKinds` trips it too, since an unregistered verb is,
+ * structurally, the same kind of hole a `shell` step is: something the
+ * bounded registry does not account for.
+ */
+export declare function classifyComponentPipelineChange(component: Component, opts?: {
+    knownKinds?: ReadonlySet<string>;
+}): PipelineChangeClassification;
+/**
+ * Classify a *change* to a component's composition between two revisions
+ * (#1569's "add or modify a shell step ... or the composition graph
+ * itself"): on top of `classifyComponentPipelineChange`'s single-composition
+ * check on `after`, a change also trips the class when the verb set itself
+ * changed — a verb added or removed changes what the composition can invoke,
+ * which is the routing signal even when every individual verb, before and
+ * after, is registry-clean. `before: undefined` (a brand-new component) never
+ * reports a verb-set change — there is nothing to diff against, and the
+ * single-composition check already covers a new component's own shell/
+ * unregistered-verb findings.
+ */
+export declare function classifyPipelineChange(before: Component | undefined, after: Component, opts?: {
+    knownKinds?: ReadonlySet<string>;
+}): PipelineChangeClassification;
+/**
+ * How the gate routes a classified pipeline change.
+ *
+ * - `"human-always"` (the recommended default — see this module's doc
+ *   comment) — a pipeline change never free-runs, mirroring #1487's "a
+ *   destructive verb always waits for a person."
+ * - `"stricter-gate"` — route to a named stricter gate class rather than
+ *   requiring a person on every run; the caller supplies what "stricter"
+ *   means (an additional approval, a narrower blast-radius budget, ...).
+ */
+export type PipelineChangeGatePolicy = "stricter-gate" | "human-always";
+export interface PipelineChangeGateVerdict extends PipelineChangeClassification {
+    /** What the policy says to do about it. `"none"` when the change is not a pipeline change at all. */
+    route: PipelineChangeGatePolicy | "none";
+}
+/** Evaluate a component composition change against a routing policy. Pure — no I/O. */
+export declare function evaluatePipelineChangeGate(before: Component | undefined, after: Component, policy?: PipelineChangeGatePolicy, opts?: {
+    knownKinds?: ReadonlySet<string>;
+}): PipelineChangeGateVerdict;
+//# sourceMappingURL=pipeline-change-gate.d.ts.map

package/dist/lint/pipeline-change-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-change-gate.d.ts","sourceRoot":"","sources":["../../src/lint/pipeline-change-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAczD,gFAAgF;AAChF,MAAM,MAAM,oBAAoB,GAC5B;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACzC;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAClE;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAErE,MAAM,WAAW,4BAA4B;IAC3C,0CAA0C;IAC1C,cAAc,EAAE,OAAO,CAAC;IACxB,OAAO,EAAE,oBAAoB,EAAE,CAAC;CACjC;AAED,oNAAoN;AACpN,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,SAAS,GAAG,GAAG,CAAC,MAAM,CAAC,CAGlE;AAED;;;;;;;GAOG;AACH,wBAAgB,+BAA+B,CAC7C,SAAS,EAAE,SAAS,EACpB,IAAI,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;CAAE,GAC1C,4BAA4B,CAc9B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,SAAS,GAAG,SAAS,EAC7B,KAAK,EAAE,SAAS,EAChB,IAAI,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;CAAE,GAC1C,4BAA4B,CAe9B;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,wBAAwB,GAAG,eAAe,GAAG,cAAc,CAAC;AAExE,MAAM,WAAW,yBAA0B,SAAQ,4BAA4B;IAC7E,qGAAqG;IACrG,KAAK,EAAE,wBAAwB,GAAG,MAAM,CAAC;CAC1C;AAED,uFAAuF;AACvF,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,SAAS,GAAG,SAAS,EAC7B,KAAK,EAAE,SAAS,EAChB,MAAM,GAAE,wBAAyC,EACjD,IAAI,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;CAAE,GAC1C,yBAAyB,CAG3B"}

package/dist/lint/post-synth.d.ts

@@ -1,6 +1,8 @@
 import type { Declarable } from "../declarable.js";
 import type { SerializerResult } from "../serializer.js";
 import type { Severity } from "./rule.js";
+import { type OutputDoc } from "./output-docs.js";
+export { parseOutputDocs, pick, get, type OutputDoc } from "./output-docs.js";
 /**
  * Context provided to post-synthesis checks.
  */
@@ -15,6 +17,25 @@ export interface PostSynthContext {
      * e.g. "no public buckets in prod". Undefined when no environment is set.
      */
     env?: string;
+    /**
+     * Parsed output documents (chant #975) — `ctx.outputs` run through
+     * `parseOutputDocs` once and cached. A lazy `readonly` getter, not a plain
+     * field: computed on first access and shared across every check in the
+     * run, so a check that only reads `entities` pays nothing, and no two
+     * checks re-parse the same YAML/JSON. See `./output-docs.ts`.
+     *
+     * Optional at the type level — NOT because it can be absent from a real
+     * build. Every context chant itself constructs (`runPostSynthChecks`
+     * below, `@intentius/chant-test-utils`'s `createPostSynthContext` and
+     * `makePostSynthCtx*`) wires it up via `createDocsAccessor` and it is
+     * always present there. It is typed optional only so the many lexicon
+     * tests that build a `PostSynthContext` object literal by hand (predating
+     * this field) keep compiling unchanged, per this issue's own "existing
+     * checks compile unchanged" constraint — a new check that wants `ctx.docs`
+     * should still get a real array from every context chant builds; guard
+     * with `ctx.docs ?? []` only when a context's provenance is unknown.
+     */
+    readonly docs?: OutputDoc[];
     /** Raw build result object */
     buildResult: {
         outputs: Map<string, string | SerializerResult>;
@@ -27,10 +48,30 @@ export interface PostSynthContext {
         sourceFileCount: number;
     };
 }
+/**
+ * Build the lazy, memoized `docs` accessor shared by `runPostSynthChecks`
+ * (below) and `@intentius/chant-test-utils`'s `createPostSynthContext` — the
+ * two places a `PostSynthContext` gets constructed. Returns a zero-arg
+ * function suitable for a `get docs()` object-literal accessor; the first
+ * call parses, every later call returns the same cached array.
+ */
+export declare function createDocsAccessor(outputs: Map<string, string | SerializerResult>): () => OutputDoc[];
 /**
  * Extract the primary content string from a serializer output.
  */
 export declare function getPrimaryOutput(output: string | SerializerResult): string;
+/**
+ * Extract the ADDITIONAL files from a serializer output — everything
+ * {@link getPrimaryOutput} discards.
+ *
+ * Every post-synth check shipped before this one reads the primary output
+ * only, which means a sidecar file (a nested stack template, committed SOPS
+ * ciphertext) is invisible to all of them. That is the right default — the
+ * primary output is what appliers read — but a rule ABOUT a sidecar has to
+ * be able to see it, and `PostSynthContext.outputs` has carried the data all
+ * along. WK8504 (k8s) is the first caller.
+ */
+export declare function getAdditionalFiles(output: string | SerializerResult): Record<string, string>;
 /**
  * A diagnostic from a post-synthesis check.
  *

package/dist/lint/post-synth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"post-synth.d.ts","sourceRoot":"","sources":["../../src/lint/post-synth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAEvC;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,kEAAkE;IAClE,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,CAAC,CAAC;IAChD,8CAA8C;IAC9C,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAClC;;;;OAIG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,8BAA8B;IAC9B,WAAW,EAAE;QACX,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,CAAC,CAAC;QAChD,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QAClC,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,MAAM,EAAE,KAAK,CAAC;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACjD,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;CACH;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,GAAG,MAAM,CAE1E;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,mBAAmB;IAClC,oDAAoD;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB,qBAAqB;IACrB,QAAQ,EAAE,QAAQ,CAAC;IACnB,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,uCAAuC;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,+CAA+C;IAC/C,KAAK,CAAC,GAAG,EAAE,gBAAgB,GAAG,mBAAmB,EAAE,CAAC;CACrD;AAED,8EAA8E;AAC9E,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAQxE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,cAAc,EAAE,EACxB,WAAW,EAAE,gBAAgB,CAAC,aAAa,CAAC,EAC5C,GAAG,CAAC,EAAE,MAAM,GACX,mBAAmB,EAAE,CAavB"}
+{"version":3,"file":"post-synth.d.ts","sourceRoot":"","sources":["../../src/lint/post-synth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,EAAmB,KAAK,SAAS,EAAE,MAAM,eAAe,CAAC;AAEhE,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,SAAS,EAAE,MAAM,eAAe,CAAC;AAE3E;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,kEAAkE;IAClE,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,CAAC,CAAC;IAChD,8CAA8C;IAC9C,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAClC;;;;OAIG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;;;;;;;;;;;;;;;OAiBG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,CAAC;IAC5B,8BAA8B;IAC9B,WAAW,EAAE;QACX,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,CAAC,CAAC;QAChD,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QAClC,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,MAAM,EAAE,KAAK,CAAC;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACjD,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;CACH;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,CAAC,GAC9C,MAAM,SAAS,EAAE,CAQnB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,GAAG,MAAM,CAE1E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAE5F;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,mBAAmB;IAClC,oDAAoD;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB,qBAAqB;IACrB,QAAQ,EAAE,QAAQ,CAAC;IACnB,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,uCAAuC;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,+CAA+C;IAC/C,KAAK,CAAC,GAAG,EAAE,gBAAgB,GAAG,mBAAmB,EAAE,CAAC;CACrD;AAED,8EAA8E;AAC9E,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAQxE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,cAAc,EAAE,EACxB,WAAW,EAAE,gBAAgB,CAAC,aAAa,CAAC,EAC5C,GAAG,CAAC,EAAE,MAAM,GACX,mBAAmB,EAAE,CAiBvB"}

package/dist/lint/receipt-checks.d.ts

@@ -0,0 +1,9 @@
+import type { PostSynthCheck } from "./post-synth.js";
+export declare const RECEIPT_PLAIN_STORE_CHECK_ID = "COR023";
+/**
+ * Core's own post-synth checks over effect receipts, run by `chant build`
+ * over the full build result (plugin checks are lexicon-scoped; receipts are
+ * recognized by marker, so this set is deliberately not).
+ */
+export declare function coreReceiptChecks(): PostSynthCheck[];
+//# sourceMappingURL=receipt-checks.d.ts.map

package/dist/lint/receipt-checks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"receipt-checks.d.ts","sourceRoot":"","sources":["../../src/lint/receipt-checks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAuB,MAAM,cAAc,CAAC;AAqCxE,eAAO,MAAM,4BAA4B,WAAW,CAAC;AAgDrD;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,EAAE,CAEpD"}

package/dist/lint/rules/__fixtures__/comp/comp003/pass/agent-turn.component.d.ts

@@ -0,0 +1,11 @@
+import type { Component } from "../../../../../../components/component.js";
+/**
+ * COMP003 pass case (#1944): a bare "run-agent" step with no "noRollback"
+ * opt-out and no component-level "rollback" — must pass COMP003 because
+ * "run-agent"'s rollbackPolicy is "native" (#1941), not "needs-opt-out". This
+ * is the regression test proving the registry's declared rollbackPolicy for
+ * "run-agent" is wired correctly into ctx.rollbackPolicies, the same seam
+ * COMP005 uses for ctx.knownKinds — see comp.test.ts's FIXTURE_ROLLBACK_POLICIES.
+ */
+export declare const agentTurn: Component;
+//# sourceMappingURL=agent-turn.component.d.ts.map

package/dist/lint/rules/__fixtures__/comp/comp003/pass/agent-turn.component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-turn.component.d.ts","sourceRoot":"","sources":["../../../../../../../src/lint/rules/__fixtures__/comp/comp003/pass/agent-turn.component.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wCAAwC,CAAC;AAGxE;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS,EAAE,SAcvB,CAAC"}

package/dist/lint/rules/cor022-receipt-leaf.d.ts

@@ -0,0 +1,13 @@
+import * as ts from "typescript";
+import type { LintRule } from "../rule.js";
+/** A variable declaration's `EffectReceipt(...)` initializer, if that is what it is. */
+export declare function receiptFactoryCall(decl: ts.VariableDeclaration): ts.CallExpression | undefined;
+/**
+ * Every variable name bound to an effect receipt in this file: direct
+ * `EffectReceipt(...)` initializers plus identifier aliases, resolved to a
+ * fixpoint so declaration order does not matter. Scope-naive by design, the
+ * same trade COR011 makes — a chant source file is flat declarations.
+ */
+export declare function collectReceiptVariables(sourceFile: ts.SourceFile): Set<string>;
+export declare const cor022ReceiptLeafRule: LintRule;
+//# sourceMappingURL=cor022-receipt-leaf.d.ts.map

package/dist/lint/rules/cor022-receipt-leaf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cor022-receipt-leaf.d.ts","sourceRoot":"","sources":["../../../src/lint/rules/cor022-receipt-leaf.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AACjC,OAAO,KAAK,EAAE,QAAQ,EAA+B,MAAM,SAAS,CAAC;AAsCrE,wFAAwF;AACxF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,EAAE,CAAC,mBAAmB,GAAG,EAAE,CAAC,cAAc,GAAG,SAAS,CAG9F;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,GAAG,GAAG,CAAC,MAAM,CAAC,CA2B9E;AASD,eAAO,MAAM,qBAAqB,EAAE,QA0CnC,CAAC"}

package/dist/lint/rules/cor024-receipt-secret-pointer.d.ts

@@ -0,0 +1,3 @@
+import type { LintRule } from "../rule.js";
+export declare const cor024ReceiptSecretPointerRule: LintRule;
+//# sourceMappingURL=cor024-receipt-secret-pointer.d.ts.map

package/dist/lint/rules/cor024-receipt-secret-pointer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cor024-receipt-secret-pointer.d.ts","sourceRoot":"","sources":["../../../src/lint/rules/cor024-receipt-secret-pointer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAA+B,MAAM,SAAS,CAAC;AA2IrE,eAAO,MAAM,8BAA8B,EAAE,QA6E5C,CAAC"}

package/dist/lint/rules/evl001-non-literal-expression.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"evl001-non-literal-expression.d.ts","sourceRoot":"","sources":["../../../src/lint/rules/evl001-non-literal-expression.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAA+B,MAAM,SAAS,CAAC;AAsDrE,eAAO,MAAM,8BAA8B,EAAE,QAU5C,CAAC"}
+{"version":3,"file":"evl001-non-literal-expression.d.ts","sourceRoot":"","sources":["../../../src/lint/rules/evl001-non-literal-expression.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAA+B,MAAM,SAAS,CAAC;AA6DrE,eAAO,MAAM,8BAA8B,EAAE,QAU5C,CAAC"}

package/dist/lint/rules/index.d.ts

@@ -24,9 +24,11 @@ export { evl010CompositeNoTransformRule } from "./evl010-composite-no-transform.
 export { cor017CompositeNameMatchRule } from "./cor017-composite-name-match.js";
 export { cor018CompositePreferLexiconTypeRule } from "./cor018-composite-prefer-lexicon-type.js";
 export { cor021EnvLiteralNameRule } from "./cor021-env-literal-name.js";
+export { cor022ReceiptLeafRule, collectReceiptVariables, receiptFactoryCall } from "./cor022-receipt-leaf.js";
+export { cor024ReceiptSecretPointerRule } from "./cor024-receipt-secret-pointer.js";
 export { isInsideCompositeFactory } from "./composite-scope.js";
 /**
- * Load all 22 core lint rules (COR + EVL).
+ * Load all 24 core lint rules (COR + EVL).
  */
 export declare function loadCoreRules(): LintRule[];
 //# sourceMappingURL=index.d.ts.map

package/dist/lint/rules/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lint/rules/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,8BAA8B,EAAE,MAAM,gCAAgC,CAAC;AAChF,OAAO,EAAE,4BAA4B,EAAE,MAAM,+BAA+B,CAAC;AAC7E,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,8BAA8B,EAAE,MAAM,iCAAiC,CAAC;AACjF,OAAO,EAAE,6BAA6B,EAAE,MAAM,gCAAgC,CAAC;AAC/E,OAAO,EAAE,+BAA+B,EAAE,MAAM,kCAAkC,CAAC;AACnF,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAC3E,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,EAAE,6BAA6B,EAAE,MAAM,gCAAgC,CAAC;AAC/E,OAAO,EAAE,8BAA8B,EAAE,MAAM,iCAAiC,CAAC;AACjF,OAAO,EAAE,4BAA4B,EAAE,MAAM,+BAA+B,CAAC;AAC7E,OAAO,EAAE,oCAAoC,EAAE,MAAM,wCAAwC,CAAC;AAC9F,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAyB7D;;GAEG;AACH,wBAAgB,aAAa,IAAI,QAAQ,EAAE,CAyB1C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lint/rules/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,8BAA8B,EAAE,MAAM,gCAAgC,CAAC;AAChF,OAAO,EAAE,4BAA4B,EAAE,MAAM,+BAA+B,CAAC;AAC7E,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,8BAA8B,EAAE,MAAM,iCAAiC,CAAC;AACjF,OAAO,EAAE,6BAA6B,EAAE,MAAM,gCAAgC,CAAC;AAC/E,OAAO,EAAE,+BAA+B,EAAE,MAAM,kCAAkC,CAAC;AACnF,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAC3E,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,EAAE,6BAA6B,EAAE,MAAM,gCAAgC,CAAC;AAC/E,OAAO,EAAE,8BAA8B,EAAE,MAAM,iCAAiC,CAAC;AACjF,OAAO,EAAE,4BAA4B,EAAE,MAAM,+BAA+B,CAAC;AAC7E,OAAO,EAAE,oCAAoC,EAAE,MAAM,wCAAwC,CAAC;AAC9F,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3G,OAAO,EAAE,8BAA8B,EAAE,MAAM,iCAAiC,CAAC;AACjF,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AA2B7D;;GAEG;AACH,wBAAgB,aAAa,IAAI,QAAQ,EAAE,CA2B1C"}

package/dist/lsp/lexicon-providers.d.ts

@@ -16,6 +16,13 @@ export interface LexiconEntry {
     writeOnly?: string[];
     primaryIdentifier?: string[];
     deprecatedProperties?: string[];
+    /**
+     * Subset of `deprecatedProperties` that only prose supports — a lexicon
+     * generator matched the property description against a deprecation regex
+     * rather than reading an upstream declaration (#1701). Editors do not strike
+     * these through; the basis is too weak to mark a property dead.
+     */
+    inferredDeprecations?: string[];
     conditionalCreateOnly?: string[];
     replacementStrategy?: "delete_then_create" | "create_then_delete";
     tagging?: {

package/dist/lsp/lexicon-providers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lexicon-providers.d.ts","sourceRoot":"","sources":["../../src/lsp/lexicon-providers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAI1F,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,UAAU,GAAG,UAAU,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,mBAAmB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9C,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;IACjC,mBAAmB,CAAC,EAAE,oBAAoB,GAAG,oBAAoB,CAAC;IAClE,OAAO,CAAC,EAAE;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,WAAW,EAAE,OAAO,CAAC;QAAC,YAAY,EAAE,OAAO,CAAA;KAAE,CAAC;CAC9E;AAID;;GAEG;AACH,qBAAa,YAAY;IACX,OAAO,CAAC,OAAO;gBAAP,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC;IAEzD,8DAA8D;IAC9D,gBAAgB,IAAI,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;IAUtE,0DAA0D;IAC1D,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE;IAqB7C,4CAA4C;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;CAGjD;AAID;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,iBAAiB,EACtB,KAAK,EAAE,YAAY,EACnB,YAAY,EAAE,MAAM,GACnB,cAAc,EAAE,CAsDlB;AAID;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,YAAY,EACjB,KAAK,EAAE,YAAY,EACnB,WAAW,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,KAAK,SAAS,GAAG,SAAS,GAC9E,SAAS,GAAG,SAAS,CAiBvB"}
+{"version":3,"file":"lexicon-providers.d.ts","sourceRoot":"","sources":["../../src/lsp/lexicon-providers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAI1F,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,UAAU,GAAG,UAAU,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,mBAAmB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9C,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;IACjC,mBAAmB,CAAC,EAAE,oBAAoB,GAAG,oBAAoB,CAAC;IAClE,OAAO,CAAC,EAAE;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,WAAW,EAAE,OAAO,CAAC;QAAC,YAAY,EAAE,OAAO,CAAA;KAAE,CAAC;CAC9E;AAID;;GAEG;AACH,qBAAa,YAAY;IACX,OAAO,CAAC,OAAO;gBAAP,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC;IAEzD,8DAA8D;IAC9D,gBAAgB,IAAI,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;IAUtE,0DAA0D;IAC1D,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE;IAqB7C,4CAA4C;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;CAGjD;AAID;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,iBAAiB,EACtB,KAAK,EAAE,YAAY,EACnB,YAAY,EAAE,MAAM,GACnB,cAAc,EAAE,CAyDlB;AAID;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,YAAY,EACjB,KAAK,EAAE,YAAY,EACnB,WAAW,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,KAAK,SAAS,GAAG,SAAS,GAC9E,SAAS,GAAG,SAAS,CAiBvB"}

package/dist/okf-read.d.ts

@@ -0,0 +1,78 @@
+import type { Declarable } from "./declarable.js";
+/**
+ * One authored concept document, parsed from a bundle. Deliberately thinner
+ * than the emit side's internal `Concept` (`./okf.ts`) — this is what a
+ * *reader* trusts, and per the #1059 design that is `type`/`title` plus the
+ * single frontmatter key chant interprets, `binds`. Everything else an
+ * author wrote rides along in {@link frontmatter} unexamined, so a consumer
+ * that needs a project-specific key (a future `category`, say) can still
+ * reach it without a reader change.
+ */
+export interface OkfConcept {
+    /** Bundle-relative path (forward-slash separated), e.g. "decisions/public-assets.md". */
+    path: string;
+    /** The frontmatter `type`. May be empty — the reader never rejects a concept for it, unlike the emitter's conformance check. */
+    type: string;
+    /** Frontmatter `title`, when the author set one. */
+    title?: string;
+    /**
+     * This concept's `binds` frontmatter key, normalized to a list — one name,
+     * several, or `[]` for "declared no binding, and that's legitimate."
+     * Structural-looking keys (`name`, `lexicon`, `kind`) are deliberately
+     * *not* surfaced here or anywhere else on this type: the reader interprets
+     * exactly `binds` (#1059's precedence-by-construction), so authored and
+     * inferred knowledge cannot conflict at the fact level.
+     */
+    binds: string[];
+    /** Every frontmatter key this concept's document carries, `binds` included, verbatim. */
+    frontmatter: Record<string, unknown>;
+    /** Markdown body (everything after the closing `---`), unchanged. */
+    body: string;
+}
+/** A loaded OKF knowledge bundle: every authored concept found, reserved files already excluded. */
+export interface OkfBundle {
+    concepts: OkfConcept[];
+}
+/**
+ * Load every authored concept from an OKF knowledge bundle directory.
+ * `index.md`/`log.md` are skipped (reserved, by basename, at any depth —
+ * matching `okfConformanceProblems`'s check on the emit side). A directory
+ * that does not exist yields an empty bundle, not an error: the #1059 design
+ * treats a missing `knowledge/` as "this project has none yet," the same
+ * posture as a project with no lexicons configured.
+ *
+ * A file that fails to parse — no frontmatter block, unparseable YAML, or
+ * frontmatter that isn't a mapping — is skipped with a `console.warn` and
+ * does not affect any other file. Nothing here throws.
+ */
+export declare function loadOkfBundle(dir: string): Promise<OkfBundle>;
+/** {@link bindConcepts}'s result: bound concepts per entity, plus every binding that resolved nothing. */
+export interface BindConceptsResult {
+    /**
+     * Bound concepts keyed by entity logical name — the same names that key
+     * `DiscoveryResult.entities` (`./discovery/index.ts`). An entity with no
+     * bound concepts is absent from the map, never present with `[]`.
+     */
+    bound: Map<string, OkfConcept[]>;
+    /** Every `binds` entry that named no entity in `entities` — chant's own broken-link posture (#1059): a warning for the caller to surface (COR022, #1865), never a load failure. */
+    unresolved: UnresolvedBinding[];
+}
+/** One `binds` entry that resolved to nothing. */
+export interface UnresolvedBinding {
+    /** The concept whose `binds` named this entity. */
+    concept: OkfConcept;
+    /** The unresolved logical name. */
+    name: string;
+}
+/**
+ * Resolve every concept's `binds` against a project's discovered entities.
+ * `entities` is the same shape `./okf.ts`'s emitter takes, `DiscoveryResult`'s
+ * own `entities` map — a bare logical name is unambiguous within one
+ * discovery pass (#1059's "Rejected options" on binding ambiguity).
+ *
+ * A concept with no `binds` contributes to neither `bound` nor `unresolved`;
+ * an unbound concept is legitimate, not an omission (a runbook, a decision
+ * about the project as a whole).
+ */
+export declare function bindConcepts(bundle: OkfBundle, entities: Map<string, Declarable>): BindConceptsResult;
+//# sourceMappingURL=okf-read.d.ts.map

package/dist/okf-read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"okf-read.d.ts","sourceRoot":"","sources":["../src/okf-read.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAkB/C;;;;;;;;GAQG;AACH,MAAM,WAAW,UAAU;IACzB,yFAAyF;IACzF,IAAI,EAAE,MAAM,CAAC;IACb,gIAAgI;IAChI,IAAI,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;;;OAOG;IACH,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,yFAAyF;IACzF,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;CACd;AAED,oGAAoG;AACpG,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,UAAU,EAAE,CAAC;CACxB;AAmCD;;;;;;;;;;;GAWG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CA8CnE;AAED,0GAA0G;AAC1G,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;IACjC,mLAAmL;IACnL,UAAU,EAAE,iBAAiB,EAAE,CAAC;CACjC;AAED,kDAAkD;AAClD,MAAM,WAAW,iBAAiB;IAChC,mDAAmD;IACnD,OAAO,EAAE,UAAU,CAAC;IACpB,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,kBAAkB,CAgBrG"}