@ai-matrx/records 0.20.0 → 0.21.0

package/CHANGELOG.md

@@ -1,7 +1,7 @@
 # Changelog — @ai-matrx/records
 
 
-## 0.20.0 — 2026-09-20
+## 0.21.0 — 2026-09-20
 
 **The store moved and this package's census caught it — twice.** The release
 gate runs the live-door suite against the real record store, and it went red on
@@ -18,6 +18,40 @@ main:
   are: the call named a value the shape does not accept, and the store's own
   sentence names the number and the range.
 
+> **About 0.20.0 on npm.** This lane tagged `0.20.0` from a commit that carried
+> the census fixes above but NOT the checklist doors below — the tag was pushed
+> while a merge of main was still open, and a tag is never moved. `0.21.0` is
+> the first version that carries both. Nobody should sit on 0.20.0.
+
+
+## 0.20.0
+
+**"Every new hire gets these twelve steps." — the checklist doors, PRODUCTS row 13.**
+
+A checklist template is a record of the store: ordered steps, each with the role
+that owns it, how many days in it is due, what it waits for and what it asks for
+before it counts as done, plus the thing that starts a run. Starting one makes
+ONE work item per step in the one work layer — assigned by role to real people,
+dated from the offsets, dependencies carried across — so a step appears in the
+person's ordinary inbox beside everything else and there is no
+checklist-shaped queue anywhere.
+
+Nine doors, all of them live on the main database:
+`checklistRefusal` (pure — a screen may ask it on every keystroke, and the
+refusal arrives before the save), `checklistDeclare`, `checklistTemplates`,
+`checklistTemplateShape`, `checklistStart`, `checklistRun`, `checklistRuns`,
+`checklistStepComplete`, `checklistStepRefusal`.
+
+`ChecklistRunStep` carries `blocked_by`, `refusal`, `may_complete` and
+`requires_key`, so a screen can say why a step cannot be finished yet — in the
+words a person would use — before anybody clicks, file the evidence under the
+key the checklist itself named, and show no control at all where a control would
+fail.
+
+THE DEPENDENCY RULE LIVES IN THE STORE, not in these methods: a BEFORE trigger
+on `custom.record` refuses a step reaching Done while a step it waits for is
+open, so `workSetState` meets the same sentence `checklistStepComplete` does.
+
 
 ## 0.19.0
 

package/dist/core/index.cjs

@@ -2214,6 +2214,16 @@ var DOORS = {
   workApprovalMayDecide: "work_approval_may_decide",
   workApprovalDecide: "work_approval_decide",
   workApprovalRead: "work_approval_read",
+  // PRODUCTS row 13 — checklists and SOP runs.
+  checklistRefusal: "checklist_refusal",
+  checklistDeclare: "checklist_declare",
+  checklistTemplates: "checklist_templates",
+  checklistTemplateShape: "checklist_template_shape",
+  checklistStart: "checklist_start",
+  checklistRun: "checklist_run",
+  checklistRuns: "checklist_runs",
+  checklistStepComplete: "checklist_step_complete",
+  checklistStepRefusal: "checklist_step_refusal",
   // Declared here BECAUSE they do not exist yet: naming them is what makes the
   // absence visible to `pnpm check:store-registry` and to the suite.
   metadataSearch: "metadata_search",
@@ -3552,6 +3562,86 @@ function createRecordsClient(config) {
         "workSlotExpire"
       );
     },
+    // ── checklists and SOP runs ──────────────────────────────────────────
+    async checklistRefusal({ spec }) {
+      return callDoor(
+        DOORS.checklistRefusal,
+        { p_spec: spec },
+        "checklistRefusal"
+      );
+    },
+    async checklistDeclare({ spec, template_id = null }) {
+      return callDoor(
+        DOORS.checklistDeclare,
+        { p_organization_id: org, p_spec: spec, p_template_id: template_id },
+        "checklistDeclare"
+      );
+    },
+    async checklistTemplates(args) {
+      return callDoor(
+        DOORS.checklistTemplates,
+        {
+          p_organization_id: org,
+          p_about_table_id: args?.about_table_id ?? null,
+          p_limit: args?.limit ?? 100
+        },
+        "checklistTemplates"
+      );
+    },
+    async checklistTemplateShape({ template_id }) {
+      return callDoor(
+        DOORS.checklistTemplateShape,
+        { p_organization_id: org, p_template_id: template_id },
+        "checklistTemplateShape"
+      );
+    },
+    async checklistStart({ template_id, about_record_id = null, roles = {}, startingAt = null }) {
+      return callDoor(
+        DOORS.checklistStart,
+        {
+          p_organization_id: org,
+          p_template_id: template_id,
+          p_about_record_id: about_record_id,
+          p_roles: roles,
+          p_starting_at: startingAt
+        },
+        "checklistStart"
+      );
+    },
+    async checklistRun({ run_id }) {
+      return callDoor(
+        DOORS.checklistRun,
+        { p_organization_id: org, p_run_id: run_id },
+        "checklistRun"
+      );
+    },
+    async checklistRuns(args) {
+      return callDoor(
+        DOORS.checklistRuns,
+        {
+          p_organization_id: org,
+          p_about_table_id: args?.about_table_id ?? null,
+          p_about_record_id: args?.about_record_id ?? null,
+          p_include_closed: args?.includeClosed ?? true,
+          p_limit: args?.limit ?? 100
+        },
+        "checklistRuns"
+      );
+    },
+    async checklistStepComplete({ step_id, evidence = {} }) {
+      return callDoor(
+        DOORS.checklistStepComplete,
+        { p_organization_id: org, p_step_id: step_id, p_evidence: evidence },
+        "checklistStepComplete"
+      );
+    },
+    async checklistStepRefusal({ step_id }) {
+      return callDoor(
+        DOORS.checklistStepRefusal,
+        { p_organization_id: org, p_step_id: step_id },
+        "checklistStepRefusal"
+      );
+    },
     // ── the work layer a person actually uses ────────────────────────────
     async workInbox(args) {
       return callDoor(