@intentius/chant 0.90.0 → 0.93.0

package/dist/workspace/point-answer.schema.json

@@ -0,0 +1,95 @@
+{
+    "$schema": "http://json-schema.org/draft-07/schema#",
+    "$id": "urn:intentius:chant:point-answer:1",
+    "title": "Decision point answer front matter",
+    "description": "The front matter of one answer to a decision point (ws-058, #2739), as `chant workspace points ask` and `points answer` write it into the records directory of a record kind with an `answers` block. One record per point, declaration and inputs: its id is the point's name and the first 12 hex digits of the inputs hash, so the same question is answered once. A table's answer is `answered`; a model's answer at or above its threshold is `proposed` until a person confirms it; a question no decider before the quorum answered is `escalated`, open for people. A workspace copies this file next to its answer kind, as reference-workspace/answers/ does. Values stay within what YAML and JSON share. Fields other than these must start with x-.",
+    "type": "object",
+    "additionalProperties": false,
+    "patternProperties": { "^x-": {} },
+    "required": ["id", "title", "point", "point_version", "question_type", "candidates", "inputs", "inputs_hash", "state", "decider", "asked_on"],
+    "properties": {
+        "id": { "type": "string", "pattern": "^[a-z][a-z0-9-]*-[0-9a-f]{12}$", "description": "The point's name, a hyphen, and the first 12 hex digits of inputs_hash." },
+        "title": { "type": "string", "minLength": 1 },
+        "point": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$", "description": "The point in the points file this answers." },
+        "point_version": { "$ref": "#/definitions/sha256", "description": "sha256 of the point's declaration when it was asked. Editing the question or any decider changes it." },
+        "question_type": { "enum": ["noul", "choice", "score"] },
+        "candidates": { "type": "array", "minItems": 2, "items": { "type": ["string", "boolean"] }, "description": "The answers the question allowed: true and false, a choice's options, or a score's levels." },
+        "inputs": { "type": "object", "description": "The state the deciders saw, input name to value." },
+        "inputs_hash": { "$ref": "#/definitions/sha256", "description": "sha256 of the point, its version and its inputs. The same hash is answered once." },
+        "constrains": { "type": "array", "items": { "type": "string", "minLength": 1 }, "description": "What the question is about, such as a work item's id." },
+        "state": { "enum": ["escalated", "proposed", "answered"] },
+        "answer": { "type": ["string", "boolean"] },
+        "decider": {
+            "type": "object",
+            "required": ["kind"],
+            "properties": {
+                "kind": { "enum": ["table", "model", "quorum"] },
+                "row": { "type": "integer", "minimum": 0, "description": "table: the row that matched." },
+                "backend": { "type": "string", "minLength": 1 },
+                "model": { "type": "string", "minLength": 1, "description": "model: the model id that answered, as the backend reported it." },
+                "count": { "type": "integer", "minimum": 1 },
+                "roles": { "type": "array", "items": { "type": "string" } },
+                "by": { "type": "array", "items": { "type": "string" }, "description": "quorum: who answered." }
+            },
+            "additionalProperties": false
+        },
+        "probabilities": { "$ref": "#/definitions/probabilities" },
+        "confidence": { "$ref": "#/definitions/unit" },
+        "threshold": { "$ref": "#/definitions/unit" },
+        "escalations": {
+            "type": "array",
+            "description": "The deciders asked before the one that answered, or before the quorum, and why each did not answer.",
+            "items": { "$ref": "#/definitions/escalation" }
+        },
+        "answered_by": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 }, "description": "The people who answered or confirmed it." },
+        "asked_on": { "$ref": "#/definitions/date" },
+        "answered_on": { "$ref": "#/definitions/date" },
+        "source": {
+            "type": "object",
+            "description": "Where the answer came from (#2708): via, client and model, the model id that answered when a model decider did."
+        }
+    },
+    "allOf": [
+        {
+            "if": { "properties": { "state": { "const": "proposed" } }, "required": ["state"] },
+            "then": { "required": ["answer"], "properties": { "decider": { "properties": { "kind": { "const": "model" } } } } }
+        },
+        {
+            "if": { "properties": { "state": { "const": "answered" } }, "required": ["state"] },
+            "then": { "required": ["answer", "answered_on"] }
+        },
+        {
+            "if": { "properties": { "state": { "const": "escalated" } }, "required": ["state"] },
+            "then": { "not": { "required": ["answer"] }, "properties": { "decider": { "properties": { "kind": { "const": "quorum" } } } } }
+        },
+        {
+            "if": { "properties": { "decider": { "properties": { "kind": { "const": "model" } }, "required": ["kind"] } }, "required": ["decider"] },
+            "then": { "required": ["probabilities", "confidence", "threshold"], "properties": { "decider": { "required": ["backend", "model"] } } }
+        },
+        {
+            "if": { "properties": { "state": { "const": "answered" }, "decider": { "properties": { "kind": { "const": "quorum" } }, "required": ["kind"] } }, "required": ["state", "decider"] },
+            "then": { "required": ["answered_by"], "properties": { "decider": { "required": ["by"] } } }
+        }
+    ],
+    "definitions": {
+        "sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" },
+        "unit": { "type": "number", "minimum": 0, "maximum": 1 },
+        "date": { "type": "string", "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$" },
+        "probabilities": { "type": "object", "additionalProperties": { "$ref": "#/definitions/unit" } },
+        "escalation": {
+            "type": "object",
+            "required": ["kind", "reason"],
+            "properties": {
+                "kind": { "enum": ["table", "model"] },
+                "reason": { "type": "string", "minLength": 1 },
+                "backend": { "type": "string" },
+                "model": { "type": "string" },
+                "answer": { "type": ["string", "boolean", "null"] },
+                "probabilities": { "$ref": "#/definitions/probabilities" },
+                "confidence": { "$ref": "#/definitions/unit" },
+                "threshold": { "$ref": "#/definitions/unit" }
+            },
+            "additionalProperties": false
+        }
+    }
+}

package/dist/workspace/points-cli.d.ts

@@ -0,0 +1,113 @@
+/**
+ * `chant workspace points [--open] [--kind <kind file>] [--at <rev>] [--json]`
+ * (ws-058, #2739): the workspace's decision points and the questions asked of
+ * them, a read-contract output (`points.schema.json`).
+ *
+ * The points come from each record kind the declaration names with an
+ * `answers` block, or from `--kind`, and the questions are that kind's
+ * records. A question is open while it is escalated to people or proposed by a
+ * model and not yet confirmed, and it lists any model's answer with its
+ * confidence, so a reader such as hud can prompt a person and an MCP client
+ * can see it. With `--open`, only open questions are listed. It never writes
+ * and never calls a model.
+ *
+ * `points ask` and `points answer` are the writes, in `decide.ts`.
+ */
+import type { CommandContext } from "../cli/registry.js";
+import { type ErrorLocation, type WorkspaceErrorCode } from "./declaration.js";
+import { type QuestionView } from "./decide.js";
+import { type Decider, type ModelAsk } from "./points.js";
+export declare const POINTS_CONTRACT_VERSION = 1;
+export declare const POINTS_OUTPUT_SCHEMA_ID = "https://intentius.io/chant/schemas/workspace/points/v1/points.schema.json";
+/** Why `points` read nothing. Closed. */
+export declare const POINTS_ERROR_CODES: readonly ["declaration-missing", "declaration-ambiguous", "declaration-unparseable", "declaration-invalid", "placement-invalid", "reader-too-old", "root-chant-required", "not-a-git-repository", "revision-unknown"];
+/** Why one answer kind's points or questions could not be read. The document is still printed. Closed. */
+export declare const POINTS_SOURCE_REASON_CODES: readonly ["kind-unreadable", "kind-invalid", "schema-unreadable", "schema-id-mismatch", "schema-invalid", "location-missing", "points-invalid"];
+type SourceReasonCode = (typeof POINTS_SOURCE_REASON_CODES)[number];
+/** One point as `points` lists it. */
+export interface PointView {
+    name: string;
+    title: string;
+    /** The answer kind file, from the workspace root, whose records answer it. */
+    kind: string;
+    /** The points file, from the repository root. */
+    file: string;
+    /** sha256 of the declaration: a question asked under another version answers an older question. */
+    version: string;
+    questionType: string;
+    instructions: string;
+    candidates: (string | boolean)[];
+    /** Each input: its name, the read-contract output it names, and its description. */
+    inputs: {
+        name: string;
+        output: string;
+        description: string;
+    }[];
+    deciders: Decider[];
+    quorum: {
+        count: number;
+        roles?: string[];
+    };
+}
+/** One answer kind the read covered. */
+export interface SourceView {
+    /** The kind file, as declared from the workspace root, or as given with --kind. */
+    kind: string;
+    /** The points file from the repository root, or null when the kind couldn't be loaded. */
+    points: string | null;
+    reason: {
+        code: SourceReasonCode;
+        message: string;
+    } | null;
+}
+export type PointsDocument = {
+    $schema: string;
+    contract: number;
+    chant: string;
+    at: string | null;
+    workspace: {
+        name: string;
+        root: string;
+    };
+    /** Whether only open questions are listed (--open). */
+    open: boolean;
+    sources: SourceView[];
+    points: PointView[];
+    questions: QuestionView[];
+    summary: {
+        points: number;
+        questions: number;
+        open: number;
+        escalated: number;
+        proposed: number;
+        answered: number;
+    };
+} | {
+    $schema: string;
+    contract: number;
+    chant: string;
+    error: {
+        code: WorkspaceErrorCode;
+        message: string;
+        location: ErrorLocation | null;
+    };
+};
+export interface PointsQuery {
+    cwd: string;
+    at?: string;
+    open?: boolean;
+    /** One answer kind file, in place of the declared ones. */
+    kind?: string;
+}
+/** Read the points and questions. Never throws a read error: a declaration that can't be read is the failure document. */
+export declare function workspacePoints(query: PointsQuery): Promise<PointsDocument>;
+/** The document as lines for a person. */
+export declare function formatPoints(doc: Extract<PointsDocument, {
+    points: unknown;
+}>): string;
+/** A POST /v1/systemone response the caller already has, as the model call: its answer to the point asked. */
+export declare function responseAsk(response: unknown): ModelAsk;
+/** `chant workspace points`, and its `ask` and `answer` verbs. */
+export declare function runWorkspacePoints(ctx: CommandContext): Promise<number>;
+export {};
+//# sourceMappingURL=points-cli.d.ts.map

package/dist/workspace/points-cli.d.ts.map

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

package/dist/workspace/points.d.ts

@@ -0,0 +1,320 @@
+/**
+ * Decision points (ws-058, #2738): the recurring questions a workspace asks of
+ * its own graph, declared as data, and the answers they leave (#2739).
+ *
+ * A points file is JSON, validated against `decision-points.schema.json`, and
+ * named by a record kind's `answers.points`: the kind whose records are the
+ * answers. Each point is a typed question (`noul`, `choice` or `score`, the
+ * question types of the POST /v1/systemone wire format, #2491), the inputs it
+ * reads, each named as a read-contract output, and an ordered chain of
+ * deciders:
+ *
+ *   table   rows of { when, answer }; the first row whose conditions all hold answers.
+ *   model   a backend asked the question with the inputs as its state, at a
+ *           pinned model id. An answer at or above the threshold is a
+ *           proposal a person confirms; below it, the next decider is asked.
+ *   quorum  people. Always last: the question escalates to them.
+ *
+ * chant never calls a model (ws-052). {@link runChain} takes the model call
+ * as a function, {@link ModelAsk}, which the decide Op activity (#2740), a
+ * runtime's decider or a test's stub supplies. Without one, a model decider is
+ * not asked and the chain moves on.
+ *
+ * Taken from chud's `packages/runtime/src/decide.mjs` at 43afcf1: the chain,
+ * the observation rule, the point version and the inputs hash. The records
+ * are chant records: `decide.ts` writes them, and {@link applyAnswers} warns
+ * about them on read.
+ */
+import type { RecordSource } from "./record-source.js";
+import type { LoadedRecordKind, ReadRecordsOptions, RecordEntry } from "./records.js";
+export declare const DECISION_POINTS_SCHEMA_ID: string;
+/**
+ * The read-contract outputs a point's input may name (#2738), each with the
+ * output schema and `$defs` entry that describes it. Closed: an input naming
+ * anything else is refused. `record`, `decision` and `work-item` are records
+ * as `records --json` lists them, of any kind, a decision kind and a work kind.
+ */
+export declare const POINT_INPUT_OUTPUTS: {
+    readonly record: {
+        readonly schema: "records";
+        readonly def: "record";
+        readonly description: "a record of any kind, as records --json lists it";
+    };
+    readonly decision: {
+        readonly schema: "records";
+        readonly def: "record";
+        readonly description: "a decision record, as records --json lists it";
+    };
+    readonly "work-item": {
+        readonly schema: "records";
+        readonly def: "record";
+        readonly description: "a work item record, as records --json lists it (#2683)";
+    };
+    readonly finding: {
+        readonly schema: "intent";
+        readonly def: "finding";
+        readonly description: "a finding of graph --intent, or of check --changes (#2794)";
+    };
+    readonly region: {
+        readonly schema: "intent";
+        readonly def: "region";
+        readonly description: "the region an intent graph covers";
+    };
+    readonly commit: {
+        readonly schema: "intent";
+        readonly def: "commit";
+        readonly description: "a commit in an intent graph's window";
+    };
+    readonly member: {
+        readonly schema: "ls";
+        readonly def: "member";
+        readonly description: "a member, as ls lists it";
+    };
+    readonly gate: {
+        readonly schema: "status";
+        readonly def: "gate";
+        readonly description: "a gate, as status lists it";
+    };
+    readonly release: {
+        readonly schema: "status";
+        readonly def: "release";
+        readonly description: "a release, as status lists it; a release plan's fields until the lifecycle ledger lists plans (#2717)";
+    };
+    readonly environment: {
+        readonly schema: "status";
+        readonly def: "environment";
+        readonly description: "an environment, as status lists it";
+    };
+    readonly component: {
+        readonly schema: "composites";
+        readonly def: "component";
+        readonly description: "a component, as graph --composites lists it";
+    };
+};
+export type PointInputOutput = keyof typeof POINT_INPUT_OUTPUTS;
+export declare const POINT_INPUT_OUTPUT_NAMES: PointInputOutput[];
+/** The output an input name reads: the part before its first dot. */
+export declare function inputOutput(name: string): string;
+export type QuestionType = "noul" | "choice" | "score";
+export interface Question {
+    /** `boolean` in a points file is read as `noul`. */
+    type: QuestionType;
+    instructions: string;
+    criteria: Record<string, string> | string[];
+}
+export type Scalar = string | number | boolean | null;
+export type Condition = Scalar | {
+    eq?: Scalar;
+    ne?: Scalar;
+    lt?: number;
+    lte?: number;
+    gt?: number;
+    gte?: number;
+    in?: Scalar[];
+};
+export interface TableRow {
+    when: Record<string, Condition>;
+    answer: string | boolean;
+    note?: string;
+}
+export type Decider = {
+    kind: "table";
+    rows: TableRow[];
+    note?: string;
+} | {
+    kind: "model";
+    backend: string;
+    model: string;
+    threshold: number;
+    unreachable?: "escalate" | "fail";
+    note?: string;
+} | {
+    kind: "quorum";
+    count: number;
+    roles?: string[];
+    note?: string;
+};
+export interface Point {
+    title: string;
+    question: Question;
+    inputs: Record<string, string>;
+    deciders: Decider[];
+}
+/** One problem with a points file: the JSON path of the field, or null for the file, and what is wrong. */
+export interface PointProblem {
+    field: string | null;
+    message: string;
+}
+export declare class PointsError extends Error {
+    readonly file: string;
+    readonly problems: PointProblem[];
+    constructor(file: string, problems: PointProblem[]);
+}
+/** A question's candidate answers: true and false, a choice's options, or a score's levels. */
+export declare function candidates(question: Question): (string | boolean)[];
+/** The schema's problems with `data`, as JSON paths. */
+export declare function schemaProblems(data: unknown): PointProblem[];
+/**
+ * Parse and validate a points file's text. Returns its points, with
+ * `boolean` read as `noul`. Throws a {@link PointsError} naming the file and
+ * each field.
+ */
+export declare function parsePoints(text: string, file: string): Record<string, Point>;
+/** One point by name, or undefined. */
+export declare function pointOf(points: Record<string, Point>, name: string): Point | undefined;
+/** JSON with keys sorted and undefined members left out, the text every hash here is taken over. */
+export declare function canonical(value: unknown): string;
+/** The version of a point: the sha256 of its declaration. Editing the question or any decider changes it. */
+export declare const pointVersion: (point: Point) => string;
+/** What is answered once: the point, its version and the inputs. */
+export declare const inputsHash: (name: string, version: string, inputs: Record<string, unknown>) => string;
+/** The id of the answer to `name` for inputs hashing to `hash`: the name and the hash's first 12 hex digits. */
+export declare const answerId: (name: string, hash: string) => string;
+/** The quorum a point ends in. */
+export declare function quorumOf(point: Point): {
+    count: number;
+    roles?: string[];
+};
+/** Whether every condition in a row's `when` holds for these inputs. An input the state lacks never matches. */
+export declare const matches: (when: Record<string, Condition>, inputs: Record<string, unknown>) => boolean;
+/** A question as the POST /v1/systemone wire format asks it (#2491). */
+export interface WireQuestion {
+    type: QuestionType;
+    instructions: string;
+    criteria: Record<string, string> | string[];
+}
+/** One answer in the wire format's shape. */
+export type WireAnswer = {
+    type: "noul";
+    noul: number;
+} | {
+    type: "choice";
+    choice: string;
+    probabilities?: Record<string, number>;
+    confidence?: number;
+} | {
+    type: "score";
+    score?: number;
+    legend?: unknown;
+    probabilities?: Record<string, number>;
+    confidence?: number;
+} | {
+    type: "unsupported";
+};
+export declare function wireQuestion(question: Question): WireQuestion;
+/** What a model decider is asked. */
+export interface ModelRequest {
+    point: string;
+    backend: string;
+    /** The pinned model id. */
+    model: string;
+    question: WireQuestion;
+    /** The inputs, as the state. */
+    state: Record<string, unknown>;
+}
+/**
+ * The model call, supplied by the caller: the decide Op activity (#2740), a
+ * runtime's decider, or a test's stub. It resolves with the model id that
+ * answered and one answer in the wire format's shape. Throwing means the
+ * backend could not be reached or gave nothing usable.
+ */
+export type ModelAsk = (request: ModelRequest) => Promise<{
+    model: string;
+    answer: WireAnswer;
+}>;
+export type Observation = {
+    observed: true;
+    answer: string | boolean;
+    probabilities: Record<string, number>;
+    confidence: number;
+} | {
+    observed: false;
+    answer?: string | boolean | null;
+    probabilities?: Record<string, number>;
+    confidence?: number;
+    reason: string;
+};
+/**
+ * A model's wire answer against the question and the decider's threshold
+ * (chud's rule):
+ *
+ * - noul p: true when p is at least the threshold, false when 1 - p is,
+ *   otherwise not observed. Its confidence is max(p, 1 - p).
+ * - choice and score: the choice (a score's most probable level) when the
+ *   reported confidence is at least the threshold. A backend that reports no
+ *   confidence is read by its largest probability.
+ *
+ * An answer outside the candidates, or an unsupported question, is not observed.
+ */
+export declare function observe(question: Question, answer: WireAnswer | undefined, threshold: number): Observation;
+/** A decider that was asked and did not answer, and why. */
+export interface Escalation {
+    kind: "table" | "model";
+    reason: string;
+    backend?: string;
+    model?: string;
+    answer?: string | boolean | null;
+    probabilities?: Record<string, number>;
+    confidence?: number;
+    threshold?: number;
+}
+export type ChainResult = {
+    status: "answered";
+    answer: string | boolean;
+    decider: {
+        kind: "table";
+        row: number;
+    };
+    note?: string;
+    escalations: Escalation[];
+} | {
+    status: "proposed";
+    answer: string | boolean;
+    decider: {
+        kind: "model";
+        backend: string;
+        model: string;
+    };
+    probabilities: Record<string, number>;
+    confidence: number;
+    threshold: number;
+    escalations: Escalation[];
+} | {
+    status: "escalated";
+    decider: {
+        kind: "quorum";
+        count: number;
+        roles?: string[];
+    };
+    escalations: Escalation[];
+};
+/** A model decider declared `unreachable: "fail"` could not answer, so the ask fails and nothing is written. */
+export declare class DeciderFailed extends Error {
+    constructor(message: string);
+}
+/**
+ * Ask a point's deciders in order. A table row answers; a model at or above
+ * its threshold proposes; otherwise the question escalates to the quorum.
+ * Each decider that did not answer is in `escalations`, with why. A model
+ * decider is asked through `ask`; without it, it is not asked.
+ */
+export declare function runChain(name: string, point: Point, inputs: Record<string, unknown>, ask?: ModelAsk): Promise<ChainResult>;
+/** Why an answer record carries a warning. Closed, like the record warning codes. */
+export declare const ANSWER_WARNING_CODES: readonly ["answer-points-unreadable", "answer-point-unknown", "answer-point-changed"];
+export type AnswerWarningCode = (typeof ANSWER_WARNING_CODES)[number];
+/** The points file an answer kind names, from `root` with / separators. */
+export declare function pointsFileOf(loaded: LoadedRecordKind, root: string): string;
+/** The points an answer kind names, read from `source` (the tree read), or the problems reading them. */
+export declare function readPointsThrough(source: RecordSource, file: string): {
+    points: Record<string, Point>;
+} | {
+    error: string;
+    problems: PointProblem[];
+};
+/**
+ * Give an answer kind's records their warnings, in place: the points file
+ * can't be read, the answer's point is gone, or the point changed since. They
+ * never make a record invalid.
+ */
+export declare function applyAnswers(loaded: LoadedRecordKind, entries: RecordEntry[], options: ReadRecordsOptions): void;
+//# sourceMappingURL=points.d.ts.map

package/dist/workspace/points.d.ts.map

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

package/dist/workspace/reason-codes.d.ts

@@ -47,11 +47,16 @@ export declare const REASONS: {
     readonly "gates-no-ledger": "The checkout has no chant/lifecycle branch, so there is no gate ledger to read.";
     readonly "gates-no-gate-ledger": "The branch has no gate ledger for the member: no run of it has reached a gate.";
     readonly "gates-ledger-unreadable": "Reading the member's gate ledger failed, so no gate is listed.";
+    readonly "stewards-unreadable": "An *.op.ts file could not be imported, so a steward it declares may be missing.";
+    readonly "stewards-conflict": "A steward was dropped: its name, or an Op it lists, belongs to another steward.";
+    readonly "steward-runs-unreadable": "Reading an Op's run ledger, or a ConvergeOp's converge ledger, failed, so its last run or last tick is null.";
     readonly "record-unparseable": "No front matter, a YAML error or a value outside the JSON subset of YAML, or for a JSON kind a file that is not one object or repeats a member name.";
     readonly "record-schema-invalid": "The record's front matter, or its JSON object, does not match the kind's schema.";
     readonly "record-id-duplicate": "Another record earlier in path order has the same id.";
     readonly "record-supersedes-unknown": "A supersedes link names an id no record has.";
     readonly "record-supersedes-conflict": "A second closed record supersedes a record another one already superseded.";
+    readonly "record-remediates-unknown": "A remediates link names an id no record has.";
+    readonly "record-remediates-not-closed": "A remediates link names a record that isn't closed; a record still open is amended instead.";
     readonly "session-seal-mismatch": "A closed session's seal is not the digest of its text: the session changed after it closed.";
     readonly "session-verdict-unknown-record": "A session's verdict names a record that none of the session kind's subject records has.";
     readonly "asset-drift": "A file the record pins by hash has changed: its bytes no longer hash to the pinned sha256.";
@@ -68,6 +73,11 @@ export declare const REASONS: {
     readonly "work-done-unpinned": "A work record is done and its evidence list is empty: nothing shows the work was done.";
     readonly "work-closed-without-date": "A work record is done or dropped and has no closing date.";
     readonly "work-done-gap-open": "A work record is done, and the finding it came from still fires on its region. graph --intent raises it, and records does by walking that region.";
+    readonly "work-acceptance-unmet": "A work record is done, and one of its acceptance criteria has no passing evidence of the verification it expects. check fails on it (WSP117).";
+    readonly "work-acceptance-self-verified": "A passing manual verdict on a work record's criterion names the record's implementer, so it does not count: a manual verdict comes from someone else.";
+    readonly "answer-points-unreadable": "The points file the answer kind names can't be read, or is not valid.";
+    readonly "answer-point-unknown": "The answer's point is not declared in the points file the answer kind names.";
+    readonly "answer-point-changed": "The point's declaration changed since the question was asked, so the answer is to an older version of the question.";
     readonly "review-decider": "The verdict is the decider's own, and the quorum counts verdicts besides the decider's.";
     readonly "review-agent": "The reviewer holds the agent role in the trust policy at base.";
     readonly "review-duplicate": "A later verdict by the same principal replaces this one. Names are compared after NFKC, trimming and lower-casing.";
@@ -101,6 +111,14 @@ export declare const REASONS: {
     readonly "record-sign-failed": "--sign was given and no author seal could be made: the record names no author, the key can't be read or used, git names no ssh signing key, or ssh-keygen is not installed.";
     readonly "session-unknown": "--session names no session of a session kind whose subjects are the record's kind.";
     readonly "session-not-open": "--session names a session in a closed state, which takes no more verdicts.";
+    readonly "points-undeclared": "No record kind with an answers block is declared, or given with --kind, so there is no points file to ask.";
+    readonly "points-invalid": "The points file an answer kind names can't be read, or does not match decision-points.schema.json and the rules checked in code.";
+    readonly "point-unknown": "No points file declares the point asked, or the one an answer names.";
+    readonly "point-inputs-invalid": "The inputs given to an ask are not a JSON object of the point's declared inputs.";
+    readonly "point-decider-failed": "A model decider that fails closed (unreachable: fail) could not answer, so the ask wrote nothing.";
+    readonly "answer-not-candidate": "The people's answer is not one of the question's candidates.";
+    readonly "quorum-not-met": "Too few of the people who answered count toward the point's quorum: distinct, not holding the agent role, not the steward that asked, and holding one of its roles when it names any.";
+    readonly "answer-in-steward-turn": "The answer was given during a steward's turn, or by a process it started: a steward never answers a decision point, and a person answers it through hud or at a shell.";
     readonly "since-rev-unknown": "--since names no commit, or a session with no opening revision and no commit that added it.";
     readonly "since-session-unknown": "--since has the shape of a session id and names no commit, and no session the kind or the declaration reads has that id.";
     readonly "since-session-open": "--since names a session that is still open, so the comparison runs to the working tree.";
@@ -124,6 +142,8 @@ export declare const REASONS: {
     readonly "intent-decision-unimplemented": "A decided decision constrains the region, no work item that is not dropped implements it, and no commit falls in its window.";
     readonly "intent-work-blocked": "A work item constraining the region has commits in its window while a work item it needs is not done.";
     readonly "intent-work-open-decided-code": "Commits in the region are a decision's own work while the work item implementing that decision is still open.";
+    readonly "change-uncovered": "A path the diff changes is covered by no current decided record and no open work item, by path or by its member.";
+    readonly "change-out-of-scope": "A record in hand for the change, such as the work item it is for or a decision that item implements, lists a path the diff changes in its out_of_scope.";
     readonly "composites-no-chant-member": "No member of kind chant was read, so nothing declares a composite instance or a component.";
     readonly "composites-none-declared": "The members read declare no composite instance.";
     readonly "composites-no-component": "The members read declare no component, so no composite instance has one.";
@@ -132,6 +152,24 @@ export declare const REASONS: {
     readonly "environments-none-declared": "The member's chant.config.ts declares no environments, so only local and the environments in its ledger are listed.";
     readonly "environments-ledger-undeclared": "The member's ledger has releases in an environment its config's environments don't cover, so chant run --env would refuse it and it is not listed.";
     readonly "environments-ledger-unreadable": "The chant/lifecycle branch exists and the member's ledger environments could not be listed.";
+    readonly "diagram-source-missing": "A declared diagram's source file does not exist in the tree read.";
+    readonly "diagram-render-missing": "A declared diagram's render file does not exist in the tree read.";
+    readonly "diagram-render-drift": "A declared diagram records a sourceHash, and the source's bytes now hash to something else: the render is stale for its source.";
+    readonly "box-credential-declared": "A file in a box member's directory carries a literal secret: a credential's shape, or a literal where a credential goes. A variable or secret-manager reference is not one.";
+    readonly "box-capability-unbrokered": "A capability in a member's box block names no broker, so the box would hold its credential.";
+    readonly "box-fountain-callback-undeclared": "A box member builds a fountain Box, whose persistent sandbox fountain gives a callback token scoped to its owner, and the member's box block does not declare the fountain-callback capability brokered by fountain with scope owner.";
+    readonly "work-kind-missing": "No work kind to find the item in: --kind names a kind with no work block, or the declaration names no work kind.";
+    readonly "work-kind-ambiguous": "More than one declared work kind has a record with the id, so --kind must name one.";
+    readonly "work-item-unknown": "No work record has the id, so there is nothing to lease.";
+    readonly "work-item-closed": "A claim on a work item in a closed state, such as done or dropped: there is no work left to claim.";
+    readonly "work-criterion-unknown": "The work record lists no acceptance criterion with the id the evidence names, or its kind has no acceptance criteria.";
+    readonly "lease-held": "Someone holds a live lease on the work item: another worker, or, for a claim, the same one.";
+    readonly "lease-not-held": "Nobody holds a live lease on the work item: it expired, was released or was never claimed.";
+    readonly "lease-token-mismatch": "The live lease on the work item carries another fencing token than the one given.";
+    readonly "lease-race": "Another writer changed the lease between this command's read and its write.";
+    readonly "lease-push-rejected": "The remote refused the lease push: another clone claimed the item first, or the remote could not be reached.";
+    readonly "box-isolation-collision": "Two boxes on one host resolve to the same port, state path or cookie name, or two ports in one box share an offset.";
+    readonly "box-isolation-literal": "A host's stateRoot or a box's state entry is a literal machine path instead of one derived from an environment reference and the box's name.";
     readonly "lock-invalid": "The lineage lock can't be read.";
     readonly "manual-step-open": "A scope in the lineage lock has an open manual step.";
 };

package/dist/workspace/reason-codes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reason-codes.d.ts","sourceRoot":"","sources":["../../src/workspace/reason-codes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,sHAAsH;AACtH,eAAO,MAAM,qBAAqB,IAAI,CAAC;AAEvC,uHAAuH;AACvH,eAAO,MAAM,mBAAmB,WAAW,CAAC;AAE5C,qFAAqF;AACrF,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwIV,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,MAAM,OAAO,OAAO,CAAC;AAE9C,mDAAmD;AACnD,eAAO,MAAM,YAAY,EAA2B,UAAU,EAAE,CAAC;AAEjE,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAEhE;AAED;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,GAAG,UAAU,MAAM,IAAI,MAAM,EAAE,CAAC;AAEtD,eAAO,MAAM,WAAW,QAAkD,CAAC;AAE3E,2HAA2H;AAC3H,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,KAAK,IAAI,UAAU,CAI/E"}
+{"version":3,"file":"reason-codes.d.ts","sourceRoot":"","sources":["../../src/workspace/reason-codes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,sHAAsH;AACtH,eAAO,MAAM,qBAAqB,IAAI,CAAC;AAEvC,uHAAuH;AACvH,eAAO,MAAM,mBAAmB,WAAW,CAAC;AAE5C,qFAAqF;AACrF,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyLV,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,MAAM,OAAO,OAAO,CAAC;AAE9C,mDAAmD;AACnD,eAAO,MAAM,YAAY,EAA2B,UAAU,EAAE,CAAC;AAEjE,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAEhE;AAED;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,GAAG,UAAU,MAAM,IAAI,MAAM,EAAE,CAAC;AAEtD,eAAO,MAAM,WAAW,QAAkD,CAAC;AAE3E,2HAA2H;AAC3H,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,KAAK,IAAI,UAAU,CAI/E"}