@intentius/chant 0.102.0 → 0.104.1

package/dist/workspace/work-size.d.ts

@@ -0,0 +1,55 @@
+/**
+ * How much a work item holds, for the `slice-tier` decision point (#3150).
+ *
+ * The point picks the smallest builder tier that can build an item, from five
+ * inputs every orchestrator must compute the same way, so chant computes
+ * them. They are read through the `work-item` output like any other field:
+ *
+ *   work-item.criteria      the item's acceptance criteria, counted
+ *   work-item.files         distinct paths the item names in backticks
+ *   work-item.words         words in the item's text
+ *   work-item.fits_<tier>   whether criteria, files and words are each within
+ *                           that tier's limits (`fits_small`, `fits_medium`)
+ *
+ * The item's text is what a person asked (`source.ask.said`, or the answer
+ * to the box's intent, `source.intent.answer`), the record's Markdown body
+ * with its heading lines left out, and each acceptance criterion's text. A
+ * path is a backticked token with a `/` between two parts, such as
+ * `app/server.ts` or `design/screens/`, or a file name with an extension of
+ * one to five letters, such as `README.md`. Words are runs of non-blank
+ * characters.
+ *
+ * The limits are the work kind's `work.tier.limits`, else
+ * {@link DEFAULT_TIER_LIMITS}: small holds at most 10 criteria, 5 files and
+ * 150 words, medium 20, 10 and 300. A tier with no limits, such as large,
+ * has no `fits_` input; an item that fits neither small nor medium is large.
+ * These are the sizing defaults studio's factory used (arugula-salad/studio
+ * `queue.mjs` `sizing()`), so a point's answers keep their meaning.
+ */
+/** What one tier may hold. A limit left out is not checked. */
+export interface TierLimit {
+    criteria?: number;
+    files?: number;
+    words?: number;
+}
+/** The limits when the work kind declares none. */
+export declare const DEFAULT_TIER_LIMITS: Readonly<Record<string, TierLimit>>;
+export interface WorkItemSize {
+    criteria: number;
+    files: number;
+    words: number;
+}
+/**
+ * Measure a work item from its front matter (`data`) and Markdown body.
+ * `acceptanceField` is the work kind's `work.acceptance.field`, `acceptance`
+ * when it names none.
+ */
+export declare function measureWorkItem(data: Record<string, unknown> | null, body: string, acceptanceField?: string): WorkItemSize;
+/** Whether `size` is within `limit`: each limit given is at least the measure. */
+export declare function fitsTier(size: WorkItemSize, limit: TierLimit | undefined): boolean;
+/**
+ * The slice-tier inputs' fields for a measured item: `criteria`, `files`,
+ * `words` and `fits_<tier>` for each tier `limits` names.
+ */
+export declare function sizeFields(size: WorkItemSize, limits?: Readonly<Record<string, TierLimit>>): Record<string, number | boolean>;
+//# sourceMappingURL=work-size.d.ts.map

package/dist/workspace/work-size.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"work-size.d.ts","sourceRoot":"","sources":["../../src/workspace/work-size.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAYH,+DAA+D;AAC/D,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,mDAAmD;AACnD,eAAO,MAAM,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAGlE,CAAC;AAEH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAMD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,eAAe,SAAe,GAAG,YAAY,CAShI;AAED,kFAAkF;AAClF,wBAAgB,QAAQ,CAAC,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,CAGlF;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,YAAY,EAAE,MAAM,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAuB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAIlJ"}

package/dist/workspace/workspace-kinds.schema.json

@@ -75,6 +75,9 @@
                 },
                 "graph": {
                     "$ref": "#/$defs/graph"
+                },
+                "fields": {
+                    "$ref": "#/$defs/fields"
                 }
             },
             "patternProperties": {
@@ -123,6 +126,34 @@
                         }
                     },
                     "additionalProperties": false
+                },
+                "anyJsonKey": {
+                    "type": "object",
+                    "description": "The directory passes when a file directly in it, whose name matches one of in, parses as JSON and has a value at one of pointers, each a JSON Pointer such as /scripts/start (#3151). A file that is not JSON is no evidence either way. Added by chant 0.103.0.",
+                    "required": [
+                        "in",
+                        "pointers"
+                    ],
+                    "properties": {
+                        "in": {
+                            "type": "array",
+                            "minItems": 1,
+                            "uniqueItems": true,
+                            "items": {
+                                "$ref": "#/$defs/fileName"
+                            }
+                        },
+                        "pointers": {
+                            "type": "array",
+                            "minItems": 1,
+                            "uniqueItems": true,
+                            "items": {
+                                "type": "string",
+                                "pattern": "^(/[^/]+)+$"
+                            }
+                        }
+                    },
+                    "additionalProperties": false
                 }
             },
             "additionalProperties": false
@@ -154,6 +185,97 @@
                 "^x-": true
             },
             "additionalProperties": false
+        },
+        "fields": {
+            "type": "object",
+            "description": "The fields a member entry of this kind may set under its own fields block, each with a type and, optionally, a default (#3151). chant workspace check fails a member whose fields name one the kind doesn't declare or give a value of the wrong type (WSP005), and chant workspace status --json prints every declared field with the defaults filled in. Added by chant 0.103.0; an older chant can't read a kinds file that uses it.",
+            "minProperties": 1,
+            "propertyNames": {
+                "$ref": "#/$defs/fieldName"
+            },
+            "additionalProperties": {
+                "oneOf": [
+                    {
+                        "$ref": "#/$defs/scalarField"
+                    },
+                    {
+                        "$ref": "#/$defs/objectField"
+                    }
+                ]
+            }
+        },
+        "fieldName": {
+            "type": "string",
+            "pattern": "^[a-z][A-Za-z0-9]{0,39}$"
+        },
+        "scalarField": {
+            "type": "object",
+            "required": [
+                "type",
+                "description"
+            ],
+            "properties": {
+                "type": {
+                    "enum": [
+                        "string",
+                        "integer",
+                        "boolean"
+                    ]
+                },
+                "description": {
+                    "type": "string",
+                    "minLength": 1
+                },
+                "default": {
+                    "oneOf": [
+                        {
+                            "type": "string"
+                        },
+                        {
+                            "type": "integer"
+                        },
+                        {
+                            "type": "boolean"
+                        }
+                    ],
+                    "description": "The value a member that doesn't set the field gets. Its type is the field's. Without it the field reads as null when unset."
+                },
+                "pattern": {
+                    "type": "string",
+                    "minLength": 1,
+                    "description": "For a string field: a regular expression the value must match."
+                }
+            },
+            "additionalProperties": false
+        },
+        "objectField": {
+            "type": "object",
+            "required": [
+                "type",
+                "description",
+                "properties"
+            ],
+            "properties": {
+                "type": {
+                    "const": "object"
+                },
+                "description": {
+                    "type": "string",
+                    "minLength": 1
+                },
+                "properties": {
+                    "type": "object",
+                    "minProperties": 1,
+                    "propertyNames": {
+                        "$ref": "#/$defs/fieldName"
+                    },
+                    "additionalProperties": {
+                        "$ref": "#/$defs/scalarField"
+                    },
+                    "description": "The object's own fields, each a string, integer or boolean field. A member sets any of them; the rest take their defaults."
+                }
+            },
+            "additionalProperties": false
         }
     }
 }

package/dist/workspace/write-lock-cli.d.ts

@@ -0,0 +1,60 @@
+/**
+ * `chant workspace lock` (#3173, ws-089): the working tree's write lock
+ * (`write-lock.ts`), seen and held from outside chant.
+ *
+ * - `lock` prints who holds it now, or that nobody does.
+ * - `lock acquire --holder <name> [--ttl <duration>]` takes it for a batch of
+ *   writes across several chant calls, waiting for it as a write does, and
+ *   prints the token. Each chant write of the batch runs with
+ *   `CHANT_WRITE_LOCK=<token>` and goes ahead without waiting; every other
+ *   writer waits. The lock lasts until it is released or the ttl passes
+ *   (default 60s, at most 10m), after which any writer may break it.
+ * - `lock release --token <token>` gives it back.
+ *
+ * Each prints one JSON document (`write-lock.schema.json`); a refusal exits 1.
+ * The token is printed only to the caller that took the lock: `lock` never
+ * prints it, so holding the lock can't be taken over by reading who holds it.
+ */
+import type { CommandContext } from "../cli/registry.js";
+import { type WriteLockHolder } from "./write-lock.js";
+export declare const WRITE_LOCK_CONTRACT_VERSION = 1;
+export declare const WRITE_LOCK_SCHEMA_ID = "https://intentius.io/chant/schemas/workspace/write-lock/v1/write-lock.schema.json";
+/** Why a lock command did nothing. Closed. */
+export declare const WRITE_LOCK_ERROR_CODES: readonly ["write-usage-invalid", "write-lock-timeout", "write-lock-not-held"];
+export type WriteLockErrorCode = (typeof WRITE_LOCK_ERROR_CODES)[number];
+/** A holder as the documents show it: everything but the token. */
+export type HolderView = Omit<WriteLockHolder, "token">;
+export type WriteLockDocument = {
+    $schema: string;
+    contract: number;
+    chant: string;
+    verb: "status" | "acquire" | "release";
+    /** The lock directory. */
+    path: string;
+    /** Who holds the lock after the command: the batch for acquire, null after release. */
+    holder: HolderView | null;
+    /** acquire only: the token each write of the batch runs with, as CHANT_WRITE_LOCK. */
+    token?: string;
+} | {
+    $schema: string;
+    contract: number;
+    chant: string;
+    verb: "status" | "acquire" | "release";
+    error: {
+        code: WriteLockErrorCode;
+        message: string;
+    };
+    holder: HolderView | null;
+};
+/** Run one lock command and build its document. */
+export declare function workspaceLock(req: {
+    cwd: string;
+    verb: string | undefined;
+    holder?: string;
+    ttl?: string;
+    token?: string;
+    agent?: string;
+}): Promise<WriteLockDocument>;
+/** `chant workspace lock [acquire|release]`. Prints one JSON document; exits 1 on a refusal. */
+export declare function runWorkspaceLock(ctx: CommandContext): Promise<number>;
+//# sourceMappingURL=write-lock-cli.d.ts.map

package/dist/workspace/write-lock-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-lock-cli.d.ts","sourceRoot":"","sources":["../../src/workspace/write-lock-cli.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGtD,OAAO,EAQL,KAAK,eAAe,EACrB,MAAM,cAAc,CAAC;AAGtB,eAAO,MAAM,2BAA2B,IAAI,CAAC;AAC7C,eAAO,MAAM,oBAAoB,sFAAsF,CAAC;AAExH,8CAA8C;AAC9C,eAAO,MAAM,sBAAsB,YAAI,qBAAqB,EAAE,oBAAoB,EAAE,qBAAqB,CAAU,CAAC;AACpH,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzE,mEAAmE;AACnE,MAAM,MAAM,UAAU,GAAG,IAAI,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;AAExD,MAAM,MAAM,iBAAiB,GACzB;IACE,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;IACvC,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,uFAAuF;IACvF,MAAM,EAAE,UAAU,GAAG,IAAI,CAAC;IAC1B,sFAAsF;IACtF,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GACD;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;IAAC,KAAK,EAAE;QAAE,IAAI,EAAE,kBAAkB,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAAA;CAAE,CAAC;AAUlL,mDAAmD;AACnD,wBAAsB,aAAa,CAAC,GAAG,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAwC7K;AAUD,gGAAgG;AAChG,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAY3E"}

package/dist/workspace/write-lock.d.ts

@@ -0,0 +1,152 @@
+/**
+ * The working tree's write lock and write journal (#3173, ws-089).
+ *
+ * The repo is the database (ws-074), and one working tree is written by
+ * several principals at once: people through hud, the coding agent, the
+ * steward and builders. chant's working-tree writes (records new, amend,
+ * review and close, points ask and answer, box listing set) each read the
+ * records, build the file they write, validate it and write it. Two of them
+ * running at once could each read the same record and the second write would
+ * drop the first's change, or two `records new` could hand out the same id.
+ * So every such write holds this lock from its first read to its last write:
+ * writes to one working tree are serialised, and each one reads what the one
+ * before it wrote.
+ *
+ * The lock is a directory, `chant-write.lock`, in the working tree's git
+ * directory (`.git`, or `.git/worktrees/<name>` for a linked worktree, so two
+ * worktrees of one repository never wait on each other), made with `mkdir`,
+ * which either creates it or fails. `owner.json` inside it says who holds it.
+ * Outside git it lives in the system's temporary directory, keyed by the
+ * working directory's real path, so nothing is added to the files a person
+ * reviews. A holder that died leaves its lock behind: one whose process is
+ * gone on this host, or whose `expiresAt` has passed, is broken by the next
+ * writer. A writer waits for the lock up to `CHANT_WRITE_LOCK_WAIT_MS`
+ * (default {@link DEFAULT_WAIT_MS}) and is then refused with
+ * `write-lock-timeout`, naming the holder.
+ *
+ * A caller can hold the lock across several chant calls, for a batch of
+ * writes nobody else interleaves with (`chant workspace lock acquire`, hud#819):
+ * each call of the batch runs with `CHANT_WRITE_LOCK=<token>` in its
+ * environment, and goes ahead without waiting while the lock is held under
+ * that token. A token that no longer holds the lock (released, or broken
+ * after it expired) is refused with `write-lock-not-held`, so a batch never
+ * runs on unlocked.
+ *
+ * The journal, `chant-writes.json` beside the lock, notes the last chant
+ * write of each record file: the verb, who it named and when, keyed by the
+ * file's SHA-256 after the write. The read contract reports it as a record's
+ * `lastWrite` while the file still has those bytes, and a conflict refusal
+ * names it. It is a cache in the git directory (ws-074's exceptions), never
+ * a fact: lost, every record's `lastWrite` is null, and nothing else changes.
+ */
+/** The environment variable that names a lock token a batch holds across chant calls. */
+export declare const WRITE_LOCK_ENV = "CHANT_WRITE_LOCK";
+/** The environment variable that sets how long a write waits for the lock, in milliseconds. */
+export declare const WRITE_LOCK_WAIT_ENV = "CHANT_WRITE_LOCK_WAIT_MS";
+/** How long a write waits for the lock by default. */
+export declare const DEFAULT_WAIT_MS = 15000;
+/** How long one command's lock is good for, should its process be unable to say it died. */
+export declare const COMMAND_TTL_MS: number;
+/** The longest a batch may hold the lock with `lock acquire --ttl`. */
+export declare const MAX_BATCH_TTL_MS: number;
+/** The default `--ttl` of `lock acquire`. */
+export declare const DEFAULT_BATCH_TTL_MS = 60000;
+/** The lock directory's name in the git directory. */
+export declare const WRITE_LOCK_NAME = "chant-write.lock";
+/** The journal's name in the git directory. */
+export declare const WRITE_JOURNAL_NAME = "chant-writes.json";
+export declare const WRITE_LOCK_CODES: readonly ["write-lock-timeout", "write-lock-not-held"];
+export type WriteLockCode = (typeof WRITE_LOCK_CODES)[number];
+/** Who holds the lock, as `owner.json` holds it. */
+export interface WriteLockHolder {
+    token: string;
+    /** The process holding it, or null for a batch held across calls by `lock acquire`. */
+    pid: number | null;
+    host: string;
+    /** What holds it: a write verb, such as `records amend`, or `batch`. */
+    verb: string;
+    by: string | null;
+    agent: string | null;
+    acquiredAt: string;
+    expiresAt: string;
+}
+/** Who is writing: the verb, and the principal and agent session the write names. */
+export interface WriteLockWho {
+    verb: string;
+    by?: string | null;
+    agent?: string | null;
+}
+export declare class WriteLockError extends Error {
+    readonly code: WriteLockCode;
+    readonly holder: WriteLockHolder | null;
+    constructor(code: WriteLockCode, message: string, holder: WriteLockHolder | null);
+}
+/**
+ * The git directory of the working tree `start` is in: `.git`, or the
+ * directory a linked worktree's `.git` file names. Null outside git.
+ */
+export declare function gitDirOf(start: string): string | null;
+/** The lock directory for the working tree `start` is in. */
+export declare function writeLockPath(start: string): string;
+/** The journal for the working tree `start` is in, or null outside git. */
+export declare function writeJournalPath(start: string): string | null;
+/** Remove the lock at `lock` when `token` holds it. Returns whether it did. */
+export declare function releaseLock(lock: string, token: string): boolean;
+/**
+ * Run `fn` holding the working tree's write lock, taken for this one write
+ * and released when `fn` settles. With `dryRun`, without it, since a dry run
+ * writes nothing. Throws a {@link WriteLockError} when the lock can't be had.
+ */
+export declare function withWriteLock<T>(start: string, who: WriteLockWho, dryRun: boolean | undefined, fn: () => Promise<T>): Promise<T>;
+/**
+ * {@link withWriteLock} for a write that is synchronous throughout: it
+ * blocks while it waits. When another write in this same process holds the
+ * lock, blocking would keep that write from ever finishing, so it is refused
+ * with write-lock-timeout at once.
+ */
+export declare function withWriteLockSync<T>(start: string, who: WriteLockWho, dryRun: boolean | undefined, fn: () => T): T;
+/**
+ * Take the lock for a batch held across chant calls (`lock acquire`): no
+ * process holds it, so it lasts until it is released or `ttlMs` passes.
+ * Waits like a write does.
+ */
+export declare function acquireBatchLock(start: string, who: WriteLockWho, ttlMs: number): Promise<{
+    path: string;
+    holder: WriteLockHolder;
+}>;
+/** Who holds the working tree's write lock now, or null when nobody does (a stale lock counts as nobody). */
+export declare function writeLockHolder(start: string): {
+    path: string;
+    holder: WriteLockHolder | null;
+};
+/** Write `text` to `file` through a sibling temporary file, so a reader never sees half of it. */
+export declare function writeFileAtomic(file: string, text: string): void;
+/** The last chant write of a record file, as the read contract reports it. */
+export interface LastWrite {
+    /** The write command, such as `records amend` or `points answer`. */
+    verb: string;
+    /** The principal the write named (--by, or the channel's author), or null when it named none. */
+    by: string | null;
+    /** The agent session it was made in (CHANT_AGENT), or null. */
+    agent: string | null;
+    /** When, as an ISO 8601 time. */
+    at: string;
+}
+export declare function sha256Text(text: string): string;
+/**
+ * Note in the journal that `who` wrote each file, with the text it now
+ * holds. Called holding the lock, after the write. Best effort: a journal
+ * that can't be written never fails the write it notes.
+ */
+export declare function noteWrites(start: string, writes: readonly {
+    path: string;
+    text: string;
+}[], who: WriteLockWho): void;
+/**
+ * A reader of the journal for the working tree `start` is in: the last chant
+ * write of a record file, while the file still holds the text that write
+ * left, and null otherwise (written by something else since, or never by
+ * chant here).
+ */
+export declare function lastWriteReader(start: string): (path: string, text: string | null) => LastWrite | null;
+//# sourceMappingURL=write-lock.d.ts.map

package/dist/workspace/write-lock.d.ts.map

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

package/dist/workspace/write-scope.d.ts

@@ -129,8 +129,12 @@ export declare function judgeRecord(declaration: Declaration | null, writer: Wri
  */
 export declare function protectedEntry(entries: readonly ProtectedPath[], path: string): ProtectedPath | null;
 /**
- * Whether JSON text `before` and `after` differ only in the top-level keys
- * `except` names. False when either is missing or isn't a JSON object.
+ * Whether JSON text `before` and `after` differ only in what `except`
+ * allows: a top-level key, or, for an entry starting with `/`, the values a
+ * JSON Pointer matches, where a `*` token matches every key or array index
+ * at its level (`/members/*\/box/listing`, #3308). Comments and trailing
+ * commas are read, so a `.jsonc` declaration is judged too. False when either
+ * is missing or isn't a JSON object.
  */
 export declare function onlyKeysChanged(before: string | null, after: string | null, except: readonly string[]): boolean;
 /** A file's text before and after a write, read only when a protected entry with `except` needs it. */

package/dist/workspace/write-scope.d.ts.map

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

package/dist/yaml.d.ts

@@ -2,7 +2,7 @@
  * YAML emitter and parser.
  *
  * The emitter writes the block-style YAML chant's serializers produce. The
- * parser is js-yaml with chant's schema (#3006): YAML 1.2 core types,
+ * parser is a vendored js-yaml loader with chant's schema (#3006): YAML 1.2 core types,
  * merge keys, `yes`/`no` booleans, and local tags such as `!reference` read
  * as strings. `splitYAMLDocuments` splits a multi-document stream. Input the
  * parser cannot read throws a `YAMLParseError` naming the line.

package/dist/yaml.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"yaml.d.ts","sourceRoot":"","sources":["../src/yaml.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA4BH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAsH/D;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,SAAI,GAAG,MAAM,CAG7E;AAMD;;;GAGG;AACH,qBAAa,cAAe,SAAQ,KAAK;IACvC,gEAAgE;IAChE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,YAAY,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAIxC;CACF;AAkID;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQlE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAO1D;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAc5D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAwBlD"}
+{"version":3,"file":"yaml.d.ts","sourceRoot":"","sources":["../src/yaml.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAqCH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAsH/D;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,SAAI,GAAG,MAAM,CAG7E;AAMD;;;GAGG;AACH,qBAAa,cAAe,SAAQ,KAAK;IACvC,gEAAgE;IAChE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,YAAY,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAIxC;CACF;AAmID;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQlE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAO1D;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAc5D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAwBlD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intentius/chant",
-  "version": "0.102.0",
+  "version": "0.104.1",
   "description": "Declarative infrastructure-as-code toolkit — TypeScript on Node.js",
   "license": "Apache-2.0",
   "homepage": "https://intentius.io/chant",
@@ -50,6 +50,11 @@
       "default": "./src/cli/index.ts"
     },
     "./workspace/*.schema.json": "./src/workspace/*.schema.json",
+    "./workspace/factory-rules": {
+      "development": "./src/workspace/factory-rules.ts",
+      "types": "./dist/workspace/factory-rules.d.ts",
+      "default": "./src/workspace/factory-rules.ts"
+    },
     "./workspace/conformance": {
       "development": "./src/workspace/conformance/index.ts",
       "types": "./dist/workspace/conformance/index.d.ts",

package/src/__fixtures__/change-set/lifecycle-plan.floci.json

@@ -0,0 +1,59 @@
+{
+  "env": "dev",
+  "entries": [
+    {
+      "name": "alerts",
+      "type": "AWS::SNS::Topic",
+      "lexicon": "aws",
+      "physicalId": "arn:aws:sns:us-east-1:000000000000:cs-alerts",
+      "action": "noop",
+      "evidence": {
+        "declared": false,
+        "inSnapshot": true,
+        "live": false,
+        "observed": true
+      },
+      "ownership": "unknown"
+    },
+    {
+      "name": "dlq",
+      "lexicon": "aws",
+      "action": "create",
+      "evidence": {
+        "declared": true,
+        "inSnapshot": false,
+        "live": false,
+        "observed": true
+      },
+      "ownership": "unknown"
+    },
+    {
+      "name": "events",
+      "type": "AWS::SQS::Queue",
+      "lexicon": "aws",
+      "physicalId": "http://localhost:4566/000000000000/cs-events",
+      "action": "noop",
+      "evidence": {
+        "declared": true,
+        "inSnapshot": true,
+        "live": true,
+        "observed": true
+      },
+      "ownership": "foreign"
+    },
+    {
+      "name": "jobs",
+      "type": "AWS::SQS::Queue",
+      "lexicon": "aws",
+      "physicalId": "http://localhost:4566/000000000000/cs-jobs",
+      "action": "noop",
+      "evidence": {
+        "declared": true,
+        "inSnapshot": true,
+        "live": true,
+        "observed": true
+      },
+      "ownership": "foreign"
+    }
+  ]
+}

package/src/__fixtures__/change-set/lifecycle-v1.ts.txt

@@ -0,0 +1,4 @@
+import { Queue, Topic } from "@intentius/chant-lexicon-aws";
+export const jobs = new Queue({ QueueName: "cs-jobs", VisibilityTimeout: 30 });
+export const events = new Queue({ QueueName: "cs-events", VisibilityTimeout: 30 });
+export const alerts = new Topic({ TopicName: "cs-alerts" });

package/src/__fixtures__/change-set/lifecycle-v2.ts.txt

@@ -0,0 +1,4 @@
+import { Queue } from "@intentius/chant-lexicon-aws";
+export const jobs = new Queue({ QueueName: "cs-jobs", VisibilityTimeout: 60 });
+export const events = new Queue({ QueueName: "cs-events-v2", VisibilityTimeout: 30 });
+export const dlq = new Queue({ QueueName: "cs-dlq" });