@cratylus/canon 0.17.0 → 0.19.0

package/README.md

@@ -6,7 +6,7 @@ optimal-signifiers, authored as typed TypeScript.
 The discipline is [latent lexicography](../../VISION.md): describing the vocabulary a foundation model
 already holds, rather than authoring prose and hoping it lands. An agent or skill in this corpus is
 therefore not a prompt. It is a **vector of values** over the catalog's factors, and the
-markdown a harness reads is a projection of these modules.
+markdown an agent harness reads is a projection of these modules.
 
 Canon is harness-agnostic **and** runtime-agnostic: it says what an agent _is_ and what a skill
 _means_, never how either is carried. What every package is for is
@@ -58,14 +58,41 @@ are [`@cratylus/schema`](../schema/README.md)'s.
 
 ## The agents
 
-The plugin carries nine agents, all in the practice `example-driven-workflow`. `architect`, `lead`,
-`builder`, `assayer`, `illustrator` and `check-writer` are the generic holders of their roles. A role
-cell (`src/roles/<role>.ts`) states a value for every factor, an explicitly empty set counting as one,
-and `agents/<role>.ts` is `holder(<role>Role)`: named for the role, carrying nothing beyond it and no
-mark. `holder` refuses a cell missing a factor, a scalar without exactly one value, a slot not filled
-exactly once, and empty guardrails.
-
-kino, nico and mav are personas over the architect role, `persona(architectRole, residue)`: each is
+The plugin carries nine agents, all in the practice `intent-based-delegation`, which delivers
+intent-based delegation. `architect`, `lead`, `builder` and `reviewer` are the generic holders of
+their roles, with `illustrator` and `check-writer` as specialists called in when a user story's risk
+warrants them. Each role is defined by what it receives and what it hands off, never by steps:
+
+- **architect** — the operator's principal architect, owning the conceptual model: receives intent,
+  hands off user stories, answers to meaning questions and read-backs; decides meaning only.
+- **lead** — owns a user story's realization, or a task with no story: orchestrates its tasks to
+  builders (orchestrator-workers) and their changes to code review as the story's risk calls for
+  (Ship, Show or Ask), joins each change by the project's own integration once every check passes
+  and any review due before it joins approves it, and hands off the outcome. Where the operator has
+  asked to review a change before it joins, no agent reviews it: the operator's review is its code
+  review, and it joins only on the operator's sign-off, a hold point.
+- **builder** — receives one task and hands off one change that passes every check.
+- **reviewer** — reviews one change it did not write, before or after it joins as its user story's
+  risk calls for, against the change and, where they apply, the story's acceptance criteria and
+  examples, held-out ones included; hands off one code review and never builds or repairs the work.
+  It never reviews a change the operator has asked to review itself; the operator takes that
+  change's held-out examples directly from the design.
+- **illustrator** — writes a user story's examples cold from its concepts alone, flagging unclear
+  terms.
+- **check-writer** — writes the checks binding a user story's examples, each seen failing before the
+  build.
+
+The reviewer, the illustrator and the check-writer run on another model family than the builders
+where one is available. A role cell (`src/roles/<role>.ts`) states a value for every factor, an
+explicitly empty set counting as one, and `agents/<role>.ts` is `holder(<role>Role)`: named for the
+role, carrying nothing beyond it and no mark. `holder` refuses a cell missing a factor, a scalar
+without exactly one value, a slot not filled exactly once, and empty guardrails.
+
+kino, nico and mav are personas over the architect role, each named for its expertise (kino film
+production and generative video, nico the corpus and latent lexicography, mav software
+engineering). The architect role owns the conceptual model of every context it is given, the
+corpus included; a persona brings its expertise and owns nothing its role does not.
+Each is `persona(architectRole, residue)`:
 an agent named as an individual, with a description and a mark of its own beside the values it
 states. A single value it states replaces the role's, a slot only its own slot; a set value is added
 after the role's, and restating one the role holds changes only its enforcement level or note. It
@@ -79,7 +106,7 @@ harm from one is on record (decision 0142(2)).
 A composed agent also says, for the projector, the role it holds (`holds`), its model's tier and
 effort (`routing`), its typed handoff (`contract`) and the per-turn persistence protocol every agent
 re-grounds its stance by (`persistence`). Nothing narrows its tools or whom it may dispatch: every
-agent keeps the harness's defaults (0142). Its `key` is reserved for ipseic agents and is empty.
+agent keeps the agent harness's defaults (0142). Its `key` is reserved for ipseic agents and is empty.
 `holder`, `persona`, `CompositionRefusal`, the six role cells and `MANIFEST` are also named exports,
 for a corpus that composes agents of its own over these roles.
 
@@ -87,29 +114,36 @@ for a corpus that composes agents of its own over these roles.
 
 An assignment and a deliverable are values of their factors, and each carries its contract as JSON
 Schema data (`src/contracts.ts`, exported as `ASSIGNMENT_CONTRACTS` and `DELIVERABLE_CONTRACTS` by
-the value's anchor). Composition copies the pair onto the agent as `contract`:
-
-| Role         | Assignment                                                             | Deliverable                                                                         |
-| ------------ | ---------------------------------------------------------------------- | ----------------------------------------------------------------------------------- |
-| lead         | cut brief `{cut, concepts[≥1], examples[≥1], decisions[≥1]}`           | outcome with efficiency `{cut, outcomes[≥1], verdicts, efficiency, hardeningNotes}` |
-| builder      | work package `{cut, workPackage, outputs[≥1], concepts[≥1], examples}` | done or failing case `{cut, workPackage, done, failingCase?}`                       |
-| assayer      | judgment brief `{cut, workPackages[≥1], examples[≥1], decisions}`      | verdict per concept `{cut, verdicts[≥1], hardeningNotes}`                           |
-| check-writer | examples `{cut, examples[≥1]}`                                         | checks seen red `{cut, checks}`                                                     |
-| illustrator  | concepts `{cut, concepts[≥1]}`                                         | examples with flagged terms `{examples, flaggedTerms}`                              |
-
-The architect's assignment is free-text intent and its deliverable goes to the operator, so it
-carries no contract. A builder's `examples` may be empty: a package sharing outputs owns no example.
-A harness binds the deliverable as its own output schema, shows the assignment form when an agent
-is dispatched or launched, and checks the assignment given (one fenced `assignment` JSON block in
-the dispatch text) with the schema package's `checkAssignment`, warning of each missing or ill-typed
-field; it never refuses the dispatch or the launch for it (0142(3)).
-
-## Evaluation and drift
+the value's anchor). Composition copies the pair onto the agent as `contract`. Each handoff states
+what it must contain, so one passed without a part shows what is missing (`?` marks an optional
+field, `[≥1]` a list that may not be empty):
+
+| Role         | Assignment                                                                                                                                                     | Deliverable                                                        |
+| ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------ |
+| lead         | user story `{story, slice, why, acceptanceCriteria[≥1], outOfScope, path, review, cost, examples?, decisions?, contexts?}`, or a task with no story (as below) | outcome `{story, criteria[≥1], meaningQuestions, followUps, cost}` |
+| builder      | task `{task, story?, goal, changes, decisions, done}`                                                                                                          | change `{change, tests, verified}`                                 |
+| reviewer     | review request `{change, story?, acceptanceCriteria?, examples?}`                                                                                              | code review `{verdict, findings, meaningQuestions}`                |
+| check-writer | examples `{story, examples[≥1]}`                                                                                                                               | checks seen red `{story, checks}`                                  |
+| illustrator  | concepts `{story, concepts[≥1]}`                                                                                                                               | examples with flagged terms `{examples, flaggedTerms}`             |
+
+The lead's assignment takes either form, stated as alternatives (`anyOf`); it fits when it fits any
+one. Its outcome names the user story, or for a task with no story the task, and holds each
+acceptance criterion (or, for a task, what done means) with whether it holds and its evidence, and
+the cost in agent runs by role, tokens and elapsed time. A code review's `verdict` is `approve` or
+`changes`. The architect's handoffs are a person's — free-text intent in, a read-back to the
+operator out (where things stand, with one recommendation) — so it carries no contract. An agent
+harness binds the deliverable as its own output schema, shows the assignment form when an agent is
+dispatched or launched, and checks the assignment given (one fenced `assignment` JSON block in the
+dispatch text) with the schema package's `checkAssignment`, warning of each missing or ill-typed
+field, of the closest form where there are alternatives; it never refuses the dispatch or the launch
+for it (0142(3)).
+
+## Evaluation and persona drift
 
 Every agent's behaviour is evaluated in real use, by the operator working with it: its evaluation
 factor holds the one value `in-use`, and no guard, hook or model-judged check holds its acts or its
-replies (0142(1)). Drift is held by the agent's own text, the persistence protocol naming its tells,
-and its definition is revised on the evidence of use.
+replies (0142(1)). Persona drift is held by the agent's own text, the persistence protocol naming
+its tells, and its definition is revised on the evidence of use.
 
 ## The first principle
 
@@ -135,7 +169,7 @@ entry. Canon reaches the projector as **data** — the corpus is passed to it as
 cell imports it.
 
 No cell imports the runtime either. A skill names the capability it routes to — `concepts` or
-`workPackage`, the two built into the runtime — as `runtime: { capability: … }`,
+`versionSkew`, the two built into the runtime — as `runtime: { capability: … }`,
 never its implementation, and a cell that emits shell invoking the binary carries it as a fact the
 projector substitutes at emission. That is the architecture's highest-ranked property — meaning
 and mechanism never referencing each other — and [ARCHITECTURE.md](../../ARCHITECTURE.md) records

package/dist/agents/kino.js

@@ -8,7 +8,7 @@ import { userCentered } from '../dimensions/stance/user-centered.js';
 import { architectRole } from '../roles/architect.js';
 export const kino = persona(architectRole, {
     name: 'kino',
-    description: "Architect of software that makes films: holds a film-production consumer's platform and production contexts and teaches the layman operator the industry's own practice, each recommendation traced to its source.",
+    description: "Architect expert in film production and generative video: teaches the layman operator the industry's own practice, each recommendation traced to its source.",
     mark: { emoji: '🎬', hue: 'magenta' },
     values: {
         expertise: [filmProduction, generativeVideo],

package/dist/agents/kino.js.map

@@ -1 +1 @@
-{"version":3,"file":"kino.js","sourceRoot":"","sources":["../../src/agents/kino.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,sBAAsB;AAEtB,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,qBAAqB,EAAE,MAAM,6DAA6D,CAAC;AACpG,OAAO,EAAE,cAAc,EAAE,MAAM,4CAA4C,CAAC;AAC5E,OAAO,EAAE,eAAe,EAAE,MAAM,6CAA6C,CAAC;AAC9E,OAAO,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD,MAAM,CAAC,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,EAAE;IACzC,IAAI,EAAE,MAAM;IACZ,WAAW,EACT,oNAAoN;IACtN,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE;IACrC,MAAM,EAAE;QACN,SAAS,EAAE,CAAC,cAAc,EAAE,eAAe,CAAC;QAC5C,MAAM,EAAE,CAAC,YAAY,CAAC;QACtB,kBAAkB,EAAE,CAAC,EAAE,KAAK,EAAE,qBAAqB,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;KAC1E;CACF,CAAC,CAAC"}
+{"version":3,"file":"kino.js","sourceRoot":"","sources":["../../src/agents/kino.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,sBAAsB;AAEtB,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,qBAAqB,EAAE,MAAM,6DAA6D,CAAC;AACpG,OAAO,EAAE,cAAc,EAAE,MAAM,4CAA4C,CAAC;AAC5E,OAAO,EAAE,eAAe,EAAE,MAAM,6CAA6C,CAAC;AAC9E,OAAO,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD,MAAM,CAAC,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,EAAE;IACzC,IAAI,EAAE,MAAM;IACZ,WAAW,EACT,8JAA8J;IAChK,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE;IACrC,MAAM,EAAE;QACN,SAAS,EAAE,CAAC,cAAc,EAAE,eAAe,CAAC;QAC5C,MAAM,EAAE,CAAC,YAAY,CAAC;QACtB,kBAAkB,EAAE,CAAC,EAAE,KAAK,EAAE,qBAAqB,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;KAC1E;CACF,CAAC,CAAC"}

package/dist/agents/mav.js

@@ -6,7 +6,7 @@ import { softwareEngineering } from '../dimensions/expertise/software-engineerin
 import { architectRole } from '../roles/architect.js';
 export const mav = persona(architectRole, {
     name: 'mav',
-    description: "Architect of the repository it is given: holds that project's contexts as a software engineer would.",
+    description: 'Architect expert in software engineering: models any repository it is given as a software engineer would.',
     mark: { emoji: '✈️', hue: 'green' },
     values: {
         expertise: [softwareEngineering],

package/dist/agents/mav.js.map

@@ -1 +1 @@
-{"version":3,"file":"mav.js","sourceRoot":"","sources":["../../src/agents/mav.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,sBAAsB;AAEtB,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,kDAAkD,CAAC;AAC/E,OAAO,EAAE,mBAAmB,EAAE,MAAM,iDAAiD,CAAC;AACtF,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD,MAAM,CAAC,MAAM,GAAG,GAAG,OAAO,CAAC,aAAa,EAAE;IACxC,IAAI,EAAE,KAAK;IACX,WAAW,EACT,sGAAsG;IACxG,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE;IACnC,MAAM,EAAE;QACN,SAAS,EAAE,CAAC,mBAAmB,CAAC;QAChC,kBAAkB,EAAE,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;KAC9D;CACF,CAAC,CAAC"}
+{"version":3,"file":"mav.js","sourceRoot":"","sources":["../../src/agents/mav.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,sBAAsB;AAEtB,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,kDAAkD,CAAC;AAC/E,OAAO,EAAE,mBAAmB,EAAE,MAAM,iDAAiD,CAAC;AACtF,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD,MAAM,CAAC,MAAM,GAAG,GAAG,OAAO,CAAC,aAAa,EAAE;IACxC,IAAI,EAAE,KAAK;IACX,WAAW,EACT,2GAA2G;IAC7G,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE;IACnC,MAAM,EAAE;QACN,SAAS,EAAE,CAAC,mBAAmB,CAAC;QAChC,kBAAkB,EAAE,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;KAC9D;CACF,CAAC,CAAC"}

package/dist/agents/nico.js

@@ -12,7 +12,7 @@ import { zeroTrust } from '../dimensions/stance/zero-trust.js';
 import { architectRole } from '../roles/architect.js';
 export const nico = persona(architectRole, {
     name: 'nico',
-    description: "Architect of cratylus's corpus and agents contexts: finds the sign that most precisely and efficiently invokes each concept in a model's semantic space.",
+    description: "Architect expert in the corpus and latent lexicography: finds the sign that most precisely and efficiently invokes each concept in a model's semantic space, and keeps the name a reader with no context decodes as meant.",
     mark: { emoji: '📐', hue: 'cyan' },
     values: {
         objective: [

package/dist/agents/nico.js.map

@@ -1 +1 @@
-{"version":3,"file":"nico.js","sourceRoot":"","sources":["../../src/agents/nico.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,sBAAsB;AAEtB,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,kDAAkD,CAAC;AAC/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,gDAAgD,CAAC;AACpF,OAAO,EAAE,SAAS,EAAE,MAAM,sCAAsC,CAAC;AACjE,OAAO,EAAE,SAAS,EAAE,MAAM,sCAAsC,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,4CAA4C,CAAC;AAC9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,8CAA8C,CAAC;AAClF,OAAO,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD,MAAM,CAAC,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,EAAE;IACzC,IAAI,EAAE,MAAM;IACZ,WAAW,EACT,0JAA0J;IAC5J,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE;IAClC,MAAM,EAAE;QACN,SAAS,EAAE;YACT,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE;YACnC,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,eAAe,EAAE;SAC5C;QACD,SAAS,EAAE,CAAC,kBAAkB,CAAC;QAC/B,MAAM,EAAE,CAAC,UAAU,EAAE,SAAS,EAAE,gBAAgB,EAAE,kBAAkB,CAAC;QACrE,kBAAkB,EAAE,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;KAC9D;CACF,CAAC,CAAC"}
+{"version":3,"file":"nico.js","sourceRoot":"","sources":["../../src/agents/nico.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,sBAAsB;AAEtB,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,kDAAkD,CAAC;AAC/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,gDAAgD,CAAC;AACpF,OAAO,EAAE,SAAS,EAAE,MAAM,sCAAsC,CAAC;AACjE,OAAO,EAAE,SAAS,EAAE,MAAM,sCAAsC,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,4CAA4C,CAAC;AAC9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,8CAA8C,CAAC;AAClF,OAAO,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD,MAAM,CAAC,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,EAAE;IACzC,IAAI,EAAE,MAAM;IACZ,WAAW,EACT,4NAA4N;IAC9N,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE;IAClC,MAAM,EAAE;QACN,SAAS,EAAE;YACT,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE;YACnC,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,eAAe,EAAE;SAC5C;QACD,SAAS,EAAE,CAAC,kBAAkB,CAAC;QAC/B,MAAM,EAAE,CAAC,UAAU,EAAE,SAAS,EAAE,gBAAgB,EAAE,kBAAkB,CAAC;QACrE,kBAAkB,EAAE,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;KAC9D;CACF,CAAC,CAAC"}

package/dist/agents/reviewer.d.ts

@@ -0,0 +1 @@
+export declare const reviewer: import("../manifest.js").Agent;

package/dist/agents/reviewer.js

@@ -0,0 +1,5 @@
+// The reviewer role's generic holder: the role's vector, named for the role.
+import { holder } from '../compose.js';
+import { reviewerRole } from '../roles/reviewer.js';
+export const reviewer = holder(reviewerRole);
+//# sourceMappingURL=reviewer.js.map

package/dist/agents/reviewer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reviewer.js","sourceRoot":"","sources":["../../src/agents/reviewer.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAE7E,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD,MAAM,CAAC,MAAM,QAAQ,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC"}

package/dist/contracts.js

@@ -1,27 +1,30 @@
 // ─────────────────────────────────────────────────────────────────────────────
-// TYPED HANDOFFS — the JSON Schema each assignment and deliverable value carries.
+// TYPED HANDOVERS — the JSON Schema each assignment and deliverable value carries.
 //
 // A role's assignment and deliverable are values of their factors; the contract a
-// handoff is checked against is DATA those values carry, paired here with the very
+// handover is checked against is DATA those values carry, paired here with the very
 // value it belongs to. Composition copies the pair onto the agent
 // (`Agent.contract`), and every harness reads it from there: the assignment checked
 // before the agent runs, the deliverable bound as the harness's output schema.
 //
-// Required fields are required, and an array takes `[]` unless it is marked
-// `minItems: 1`. Free-text intent (the architect's assignment) and the architect's
-// deliverable to the operator carry no contract.
+// Each handover states what it must contain, so one passed without a part shows
+// what is missing: its required fields are its contents. An array takes `[]` unless
+// it is marked `minItems: 1`. An assignment taking alternative forms states each
+// under `anyOf`, and fits when it fits any one. The architect's handovers are a
+// person's: free-text intent in, a read-back to the operator out, neither of them
+// JSON, so neither carries a contract.
 // ─────────────────────────────────────────────────────────────────────────────
 import { anchorOf } from '@cratylus/schema';
 import { concepts } from './dimensions/assignment/concepts.js';
-import { cutBrief } from './dimensions/assignment/cut-brief.js';
 import { examples } from './dimensions/assignment/examples.js';
-import { judgmentBrief } from './dimensions/assignment/judgment-brief.js';
-import { workPackage } from './dimensions/assignment/work-package.js';
+import { reviewRequest } from './dimensions/assignment/review-request.js';
+import { task } from './dimensions/assignment/task.js';
+import { userStory } from './dimensions/assignment/user-story.js';
+import { change } from './dimensions/deliverable/change.js';
 import { checksSeenRed } from './dimensions/deliverable/checks-seen-red.js';
-import { doneOrFailingCase } from './dimensions/deliverable/done-or-failing-case.js';
+import { codeReview } from './dimensions/deliverable/code-review.js';
 import { examplesWithFlaggedTerms } from './dimensions/deliverable/examples-with-flagged-terms.js';
-import { outcomeWithEfficiency } from './dimensions/deliverable/outcome-with-efficiency.js';
-import { verdictPerConcept } from './dimensions/deliverable/verdict-per-concept.js';
+import { outcome } from './dimensions/deliverable/outcome.js';
 const text = { type: 'string' };
 const count = { type: 'integer' };
 const texts = { type: 'array', items: text };
@@ -37,117 +40,113 @@ const said = (schema, description) => ({
     ...schema,
     description,
 });
-// What a field of an assignment names, said once for every assignment that holds it.
-const cutField = said(text, 'The cut, by its name (its examples are design/examples/<context>/<cut>.md).');
+// What a field of a handover names, said once for every handover that holds it.
+const storyField = said(text, 'The user story, by its name (a kebab-case id).');
 const exampleRefs = (schema, whose) => said(schema, `${whose}, each as \`<context>/<number>\` (e.g. \`booking/1\`).`);
+const meaningQuestions = said(texts, 'Each question whose answer would change a concept or an example, for the architect to settle; empty when there is none.');
+// The story and the task, each a form of its own: the lead takes either, a builder a task.
+const storyForm = record({
+    story: storyField,
+    slice: said(text, "The thin slice of behaviour a user can rely on, in the design's own terms."),
+    why: said(text, 'Why the slice is wanted.'),
+    acceptanceCriteria: said(someTexts, 'What must hold in merged work for the story to be done, each criterion on its own.'),
+    outOfScope: said(texts, 'What the story does not cover; empty when nothing needs saying.'),
+    path: said({ type: 'string', enum: ['plain', 'scaled-up'] }, 'The path the story takes: plain, broken into tasks each built by one builder, or scaled up with specialists for its risk.'),
+    review: said(text, "How the story's changes are reviewed, as its risk picks: Ship (joined with no code review), Show (joined, then reviewed) or Ask (reviewed before it joins); and, where the operator has asked to review a change before it joins, that hold point: the operator's review is that change's code review, under Ask, and no agent reviews it."),
+    cost: said(text, 'Roughly what the story will cost, which its effort is weighed against.'),
+    examples: exampleRefs(texts, "The story's visible examples, where misunderstanding is likely"),
+    decisions: said(texts, 'The decisions in force for the story, by their ids (e.g. `0081`).'),
+    contexts: said(texts, 'The bounded contexts the story touches.'),
+}, ['examples', 'decisions', 'contexts']);
+const taskForm = record({
+    task: said(text, 'The task, by its name (a kebab-case id).'),
+    story: said(text, 'The user story the task serves, by its name; absent for a change that alters no meaning, a task with no story.'),
+    goal: said(text, "What the task is for, in its user story's terms."),
+    changes: said(text, 'What the task changes.'),
+    decisions: said(texts, 'The technical decisions that bind the task; empty when there are none.'),
+    done: said(text, 'What done means for the task.'),
+}, ['story']);
 const assignments = [
     [
-        cutBrief,
-        record({
-            cut: cutField,
-            concepts: said(someTexts, 'The concepts the cut realizes, by their names in the design.'),
-            examples: exampleRefs(someTexts, "The cut's visible examples"),
-            decisions: said(someTexts, 'The decisions in force for the cut, by their ids (e.g. `0081`).'),
-        }),
-    ],
-    [
-        workPackage,
-        record({
-            cut: cutField,
-            workPackage: said(text, 'The work package, by its name in the ledger.'),
-            outputs: said(someTexts, 'The paths the package owns, which no other builder changes.'),
-            concepts: said(someTexts, 'The concepts the package serves, by name.'),
-            // A shared-output package owns no example, which a work package may do.
-            examples: exampleRefs(texts, 'The visible examples the package owns (none for a package sharing outputs)'),
-        }),
+        userStory,
+        {
+            anyOf: [
+                said(storyForm, 'A user story.'),
+                said(taskForm, 'A task with no story: a change that alters no meaning.'),
+            ],
+        },
     ],
+    [task, taskForm],
     [
-        judgmentBrief,
+        reviewRequest,
         record({
-            cut: cutField,
-            workPackages: said(someTexts, 'The work packages to judge, by their names in the ledger.'),
-            examples: exampleRefs(someTexts, 'The examples to judge against'),
-            decisions: said(texts, 'The decisions in force, by their ids; empty when there are none.'),
-        }),
+            change: said(text, 'The change to review, by its reference.'),
+            story: said(text, 'The user story the change serves, by its name; absent for a task with no story.'),
+            acceptanceCriteria: said(texts, "The story's acceptance criteria the change is reviewed against, where they apply."),
+            examples: exampleRefs(texts, 'The examples the change is reviewed against, where they apply'),
+        }, ['story', 'acceptanceCriteria', 'examples']),
     ],
     [
         examples,
         record({
-            cut: cutField,
+            story: storyField,
             examples: exampleRefs(someTexts, 'The examples to bind checks to'),
         }),
     ],
     [
         concepts,
         record({
-            cut: cutField,
+            story: storyField,
             concepts: said(someTexts, 'The concepts to illustrate with examples, by name.'),
         }),
     ],
 ];
 const deliverables = [
     [
-        outcomeWithEfficiency,
+        outcome,
         said(record({
-            cut: said(text, 'The cut this report is for, by its name.'),
-            outcomes: said({
+            story: said(text, 'The user story, or for a task with no story the task, by name.'),
+            criteria: said({
                 type: 'array',
                 minItems: 1,
                 items: record({
-                    example: said(text, 'The visible example, as `<context>/<number>`.'),
-                    concept: said(text, 'The concept the example shows, by its name in the design.'),
-                    outcome: said({ type: 'string', enum: ['pass', 'fail'] }, 'Whether the example holds in the delivered work.'),
-                    evidence: said(text, "Why the outcome holds, named by the example and by the check that binds it, in the design's concepts: what the check showed of the concept. Never a file, function, path or command, even where a verdict cites one: translate it into the concept it bears on."),
-                }),
-            }, "One outcome per visible example of the cut, each in the design's concepts."),
-            verdicts: said({
-                type: 'array',
-                items: record({
-                    assayer: said(text, 'The assayer that judged, by its run.'),
-                    verdict: said({ type: 'string', enum: ['accept', 'reject'] }, "The assayer's verdict on the cut, as it returned it."),
-                    findings: said(texts, "The assayer's findings, each restated in the design's concepts; empty when it found none."),
+                    criterion: said(text, 'The acceptance criterion, as the story states it.'),
+                    holds: said(flag, 'Whether the criterion holds in merged work.'),
+                    evidence: said(text, "Why it holds or does not, in the design's own terms: what the code review and the checks showed of the concept. Never a file, function, path or command: translate it into the concept it bears on."),
                 }),
-            }, "Each assayer's verdict, as it returned it."),
-            efficiency: said(record({
+            }, 'The acceptance criteria, or for a task with no story what done means, each with whether it holds and its evidence.'),
+            meaningQuestions,
+            followUps: said(texts, 'What the story leaves unfinished, each as work to take up later; empty when there is none.'),
+            cost: said(record({
                 agentRuns: said(record({
-                    total: said(count, 'Every agent run the cut took.'),
+                    total: said(count, 'Every agent run the story took.'),
                     byRole: said({ type: 'object', additionalProperties: count }, 'The agent runs by role.'),
-                }), 'The agent runs the harness reports for the cut.'),
-                rounds: said(count, 'The rounds of build and judgment.'),
-                wholeCheckRuns: said(count, 'The runs of the whole check.'),
+                }), 'The agent runs the harness reports for the story.'),
                 tokens: said(count, 'The tokens the runs reported, summed.'),
-            }), "The cut's figures, as the ledger computes them."),
-            hardeningNotes: said(texts, "What would make the cut's examples or checks harder to pass by accident, each in the design's concepts; empty when there is none."),
-        }), "The lead's report of the cut to whoever dispatched it, in the design's concepts: each example's outcome with its evidence, the assayers' verdicts, the figures and the hardening notes."),
+                elapsed: said(text, 'The time the story took, from its start to its end.'),
+            }), 'What the story cost, as the agent harness records it.'),
+        }), "The lead's outcome of the user story to the architect, in the design's own terms: which acceptance criteria hold with their evidence, the meaning questions it raised, the follow-ups it leaves and what it cost."),
     ],
     [
-        doneOrFailingCase,
-        record({ cut: text, workPackage: text, done: flag, failingCase: text }, [
-            'failingCase',
-        ]),
+        change,
+        record({
+            change: said(text, 'What the change does and why, by area.'),
+            tests: said(text, 'The tests added, changed or deleted.'),
+            verified: said(text, 'What was verified, and how.'),
+        }),
     ],
     [
-        verdictPerConcept,
+        codeReview,
         record({
-            cut: text,
-            verdicts: {
-                type: 'array',
-                minItems: 1,
-                items: record({
-                    workPackage: text,
-                    concept: text,
-                    passes: flag,
-                    evidence: text,
-                    finding: text,
-                }, ['finding']),
-            },
-            hardeningNotes: texts,
+            verdict: said({ type: 'string', enum: ['approve', 'changes'] }, 'Whether the code review approves the change or asks for changes.'),
+            findings: said(texts, 'Each finding, naming what must change and why; empty when there is none.'),
+            meaningQuestions,
         }),
     ],
     [
         checksSeenRed,
         record({
-            cut: text,
+            story: storyField,
             checks: {
                 type: 'array',
                 items: record({ example: text, check: text, seenRed: flag }),

package/dist/contracts.js.map

@@ -1 +1 @@
-{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../src/contracts.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../src/contracts.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,mFAAmF;AACnF,EAAE;AACF,kFAAkF;AAClF,oFAAoF;AACpF,kEAAkE;AAClE,oFAAoF;AACpF,+EAA+E;AAC/E,EAAE;AACF,gFAAgF;AAChF,oFAAoF;AACpF,iFAAiF;AACjF,gFAAgF;AAChF,kFAAkF;AAClF,uCAAuC;AACvC,gFAAgF;AAEhF,OAAO,EAAmB,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,MAAM,qCAAqC,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,qCAAqC,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,2CAA2C,CAAC;AAC1E,OAAO,EAAE,IAAI,EAAE,MAAM,iCAAiC,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,uCAAuC,CAAC;AAClE,OAAO,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,6CAA6C,CAAC;AAC5E,OAAO,EAAE,UAAU,EAAE,MAAM,yCAAyC,CAAC;AACrE,OAAO,EAAE,wBAAwB,EAAE,MAAM,yDAAyD,CAAC;AACnG,OAAO,EAAE,OAAO,EAAE,MAAM,qCAAqC,CAAC;AAG9D,MAAM,IAAI,GAAe,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;AAC5C,MAAM,KAAK,GAAe,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;AAC9C,MAAM,KAAK,GAAe,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AACzD,MAAM,SAAS,GAAe,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;AAC1E,MAAM,IAAI,GAAe,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;AAE7C,MAAM,MAAM,GAAG,CACb,UAAsC,EACtC,WAA8B,EAAE,EACpB,EAAE,CAAC,CAAC;IAChB,IAAI,EAAE,QAAQ;IACd,UAAU;IACV,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;CACvE,CAAC,CAAC;AAEH,sEAAsE;AACtE,MAAM,IAAI,GAAG,CAAC,MAAkB,EAAE,WAAmB,EAAc,EAAE,CAAC,CAAC;IACrE,GAAG,MAAM;IACT,WAAW;CACZ,CAAC,CAAC;AAEH,gFAAgF;AAChF,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,EAAE,gDAAgD,CAAC,CAAC;AAChF,MAAM,WAAW,GAAG,CAAC,MAAkB,EAAE,KAAa,EAAc,EAAE,CACpE,IAAI,CACF,MAAM,EACN,GAAG,KAAK,wDAAwD,CACjE,CAAC;AACJ,MAAM,gBAAgB,GAAG,IAAI,CAC3B,KAAK,EACL,yHAAyH,CAC1H,CAAC;AAEF,2FAA2F;AAC3F,MAAM,SAAS,GAAG,MAAM,CACtB;IACE,KAAK,EAAE,UAAU;IACjB,KAAK,EAAE,IAAI,CACT,IAAI,EACJ,4EAA4E,CAC7E;IACD,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,0BAA0B,CAAC;IAC3C,kBAAkB,EAAE,IAAI,CACtB,SAAS,EACT,oFAAoF,CACrF;IACD,UAAU,EAAE,IAAI,CACd,KAAK,EACL,iEAAiE,CAClE;IACD,IAAI,EAAE,IAAI,CACR,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC,EAAE,EAChD,2HAA2H,CAC5H;IACD,MAAM,EAAE,IAAI,CACV,IAAI,EACJ,4UAA4U,CAC7U;IACD,IAAI,EAAE,IAAI,CACR,IAAI,EACJ,wEAAwE,CACzE;IACD,QAAQ,EAAE,WAAW,CACnB,KAAK,EACL,gEAAgE,CACjE;IACD,SAAS,EAAE,IAAI,CACb,KAAK,EACL,mEAAmE,CACpE;IACD,QAAQ,EAAE,IAAI,CAAC,KAAK,EAAE,yCAAyC,CAAC;CACjE,EACD,CAAC,UAAU,EAAE,WAAW,EAAE,UAAU,CAAC,CACtC,CAAC;AACF,MAAM,QAAQ,GAAG,MAAM,CACrB;IACE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,0CAA0C,CAAC;IAC5D,KAAK,EAAE,IAAI,CACT,IAAI,EACJ,gHAAgH,CACjH;IACD,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,kDAAkD,CAAC;IACpE,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,wBAAwB,CAAC;IAC7C,SAAS,EAAE,IAAI,CACb,KAAK,EACL,wEAAwE,CACzE;IACD,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,+BAA+B,CAAC;CAClD,EACD,CAAC,OAAO,CAAC,CACV,CAAC;AAEF,MAAM,WAAW,GAAmD;IAClE;QACE,SAAS;QACT;YACE,KAAK,EAAE;gBACL,IAAI,CAAC,SAAS,EAAE,eAAe,CAAC;gBAChC,IAAI,CACF,QAAQ,EACR,wDAAwD,CACzD;aACF;SACF;KACF;IACD,CAAC,IAAI,EAAE,QAAQ,CAAC;IAChB;QACE,aAAa;QACb,MAAM,CACJ;YACE,MAAM,EAAE,IAAI,CAAC,IAAI,EAAE,yCAAyC,CAAC;YAC7D,KAAK,EAAE,IAAI,CACT,IAAI,EACJ,iFAAiF,CAClF;YACD,kBAAkB,EAAE,IAAI,CACtB,KAAK,EACL,mFAAmF,CACpF;YACD,QAAQ,EAAE,WAAW,CACnB,KAAK,EACL,+DAA+D,CAChE;SACF,EACD,CAAC,OAAO,EAAE,oBAAoB,EAAE,UAAU,CAAC,CAC5C;KACF;IACD;QACE,QAAQ;QACR,MAAM,CAAC;YACL,KAAK,EAAE,UAAU;YACjB,QAAQ,EAAE,WAAW,CAAC,SAAS,EAAE,gCAAgC,CAAC;SACnE,CAAC;KACH;IACD;QACE,QAAQ;QACR,MAAM,CAAC;YACL,KAAK,EAAE,UAAU;YACjB,QAAQ,EAAE,IAAI,CACZ,SAAS,EACT,oDAAoD,CACrD;SACF,CAAC;KACH;CACF,CAAC;AAEF,MAAM,YAAY,GAAoD;IACpE;QACE,OAAO;QACP,IAAI,CACF,MAAM,CAAC;YACL,KAAK,EAAE,IAAI,CACT,IAAI,EACJ,gEAAgE,CACjE;YACD,QAAQ,EAAE,IAAI,CACZ;gBACE,IAAI,EAAE,OAAO;gBACb,QAAQ,EAAE,CAAC;gBACX,KAAK,EAAE,MAAM,CAAC;oBACZ,SAAS,EAAE,IAAI,CACb,IAAI,EACJ,mDAAmD,CACpD;oBACD,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,6CAA6C,CAAC;oBAChE,QAAQ,EAAE,IAAI,CACZ,IAAI,EACJ,qMAAqM,CACtM;iBACF,CAAC;aACH,EACD,oHAAoH,CACrH;YACD,gBAAgB;YAChB,SAAS,EAAE,IAAI,CACb,KAAK,EACL,4FAA4F,CAC7F;YACD,IAAI,EAAE,IAAI,CACR,MAAM,CAAC;gBACL,SAAS,EAAE,IAAI,CACb,MAAM,CAAC;oBACL,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,iCAAiC,CAAC;oBACrD,MAAM,EAAE,IAAI,CACV,EAAE,IAAI,EAAE,QAAQ,EAAE,oBAAoB,EAAE,KAAK,EAAE,EAC/C,yBAAyB,CAC1B;iBACF,CAAC,EACF,mDAAmD,CACpD;gBACD,MAAM,EAAE,IAAI,CAAC,KAAK,EAAE,uCAAuC,CAAC;gBAC5D,OAAO,EAAE,IAAI,CACX,IAAI,EACJ,qDAAqD,CACtD;aACF,CAAC,EACF,uDAAuD,CACxD;SACF,CAAC,EACF,mNAAmN,CACpN;KACF;IACD;QACE,MAAM;QACN,MAAM,CAAC;YACL,MAAM,EAAE,IAAI,CAAC,IAAI,EAAE,wCAAwC,CAAC;YAC5D,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,sCAAsC,CAAC;YACzD,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,6BAA6B,CAAC;SACpD,CAAC;KACH;IACD;QACE,UAAU;QACV,MAAM,CAAC;YACL,OAAO,EAAE,IAAI,CACX,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC,EAAE,EAChD,kEAAkE,CACnE;YACD,QAAQ,EAAE,IAAI,CACZ,KAAK,EACL,0EAA0E,CAC3E;YACD,gBAAgB;SACjB,CAAC;KACH;IACD;QACE,aAAa;QACb,MAAM,CAAC;YACL,KAAK,EAAE,UAAU;YACjB,MAAM,EAAE;gBACN,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;aAC7D;SACF,CAAC;KACH;IACD,CAAC,wBAAwB,EAAE,MAAM,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,CAAC;CAC7E,CAAC;AAEF,+DAA+D;AAC/D,MAAM,CAAC,MAAM,oBAAoB,GAC/B,MAAM,CAAC,WAAW,CAChB,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,CAAC,CAChE,CAAC;AAEJ,gEAAgE;AAChE,MAAM,CAAC,MAAM,qBAAqB,GAChC,MAAM,CAAC,WAAW,CAChB,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,CAAC,CACjE,CAAC"}

package/dist/dimensions/action-scope/integrate.js

@@ -1,2 +1,2 @@
-export const integrate = `integrate ≜ combine accepted work and run the whole check`;
+export const integrate = `integrate ≜ join a change to the project's shared work by the project's own convention, once every check passes and any code review due before it joins approves it`;
 //# sourceMappingURL=integrate.js.map

package/dist/dimensions/action-scope/integrate.js.map

@@ -1 +1 @@
-{"version":3,"file":"integrate.js","sourceRoot":"","sources":["../../../src/dimensions/action-scope/integrate.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,SAAS,GAAgB,2DAA2D,CAAC"}
+{"version":3,"file":"integrate.js","sourceRoot":"","sources":["../../../src/dimensions/action-scope/integrate.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,SAAS,GAAgB,qKAAqK,CAAC"}

package/dist/dimensions/assignment/concepts.js

@@ -1,2 +1,2 @@
-export const concepts = `concepts ≜ a cut's concepts only`;
+export const concepts = `concepts ≜ a user story's concepts only`;
 //# sourceMappingURL=concepts.js.map

package/dist/dimensions/assignment/concepts.js.map

@@ -1 +1 @@
-{"version":3,"file":"concepts.js","sourceRoot":"","sources":["../../../src/dimensions/assignment/concepts.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,QAAQ,GAAe,kCAAkC,CAAC"}
+{"version":3,"file":"concepts.js","sourceRoot":"","sources":["../../../src/dimensions/assignment/concepts.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,QAAQ,GAAe,yCAAyC,CAAC"}

package/dist/dimensions/assignment/{judgment-brief.d.ts → review-request.d.ts}

@@ -1,2 +1,2 @@
 import type { Assignment } from '../../manifest.js';
-export declare const judgmentBrief: Assignment;
+export declare const reviewRequest: Assignment;

package/dist/dimensions/assignment/review-request.js

@@ -0,0 +1,2 @@
+export const reviewRequest = `review-request ≜ a change to review, before or after it joins as its user story's risk calls for, with the story's acceptance criteria and examples, held-out ones included, where they apply`;
+//# sourceMappingURL=review-request.js.map

package/dist/dimensions/assignment/review-request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-request.js","sourceRoot":"","sources":["../../../src/dimensions/assignment/review-request.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,aAAa,GAAe,+LAA+L,CAAC"}

package/dist/dimensions/assignment/{cut-brief.d.ts → task.d.ts}

@@ -1,2 +1,2 @@
 import type { Assignment } from '../../manifest.js';
-export declare const cutBrief: Assignment;
+export declare const task: Assignment;

package/dist/dimensions/assignment/task.js

@@ -0,0 +1,2 @@
+export const task = `task ≜ one change: its goal in its user story's terms, what it changes, the technical decisions that bind it, and what done means`;
+//# sourceMappingURL=task.js.map

package/dist/dimensions/assignment/task.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.js","sourceRoot":"","sources":["../../../src/dimensions/assignment/task.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,IAAI,GAAe,mIAAmI,CAAC"}

package/dist/dimensions/assignment/{work-package.d.ts → user-story.d.ts}

@@ -1,2 +1,2 @@
 import type { Assignment } from '../../manifest.js';
-export declare const workPackage: Assignment;
+export declare const userStory: Assignment;

package/dist/dimensions/assignment/user-story.js

@@ -0,0 +1,2 @@
+export const userStory = `user-story ≜ one thin slice of behaviour a user can rely on: the slice and why it is wanted, its acceptance criteria, what is out of scope, its path and whether its changes ship, show or ask, its rough cost, and examples where misunderstanding is likely; or, for a change that alters no meaning, a task with no story`;
+//# sourceMappingURL=user-story.js.map

package/dist/dimensions/assignment/user-story.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-story.js","sourceRoot":"","sources":["../../../src/dimensions/assignment/user-story.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,SAAS,GAAe,8TAA8T,CAAC"}

package/dist/dimensions/autonomy/management-by-exception.d.ts

@@ -0,0 +1,2 @@
+import type { Autonomy } from '../../manifest.js';
+export declare const managementByException: Autonomy;

package/dist/dimensions/autonomy/management-by-exception.js

@@ -0,0 +1,2 @@
+export const managementByException = `management-by-exception ≜ in PRINCE2's sense: work runs within its tolerance, the user story's rough cost, and a forecast past it is raised to the level above, never pushed on`;
+//# sourceMappingURL=management-by-exception.js.map

package/dist/dimensions/autonomy/management-by-exception.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"management-by-exception.js","sourceRoot":"","sources":["../../../src/dimensions/autonomy/management-by-exception.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,qBAAqB,GAAa,iLAAiL,CAAC"}

package/dist/dimensions/deliverable/{done-or-failing-case.d.ts → change.d.ts}

@@ -1,2 +1,2 @@
 import type { Deliverable } from '../../manifest.js';
-export declare const doneOrFailingCase: Deliverable;
+export declare const change: Deliverable;

package/dist/dimensions/deliverable/change.js

@@ -0,0 +1,2 @@
+export const change = `change ≜ one task's change: what it changes, its tests and what was verified`;
+//# sourceMappingURL=change.js.map

package/dist/dimensions/deliverable/change.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"change.js","sourceRoot":"","sources":["../../../src/dimensions/deliverable/change.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,MAAM,GAAgB,8EAA8E,CAAC"}

package/dist/dimensions/deliverable/{verdict-per-concept.d.ts → code-review.d.ts}

@@ -1,2 +1,2 @@
 import type { Deliverable } from '../../manifest.js';
-export declare const verdictPerConcept: Deliverable;
+export declare const codeReview: Deliverable;

package/dist/dimensions/deliverable/code-review.js

@@ -0,0 +1,2 @@
+export const codeReview = `code-review ≜ approve or ask for changes, naming each finding, with each meaning question for the architect`;
+//# sourceMappingURL=code-review.js.map

package/dist/dimensions/deliverable/code-review.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-review.js","sourceRoot":"","sources":["../../../src/dimensions/deliverable/code-review.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,UAAU,GAAgB,6GAA6G,CAAC"}

package/dist/dimensions/deliverable/outcome.d.ts

@@ -0,0 +1,2 @@
+import type { Deliverable } from '../../manifest.js';
+export declare const outcome: Deliverable;

package/dist/dimensions/deliverable/outcome.js

@@ -0,0 +1,2 @@
+export const outcome = `outcome ≜ which of the user story's acceptance criteria hold, each with its evidence in the design's own terms rather than those of the realization, the meaning questions it raised, the follow-ups it leaves, and what it cost`;
+//# sourceMappingURL=outcome.js.map

package/dist/dimensions/deliverable/outcome.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"outcome.js","sourceRoot":"","sources":["../../../src/dimensions/deliverable/outcome.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,OAAO,GAAgB,kOAAkO,CAAC"}