@intentius/chant 0.101.0 → 0.104.0

package/dist/workspace/conformance/writer.d.ts

@@ -0,0 +1,462 @@
+/**
+ * Workspace writer conformance (#3159, ws-074).
+ *
+ * The repo is the database (ws-074): every durable fact about a workspace is
+ * a file in the repository or a line on its ledger branch, written only
+ * through chant's write contract, and a tool keeps nothing but secrets,
+ * telemetry, caches and its substrate's runtime state outside it. The reader
+ * suite beside this module holds a reader to the read contract. This one
+ * holds a writer, such as hud or studio's factory, to the write contract:
+ *
+ *   1. Writes go through chant. The suite drives a script of writes
+ *      ({@link WRITER_SCRIPT}) through the writer's `write(step)`. Each step
+ *      must make exactly one chant call, the step's write-contract command
+ *      with its arguments (and its JSON flag, where the command has one),
+ *      giving chant the step's fields on stdin. The document the writer
+ *      returns is the one chant printed, it validates against the command's
+ *      output schema, and it is not a refusal.
+ *   2. Every change is chant's. The workspace's files (outside `.git`) and its
+ *      git refs are read before and after each step. A file may change only
+ *      when it is the path the command reports writing, and a ref only when
+ *      it is the lease ref or the `chant/lifecycle` commit the command
+ *      reports.
+ *   3. Amnesia. The writer is given a state directory of its own, outside
+ *      the workspace, and declares what it keeps there (`privateState`). After
+ *      the script the suite asks the writer for the facts it shows
+ *      (`facts()`), closes it, deletes everything in the state directory,
+ *      builds the writer again and asks again: the two answers must be equal.
+ *      The suite also reads every fact the script produced back through the
+ *      read contract, the uncommitted records included.
+ *   4. No facts outside the repo. A file left in the state directory that
+ *      `privateState` does not declare is a problem, and so is an entry of
+ *      the writer's optional `holds()` that names a record, run or lease the
+ *      repository does not have, unless it names itself one of the four
+ *      exceptions.
+ *
+ *   5. Concurrent writes (#3173, ws-089). When the writer performs `records
+ *      amend`, the suite has it make three amendments of the script's
+ *      decision at once, each from the digest the suite read
+ *      (`--expect <digest>`), as two people and an agent would. Exactly one
+ *      must be written; the other two must come back as chant's
+ *      record-conflict refusal, naming the winner's digest, returned to the
+ *      suite unchanged rather than retried blindly or hidden. The suite then
+ *      has the writer retry each from the digest its refusal named, and each
+ *      retry must be written. See {@link CONCURRENT_AMENDS}.
+ *
+ * `facts()` may only read: every chant call it makes must be a read-contract
+ * command, and it must leave the workspace as it was.
+ *
+ * The workspace is generated for each run, from the reader suite's fixture
+ * and the `__writer_fixture__/` overlay this package ships beside this module:
+ * the reference workspace's work, answer and session kinds (with the
+ * contract and driver kinds a session's verdicts may also name), its
+ * decision points, and one open work item, W-001. Nothing is written
+ * anywhere else.
+ *
+ * Actions a writer does not list in `actions` are not applicable to it. The
+ * suite still performs those steps itself, directly through chant, so a later
+ * step that depends on one (an amend on the decision a `records new` made,
+ * an evidence entry under a claimed lease) has what it needs.
+ */
+import { type ChantRun, type ChantTransport } from "./index.js";
+/** The write-contract commands a writer performs, as the suite names them. */
+export declare const WRITE_CONTRACT_ACTIONS: readonly ["records new", "records amend", "records review", "records close", "points ask", "points answer", "points retract", "work claim", "work renew", "work evidence", "work release", "runs start", "runs end", "runs record", "box listing set", "wip save", "wip restore"];
+export type WriteContractAction = (typeof WRITE_CONTRACT_ACTIONS)[number];
+/** Each action's output schema, in `src/workspace/` beside this module's directory. */
+export declare const WRITE_CONTRACT_SCHEMAS: Record<WriteContractAction, string>;
+/**
+ * The flags a writer may add to each command. The record, points, evidence,
+ * run and listing writes always print their document, so a writer adds
+ * nothing or `--json`; a lease prints its document only with `--json`.
+ */
+export declare const WRITE_CONTRACT_JSON_FLAGS: Record<WriteContractAction, readonly (readonly string[])[]>;
+/** What each action is given. Field documents are JSON values; the command reads them from stdin. */
+export interface WriteParams {
+    "records new": {
+        kind: string;
+        fields: Record<string, unknown>;
+    };
+    /** `expect` (#3173): the record's digest the write builds on, passed as `--expect`. */
+    "records amend": {
+        id: string;
+        kind: string;
+        fields: Record<string, unknown>;
+        expect?: string;
+    };
+    "records review": {
+        id: string;
+        kind: string;
+        verdict: "agree" | "dissent" | "abstain";
+        by: string;
+        note?: string;
+    };
+    "records close": {
+        id: string;
+        kind: string;
+    };
+    /** `candidates` is an ad-hoc point's question and candidates (#3403), `{ question, criteria }`: they go on stdin, and the inputs as JSON on the command line. */
+    "points ask": {
+        point: string;
+        kind: string;
+        inputs: Record<string, unknown>;
+        subject?: string;
+        candidates?: {
+            question: string;
+            criteria: Record<string, string> | string[];
+        };
+    };
+    "points answer": {
+        id: string;
+        kind: string;
+        answer: string;
+        by: string;
+        note?: string;
+    };
+    "points retract": {
+        id: string;
+        kind: string;
+        by: string;
+        note?: string;
+    };
+    "work claim": {
+        id: string;
+        kind: string;
+        holder: string;
+    };
+    "work renew": {
+        id: string;
+        kind: string;
+        holder: string;
+        token: string;
+    };
+    "work evidence": {
+        id: string;
+        kind: string;
+        holder: string;
+        token: string;
+        entry: Record<string, unknown>;
+    };
+    "work release": {
+        id: string;
+        kind: string;
+        holder: string;
+        token: string;
+        outcome: string;
+    };
+    "runs start": {
+        run: Record<string, unknown>;
+    };
+    "runs end": {
+        id: string;
+        fields: Record<string, unknown>;
+    };
+    "runs record": {
+        run: Record<string, unknown>;
+    };
+    /** A box's listing (#3308): the member, the listing fields, and an image to copy in as its cover. */
+    "box listing set": {
+        member: string;
+        fields: Record<string, unknown>;
+        cover?: string;
+    };
+    /** A snapshot of the working tree, uncommitted records included, onto refs/chant/wip/<branch> (#3172): what the caller calls it, and who took it. */
+    "wip save": {
+        label?: string;
+        by?: string;
+    };
+    /** Put the working tree back as a snapshot holds it (#3172). */
+    "wip restore": {
+        snapshot: string;
+        by?: string;
+    };
+}
+/** One write the suite asks of the writer: the action, what it is given, and the command that performs it. */
+export type WriteStep = {
+    [A in WriteContractAction]: {
+        /** The step's name in the script, such as `review`. */
+        id: string;
+        action: A;
+        params: WriteParams[A];
+        /** The arguments after `chant workspace <action>`, as {@link writeArgv} builds them from `params`. */
+        args: string[];
+        /** What the command reads on stdin (`--from -`, `--set -`, `--inputs -`, `--candidates -`), when it reads anything. */
+        input?: string;
+    };
+}[WriteContractAction];
+/**
+ * The arguments that perform `action` with `params`, after `chant workspace
+ * <action>`, and the JSON the command reads on stdin. A writer can build its
+ * calls with this, or with its own code that makes the same call.
+ */
+export declare function writeArgv<A extends WriteContractAction>(action: A, params: WriteParams[A]): {
+    args: string[];
+    input?: string;
+};
+/** The kind files of the writer workspace, from its root. */
+export declare const WRITER_KINDS: {
+    readonly decision: "decisions/decision.kind.mjs";
+    readonly session: "sessions/session.kind.mjs";
+    readonly answer: "answers/answer.kind.mjs";
+    readonly work: "work/work.kind.mjs";
+};
+/** The member of the writer workspace whose box block the script lists (#3308). */
+export declare const WRITER_BOX = "app";
+/**
+ * The files the suite makes for a run outside the workspace, for a step to
+ * hand chant: the cover image the listing step copies in (#3308), a PNG.
+ */
+export declare const WRITER_INPUTS: {
+    readonly cover: {
+        readonly name: "cover.png";
+        readonly bytes: Buffer<ArrayBuffer>;
+    };
+};
+/** Where the suite put {@link WRITER_INPUTS} for this run. */
+export interface WriterInputs {
+    dir: string;
+}
+/** Write {@link WRITER_INPUTS} into `dir`. */
+export declare function writeWriterInputs(dir: string): WriterInputs;
+/** The principals the script writes as. */
+export declare const WRITER_PRINCIPALS: {
+    readonly holder: "conformance-writer";
+    readonly reviewer: "conformance-reviewer";
+    readonly by: "conformance";
+};
+/** One step of the script: its name, its action, and its params from the documents of the steps before it. */
+export interface WriterScriptStep<A extends WriteContractAction = WriteContractAction> {
+    id: string;
+    action: A;
+    /** `inputs` is where the suite put {@link WRITER_INPUTS}; a step that hands chant one of them leaves it out without. */
+    params(done: Record<string, Record<string, unknown>>, inputs?: WriterInputs): WriteParams[A];
+}
+/**
+ * The writes the suite drives, in order, each action at least once: a
+ * decision made, amended and reviewed; a review session opened and closed; a
+ * decision point asked, answered with a note, the answer retracted and the
+ * question answered again (#3351); an ad-hoc question asked with its own
+ * question and candidates, as an agent asks the room, and answered (#3403); the work item's lease claimed, renewed,
+ * evidence attached under it and released; one run started and ended, and one
+ * recorded whole; the box's listing set, with a cover image copied in; and a
+ * snapshot of the working tree taken and restored (#3172).
+ */
+export declare const WRITER_SCRIPT: readonly WriterScriptStep[];
+/**
+ * The concurrent case (#3173): three amendments of the script's decision the
+ * writer makes at once, each setting its question, as two people and an
+ * agent answering the same record would. The suite gives each the digest it
+ * read as `expect`.
+ */
+export declare const CONCURRENT_AMENDS: readonly {
+    id: string;
+    fields: Record<string, unknown>;
+}[];
+/** The amend step of {@link CONCURRENT_AMENDS} entry `c`, on record `id`, from digest `expect`. */
+export declare function concurrentAmendStep(c: {
+    id: string;
+    fields: Record<string, unknown>;
+}, id: string, expect: string): WriteStep;
+/** The four things ws-074 lets a tool keep outside the repo. */
+export declare const PRIVATE_STATE_CATEGORIES: readonly ["cache", "telemetry", "secret", "runtime"];
+export type PrivateStateCategory = (typeof PRIVATE_STATE_CATEGORIES)[number];
+/** A file or directory the writer keeps in its state directory, and which of the four it is. */
+export interface PrivateStatePath {
+    /** From the state directory, with / separators. A directory covers everything under it. */
+    path: string;
+    is: PrivateStateCategory | readonly PrivateStateCategory[];
+}
+/** One thing the writer holds, as its `holds()` reports it. */
+export type HeldItem = {
+    record: string;
+    kind: string;
+} | {
+    run: string;
+} | {
+    lease: string;
+    kind: string;
+} | {
+    exempt: PrivateStateCategory;
+    what: string;
+};
+export interface WorkspaceWriter {
+    /** Perform one step: run its write-contract command through the transport, and return the parsed document chant printed. */
+    write(step: WriteStep): Promise<unknown> | unknown;
+    /**
+     * The facts the tool shows, read the way the tool reads them, as a JSON
+     * value. The suite compares the answer before and after amnesia. It may make
+     * read-contract calls only.
+     */
+    facts(): Promise<unknown> | unknown;
+    /** Optional: what the tool holds, each entry a record, run or lease in the repo, or one of the four exceptions. */
+    holds?(): Promise<readonly HeldItem[]> | readonly HeldItem[];
+    /** Optional: let go of the state directory (close a database) before the suite deletes it. */
+    close?(): Promise<void> | void;
+}
+export interface WriterContext {
+    /**
+     * A directory the writer keeps its private state in, such as a database
+     * file. The suite makes it, outside the workspace, and the same one is given
+     * to the writer built again after amnesia.
+     */
+    stateDir: string;
+}
+/** Build the writer over the transport the suite gives it. Called twice: before the script, and again after amnesia. */
+export type WorkspaceWriterFactory = (chant: ChantTransport, context: WriterContext) => WorkspaceWriter;
+export interface WorkspaceWriterConformanceOptions {
+    /** The actions the writer performs. The suite performs the other steps itself. Defaults to every action. */
+    actions?: readonly WriteContractAction[];
+    /** What the writer keeps in its state directory. Anything else left there is a problem. Defaults to nothing. */
+    privateState?: readonly PrivateStatePath[];
+    /** The chant to run, as a command and its leading arguments. The reader suite's default. */
+    chantCommand?: string[];
+    /** How long one chant run may take, in milliseconds. Default 120000. */
+    timeoutMs?: number;
+}
+export interface WorkspaceWriterConformanceConfig extends WorkspaceWriterConformanceOptions {
+    /** Short label, used in the suite name. */
+    name: string;
+    writer: WorkspaceWriterFactory;
+}
+/** What one step found. */
+export interface WriterStepResult {
+    id: string;
+    action: WriteContractAction;
+    /** Whether the writer performed it, or the suite did because the action is not the writer's. */
+    by: "writer" | "suite";
+    args: string[];
+    problems: string[];
+}
+/** What {@link runWorkspaceWriterConformance} found. The writer conforms when `problems` is empty. */
+export interface WorkspaceWriterConformanceReport {
+    /** Every problem, each starting with the step it concerns, or `amnesia:`, `facts:`, `state:`, `holds:` or `read back:`. */
+    problems: string[];
+    /** The actions the writer performed, in contract order. */
+    checked: WriteContractAction[];
+    /** The actions not in `actions`, so not applicable to this writer. */
+    skipped: WriteContractAction[];
+    results: WriterStepResult[];
+    /** The problems of the checks after the script, by check. `concurrent` is empty, and not run, when the writer does not perform records amend. */
+    after: {
+        facts: string[];
+        state: string[];
+        amnesia: string[];
+        holds: string[];
+        readBack: string[];
+        concurrent: string[];
+    };
+    /** What `facts()` returned before amnesia and after. */
+    facts: {
+        before: unknown;
+        after: unknown;
+    };
+    /** The workspace written. Removed before the report is returned. */
+    workspaceDir: string;
+}
+/** The overlay the writer workspace adds to the reader suite's fixture, shipped under `src/`. */
+export declare const WRITER_FIXTURE_DIR: string;
+type Validate = ((d: unknown) => boolean) & {
+    errors?: unknown;
+};
+/** An action's output schema and a draft 2020-12 validator for it, from this package's own ajv 8. */
+export declare function writeContractSchema(action: WriteContractAction): {
+    schema: {
+        $id: string;
+    };
+    validate: Validate;
+};
+/** A digest of every file under `dir`, skipping `.git` and node_modules: the working tree. */
+export declare function worktreeDigest(dir: string): Record<string, string>;
+/** Every git ref in `dir` and what it points at, with `HEAD` as the branch it names and its commit. */
+export declare function gitRefs(dir: string): Record<string, string>;
+/** The refs that differ between two {@link gitRefs}, with what each now points at (empty when removed). */
+export declare function refChanges(before: Record<string, string>, after: Record<string, string>): Record<string, string>;
+/** Whether `argv` is a read-contract call: one a reader may make, which writes nothing. */
+export declare function isReadCall(argv: readonly string[]): boolean;
+/**
+ * What is wrong with the chant calls one step made: anything but exactly
+ * one call, of `workspace <action>` with the step's arguments in order and
+ * the action's JSON flag, given the step's fields on stdin. Empty when the
+ * calls conform.
+ */
+export declare function writerCallProblems(step: WriteStep, calls: readonly ChantRun[]): string[];
+/** Everything wrong with the document one step returned (`doc`), given what chant printed (`printed`). Empty when it conforms. */
+export declare function writerDocumentProblems(step: WriteStep, printed: ChantRun, doc: unknown): string[];
+/** The files and refs a step's document says chant wrote. */
+export declare function reportedWrites(action: WriteContractAction, doc: unknown): {
+    paths: string[];
+    refs: Record<string, string>;
+};
+/**
+ * What changed in the workspace during one step that the step's document
+ * does not report: a file other than the path chant wrote, or a ref other
+ * than the lease ref and the ledger commit chant wrote.
+ */
+export declare function unreportedChanges(step: WriteStep, doc: unknown, files: {
+    before: Record<string, string>;
+    after: Record<string, string>;
+}, refs: {
+    before: Record<string, string>;
+    after: Record<string, string>;
+}): string[];
+/** Build the step a script step is at, from the documents of the steps before it and where the suite put its inputs. */
+export declare function buildStep(s: WriterScriptStep, done: Record<string, Record<string, unknown>>, inputs?: WriterInputs): WriteStep;
+/** The box listings `status --json` prints, by member: what a home site shows of each box (#3308). */
+export declare function readListing(run: (argv: string[]) => Promise<ChantRun>): Promise<Record<string, unknown>>;
+/** Each branch's work-in-progress snapshots `wip --json` lists (#3172), by branch: each snapshot's kind and label, newest first. */
+export declare function readWip(run: (argv: string[]) => Promise<ChantRun>): Promise<Record<string, [string, string | null][]>>;
+/** The smallest writer that conforms: each step is its one command, and its facts are read through the read contract. */
+export declare const referenceWriter: WorkspaceWriterFactory;
+/** A workspace generated for a writer run, and how to remove it. */
+export interface WriterConformanceWorkspace {
+    dir: string;
+    dispose(): void;
+}
+/**
+ * Generate the writer conformance workspace: the reader suite's workspace
+ * ({@link createConformanceWorkspace}), with `__writer_fixture__/` copied over
+ * it, the four kinds declared in its `records`, a box block on
+ * {@link WRITER_BOX} for the listing step, and that committed.
+ */
+export declare function createWriterConformanceWorkspace(options?: {
+    chantCommand?: string[];
+    timeoutMs?: number;
+}): WriterConformanceWorkspace;
+/** The actions to exercise and the ones skipped, from `actions`. Throws on a name that is not a write-contract action. */
+export declare function selectActions(actions?: readonly WriteContractAction[]): {
+    checked: WriteContractAction[];
+    skipped: WriteContractAction[];
+};
+/** The files in the state directory that `privateState` does not declare, and problems with the declaration itself. */
+export declare function undeclaredState(files: readonly string[], privateState: readonly PrivateStatePath[]): string[];
+/**
+ * Hold a writer to the write contract, with no test runner: drive
+ * {@link WRITER_SCRIPT} through it on a generated workspace, check each step,
+ * then the amnesia test and what the writer holds, and return what is wrong.
+ * The writer conforms when `problems` is empty.
+ *
+ * ```js
+ * import { test } from "node:test";
+ * import assert from "node:assert/strict";
+ * import { runWorkspaceWriterConformance } from "@intentius/chant/workspace/conformance";
+ *
+ * test("my writer writes only through chant", { timeout: 600_000 }, async () => {
+ *   const report = await runWorkspaceWriterConformance(myWriter, {
+ *     actions: ["records review", "points answer"],
+ *     privateState: [{ path: "events.db", is: "cache" }],
+ *   });
+ *   assert.deepEqual(report.problems, []);
+ * });
+ * ```
+ */
+export declare function runWorkspaceWriterConformance(writer: WorkspaceWriterFactory, options?: WorkspaceWriterConformanceOptions): Promise<WorkspaceWriterConformanceReport>;
+/**
+ * The concurrent case (#3173, ws-089): the writer makes the three
+ * {@link CONCURRENT_AMENDS} of record `id` at once, each from the digest the
+ * suite read. Exactly one is written and the others are refused with
+ * record-conflict naming its digest; each is then retried from the digest
+ * its refusal named, and written. Returns the problems, each starting
+ * `concurrent:`.
+ */
+export declare function concurrentAmends(built: WorkspaceWriter, calls: ChantRun[], direct: (argv: string[], input?: string) => Promise<Record<string, unknown>>, id: string, dir: string): Promise<string[]>;
+export {};
+//# sourceMappingURL=writer.d.ts.map

package/dist/workspace/conformance/writer.d.ts.map

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