@inventarch/runtime 3.8.0 → 3.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (67) hide show
  1. package/SPEC.md +12 -8
  2. package/dist/index.d.ts +2 -2
  3. package/dist/index.d.ts.map +1 -1
  4. package/dist/index.js +2 -2
  5. package/dist/index.js.map +1 -1
  6. package/dist/machine-protocol.d.ts.map +1 -1
  7. package/dist/machine-protocol.js +3 -2
  8. package/dist/machine-protocol.js.map +1 -1
  9. package/dist/mandate-guard.d.ts +2 -0
  10. package/dist/mandate-guard.d.ts.map +1 -1
  11. package/dist/mandate-guard.js +2 -2
  12. package/dist/mandate-guard.js.map +1 -1
  13. package/dist/mandate-modes.d.ts +8 -3
  14. package/dist/mandate-modes.d.ts.map +1 -1
  15. package/dist/mandate-modes.js +37 -2
  16. package/dist/mandate-modes.js.map +1 -1
  17. package/dist/method/catalogue.d.ts.map +1 -1
  18. package/dist/method/catalogue.js +2 -0
  19. package/dist/method/catalogue.js.map +1 -1
  20. package/dist/method/index.d.ts +4 -4
  21. package/dist/method/index.d.ts.map +1 -1
  22. package/dist/method/index.js +2 -2
  23. package/dist/method/index.js.map +1 -1
  24. package/dist/method/installed-kits.d.ts +17 -3
  25. package/dist/method/installed-kits.d.ts.map +1 -1
  26. package/dist/method/installed-kits.js +52 -4
  27. package/dist/method/installed-kits.js.map +1 -1
  28. package/dist/method/kits.d.ts +3 -2
  29. package/dist/method/kits.d.ts.map +1 -1
  30. package/dist/method/kits.js +25 -6
  31. package/dist/method/kits.js.map +1 -1
  32. package/dist/method/packet.d.ts +4 -0
  33. package/dist/method/packet.d.ts.map +1 -1
  34. package/dist/method/packet.js +5 -1
  35. package/dist/method/packet.js.map +1 -1
  36. package/dist/method/resolve.d.ts +3 -1
  37. package/dist/method/resolve.d.ts.map +1 -1
  38. package/dist/method/resolve.js +22 -5
  39. package/dist/method/resolve.js.map +1 -1
  40. package/dist/method/retained.d.ts.map +1 -1
  41. package/dist/method/retained.js +25 -5
  42. package/dist/method/retained.js.map +1 -1
  43. package/dist/next.d.ts +2 -1
  44. package/dist/next.d.ts.map +1 -1
  45. package/dist/next.js +2 -1
  46. package/dist/next.js.map +1 -1
  47. package/dist/packet-host.d.ts +4 -2
  48. package/dist/packet-host.d.ts.map +1 -1
  49. package/dist/packet-host.js +20 -3
  50. package/dist/packet-host.js.map +1 -1
  51. package/dist/packet.d.ts +5 -1
  52. package/dist/packet.d.ts.map +1 -1
  53. package/dist/packet.js +3 -1
  54. package/dist/packet.js.map +1 -1
  55. package/dist/plain-format.d.ts +27 -0
  56. package/dist/plain-format.d.ts.map +1 -0
  57. package/dist/plain-format.js +27 -0
  58. package/dist/plain-format.js.map +1 -0
  59. package/dist/position.d.ts +2 -1
  60. package/dist/position.d.ts.map +1 -1
  61. package/dist/position.js +2 -1
  62. package/dist/position.js.map +1 -1
  63. package/dist/written-names.d.ts +9 -0
  64. package/dist/written-names.d.ts.map +1 -0
  65. package/dist/written-names.js +9 -0
  66. package/dist/written-names.js.map +1 -0
  67. package/package.json +4 -4
package/SPEC.md CHANGED
@@ -6,13 +6,17 @@
6
6
 
7
7
  The [kit runtime specification](../../docs/specs/kit-runtime/README.md) is normative for the kit layout, `bindings.json`, the check, delivery and on-write sidecars, lanes and the door contract; this section keeps the package-specific detail and defers to it on any disagreement.
8
8
 
9
+ Written names: the plain names (`position-body`, `delivery-view`, `position-packet`, `packet-receipt` and `method-bytes`, each beside `formatVersion` 1) are read everywhere, and so are the released literals (`ia.position-body.v1`, `ia.delivery-view.v1`, `ia.position-packet.v1`, `ia.packet-receipt.v1` and `inventarch.method-bytes/1`). Older, separately released programs accept only the released literals, so this release writes them, with no `formatVersion`, in every shared document until the package's one switch, `src/written-names.ts` exporting `WRITE_PLAIN_NAMES`, is flipped to `true` in a follow-up release. The goldens beside `tests/golden/plain/` hold the plain bodies and packet for the switch-flipped tests.
10
+
9
11
  `@inventarch/runtime/method` is the shared method resolver the MCP door reads kits through, in process. It reads kit folders (`.ia/release.json`, `.ia/src`, the lock, `releases.json` in format 1 or format 2 with `releases/<version>.json`, and the `checks.json`, `delivery.json`, `bindings.json` and `onwrite.json` sidecars) from a bundled folder and then `<IA home>/kits/<folder>/<version>/`; selects a repository's binding from `.ia/bindings.json` (exact, wildcard, default, then precedence); keeps task pins (format 3, format 1 read as format 3) under `<IA home>/work-v1/<project>/<task>/`; retains exact method bytes under the closure store; restores kit read roots under `<IA home>/kit-roots-v1/` unless the caller names a cache; and assembles the packet with the digest over its sorted-key canonical form, the envelope and binding excluded. `resolveMethod` follows the `ia` plugin's `resolve.mjs` step for step, reading position bodies, records, inbound rows and cell bodies through db and this package instead of the CLI. Its caller supplies the native restore that installs a kit's language base into the kit's read root, so this package gains no distribution dependency. `selectKitBase` chooses that base from the bases the caller carries: the kit's locked archive when carried (exact, by digest, whatever its label says); otherwise the newest carried base when it is the same major, not a downgrade, and admitted by the range in `.ia/release.json` and the lock's `requests` range (`^<locked version>` when neither is present) (compatible); otherwise `IA-CORE-CLI-UNSUPPORTED` naming what is needed. `lockOnBase` rewrites the language row of the lock a read root is restored with, `kit-root.ts` keys read roots by the effective base and verifies the whole lock on reuse, and the packet's `envelope.base` is `{locked, effective, mode}` with its digests unchanged. `laneCatalogue`, `openSession`, `readRegistry`, `registerWorkspace` and `checkRoot` serve the door's catalogue, session log, workspace registry (format `ia-workspace-locations-2`, reading `personal-workspace-locations-1` and Studio's format 1, writing format 2 only) and per-root mandate check. Lanes, keys, words and phases are closed tokens; a subject is carried as the caller gives it and never reaches a position.
10
12
 
11
13
  Home folders (first release): the IA home holds five folders the runtime reads and writes: `work` (task pins), `sessions` (session logs), `kit-roots` (read-root cache), `installed-kits` (materialized store kits) and `method-closures` (retained bytes). Each is today a `*-v1` folder (`work-v1`, `sessions-v1`, `kit-roots-v1`, `installed-kits-v1`, `method-closures-v1`). `homeFolder(home, kind)` is the one resolver: the authoritative folder of a kind is the plain folder `<home>/<kind>` when it holds a file named `authoritative` (`AUTHORITATIVE_MARKER`), and otherwise `<home>/<kind>-v1`. Every read and write of a kind goes through it, so a marker in one kind changes only that kind, and a pin, log, cache or closure left in the other folder is neither read nor written. On a machine with no marker every path is exactly the one it was. This release creates neither the plain folder nor the marker and moves nothing; a later release performs the cutover (copy, verify, write the marker, then remove the `*-v1` folder) once every participant that writes these homes, this runtime and CLI and the `ia` plugin, understands the marker. `IA_CORE_CLOSURES_DIR` still overrides the closure store, and `<IA home>/workspace-locations.json` and the `kits` folder are unchanged.
12
14
 
13
15
  Installed kits (2026-10-31, contract C7b): a workspace lock's `package` entries (`lockedPackageKits`) name kit releases the engine installs as ordinary releases in `.ia/distributions/store/<archive>/`; npm is transport only, and no kit is read from an npm package folder. `installedPackageKits` reads each from the store: its `distribution.json` must hash to the manifest digest the lock pins and name that release, and its pinned files are copied, each checked against its SHA-256, into `<IA home>/installed-kits-v1/<archive>/` with a format 1 `releases.json` of its one release and a `.ia/distributions.lock.json` that pins its dependencies exactly as the workspace lock does, so retention, read roots and the door's restore treat it as any kit folder (origin `installed`). `workspaceKits` lists a workspace's kits: the bundled ones, each installed kit, then the home's; a kit an entry names is taken from no other source, so `resolveMethod` refuses a binding to one the store lacks `IA-CORE-KIT-RESTORE-REQUIRED` ("run ia restore"; a pinned task may still read its retained bytes), and a kit no source provides still refuses `IA-CORE-KIT-UNKNOWN`. `installedKit` counts an entry kit as installed, so its packet's laws are the repository's position's and `envelope.kitInstalled` is true. `openSession` takes the kits the store lacks and adds `restore: {kits, message}` and a "Kits not restored" briefing line. `checkRoot` keeps the installation's refusal reason (`restore-required`, `lock-drift`) on its error. A lock without entries changes none of this.
14
16
 
15
- Installation requirement (2026-11-03): a repository-bound method runs a kit only while the repository's own lock installs it. `resolveMethod` calls `requireKitInstalled(root, { id })` as soon as the binding is chosen and the task pin is read, for a first resolve, a pinned key and `--rebind` alike, before the kit is found, retained or restored and before any pin is written. A bound kit that no lock row names, whether a `packages` row or a kit row of a `package` carrier in `entries`, at any version and archive, refuses with `IA-CORE-KIT-NOT-INSTALLED` (`kit <id> is bound by this repository but its lock does not install it; install the npm package that carries it with ia install --package <name> --apply --yes (the public kits ship in @inventarch/public-kits), or ia install <id> --apply --yes where a registry serves it, or kit.mjs add <id> --apply; then resolve again`; the package route leads because `ia install <id>` reaches only a registry release and refuses the public kits, issue #301), a code distinct from `IA-CORE-PIN-UNAVAILABLE`, and no bundled, IA-home or retained copy stands in for the missing row. Presence ignores version and archive, so a task pin older than the installed version keeps running from its retained bytes. `kitInstallation(root, id)` reports the lock's row and where it came from (`package` or `entry`), and `kitInstallMatches(root, { id, version, archive })` is the separate, pure question of whether the row is exactly that release; the resolver does not call it. The unbound route (outside a workspace, `--kit` with `--capability`) needs no row. A binding may name a kit by its folder (as `findKit` reads it): the lock is asked about the kit's canonical id, and the task's retained pin is read under that id too. The reference is read as the resolver serves it: an exact id first (`findKit` tries every id before any folder), then a folder in `workspaceKits`' order, bundled, then the lock's entry rows (lock order, the first row wins when several share a folder, whether or not the store holds it yet), then IA home. A bundled kit sharing the folder is therefore the kit asked about, and it refuses without its own row rather than passing on another kit's. A carried copy of a kit the entries name yields its folder to those rows, as `workspaceKits` drops it, and names that kit only when nothing else has the folder. The guard is deliberately stricter than the resolver in one case: when the first entries row sharing a folder is missing from the store, the guard asks about that row and refuses as a restore, where `findKit` would serve the next row; do not align it with the resolver. The refusal carries the kit as a field, `{ error: { code, message, kit } }` (`MethodError.kit`, written by `methodRefusal`). `kitInstallMatches` never throws: a lock that cannot be read or parsed matches nothing. `requireKitInstalled` still propagates an unreadable or corrupt lock as its own error, not as not installed.
17
+ Installation requirement (2026-11-03): a repository-bound method runs a kit only while the repository's own lock installs it. `resolveMethod` calls `requireKitInstalled(root, { id })` as soon as the binding is chosen and the task pin is read, for a first resolve, a pinned key and `--rebind` alike, before the kit is found, retained or restored and before any pin is written. A bound kit that no lock row names, whether a `packages` row or a kit row of a `package` carrier in `entries`, at any version and archive, refuses with `IA-CORE-KIT-NOT-INSTALLED` (`kit <id> is bound by this repository but its lock does not install it; install the npm package that carries it with ia install --package <name> --apply --yes (the public kits ship in @inventarch/public-kits), or ia install <id> --apply --yes where a registry serves it, or kit.mjs add <id> --apply; then resolve again`; the package route leads because `ia install <id>` reaches only a registry release and refuses the public kits, issue #301), a code distinct from `IA-CORE-PIN-UNAVAILABLE`, and no bundled, IA-home or retained copy stands in for the missing row. Presence ignores version and archive, so a task pin older than the installed version keeps running from its retained bytes. `kitInstallation(root, id)` reports the lock's row and where it came from (`package`, `entry` or `hosted`), and `kitInstallMatches(root, { id, version, archive })` is the separate, pure question of whether the row is exactly that release; the resolver does not call it. The unbound route (outside a workspace, `--kit` with `--capability`) needs no row. A binding may name a kit by its folder (as `findKit` reads it): the lock is asked about the kit's canonical id, and the task's retained pin is read under that id too. The reference is read as the resolver serves it: an exact id first (`findKit` tries every id before any folder), then a folder in `workspaceKits`' order, bundled, then the lock's entry rows (lock order, the first row wins when several share a folder, whether or not the store holds it yet), then IA home. A bundled kit sharing the folder is therefore the kit asked about, and it refuses without its own row rather than passing on another kit's. A carried copy of a kit the entries name yields its folder to those rows, as `workspaceKits` drops it, and names that kit only when nothing else has the folder. The guard is deliberately stricter than the resolver in one case: when the first entries row sharing a folder is missing from the store, the guard asks about that row and refuses as a restore, where `findKit` would serve the next row; do not align it with the resolver. The refusal carries the kit as a field, `{ error: { code, message, kit } }` (`MethodError.kit`, written by `methodRefusal`). `kitInstallMatches` never throws: a lock that cannot be read or parsed matches nothing. `requireKitInstalled` still propagates an unreadable or corrupt lock as its own error, not as not installed.
18
+
19
+ Hosted kit lock pins: a workspace lock's `hosted` entries (`lockedHostedKits`, `{ kind: "hosted", id, version, hosted: true, archive, manifest }` under db lock engine `0.1.3`) name kits executed through the hosted InventArch service rather than from local files. `workspaceKits` surfaces each hosted pin in `kits` with `origin: 'hosted'` and its pinned `archive` and `manifest` digests on `latest`/`releases`, and never lists it under `missing`, so `openSession` reports `source: 'hosted'` in `session.kits` and the briefing without requesting `ia restore`. `kitInstallation` reports `via: 'hosted'` with its locked `archive` and `manifest` SHA-256 digests (refusing unqualified hosted rows missing valid digests). When `resolveMethod` resolves a repository binding whose canonical kit is pinned as `hosted`, it refuses local resolution with `IA-CORE-KIT-HOSTED` (`hostedRefusal`, carrying `kit`) before retaining or reading local kit bytes, directing the caller to invoke the hosted `inventarch` MCP connector / `api.inventarch.dev`.
16
20
 
17
21
  ## Optional topical context assembly
18
22
 
@@ -78,11 +82,11 @@ R13. Steward-write evaluation is a bounded pure consumer over admitted compiled
78
82
 
79
83
  R14. Scope key. `src/scope-key.ts` holds it: the package root exports `K0`, `SCOPE_KEY_CAPS`, `normalizeScopeKey`, `resolveScopeKey` and `rootRelative` with the `ScopeKey`, `ResolvedSeat` and `ResolvedScopeKey` types, and the `./internal/scope-key` subpath carries the module; `scopeCoordinate` (R01) is in `src/coordinate.ts`, on the `./internal/coordinate` subpath only. `ScopeKey` is K = (seat, shape, phase, depth, budget, word), with an optional primitive override: `shape` one of the five SHAPE_ROWS shapes, `phase` one of the four phases, `depth` an integer in 0..2, `budget` an integer in 0..64 and `word` optional; `SCOPE_KEY_CAPS` exports the two caps, and `K0` is the frozen key (no seat, context, orient, 0, 0, no word). Three seat notions are kept apart, each named once here. The key's `seat` is what a caller names: absent for the repository's own `@workspace`, a record identity, or `{path}` for a location. The resolved seat (`ResolvedSeat`) is what that names once read through the scope: `{kind, identity?, path?, unknown?}`, kind `workspace` for no seat (identity the repository's `@workspace`), `record` for an identity (identity that record) and `location` for a path (path its canonical workspace-relative path; a location is not a record and has no identity). The database's `SeatResolution.seat` (db D02b) is the record a path is declared at, a `@system` or `@workspace`; it stays in the result's `resolution` with the rule `by` and the path's claimants, and is never a location's resolved seat. `normalizeScopeKey(partial?)` completes a partial key with its defaults, the one place every host applies them: a partial that names no part (a part whose value is undefined is not named) is K0; otherwise `shape` defaults to context, `phase` to the anchor of the explicit primitive or the shape's primitive, PRIMITIVE_ANCHORS[primitive ?? SHAPE_ROWS[shape].primitive] (context orient, governance plan, execution act, sequence plan, learning learn), `depth` to 1 and `budget` to 16, and a seat, word or primitive override stays absent unless named. It reads nothing, so it checks the key's form and leaves the word and the seat to resolution. `resolveScopeKey(handle, within, key)` requires a scope token like every runtime read, checks a complete key and returns a frozen `{key, seat, resolution?, coordinate}`: `key` copies the validated parts in K order, a location as the canonical path it resolved to, so a key never carries the root; `seat` is the resolved seat; `resolution` is the database's resolution of the repository root `''` or of the path, for a workspace or location seat; and `coordinate` is scopeCoordinate's (R01), shape and phase declared, category derived, primitive declared when supplied and otherwise derived. Every key refusal is IA-RUNTIME-REQUEST-INVALID naming the closed set or bound: an unknown part, a shape, phase or primitive outside its closed set, a depth or budget outside its cap or not an integer, a seat that is neither an identity nor `{path}`, a word the read's view does not register for its admitted systems (db D09a `words`), the refusal listing those it does, an identity that is not an admitted record in the scope, and a path outside the workspace root or escaping it. The key's parts, closed sets, caps and seat form are checked before any read, so a key malformed in them is refused whatever the token. An absolute path reads by `rootRelative(root, path)`, the one absolute-path rule, which `ia read` also reads the path of a `<path>:<line>` locator with (2026-10-08, which gave the two one rule): the path from the handle's root that Node's `path.relative` gives (on Windows without case, with either separator), `/`-separated, and the root itself, however it is spelled, as `''`, the location that `.` also names (`ia read`, whose line locator needs a path, spells it `.`). It names no path inside the root, so it is undefined and the path goes on as given, refused below, when that path's first segment is `..`, a check made segment by segment, so an in-root name that only begins with `..`, such as `..cache`, is inside the root whichever way it is spelled, or when the path is on another drive, which has no path from the root. A relative path goes as given to the database's `resolveSeat` (db D02b), as does the path `rootRelative` reads, and the database canonicalises it segment by segment and names one that escapes the workspace `outside`, refused here: a `..` segment escapes. No seat takes the seat the database resolves for `''`: the `@workspace` declaring a `sources` root of the whole repository, else the repository's own `@workspace` as D02b decides it. When no admitted record in the scope is declared at a workspace or location seat, the resolved seat names `unknown: 'undeclared'`, and a workspace seat then has no identity: K0 is the empty composition with the unknown named, never a refusal (db D02b). Database token failures (SCOPE-UNAVAILABLE, STALE, CLOSED) keep their IA-DB codes on every read the resolution makes: the word's, the identity's and the path's. This row types, completes, validates and resolves the key; R15 assembles the body a resolved key gives (seeding, pointers to 48 then tallies, the word's restriction of seeds and tallies, blockers reserved outside the budget), and `position` (R16) completes, resolves and assembles a key with its digest and host note. The Door's `position` operation reads a key (R12 refinement, position); the nine version 1 Door routes, `context` and `select` included, and `ia scope` neither read nor accept one, and the consumer verb is `ia position`. Each key refusal's `RuntimeError` carries `next`, the one command to run: the closed set of a shape or phase, the cap of a depth or budget, `ia vocabulary` for a word, and `ia position`, K0, for a key that is no object or names an unknown part and for a seat of another form, outside the scope or outside the workspace. `RuntimeError` gains the optional `next` for it, absent from every other refusal. `tests/scope-key.test.ts` pins the caps and K0; the defaults, an empty partial being K0 and every shape's anchor phase; a key naming only a shape resolved, and depth 3 and budget 65 refused; a key completed from shape and phase alone for every shape and phase; the unchanged version 1 refusal bytes of a context or select request that declares only shape and phase; the closed sets, caps and seat form refused by both functions, an unknown part and a key that is no object naming `ia position` as `next`, and the key's form refused before a forged token is read; the token on every seat form and the word, a forged, stale or closed one keeping its database code; the registered word checked in the scope's own view; each seat form and a location pruned by a narrower scope; absolute paths inside the root, in native, forward and mixed separators (and on Windows with the drive letter in either case), read as the relative path, the root in every spelling as the location `''`, an in-root name beginning with `..` read alike in both spellings, and absolute paths outside the root (a sibling whose name extends the root's among them), escaping paths and another drive refused; `rootRelative` itself on each of those spellings, a relative path returned as given; K0 seated by a workspace that declares the whole repository as a root; and K0 with the repository workspace undecided.
80
84
 
81
- R15. Position body (2026-10-08): `src/position.ts`, exported from the package root and the `./internal/position` subpath, publishes `positionBody(handle, within, resolved)` with the `PositionBody`, `LoadedEntry`, `LoadedPlace`, `LoadedRecord`, `PositionRecord`, `PositionPointer`, `PositionVia`, `PointerTally`, `FrontierTally`, `PositionUnknown`, `PositionCounts` and `PositionWidening` types. `resolved` is what resolveScopeKey (R14) returned for the same scope token `within`. Every read carries that token: the snapshot and its D02a membership rows, directed views (db D09), the declared roots (db D02c `roots`) and the seat of `''` (D02b); a missing token is IA-RUNTIME-REQUEST-INVALID, and an unknown, stale or closed one keeps its database code, and a resolved seat identity the token does not admit (a key resolved through another token) is IA-RUNTIME-REQUEST-INVALID, `The seat '<identity>' is not an admitted record in this scope`, naming as its `next` `ia position`, the position without that seat, as R14 names it for a seat outside the scope. body(K) is a pure function of the key and the admitted records the token reads, and only a whole-workspace token (db `isCompleteScope`, PT5) also reads the admission findings it alone may disclose: it carries no root path, token, time, request text, capture state or record body (a body is read on demand by `ia read`; R17's cells carry a playbook cell's text, not its record's body), and nothing is written. A record at runtime placement (band 0) is no part of a body (2026-10-08: runtime-band evidence is admitted below authored, where it must not move what agents are given): the body reads the scope's records without those records and without every directed-view row and claimant that names one, so none is composition, a seed, a hop or waypoint, loaded, in `rules`, a pointer, tallied or frontier, none primes, reaches or names the steward of another record, and none claims a location or is the record one is declared at, so a location whose declarer and claimants are all at runtime placement names the `seat` unknown it would name without them; a seat at runtime placement, whether the key names it or it is the repository's own `@workspace` (K0 included), is IA-RUNTIME-REQUEST-INVALID, `The seat '<identity>' is at runtime placement (band 0), which no position body enters`, whose `next` (2026-10-08, moved here from the Door) is `ia inspect`, the overview, when the seat is the one K0 takes, the repository's own `@workspace` (`resolveSeat('')`), whether the key names it or not, since K0 is refused alike, and `ia position`, the position without it, for any other seat. Two inputs still read every placement, so a runtime-band record appearing can still move the body. The database's own decisions: a runtime-band `@workspace` or `@system` can move the D02a membership roots, the D02c declared roots, the D02b seat of a path and the repository's own `@workspace` that the closure is built from, and a location's resolved `seat` (R14) then names no `unknown` while `unknowns` names the seat. Admission's findings, which resolve every reference against every placement: a runtime-band record that an edge or field reference of an authored loaded record names resolves it, so that record's IA-GRAPH-TARGET-MISSING or IA-COMP-FIELD-REF-MISSING `finding` leaves `unknowns`, and the row to it, naming a band-0 record, is dropped, so the body names that relation neither as a pointer nor as an unknown. The body's `revision` is not one of them: it is the authored revision of the view the scope reads (db D05a), which no runtime-band source moves (R16). It is `{format: 'ia.position-body.v1', revision, key, seat, loaded, rules, omittedRules, pointers, pointerTallies, appliesByWord, appliesByWordTallies, cells, mandates, frontier, unknowns, counts, widening}`, `key` and `seat` being the resolved key and seat and the four sections after `pointerTallies` R17's. The seat's workspace is the seat when it is a `@workspace`; else, of the repository's own `@workspace`, the one D02b seats `''` at, and the workspace of the first declared root, in D02c order, that contains the D02a membership root of the seat record (for a location, of the record it is declared at), the first whose closure holds that record; else no workspace holds the seat. A floor or adopted record, an installed one included, is in every closure, so it is seated in the repository's own workspace with the records the repository authors, even when the installed or adopted `@workspace` that ships it declares the root it sits in, as the bundled base's language-workspace declares `.ia/src @authored` in the store (2026-10-08: the floor, the adopted records and the repository's own roots); the workspace whose root holds the record is taken for an authored record of another workspace's root. D02b's unique init entry point keeps the repository seat decidable when local domain workspaces declare sources; this does not widen a closure. A repository and a domain that need the same local records must both declare those membership roots explicitly, and private domain roots remain outside other closures. A workspace's closure is every floor (band 10) and adopted (band 90) record, plus the members of its own declared roots or, while it declares none, every record whose membership root no workspace declares; when no workspace holds the seat, the closure is that fallback. Reading the closure as the declared members alone would leave a repository without a declared root (the conformance corpus, and every repository an earlier `ia init` made, which declared none) unable to reach any record of its own; and falling back to the repository's workspace whatever its roots would, when none of them holds the seat record, leave the seat outside its own closure (the seat S always resolves inside it) and its own system's blocking governance out of `rules`. Both fallbacks are named under `unknowns`. A record outside the closure is never entered: it is a pointer that names, as `workspace`, the `@workspace` whose declared root holds it, when one does. The composition C0, at cost 0 and one level from the seat, is the seat's field references both ways (directed-view `field-ref` rows); a `@workspace` seat's capture members, the membership rows under its own declared roots; a `@system` seat's word members, the admitted records whose owner system it is; and a location's declared-at record and claimants from `resolution`. A location is no record and has no fields, and a workspace seat no record declares has an empty composition. The first class that reaches a C0 record is its `via`, unless a hop reaches it (below): `field` (`from`, `field`, `direction`, read from `from`'s side), `membership` (`root`), `word` (`system`), `declared-at` (`rule`) or `claim` (`matches`); C0 counts only what the closure admits, a composition record a hop reaches included. The seeds Σ are the seat and the C0 records whose kind is in SHAPE_ROWS[shape].kinds or whose lane, graph `laneOf` (G05), is in its lanes. Hops 1..depth start from Σ and follow directed-view edge rows only, declared or derived inverse, in either direction, whose predicate is in SHAPE_ROWS[shape].predicates, never leaving the closure; each record other than the seat and the seeds that a hop reaches, a C0 record among them, keeps the first row that reaches it, from the seat, then the seeds and each later hop in identity order, as `via: {by: 'row', from, predicate, spelling, declaredBy}`, and is in C. A row that carries a condition is a row of the body only where its condition holds at the key's coordinate (2026-10-08): graph `conditionHolds` over the coordinate R14's scopeCoordinate builds, the key's shape and phase with the derived category and selected primitive, the condition's subject being the record that states the row (its `declaredOn`, the author graph G06 keeps as an edge's condition subject), so the body agrees with graph traversal for the same coordinate. A row that does not hold is not followed and its counterpart is not reached through it: it is no hop, primes no record, names no out-of-focus pointer and counts in no frontier, while a field reference carries no condition. The phase can so change the loaded set; a body whose rows carry no condition and whose reserved rules state no `activation` is unchanged by it, and one whose reserved rules state an `activation` can move a rule between `rules` and `omittedRules` (the R15, R17 rule activation addendum). The conformance corpus's fixture law `enforced-by @check instance-schema-check when phase is act and severity is blocking` reaches the check at act only. With `word` set (the word restricts seeds and tallies inside the body, and blockers are reserved outside n), C0, the seeds, the hop-reached records that load, the pointers, their tallies and the frontier are records of that word only; a record of another word that a hop reaches is a waypoint, followed but never loaded or listed; the seat loads whatever its word. The word never filters `rules` (2026-10-08: a word must not hide a blocking rule that governs what it loads, as one claiming a location seat or applying by its subject-word to a record of the word would be hidden if R were read under the word): R is taken from the candidates of the walk without the word, each with the row or class that reaches it there, so `rules` under a word is the body's without it, and R17's applies-by-word section with its tallies, its cells and the mandates are not filtered either. The order keys are total: governance (prime ↑, band ↓, hop ↑, sev ↑, identity ↑) and every other shape (band ↓, hop ↑, lane ↑, identity ↑). prime is the least index in SHAPE_ROWS.governance.priming (govern, constrain, forbid, enforce, implement) of an edge row incident to the record, else 5; sev is the rank of graph `effectiveSeverity` in [blocking, advisory, informational], a record with none last; lane is its index in the shape's lanes, else their count; hop is 0 for Σ and for a C0 record no hop reaches, else the first hop that reached it. The candidates K = {S} ∪ C0 ∪ Σ ∪ C, C the hop-reached records, are taken before any truncation and before the word filter, and R is the governance-kind candidates other than the seat whose effective severity is blocking, with the blocking rules that apply by word to a candidate (R17), all reserved outside the budget; `rules` is the members of R whose activation admits the key's coordinate (the R15, R17 rule activation addendum), in the governance order and never counted against the budget, and `omittedRules` names the rest, so a blocking law that claims a location only through `subject.covers` is in `rules` at budget 0. `loaded` is the seat, then the first `budget` records of ((Σ \ {S}) ∪ C) \ R in the shape's order. A record seat loads as a `LoadedRecord`; a location, or a workspace seat no record declares, as the `LoadedPlace` `{path}` of its canonical path (`''` for the latter). A `LoadedRecord`, and each entry of `rules`, is the pointer tuple plus the record's G13 `digest`. `pointers` are the C0 and hop-reached records outside `loaded` and R, an activation-omitted rule included, those the budget truncated among them; the records outside the closure that composition or a hop reached; and the counterparts of each loaded record's out-of-focus edge rows and field references, at that record's hop. Each is listed once, by the first that reaches it, in the shape's order, as the pointer 9-tuple `{identity, word, kind, lane, system, steward?, band, hop, via}`, `system` being the owner system and `steward` the `head.steward` field reference of its `@system` record (`floor/definition/system/<name>`) when the scope admits it, read without the registry. The first 48 are listed, and the rest are tallied per (word, owner system) as `{system, word, steward?, count}`, sorted by system then word. `frontier` tallies per (owner system, kind), as `{system, kind, steward?, count}`, the counterparts of the in-focus rows of the loaded records at hop `depth` that the body neither lists nor reached, never entered. `unknowns` are `{kind, subject?, code?, path?, line?, message}`: `seat` for a location no admitted record is declared at, a location that nothing claims and none is declared at (`no record claims '<path>' and none is declared at it; widening key: the workspace`, or on a narrowed scope, which prunes the claimants it does not admit, `no record in this scope claims '<path>' and none in it is declared at it; widening key: the workspace`), or the repository root no `@workspace` is declared at; `sources` when the seat's workspace declares no sources (`workspace declares no sources: …`) or no workspace holds the seat; `finding`, read only on a whole-workspace scope (db PT5, as R18 reads admission findings), each IA-GRAPH-TARGET-MISSING, IA-GRAPH-TARGET-AMBIGUOUS, IA-GRAPH-EDGE-UNCONSENTED and IA-COMP-FIELD-REF-MISSING report finding on the source span of a loaded record, the innermost one, with its code, path, line and message; and `unread` on a narrowed scope, which reads none. `counts` are `{composition: |C0|, seeds: |Σ| with the seat, loaded: |L| with the seat, rules, pointers (listed and tallied), appliesByWord (R17), frontier, truncatedLoaded, truncatedPointers, truncatedAppliesByWord}`. `widening` is `{deeper: the key at depth + 1, absent at depth 2; reseat: {shape, phase, primitive?, depth: 1, budget: 16}}`, to be seated at any pointer, no seat being the repository's workspace. `position` (R16) returns the body with its digest and host note; R17 adds the applies-by-word section, the playbook cells and the mandates; and the Door's version-2 `position` operation and the MCP tool `ia_position` serve it (R12), as does the `ia position` CLI verb (apps/cli/SPEC.md). `tests/position.test.ts` pins, over the conformance corpus, golden bodies of K0, governance at the fixture law (at plan, where its conditional `enforced-by` row does not hold, and at act, where it does), sequence at depth 2 from the workspace and the word law at the governance-system seat, in `tests/golden/` with the revision masked and asserted apart (only `node packages/runtime/tests/golden/write.mjs` regenerates them); K0's single loaded seat, five system pointer lines from `composition.systems`, frontier and named missing sources; byte-equal bodies for equal keys through every whole-workspace token and handle of one revision, and a token selecting every admitted identity differing only by the `unread` note; hops in either direction, out-of-focus pointers and a seed a later hop reaches keeping hop 0; each order key deciding in turn (band, then hop, then lane in the other shapes; prime, then band, an adopted record against a local one, then hop, then sev in governance) and two blocking laws in `rules` in the governance order under governance and context; seeds picked by kind and by lane (an authority-facet contract); the counts of a budget below |Σ ∪ C| and one tally past 48 per word and owner system; the word law loading the seat and only laws, waypoints and only-law pointers, tallies and frontier; a location seat claimed only through `subject.covers` by a blocking law at budget 0, the law in `rules`, not a pointer, the seat alone loaded; a location nothing claims, and one claimed but declared at no record; a record of another workspace's root never entered and named as a pointer, whether a hop or the seat's `composition.systems` reaches it, and not listed under a word it is not of; a location in that root's system folder, closed in that workspace; an adopted `@system` seated in the repository's workspace though its adopted `@workspace` declares the root it sits in, the repository's own blocking law of its word reserved; a conditional row followed at each phase exactly where graph traversal follows it for the key's coordinate, from either side and with its severity term read from the record that states it, and a task reached through a conditional requirement only at the phase it names; the narrowed location unknown; K0 with the repository workspace undecided; a seat no declared root holds, under the fallback closure and named, its blocking law still in `rules`; on a whole-workspace scope, missing targets, unconsented rows and missing field references named on the loaded record whose span holds them, never on an earlier record of the file or on a pointer, and the `unread` note on a narrowed one; and the token. `tests/purity.test.ts` pins the runtime-placement rule (R16). The conformance corpus places no source at runtime, so the rule leaves the golden bodies unchanged.
85
+ R15. Position body (2026-10-08): `src/position.ts`, exported from the package root and the `./internal/position` subpath, publishes `positionBody(handle, within, resolved)` with the `PositionBody`, `LoadedEntry`, `LoadedPlace`, `LoadedRecord`, `PositionRecord`, `PositionPointer`, `PositionVia`, `PointerTally`, `FrontierTally`, `PositionUnknown`, `PositionCounts` and `PositionWidening` types. `resolved` is what resolveScopeKey (R14) returned for the same scope token `within`. Every read carries that token: the snapshot and its D02a membership rows, directed views (db D09), the declared roots (db D02c `roots`) and the seat of `''` (D02b); a missing token is IA-RUNTIME-REQUEST-INVALID, and an unknown, stale or closed one keeps its database code, and a resolved seat identity the token does not admit (a key resolved through another token) is IA-RUNTIME-REQUEST-INVALID, `The seat '<identity>' is not an admitted record in this scope`, naming as its `next` `ia position`, the position without that seat, as R14 names it for a seat outside the scope. body(K) is a pure function of the key and the admitted records the token reads, and only a whole-workspace token (db `isCompleteScope`, PT5) also reads the admission findings it alone may disclose: it carries no root path, token, time, request text, capture state or record body (a body is read on demand by `ia read`; R17's cells carry a playbook cell's text, not its record's body), and nothing is written. A record at runtime placement (band 0) is no part of a body (2026-10-08: runtime-band evidence is admitted below authored, where it must not move what agents are given): the body reads the scope's records without those records and without every directed-view row and claimant that names one, so none is composition, a seed, a hop or waypoint, loaded, in `rules`, a pointer, tallied or frontier, none primes, reaches or names the steward of another record, and none claims a location or is the record one is declared at, so a location whose declarer and claimants are all at runtime placement names the `seat` unknown it would name without them; a seat at runtime placement, whether the key names it or it is the repository's own `@workspace` (K0 included), is IA-RUNTIME-REQUEST-INVALID, `The seat '<identity>' is at runtime placement (band 0), which no position body enters`, whose `next` (2026-10-08, moved here from the Door) is `ia inspect`, the overview, when the seat is the one K0 takes, the repository's own `@workspace` (`resolveSeat('')`), whether the key names it or not, since K0 is refused alike, and `ia position`, the position without it, for any other seat. Two inputs still read every placement, so a runtime-band record appearing can still move the body. The database's own decisions: a runtime-band `@workspace` or `@system` can move the D02a membership roots, the D02c declared roots, the D02b seat of a path and the repository's own `@workspace` that the closure is built from, and a location's resolved `seat` (R14) then names no `unknown` while `unknowns` names the seat. Admission's findings, which resolve every reference against every placement: a runtime-band record that an edge or field reference of an authored loaded record names resolves it, so that record's IA-GRAPH-TARGET-MISSING or IA-COMP-FIELD-REF-MISSING `finding` leaves `unknowns`, and the row to it, naming a band-0 record, is dropped, so the body names that relation neither as a pointer nor as an unknown. The body's `revision` is not one of them: it is the authored revision of the view the scope reads (db D05a), which no runtime-band source moves (R16). It is `{format: 'ia.position-body.v1', revision, key, seat, loaded, rules, omittedRules, pointers, pointerTallies, appliesByWord, appliesByWordTallies, cells, mandates, frontier, unknowns, counts, widening}` (`format: 'position-body', formatVersion: 1` once `WRITE_PLAIN_NAMES` flips), `key` and `seat` being the resolved key and seat and the four sections after `pointerTallies` R17's. The seat's workspace is the seat when it is a `@workspace`; else, of the repository's own `@workspace`, the one D02b seats `''` at, and the workspace of the first declared root, in D02c order, that contains the D02a membership root of the seat record (for a location, of the record it is declared at), the first whose closure holds that record; else no workspace holds the seat. A floor or adopted record, an installed one included, is in every closure, so it is seated in the repository's own workspace with the records the repository authors, even when the installed or adopted `@workspace` that ships it declares the root it sits in, as the bundled base's language-workspace declares `.ia/src @authored` in the store (2026-10-08: the floor, the adopted records and the repository's own roots); the workspace whose root holds the record is taken for an authored record of another workspace's root. D02b's unique init entry point keeps the repository seat decidable when local domain workspaces declare sources; this does not widen a closure. A repository and a domain that need the same local records must both declare those membership roots explicitly, and private domain roots remain outside other closures. A workspace's closure is every floor (band 10) and adopted (band 90) record, plus the members of its own declared roots or, while it declares none, every record whose membership root no workspace declares; when no workspace holds the seat, the closure is that fallback. Reading the closure as the declared members alone would leave a repository without a declared root (the conformance corpus, and every repository an earlier `ia init` made, which declared none) unable to reach any record of its own; and falling back to the repository's workspace whatever its roots would, when none of them holds the seat record, leave the seat outside its own closure (the seat S always resolves inside it) and its own system's blocking governance out of `rules`. Both fallbacks are named under `unknowns`. A record outside the closure is never entered: it is a pointer that names, as `workspace`, the `@workspace` whose declared root holds it, when one does. The composition C0, at cost 0 and one level from the seat, is the seat's field references both ways (directed-view `field-ref` rows); a `@workspace` seat's capture members, the membership rows under its own declared roots; a `@system` seat's word members, the admitted records whose owner system it is; and a location's declared-at record and claimants from `resolution`. A location is no record and has no fields, and a workspace seat no record declares has an empty composition. The first class that reaches a C0 record is its `via`, unless a hop reaches it (below): `field` (`from`, `field`, `direction`, read from `from`'s side), `membership` (`root`), `word` (`system`), `declared-at` (`rule`) or `claim` (`matches`); C0 counts only what the closure admits, a composition record a hop reaches included. The seeds Σ are the seat and the C0 records whose kind is in SHAPE_ROWS[shape].kinds or whose lane, graph `laneOf` (G05), is in its lanes. Hops 1..depth start from Σ and follow directed-view edge rows only, declared or derived inverse, in either direction, whose predicate is in SHAPE_ROWS[shape].predicates, never leaving the closure; each record other than the seat and the seeds that a hop reaches, a C0 record among them, keeps the first row that reaches it, from the seat, then the seeds and each later hop in identity order, as `via: {by: 'row', from, predicate, spelling, declaredBy}`, and is in C. A row that carries a condition is a row of the body only where its condition holds at the key's coordinate (2026-10-08): graph `conditionHolds` over the coordinate R14's scopeCoordinate builds, the key's shape and phase with the derived category and selected primitive, the condition's subject being the record that states the row (its `declaredOn`, the author graph G06 keeps as an edge's condition subject), so the body agrees with graph traversal for the same coordinate. A row that does not hold is not followed and its counterpart is not reached through it: it is no hop, primes no record, names no out-of-focus pointer and counts in no frontier, while a field reference carries no condition. The phase can so change the loaded set; a body whose rows carry no condition and whose reserved rules state no `activation` is unchanged by it, and one whose reserved rules state an `activation` can move a rule between `rules` and `omittedRules` (the R15, R17 rule activation addendum). The conformance corpus's fixture law `enforced-by @check instance-schema-check when phase is act and severity is blocking` reaches the check at act only. With `word` set (the word restricts seeds and tallies inside the body, and blockers are reserved outside n), C0, the seeds, the hop-reached records that load, the pointers, their tallies and the frontier are records of that word only; a record of another word that a hop reaches is a waypoint, followed but never loaded or listed; the seat loads whatever its word. The word never filters `rules` (2026-10-08: a word must not hide a blocking rule that governs what it loads, as one claiming a location seat or applying by its subject-word to a record of the word would be hidden if R were read under the word): R is taken from the candidates of the walk without the word, each with the row or class that reaches it there, so `rules` under a word is the body's without it, and R17's applies-by-word section with its tallies, its cells and the mandates are not filtered either. The order keys are total: governance (prime ↑, band ↓, hop ↑, sev ↑, identity ↑) and every other shape (band ↓, hop ↑, lane ↑, identity ↑). prime is the least index in SHAPE_ROWS.governance.priming (govern, constrain, forbid, enforce, implement) of an edge row incident to the record, else 5; sev is the rank of graph `effectiveSeverity` in [blocking, advisory, informational], a record with none last; lane is its index in the shape's lanes, else their count; hop is 0 for Σ and for a C0 record no hop reaches, else the first hop that reached it. The candidates K = {S} ∪ C0 ∪ Σ ∪ C, C the hop-reached records, are taken before any truncation and before the word filter, and R is the governance-kind candidates other than the seat whose effective severity is blocking, with the blocking rules that apply by word to a candidate (R17), all reserved outside the budget; `rules` is the members of R whose activation admits the key's coordinate (the R15, R17 rule activation addendum), in the governance order and never counted against the budget, and `omittedRules` names the rest, so a blocking law that claims a location only through `subject.covers` is in `rules` at budget 0. `loaded` is the seat, then the first `budget` records of ((Σ \ {S}) ∪ C) \ R in the shape's order. A record seat loads as a `LoadedRecord`; a location, or a workspace seat no record declares, as the `LoadedPlace` `{path}` of its canonical path (`''` for the latter). A `LoadedRecord`, and each entry of `rules`, is the pointer tuple plus the record's G13 `digest`. `pointers` are the C0 and hop-reached records outside `loaded` and R, an activation-omitted rule included, those the budget truncated among them; the records outside the closure that composition or a hop reached; and the counterparts of each loaded record's out-of-focus edge rows and field references, at that record's hop. Each is listed once, by the first that reaches it, in the shape's order, as the pointer 9-tuple `{identity, word, kind, lane, system, steward?, band, hop, via}`, `system` being the owner system and `steward` the `head.steward` field reference of its `@system` record (`floor/definition/system/<name>`) when the scope admits it, read without the registry. The first 48 are listed, and the rest are tallied per (word, owner system) as `{system, word, steward?, count}`, sorted by system then word. `frontier` tallies per (owner system, kind), as `{system, kind, steward?, count}`, the counterparts of the in-focus rows of the loaded records at hop `depth` that the body neither lists nor reached, never entered. `unknowns` are `{kind, subject?, code?, path?, line?, message}`: `seat` for a location no admitted record is declared at, a location that nothing claims and none is declared at (`no record claims '<path>' and none is declared at it; widening key: the workspace`, or on a narrowed scope, which prunes the claimants it does not admit, `no record in this scope claims '<path>' and none in it is declared at it; widening key: the workspace`), or the repository root no `@workspace` is declared at; `sources` when the seat's workspace declares no sources (`workspace declares no sources: …`) or no workspace holds the seat; `finding`, read only on a whole-workspace scope (db PT5, as R18 reads admission findings), each IA-GRAPH-TARGET-MISSING, IA-GRAPH-TARGET-AMBIGUOUS, IA-GRAPH-EDGE-UNCONSENTED and IA-COMP-FIELD-REF-MISSING report finding on the source span of a loaded record, the innermost one, with its code, path, line and message; and `unread` on a narrowed scope, which reads none. `counts` are `{composition: |C0|, seeds: |Σ| with the seat, loaded: |L| with the seat, rules, pointers (listed and tallied), appliesByWord (R17), frontier, truncatedLoaded, truncatedPointers, truncatedAppliesByWord}`. `widening` is `{deeper: the key at depth + 1, absent at depth 2; reseat: {shape, phase, primitive?, depth: 1, budget: 16}}`, to be seated at any pointer, no seat being the repository's workspace. `position` (R16) returns the body with its digest and host note; R17 adds the applies-by-word section, the playbook cells and the mandates; and the Door's version-2 `position` operation and the MCP tool `ia_position` serve it (R12), as does the `ia position` CLI verb (apps/cli/SPEC.md). `tests/position.test.ts` pins, over the conformance corpus, golden bodies of K0, governance at the fixture law (at plan, where its conditional `enforced-by` row does not hold, and at act, where it does), sequence at depth 2 from the workspace and the word law at the governance-system seat, in `tests/golden/` with the revision masked and asserted apart (only `node packages/runtime/tests/golden/write.mjs` regenerates them); K0's single loaded seat, five system pointer lines from `composition.systems`, frontier and named missing sources; byte-equal bodies for equal keys through every whole-workspace token and handle of one revision, and a token selecting every admitted identity differing only by the `unread` note; hops in either direction, out-of-focus pointers and a seed a later hop reaches keeping hop 0; each order key deciding in turn (band, then hop, then lane in the other shapes; prime, then band, an adopted record against a local one, then hop, then sev in governance) and two blocking laws in `rules` in the governance order under governance and context; seeds picked by kind and by lane (an authority-facet contract); the counts of a budget below |Σ ∪ C| and one tally past 48 per word and owner system; the word law loading the seat and only laws, waypoints and only-law pointers, tallies and frontier; a location seat claimed only through `subject.covers` by a blocking law at budget 0, the law in `rules`, not a pointer, the seat alone loaded; a location nothing claims, and one claimed but declared at no record; a record of another workspace's root never entered and named as a pointer, whether a hop or the seat's `composition.systems` reaches it, and not listed under a word it is not of; a location in that root's system folder, closed in that workspace; an adopted `@system` seated in the repository's workspace though its adopted `@workspace` declares the root it sits in, the repository's own blocking law of its word reserved; a conditional row followed at each phase exactly where graph traversal follows it for the key's coordinate, from either side and with its severity term read from the record that states it, and a task reached through a conditional requirement only at the phase it names; the narrowed location unknown; K0 with the repository workspace undecided; a seat no declared root holds, under the fallback closure and named, its blocking law still in `rules`; on a whole-workspace scope, missing targets, unconsented rows and missing field references named on the loaded record whose span holds them, never on an earlier record of the file or on a pointer, and the `unread` note on a narrowed one; and the token. `tests/purity.test.ts` pins the runtime-placement rule (R16). The conformance corpus places no source at runtime, so the rule leaves the golden bodies unchanged.
82
86
 
83
87
  R16. Position and host note (2026-10-08): `src/position.ts`, on the package root and the `./internal/position` subpath, also publishes `position(handle, within, partial?)` with the `PositionOutput`, `HostNote` and `Freshness` types. It completes `partial` with normalizeScopeKey (R14), resolves the key with resolveScopeKey through the scope token `within`, assembles the body with positionBody (R15) and returns the frozen `{body, digest, hostNote}`, the two outputs of a position, printed together and never merged. `digest` is graph's codec `digest` of the body, the SHA-256 of its canonical JSON text, and the note carries none. Purity: the body is a function of the key and the admitted revision alone. A key's parts are closed (R14), so a partial naming `text`, `token`, `within` or any other part is an unknown part, IA-RUNTIME-REQUEST-INVALID, and nothing text-driven runs, no classifier, search or text ranking; the version 1 `context` and `select` operations stay text-driven and unchanged. The body names no root path (a location seat spelled as an absolute path enters it as its root-relative path), no scope token, no time, no request text and no capture: one key over two copies of a corpus at different roots gives byte-equal bodies and equal digests, a `context` call with any text on the same handle and token leaves both unchanged, and so does writing a capture. The host note is host state, never claimed identical across hosts or working trees: `{revision, capturedRevision?, previousRevision?, freshness, key}`. `revision` is the handle's authored revision (`handle.authoredRevision`, db D05a); `capturedRevision` the authored revision of the capture at `.ia/work/snapshot/current.json` (db D08a) and `previousRevision` the authored revision of the previous root snapshot the handle retains (db D08), each absent when there is none; `freshness` is `current` when the capture is at `revision`, `stale` when it is at another and `no-capture` when there is none; and `key` is the key used, the partial normalizeScopeKey completed, a location as the caller spelled it, while the body's `key` is the resolved one. The handle reads the capture pair once per state, on first use, so a capture written while it is open shows after its `refresh`, the scope token still valid. A position does not require a capture: the body is computed over the live admitted revision, and freshness is a note, never a refusal. The note reports no installed state per command, no CLI or adapter id@version and no classification rule number. Records at runtime placement are no part of the body (R15), so a runtime-band record appearing that no authored record names and that decides no database seat or root leaves it, its `revision` (the authored revision), its digest and the host note byte-equal. Only `handle.revision`, the graph revision that hashes every source at its placement (graph revisionOf), moves. The note compares authored revisions, so a capture taken before stays `current`. A runtime-band record that an authored loaded record's edge or field reference names moves `unknowns` too (R15): admission resolves the reference against every placement, so the record's missing-target or missing-field-reference finding leaves the body. That is the evidence flow itself, an observation an `ia validate` writes at runtime placement that a task's `work.exit-evidence` names. Such evidence can still move body(K) and its digest through `unknowns`, while it leaves the body's `revision` and a capture's freshness unchanged. Refusals are those of the three steps: the key's (R14), the token's (a missing one IA-RUNTIME-REQUEST-INVALID, an unknown, stale or closed one its database code) and a seat at runtime placement (R15), each refusal of the key or its seat carrying `next`. The Door serves it as the `position` operation (R12 refinement, position), the MCP door as `ia_position` and the CLI as the consumer verb `ia position` (apps/cli/SPEC.md). `tests/purity.test.ts` pins, for K0 and seven other keys (two locations among them), byte-equal bodies and digests at two roots, and the digest the codec digest of the body; an absolute location seat root-free in the body and as spelled in the note, with no token in the body; a capture that moves only the note: `no-capture`, then `current` after a refresh with the same token and on a new handle, then `stale` after an edit, the earlier revision captured and previous, which the body names neither; `text`, `token` and `within` refused as key parts, and the token refusals; bodies and digests unchanged by two `context` calls with text, in both rankings; runtime-band records (a blocking law that the check enforces and that claims two paths, and observations of the workspace and of the law) leaving each body, its revision and its digest unchanged while `handle.revision` moves, and a capture current across them, while the same records authored change every one, and a seat at runtime placement refused, a named one and K0's with the repository's own `@workspace` placed so; a location whose only declarer is a runtime-band `@system` naming the seat unknown, its body differing from the body without that `@system` in the resolved seat's `unknown` alone; the limit pinned: a runtime-band check and observation that an authored law's `enforced-by` and a task's `work.exit-evidence` name removing exactly those two findings from the bodies seated at the law and the task; and a key resolved through a whole-workspace token refused through a narrower one that does not admit its seat.
84
88
 
85
- R17. Applies by word, playbook cells and mandates (2026-10-08): `src/position.ts`, on the package root and the `./internal/position` subpath, also publishes the `AppliesByWord`, `PositionCell` and `SubjectMatch` types, and `PositionVia` gains `subject`. positionBody (R15) adds four sections to `ia.position-body.v1`, whose format name is unchanged: `appliesByWord`, `appliesByWordTallies`, `cells` and `mandates`, after `pointerTallies`; it reserves blocking rules by word in `rules` too, and `counts` gains `appliesByWord` and `truncatedAppliesByWord`. The subjects are the `@law`, `@convention`, `@principle` and `@playbook` records of the seat's closure (R15), of every word whatever `word` is (R15: the word never filters these sections), that state `subject.subject-word` or `subject.subject-kind` unconditionally. Those fields exist on all four schemas, and nothing read them before. An `@agent`'s `governance.applies` is not read, since it is no field match against the loaded set (it feeds COMP-STEWARD), and a `@mandate`, which declares no subject field, is no subject. A subject applies by word to a record when its `subject-word` is the record's word or its `subject-kind` the record's kind. That is a field match, not a row: it costs no hop, follows nothing and claims no relation or consent. It enters the body at hop 0 as `via: {by: 'subject', label: 'field match, not a row', matches}`, each match `{field, value, record}` naming the field, the word or kind it states and the first record that answers it. `appliesByWord` lists the subjects outside `rules` that apply by word to a record of `loaded`, the seat included, or to a blocking candidate in `rules` (R15). The body delivers `rules` in full, as it does `loaded`, so making a rule blocking keeps what applies to it while its activation admits the coordinate, and an entry's match names the first answering record in `loaded` order, then `rules` order. A rule that `rules` holds by word alone is itself a field match, not a record of L or a candidate of K, and nothing applies by word to it, so matches never chain. Each entry is listed once, whichever of its fields match and however many records answer them, ranked by band ↓ then identity ↑, as claimants and cells are ranked, since a field match has no row or hop to rank by. The first 48 are listed as `AppliesByWord`: the pointer tuple with that `via`, and `reseat`, the re-seat key (x, H, P, 1, 16, no word) as a full key `{seat, shape, phase, depth, budget}`. The rest are tallied per (word, owner system) in `appliesByWordTallies`, as `pointerTallies` are. A subject may also be loaded or a pointer: non-blocking governance stays where R15 places it. R (R15) includes every blocking subject other than the seat, of governance kind (`@law`, `@convention` or `@principle`), that applies by word to a candidate of K = {S} ∪ C0 ∪ Σ ∪ C, the candidates before the budget truncates any or the word leaves any out (blockers are reserved outside n). Its matches name the first answering candidate, the seat first and then by identity. A blocking subject that is itself a candidate is already in R, by its claim, its composition class or its row, and keeps that `via`. `rules`, the members of R whose activation admits the coordinate (the R15, R17 rule activation addendum), stays in the governance order and outside the budget, and no member of R, omitted or not, is in `appliesByWord`, `pointers` or the frontier. So a blocking rule its activation admits survives budget 0 whether it applies by claim, by row or by word: one whose subject-kind is the kind of a candidate the budget truncated to a pointer is in `rules`. An advisory or informational subject applies by word to `loaded` and `rules` only, never to a candidate the budget truncated or a rule activation leaves out. `cells` holds, for each `@playbook` of `appliesByWord` in its order, up to c = 4 (a rendering constant), its cell at (P, primitive): P the key's phase, and primitive the explicit override or SHAPE_ROWS[shape].primitive. A playbook with a cell there gives `{playbook, address, text}`: `address` is `<identity>#<phase>/<Primitive>` and `text` what `ia read` reads at that address (`fragmentText`, every cell of the record at it in source order, a cell's condition unevaluated), so the cell is delivered while the record's body is not. A playbook with none there gives `{playbook, missing, nearest?, message}`: `nearest` is the phase other than P with a cell of that primitive at the least distance in the cycle orient, plan, act, learn, a tie going to the phase that order lists first (from learn, orient before act), and `message` reads `no cell; nearest phase with a cell: <phase>`, or `no cell; no phase has a cell at <Primitive>` when no phase has one. Besides deciding a conditional relation row, which R15 follows only where it holds at the key's coordinate (R15), and a reserved rule's activation, which places it in `rules` or `omittedRules` (the R15, R17 rule activation addendum), the key's phase changes only `cells` and the keys spelled with it. `mandates` lists the `@mandate` records of the closure, whatever `word` is, that claim a location seat, from its `resolution` claimants (`via: {by: 'claim', matches}`), or whose `authority.scope` names the seat's workspace (R15), read as a field reference from the workspace's side (`via: {by: 'field', from: <workspace>, field: 'authority.scope', direction: 'in'}`), each once, a mandate that does both keeping its claim `via`, all ranked by band ↓ then identity ↑ whichever way they govern, as pointer tuples at hop 0. A body matches no participant: the position packet selects its participants over body(K0)'s mandates (R19), and body(K) is unchanged. No record at runtime placement is a subject, a match, a cell or a mandate (R15). `tests/applies.test.ts` pins: the fixture playbook's plan cell at phase plan under governance, equal to what `readBody` reads at its address, and Attention's under context, the phase moving only the cells where no conditional row bears on the body; the nearest phase by distance, the cycle wrapping, a tie going to the phase the order lists first, no phase with the primitive, and c = 4; a local playbook before an adopted one; the blocking fixture law in `rules` at budget 0 through a claim and through a subject-kind match on a contract the budget truncated, and taken out of the pointers at the check by its subject-word and out of the frontier under governance, never in `appliesByWord` or `pointers`, while an advisory rule that matches only a truncated candidate is in neither section; a convention and a playbook naming the word law applying to the blocking fixture law in `rules` as they do while it is advisory and loaded, the playbook's cell delivered, and to no rule `rules` holds by word alone; `rules` in the governance order across a claimed rule and a word-reserved one, a blocking candidate that also matches by word listed once with its own `via`, a blocking seat whose subject matches itself not reserved, and a word-reserved rule's matches on both fields, each naming the first answering candidate, the seat first and then by identity; no subject or mandate of another workspace's root applying, reserved or governing; the sample convention (subject-word and subject-kind contract) applying once with both matches while a `@contract` is loaded and not while it is only a pointer, its re-seat key seating a body at it, a loaded principle also applying, and each of 51 entries listed once with 48 listed and 3 tallied; the mandates of a workspace, a record and a location seat, none scoped to another workspace, one that both claims and scopes listed once by its claim, and a local mandate before an adopted one; under four words, `rules`, `cells` and `mandates` equal to the body's without the word and `appliesByWord` listing the same entries, a match naming the first answering record of what loads under the word, the blocking convention a `@system` seat's word member reserved under every word, one reserved by its subject-kind alone kept under its own word and another, and the playbook's cell delivered under `word: playbook`, where no playbook loads; a blocking law reserved under the word contract by its claim on a location, nothing loaded or listed, and by its subject-word on the contract that loads at hop 1 under that word, as without the word and at budget 0; and runtime-band subjects and mandates left out of K0. The golden bodies of R15 carry the sections.
89
+ R17. Applies by word, playbook cells and mandates (2026-10-08): `src/position.ts`, on the package root and the `./internal/position` subpath, also publishes the `AppliesByWord`, `PositionCell` and `SubjectMatch` types, and `PositionVia` gains `subject`. positionBody (R15) adds four sections to the `position-body` format, whose name is unchanged: `appliesByWord`, `appliesByWordTallies`, `cells` and `mandates`, after `pointerTallies`; it reserves blocking rules by word in `rules` too, and `counts` gains `appliesByWord` and `truncatedAppliesByWord`. The subjects are the `@law`, `@convention`, `@principle` and `@playbook` records of the seat's closure (R15), of every word whatever `word` is (R15: the word never filters these sections), that state `subject.subject-word` or `subject.subject-kind` unconditionally. Those fields exist on all four schemas, and nothing read them before. An `@agent`'s `governance.applies` is not read, since it is no field match against the loaded set (it feeds COMP-STEWARD), and a `@mandate`, which declares no subject field, is no subject. A subject applies by word to a record when its `subject-word` is the record's word or its `subject-kind` the record's kind. That is a field match, not a row: it costs no hop, follows nothing and claims no relation or consent. It enters the body at hop 0 as `via: {by: 'subject', label: 'field match, not a row', matches}`, each match `{field, value, record}` naming the field, the word or kind it states and the first record that answers it. `appliesByWord` lists the subjects outside `rules` that apply by word to a record of `loaded`, the seat included, or to a blocking candidate in `rules` (R15). The body delivers `rules` in full, as it does `loaded`, so making a rule blocking keeps what applies to it while its activation admits the coordinate, and an entry's match names the first answering record in `loaded` order, then `rules` order. A rule that `rules` holds by word alone is itself a field match, not a record of L or a candidate of K, and nothing applies by word to it, so matches never chain. Each entry is listed once, whichever of its fields match and however many records answer them, ranked by band ↓ then identity ↑, as claimants and cells are ranked, since a field match has no row or hop to rank by. The first 48 are listed as `AppliesByWord`: the pointer tuple with that `via`, and `reseat`, the re-seat key (x, H, P, 1, 16, no word) as a full key `{seat, shape, phase, depth, budget}`. The rest are tallied per (word, owner system) in `appliesByWordTallies`, as `pointerTallies` are. A subject may also be loaded or a pointer: non-blocking governance stays where R15 places it. R (R15) includes every blocking subject other than the seat, of governance kind (`@law`, `@convention` or `@principle`), that applies by word to a candidate of K = {S} ∪ C0 ∪ Σ ∪ C, the candidates before the budget truncates any or the word leaves any out (blockers are reserved outside n). Its matches name the first answering candidate, the seat first and then by identity. A blocking subject that is itself a candidate is already in R, by its claim, its composition class or its row, and keeps that `via`. `rules`, the members of R whose activation admits the coordinate (the R15, R17 rule activation addendum), stays in the governance order and outside the budget, and no member of R, omitted or not, is in `appliesByWord`, `pointers` or the frontier. So a blocking rule its activation admits survives budget 0 whether it applies by claim, by row or by word: one whose subject-kind is the kind of a candidate the budget truncated to a pointer is in `rules`. An advisory or informational subject applies by word to `loaded` and `rules` only, never to a candidate the budget truncated or a rule activation leaves out. `cells` holds, for each `@playbook` of `appliesByWord` in its order, up to c = 4 (a rendering constant), its cell at (P, primitive): P the key's phase, and primitive the explicit override or SHAPE_ROWS[shape].primitive. A playbook with a cell there gives `{playbook, address, text}`: `address` is `<identity>#<phase>/<Primitive>` and `text` what `ia read` reads at that address (`fragmentText`, every cell of the record at it in source order, a cell's condition unevaluated), so the cell is delivered while the record's body is not. A playbook with none there gives `{playbook, missing, nearest?, message}`: `nearest` is the phase other than P with a cell of that primitive at the least distance in the cycle orient, plan, act, learn, a tie going to the phase that order lists first (from learn, orient before act), and `message` reads `no cell; nearest phase with a cell: <phase>`, or `no cell; no phase has a cell at <Primitive>` when no phase has one. Besides deciding a conditional relation row, which R15 follows only where it holds at the key's coordinate (R15), and a reserved rule's activation, which places it in `rules` or `omittedRules` (the R15, R17 rule activation addendum), the key's phase changes only `cells` and the keys spelled with it. `mandates` lists the `@mandate` records of the closure, whatever `word` is, that claim a location seat, from its `resolution` claimants (`via: {by: 'claim', matches}`), or whose `authority.scope` names the seat's workspace (R15), read as a field reference from the workspace's side (`via: {by: 'field', from: <workspace>, field: 'authority.scope', direction: 'in'}`), each once, a mandate that does both keeping its claim `via`, all ranked by band ↓ then identity ↑ whichever way they govern, as pointer tuples at hop 0. A body matches no participant: the position packet selects its participants over body(K0)'s mandates (R19), and body(K) is unchanged. No record at runtime placement is a subject, a match, a cell or a mandate (R15). `tests/applies.test.ts` pins: the fixture playbook's plan cell at phase plan under governance, equal to what `readBody` reads at its address, and Attention's under context, the phase moving only the cells where no conditional row bears on the body; the nearest phase by distance, the cycle wrapping, a tie going to the phase the order lists first, no phase with the primitive, and c = 4; a local playbook before an adopted one; the blocking fixture law in `rules` at budget 0 through a claim and through a subject-kind match on a contract the budget truncated, and taken out of the pointers at the check by its subject-word and out of the frontier under governance, never in `appliesByWord` or `pointers`, while an advisory rule that matches only a truncated candidate is in neither section; a convention and a playbook naming the word law applying to the blocking fixture law in `rules` as they do while it is advisory and loaded, the playbook's cell delivered, and to no rule `rules` holds by word alone; `rules` in the governance order across a claimed rule and a word-reserved one, a blocking candidate that also matches by word listed once with its own `via`, a blocking seat whose subject matches itself not reserved, and a word-reserved rule's matches on both fields, each naming the first answering candidate, the seat first and then by identity; no subject or mandate of another workspace's root applying, reserved or governing; the sample convention (subject-word and subject-kind contract) applying once with both matches while a `@contract` is loaded and not while it is only a pointer, its re-seat key seating a body at it, a loaded principle also applying, and each of 51 entries listed once with 48 listed and 3 tallied; the mandates of a workspace, a record and a location seat, none scoped to another workspace, one that both claims and scopes listed once by its claim, and a local mandate before an adopted one; under four words, `rules`, `cells` and `mandates` equal to the body's without the word and `appliesByWord` listing the same entries, a match naming the first answering record of what loads under the word, the blocking convention a `@system` seat's word member reserved under every word, one reserved by its subject-kind alone kept under its own word and another, and the playbook's cell delivered under `word: playbook`, where no playbook loads; a blocking law reserved under the word contract by its claim on a location, nothing loaded or listed, and by its subject-word on the contract that loads at hop 1 under that word, as without the word and at budget 0; and runtime-band subjects and mandates left out of K0. The golden bodies of R15 carry the sections.
86
90
 
87
91
  The public `/authoring` boundary also owns chat-turn, chat-reply and conversation-summary contracts. A turn discloses one user message/current source snapshot and names its conversation/previous run; the service owns accumulated history and agent-selected targets. Nested proposals remain bound to that turn's exact message/context/base, fixed agent attestation and the existing proposal decoder. No API database, provider SDK or chat session lifecycle is imported into runtime.
88
92
 
@@ -106,13 +110,13 @@ R12 protocol version 2 refinement, position (2026-10-08): the Door also accepts
106
110
 
107
111
  This boundary also owns the neutral repository inventory helpers the repository's documentation and test-inventory tooling use. `gitFiles` executes only the fixed local `git ls-files --cached --others --exclude-standard -z` query, deduplicates/sorts the result and refuses subprocess/output limits (10 seconds,16MiB). `ownerOf` preserves the existing root/package/app/tool/example/distribution/native owner path mapping exactly; it selects no catalogue, executable, quality policy or queue. Tool imports remain compatibility exports. Consumer source capture must still validate file bytes, aliases and scope; a path listing is not source admission or authority. `ownerOf` names its root-owned top-level directories by stem, so no runtime source or test carries the CI-configuration directory as a path segment, and the cache-safety invariant in `tools/testing/inventory.test.ts` (only tools tasks read CI configuration) holds; the mapping and both exports are unchanged.
108
112
 
109
- Mandate authority (2026-10-06): `src/mandate-modes.ts`, exported from the package root, publishes `MOVES` (the five kernel moves in kernel order), the frozen `MODE_MOVES` table (read→Observation, validate→Verification, author→Synthesis, effect→Execution, re-seat→Delegation), `mandateAuthorityOf(record)`, which reads a compiled `@mandate`'s `authority` section (participant, moves, scope, excluded-words, covers) and refuses a non-mandate or a malformed field with IA-RUNTIME-REQUEST-INVALID, and `mandateRefusal(mandate, mode, words)`, which returns undefined when the mandate permits the mode for the words and otherwise `{code, message, next}`: IA-RUNTIME-MANDATE-MOVE when the mode's move is not among the declared moves, IA-RUNTIME-MANDATE-WORD when a word is excluded, and `next` exactly one catalog command, `ia inspect <mandate identity> --edges both`. A mandate without `authority.moves` restricts no move; a declared list admits only the moves it lists and must name at least one (admission refuses an authored `moves []` since 2026-10-12, compliance C05; one handed in all the same is IA-RUNTIME-REQUEST-INVALID here, never a lockout); excluded words are refused whatever the moves; the move is judged before the words. Both codes are registered in RUNTIME_CODES and covered by the compliance runtime fixtures over the conformance sample-mandate. The CLI's mandate profile judges its gated commands through `profileRefusal` (R21); a mandate adds closed restrictions only and never grants host permissions.
113
+ Mandate authority (2026-10-06; `authority.words` allow-list added 2026-11-18, inventarch/ia#286): `src/mandate-modes.ts`, exported from the package root, publishes `MOVES` (the five kernel moves in kernel order), the frozen `MODE_MOVES` table (read→Observation, validate→Verification, author→Synthesis, effect→Execution, re-seat→Delegation), `mandateAuthorityOf(record)`, which reads a compiled `@mandate`'s `authority` section (participant, moves, scope, words, excluded-words, covers) and refuses a non-mandate or a malformed field with IA-RUNTIME-REQUEST-INVALID, and `mandateRefusal(mandate, mode, words)`, which returns undefined when the mandate permits the mode for the words and otherwise `{code, message, next}`: IA-RUNTIME-MANDATE-MOVE when the mode's move is not among the declared moves, IA-RUNTIME-MANDATE-WORD when a word is omitted from a stated `authority.words` allow-list or listed in `authority.excluded-words` (when both are stated, a word must be in `words` and not in `excluded-words`), and `next` exactly one catalog command, `ia inspect <mandate identity> --edges both`. A mandate without `authority.moves` restricts no move; a declared list admits only the moves it lists and must name at least one (admission refuses an authored `moves []` since 2026-10-12, compliance C05; one handed in all the same is IA-RUNTIME-REQUEST-INVALID here, never a lockout); word restrictions apply once the move is judged. Both codes are registered in RUNTIME_CODES and covered by the compliance runtime fixtures over the conformance sample-mandate. The CLI's mandate profile and edit guard (`evaluateMandateGuard`, accepting optional `request.words`, which steward-hook fills with the words of the record headers, `@<word> <name>` lines, in the text a `Write`, `Edit` or `MultiEdit` writes to a `.ia` file under `.ia/src/`; an edit that changes an existing record's fields without rewriting its header line carries no words, so it is judged on the move alone) judge gated operations through `profileRefusal` (R21), where `GoverningMandate` and R19 `PacketMandate` carry `words?` alongside `excludedWords?`; a mandate adds closed restrictions only and never grants host permissions.
110
114
 
111
115
  R21. Mandate resolution (2026-10-09): `src/mandate-modes.ts`, on the package root and the `./internal/mandate-modes` subpath, publishes `governingMandates(handle, within, options?)`, `defaultActor(handle, within, workspace)` and `profileRefusal(mandates, mode, words?)` with the `GoverningOptions`, `GoverningMandate`, `DefaultActor`, `ProfileMandate` and `ProfileVerdict` types: the one answer to which `@mandate` governs an actor here, for the CLI's mandate profile and the re-keyed edit guard (R22). Every read goes through the scope token `within` (the snapshot and its membership, the declared roots, directed views and db `resolveSeat`), so a narrowed scope resolves only what it admits; a record at runtime placement (band 0) is never read, and only authored mandates (band 100) govern, so an adopted or floor mandate never does, whatever it claims. Only the workspace's closure is read, as position reads it: the floor and adopted bands and the members of the workspace's own declared roots, or, while it declares none, of the roots no workspace declares, so a mandate under another workspace's root never governs or names a participant there. None requires a clean scope: a workspace with admission errors resolves the records admission admitted, except that while an authored `@mandate` fails admission every resolver that reads a handle fails closed (R23). Nothing is written, and every result is frozen. A missing token is IA-RUNTIME-REQUEST-INVALID, and an unknown, stale or closed one keeps its database code. `governingMandates` returns the governing mandates by identity (each of band 100, so in band-then-identity order), each `{identity, band: 100, participant?, binds?, moves?, scope, covers?, excludedWords?}`: its authority as `mandateAuthorityOf` reads it, `participant` the `@agent` identity its `authority.participant` field reference resolves to (the reference as authored, `@agent <name>`, when no admitted record answers it), `scope` the `@workspace` identity each `authority.scope` reference resolves to, each once, or the reference as authored, and `moves`, `covers` and `excludedWords` present exactly when the record states the key (a declared empty list is stated), so that, `band` and `binds` aside, an entry for a workspace equals the position packet's entry for the same mandate. Its `options` are `{actor?, path?, workspace?, fold?}` (`fold`, the key applied to a path and each `authority.covers` selection before they are matched, is R22's); `workspace`, an admitted `@workspace` identity, also names the closure read. Without it the closure is the one position reads for the same location seat: with `path`, that of the workspace position seats the path in (the `@workspace` the path is declared at, else, of the repository's own `@workspace` and the one whose declared root holds the record the path is declared at, the first whose closure holds that record), so that the closure is the one position reads even where two workspaces declare roots and the repository has none of its own (only the closure: a path's governing mandates are those that claim it, not every mandate scoped to the seated workspace that position's location-seat governance also lists); with neither, the repository's own `@workspace`'s. With `workspace` or `path`, a workspace-relative path, a mandate governs when its `authority.scope` names the workspace or its `authority.covers` selects the path (db D02b claimants, graph G06c's selection dialect), either one sufficing; a mandate that states neither key with a value (a declared empty `scope []` or `covers []` locates nothing, so an empty list never lifts a restriction) is located by its participant alone and governs wherever that participant acts, with `actor` when its participant is the actor and without one whenever it names a participant, so one that names no participant either governs only where no location is asked. With neither, every authored mandate of the closure governs. `actor`, an admitted `@agent` identity, drops no mandate that governs the workspace or path: each entry then carries `binds`, true when its participant resolves to the actor or it names none (a mandate naming no participant binds whoever acts), false when it binds another participant. The participant, the scope and the covers are not read as alternatives: the resolver reads the scope and the covers as where a mandate governs and the participant as whom it binds, so one participant's mandate never grants another a move, a mandate naming no participant or no location is never dropped, and an actor that none of the mandates governing here binds is refused rather than read as ungoverned. An `actor` or `workspace` that is not an admitted record of its word is IA-RUNTIME-REQUEST-INVALID, as is a governing mandate whose authority `mandateAuthorityOf` refuses (a child under an authority field, or a conditional or fragment-bearing one; a declared `moves []` too, which admission refuses since 2026-10-12, compliance C05, so the reader refuses it only as defence in depth), the error's `where` locating the record (R23); a mandate that does not govern is never read. `defaultActor`, the actor a mandate-gated command acts as when none is named, returns `{actor?, by?, participants, actors, reason?, refusal?}`: `participants` the authored `@agent` records that an authored mandate of the workspace's closure whose `authority.scope` names the workspace names as participant, each once, by identity, as the position packet lists them when K0 seats at the workspace; `actor` the `@agent` the workspace's `composition.steward` resolves to when that is an authored (band 100) record (`by: 'steward'`, a participant or not; ia init names its participant there), else the only participant (`by: 'participant'`): an installed steward names no actor, as if none were stated (so the CLI's profile and the edit guard give one answer); `actors` the identities a command may be told to act as, sorted, the participants and the authored steward. With several participants and no steward there is no actor: `reason` names the participants and the choice, the workspace's `composition.steward`, and `refusal` is `{code: IA-RUNTIME-MANDATE-ACTOR, message: reason, next: 'ia position --seat <workspace> --shape governance'}`, which a mandate-gated command returns. With no participant and no steward there is no actor and a `reason` but no refusal: the command's profile is resolved without an actor, every mandate that governs there is judged, and the command runs unrestricted, with profileRefusal's notice, only when none governs. Each reason says whether the workspace states no `composition.steward`, one that resolves to no admitted `@agent`, or one that is no authored `@agent`. A workspace that is not an admitted `@workspace` of the scope is IA-RUNTIME-REQUEST-INVALID. `profileRefusal` judges `mode` and its target `words` against the governing mandates, each a `GoverningMandate`, a `MandateAuthority` or a compiled `@mandate` it reads through `mandateAuthorityOf`, and returns the `ProfileVerdict` `{refusal?, notice?}`, the mode allowed exactly when it holds no refusal. A mandate whose `binds` is false is left out of the judgement; when every one is, no mandate here binds the actor, and the verdict is IA-RUNTIME-MANDATE-ACTOR, naming each mandate with the participant it binds. The rest are never pooled across participants: when they name more than one participant, the verdict is IA-RUNTIME-MANDATE-ACTOR too, naming each with its participant. Every remaining mandate that names a participant requires an established actor binding (`binds: true`); a named participant with `binds` absent refuses every mode as IA-RUNTIME-MANDATE-ACTOR, even when it is the only participant. A path-only mandate therefore cannot supply grants to an unidentified CLI actor. Participantless mandates retain their existing move restrictions. Callers passing a compiled mandate or a plain `MandateAuthority` must establish the actor binding before judging a named participant's grants. Then the move is judged: the mode is allowed when any remaining mandate grants its move, by listing it or by declaring no moves, else IA-RUNTIME-MANDATE-MOVE, whose message gives each one's moves and the move the mode needs. Then, only when words are given, a word any of them excludes is IA-RUNTIME-MANDATE-WORD, naming each excluding mandate with the words it excludes. Each refusal's `next` is exactly one command, `ia position --seat <mandate identity> --shape governance` for the first mandate it names, not `mandateRefusal`'s `ia inspect`, which is unchanged. That next command, like `defaultActor`'s, is a read, which a command gated on the profile must leave ungated so that the refusal can be followed: an actor that no governing mandate binds is refused every mode, read included. No governing mandate restricts nothing: the verdict is `{notice}`, which says a mandate only adds restrictions, whatever the mode and words. An unknown mode, or a declared empty move list on any mandate, bound or not, is IA-RUNTIME-REQUEST-INVALID. IA-RUNTIME-MANDATE-ACTOR joins RUNTIME_CODES and MANDATE_CODES, and the compliance runtime fixtures observe it and both profile refusals over a copy of the conformance corpus that gives the foundation workspace two participants. This repository's `language-mandate` (`.ia/src/participant.ia`) grants all five moves, so `ia capture`, `ia project` and `pnpm projections:generate`, effect commands (Execution), pass the profile here; its `CLAUDE.md` mandate entry lists the five. `tests/mandate-resolution.test.ts` pins: a fresh init's steward participant as the default actor, its mandate governing, every mode allowed and its entries and participants the packet's, and its only participant as the actor without a steward however many mandates name it; a mandate without Execution refusing effect with its governance position, whose key resolves; `authority.covers` claiming a path, an adopted claimant left out, each governing mandate saying whether it binds the actor and each actor held to its own, a workspace and a path either sufficing, and a mandate that only covers paths not governing without one; a steward that no governing mandate binds refused in every mode with IA-RUNTIME-MANDATE-ACTOR, and nothing restricted where no mandate claims the path; a mandate under another workspace's root neither governing nor naming a participant, as position lists the governance; a path alone read in the closure of the workspace position seats it in, where two workspaces declare roots and the repository has none of its own; a mandate stating neither scope nor covers governing wherever its participant acts, with or without a steward; two participants' mandates refused rather than pooled without an actor, and each actor held to its own; a mandate naming no participant binding the steward and governing without an actor, whatever its participant resolves to; several participants without a steward naming no actor and refusing with the choice, a steward that resolves to no admitted `@agent` reported as such, and no mandate naming no actor and refusing nothing; only the authored participants of authored mandates counted; no mandate restricting nothing, with the notice; a workspace with admission errors resolving, an unresolved participant kept as authored; excluded words judged only when given, after the move, and declared empty lists and repeated or unresolved scope references rendered as the packet renders them; any one of several mandates granting a move and any one excluding a word, the first named next, a mandate binding another left out, two participants' mandates never pooled and every move list judged; reads through the token alone, runtime placement left out for a mandate and a steward, an unknown token keeping its database code, and the refusals; and this repository's participant as its default actor with all five moves. The CLI's mandate profile consults `governingMandates`, `defaultActor` and `profileRefusal` for its gated commands, and the edit guard (`evaluateMandateGuard`, R22, which steward-hook's `--hook` mode calls) consults all three for each edit an authored `@hook` selects, both keying a target path and each `authority.covers` selection with db `pathKey` (`GoverningOptions.fold`, R22), which folds case on win32 and darwin whatever the volume, so there a covers entry claims a path in any letter case and, on a case-sensitive directory, also a sibling spelled in another case, while on other platforms case is significant; agent-profile generation reads `governingMandates` for a profile that names no mandate; no Door operation does, and a mandate grants no host permission.
112
116
 
113
117
  R14, R15, R21 shared roots (2026-11-04, inventarch/ia#194). A path under a root several admitted `@workspace` records declare resolves as db D02b `shared`, with its `declarers` and no seat, and belongs to each declarer equally; no reader picks one of them by identity. R14: a location seat, and a workspace seat whose repository root `''` resolves so, carry `declarers`, every declarer in identity order, and no identity. R15: such a seat has no home workspace; its closure is the union of every declarer's closure; its composition holds each declarer by `declared-at` with rule `shared`, none of them the record it is declared at; its loaded place carries the same `declarers`; its mandates are its claimants and the mandates whose `authority.scope` names every declarer (a mandate scoped to only some of them is no mandate of the seat); and it states no `seat` or `sources` unknown, since its declarers declare it. A declarer at runtime placement is in `declarers` but no part of the body, so a scope need not name it. R21 (narrow, per inventarch/ia#228): at a root several workspaces declare, only two kinds of mandate govern, on every route: one whose `authority.scope` names every declarer, and one whose `authority.covers` selects the path. The closure read is every declarer's, whatever `workspace` names, so one declarer's grant, scoped to that declarer alone, never opens a shared root, however many moves it allows and however the declarers sort. The routes agree: a `path` (with or without `workspace`); `workspace` alone, which reads the repository root `''` when that resolves so and the workspace is one of its declarers (any other workspace keeps its own closure); and neither, which reads `''` for the repository root. A path read that names no workspace is claims-only, as for any path. A mandate that states neither `scope` nor `covers` is located by its participant elsewhere and governs a shared root on no route. When no mandate qualifies, the root is ungoverned and the guard's rule for an ungoverned location applies (nothing is restricted, `governed` is false): that is the consequence of the rule, not an exception, and a mandate scoped to the repository workspace alone does not govern a root it shares with a department. A declarer at runtime placement is no part of the read, so a scope need not name it, and with none left the path reads as the workspace's. The listings that consume `governingMandates` without a workspace (the doctor source-protection check, the generated agent-profile fallback, the default position) therefore list at a shared root only those mandates. `seatedWorkspace` gives, for such a path, the repository's own `@workspace` (db `repositoryWorkspace`) when it is a declarer, so the edit guard's main session acts as its default actor, and none otherwise; `governingWorkspace` gives it or, with none, a declarer, which the guard's governing lookup takes, so a mandate scoped to every declarer governs an edit there whoever acts (with no default actor, one that names a participant refuses as IA-HOOK-IDENTITY-UNAVAILABLE). `rootWorkspace(handle, read)`, on the package root, is the workspace that answers for the repository root, for the mandate read, position, the CLI's profile and method `checkRoot`: the record `''` seats at, when it is a `@workspace`; at a shared `''`, the repository's own when it is a declarer, and none otherwise, so a shared root keeps its repository workspace and a workspace declaring no part of the root does not answer for it. A scope that prunes the declarers to one seats the path at that one by `root`, and every rule above reads it as before. `tests/mandate-resolution.test.ts` pins a root the repository's `@workspace` shares with a department: the claimant governing a path alone, the mandate scoped to both governing with either workspace and the ones scoped to one not, the department keeping its own mandates away from the shared root, the seated workspace and its actor's profile, the position seat, loaded place and mandates, and a scope pruning the declarers to the department; a department's own mandate, held in its private root and scoped to it alone, pins that it governs no route to the shared root, and a repository root shared by two workspaces pins `checkRoot` refusing with the repository's workspace and with a repository workspace absent or no declarer when a mandate names both declarers, one declarer's all-moves grant scoped to it alone (either declarer order) opening nothing and leaving the root ungoverned, the path route and the workspace route agreeing, a default position composed as its explicit path is, and a runtime-placed declarer. `apps/steward-hook/tests/mandate-guard.test.ts` pins the guard refusing there, and `apps/cli/tests/preview.test.ts` `ia validate`, `ia capture --preview` and `ia preview`.
114
118
 
115
- R22. Mandate guard (2026-10-11): `src/mandate-guard.ts`, on the package root, publishes `evaluateMandateGuard(handle, within, request)` and `mandateGuardSelects(request)` with the `MandateGuardRequest` and `MandateGuardDecision` types, the decision steward-hook's `--hook` mode asks for one edit an authored `@hook` may select; `src/mandate-modes.ts` adds `seatedWorkspace(handle, within, path)`, the workspace position seats a path in. The request carries the hook as hook generation declares it (identity, tools, paths, message), the event's tool, the edited file's workspace-relative spellings, the event's `agent_id` and `agent_type` as received, and an optional `fold`. The hook decides an edit only when its `hook.paths` select a spelling of the file and its `hook.tools` name the tool, in the G06c dialect, where only `*`, `?` and `/` are special; any other edit is allowed. A workspace guards its governing records (the `.ia/src` sources of its hooks, mandates and profiles) by selecting them in a hook, such as `paths [".ia/src/**"]`; nothing selects them automatically. The actor is resolved first: an event that carries `agent_id` is a subagent, acting as the `composition.agent` of the one authored `@agent-profile` named exactly its `agent_type`, and a subagent no such profile names, a malformed `agent_id` or a missing `agent_type` is refused with IA-HOOK-IDENTITY-UNAVAILABLE at every path the hook selects, governed or not; any other event, a main session launched with `--agent` included, acts as `defaultActor` of the workspace position seats the path in. The mandates that govern a decided edit are `governingMandates` for the path and that workspace (R21), so a mandate scoped to the workspace governs every path a hook selects in it, beside those whose `authority.covers` claims the path; with none, an established actor and the main session are allowed. The edit is allowed when `profileRefusal` allows the author mode (Synthesis) for that actor: a governing mandate that binds it, its participant or one naming no participant (which binds every established actor, R21's `binds`), grants Synthesis; otherwise the decision is IA-HOOK-NOT-MANDATED with the profile's one next command, `ia position --seat <mandate> --shape governance`. An ambiguous default actor (several participants, no steward) is IA-HOOK-IDENTITY-UNAVAILABLE naming the workspace's governance position, and a main session with no default actor under a mandate that names a participant is IA-HOOK-IDENTITY-UNAVAILABLE; a governing mandate whose authority `mandateAuthorityOf` refuses is IA-HOOK-MANDATE-UNAVAILABLE, naming that admitted mandate's governance position; and while an authored `@mandate`, or a record a mandate resolution reads, fails admission (R23) every edit the hook selects, whoever acts, is IA-HOOK-MANDATE-UNAVAILABLE, naming the refused record's `path:line` and admission finding and `admissionReport(request.root)` (steward-hook passes the registration's root, printed only when inert unquoted, else the command is run from the workspace root), since `ia validate` and every other mandate-gated command refuse in that state and a position cannot seat at a refused record; it branches on the refusal's marked cause (`isAdmissionRefusal`), and the decision then carries the error's `where`. An edit the hook does not select is still allowed. Each refusal's message opens with the hook's message. Excluded words are not judged here. `HOOK_CODES` gains IA-HOOK-DECLARATION-UNAVAILABLE, IA-HOOK-MANDATE-UNAVAILABLE and IA-HOOK-NOT-MANDATED. `GoverningOptions.fold`, a key applied to the path and each `authority.covers` selection before they are matched (db `pathKey`, which folds case on win32 and darwin whatever the volume, so on a case-sensitive directory there a sibling spelled in another case is claimed too), makes a mandate claim every spelling the key folds alike; without it the claims stay db's case-sensitive G06c claimants.
119
+ R22. Mandate guard (2026-10-11): `src/mandate-guard.ts`, on the package root, publishes `evaluateMandateGuard(handle, within, request)` and `mandateGuardSelects(request)` with the `MandateGuardRequest` and `MandateGuardDecision` types, the decision steward-hook's `--hook` mode asks for one edit an authored `@hook` may select; `src/mandate-modes.ts` adds `seatedWorkspace(handle, within, path)`, the workspace position seats a path in. The request carries the hook as hook generation declares it (identity, tools, paths, message), the event's tool, the edited file's workspace-relative spellings, the event's `agent_id` and `agent_type` as received, and an optional `fold`. The hook decides an edit only when its `hook.paths` select a spelling of the file and its `hook.tools` name the tool, in the G06c dialect, where only `*`, `?` and `/` are special; any other edit is allowed. A workspace guards its governing records (the `.ia/src` sources of its hooks, mandates and profiles) by selecting them in a hook, such as `paths [".ia/src/**"]`; nothing selects them automatically. The actor is resolved first: an event that carries `agent_id` is a subagent, acting as the `composition.agent` of the one authored `@agent-profile` named exactly its `agent_type`, and a subagent no such profile names, a malformed `agent_id` or a missing `agent_type` is refused with IA-HOOK-IDENTITY-UNAVAILABLE at every path the hook selects, governed or not; any other event, a main session launched with `--agent` included, acts as `defaultActor` of the workspace position seats the path in. The mandates that govern a decided edit are `governingMandates` for the path and that workspace (R21), so a mandate scoped to the workspace governs every path a hook selects in it, beside those whose `authority.covers` claims the path; with none, an established actor and the main session are allowed. The edit is allowed when `profileRefusal` allows the author mode (Synthesis) for that actor: a governing mandate that binds it, its participant or one naming no participant (which binds every established actor, R21's `binds`), grants Synthesis; otherwise the decision is IA-HOOK-NOT-MANDATED with the profile's one next command, `ia position --seat <mandate> --shape governance`. An ambiguous default actor (several participants, no steward) is IA-HOOK-IDENTITY-UNAVAILABLE naming the workspace's governance position, and a main session with no default actor under a mandate that names a participant is IA-HOOK-IDENTITY-UNAVAILABLE; a governing mandate whose authority `mandateAuthorityOf` refuses is IA-HOOK-MANDATE-UNAVAILABLE, naming that admitted mandate's governance position; and while an authored `@mandate`, or a record a mandate resolution reads, fails admission (R23) every edit the hook selects, whoever acts, is IA-HOOK-MANDATE-UNAVAILABLE, naming the refused record's `path:line` and admission finding and `admissionReport(request.root)` (steward-hook passes the registration's root, printed only when inert unquoted, else the command is run from the workspace root), since `ia validate` and every other mandate-gated command refuse in that state and a position cannot seat at a refused record; it branches on the refusal's marked cause (`isAdmissionRefusal`), and the decision then carries the error's `where`. An edit the hook does not select is still allowed. Each refusal's message opens with the hook's message. Words are judged only when `request.words` carries them (2026-11-18, inventarch/ia#286): `profileRefusal` judges them after the move against `authority.words` and `authority.excluded-words`, and steward-hook passes only the words of the record headers in the text the edit writes, so an edit whose text holds no record header is judged on the move alone. `HOOK_CODES` gains IA-HOOK-DECLARATION-UNAVAILABLE, IA-HOOK-MANDATE-UNAVAILABLE and IA-HOOK-NOT-MANDATED. `GoverningOptions.fold`, a key applied to the path and each `authority.covers` selection before they are matched (db `pathKey`, which folds case on win32 and darwin whatever the volume, so on a case-sensitive directory there a sibling spelled in another case is claimed too), makes a mandate claim every spelling the key folds alike; without it the claims stay db's case-sensitive G06c claimants.
116
120
 
117
121
  R23. Refused mandates fail closed (2026-10-12: fail closed for any `@mandate` that fails admission, reject `moves []` in the schema, the refusal names the record, `ia position` and hand edits still work). Admission drops a record it refuses from the graph, so a resolver that read only admitted records read a mandate that failed admission as absent and its restrictions as lifted. `src/mandate-modes.ts`, on the package root and the `./internal/mandate-modes` subpath, publishes `refusedMandates(handle)` with the `RefusedMandate` type: every `@mandate` of the workspace's own authored sources (band 100) that failed admission, frozen, by path then line, each `{identity?, path, line, code, message, unidentified?}`, read from db's `unadmitted` (db D15), whose own admission finding gives `code` and `message` (no finding is matched back from the report): (a) one admission refused, as db's `refused` names it; (b) both occurrences of a mandate identity that ties at band 100; (c) one a file refused whole declares, by a language error or a duplicate requirement id, as db's own parse of the file reads its headers (with the identity db D15 gives each header), as its captured text shows a header the parse could not read (a line opening `@mandate`, inside a parsed record too), or as a `@mandate` token on a line no parsed record spans that the language scanner does not read as a whole-line comment (db D15's readings, with no identity; the comment classification correction below); and (d) every occurrence db lists with no word, a line of a file refused whole that may declare a record db cannot identify and so may be a mandate, marked `unidentified: true`, except at a line db also lists a mandate at, which counts once, as that mandate. The principle: an authored file refused whole whose records db cannot all identify fails closed, as far as db's readings of its text reach; db D15 states exactly which lines they read and the one shape they still miss, an at sign behind another character inside a parsed record's lines. A record is a mandate when its word is `mandate` or its identity's facet is, or when db names no word. An error inside the lines of a record db identifies stays that record's, so an error inside a parsed `@agent` adds no possible mandate. The band is the one db reads from the source's placement, as capture membership and `governingMandates` read it, so a mandate refused in an installed base (band 90) is never one: it never governs. It also publishes `refusedDependencies(handle)` with the `RefusedDependency` type, every admitted authored (band 100) record whose resolution a refused authored record would change, frozen, by dependent, field, path and line, each `{dependent, field, reference, identity?, path, line, code, message}`: a `@mandate` whose `authority.participant` names a refused `@agent` or whose `authority.scope` names a refused `@workspace`, and a `@workspace` whose `composition.steward` names a refused `@agent` (otherwise a refused steward or participant would switch the default actor to a looser participant, and a refused workspace would leave a scope-only mandate governing nowhere). The reference is matched as authored, by word and name lowercased, against db's `unadmitted` entries of band 100 that carry a name, so a schema refusal, a tie and a file refused whole all count, the last through its parsed headers and through every line opening `@agent <name>` or `@workspace <name>`, inside a parsed record too; an occurrence db lists with no word needs no dependency reading, since (d) already fails every resolver closed on it, before any dependency is named; a reference no authored record answers at all, one to a record refused in an installed base, and a refused `@agent` or `@workspace` that no admitted mandate or workspace names are none, and keep today's reading. `requireMandatesAdmitted(handle, within)` raises, while either returns anything, IA-RUNTIME-REQUEST-INVALID marked `admission: 'refused'` on the error (`isAdmissionRefusal(error)` reads it, the one test callers branch on, never `reader.get` of the located identity, which for a refused authored record shadowing an admitted one of another band would find that one). The decision reads db's root view, whatever `within` binds, since a refused record belongs to no scope and its scope, covers and participant cannot be trusted, so the fail-closed is workspace-wide; what the error discloses follows the token (db PT5): through a whole-workspace token (`isCompleteScope`) it names the first refused mandate db identifies, else the first `unidentified` one, as "an unidentified record at `path:line`, possibly a @mandate", counting the rest by kind, else the first dependency (the dependent record, its field and reference), with the refused record's identity, `path:line`, admission code and message and how many more failed, and locates the refused record as `where`; through a narrowed token it names no path, record or finding and carries no `where`. An unknown token keeps its database code. `governingMandates`, `seatedWorkspace` and `defaultActor` call it first. `profileRefusal` and `mandateRefusal` read no handle and keep their own empty-move-list refusal as defence in depth. `RuntimeError` gains optional fourth and fifth constructor arguments, a frozen `where` `{path, line, identity?}` (the `RuntimeWhere` type), which this refusal and every `mandateAuthorityOf` refusal carry, so the CLI and the guard locate the record without reading the message, and `admission`. `src/mandate-guard.ts` publishes `admissionReport(root?)`, the admission report command (`ia report`, the version 1 machine route no mandate gates) for a workspace root: `ia report --root <root>`, with forward slashes on win32, only when every character of the root is inert unquoted in sh, PowerShell and cmd (letters, digits, `.`, `_`, `-`, `/`, `:`), else `ia report` with `fromRoot`, run from the workspace root, so no root is printed with a shell-active character and none is wrapped in double quotes, where `$` and backticks stay live. The edit guard branches on `isAdmissionRefusal`: a refused record names `admissionReport(request.root)`, an admitted mandate whose authority the resolver cannot read its governance position. Position, `body(K)`, the packet renderer and every Door operation never call these resolvers, so they keep running and simply render no mandate for a refused record. `tests/mandate-resolution.test.ts` pins (a), (b) and (c); (d) for a header spelled `@ mandate`, a full-width at sign, UTF-16LE text without a byte-order mark and a stray top-level line, each failing closed located at its line, a spaced or joined header after a named first header with no pragma, a spaced header indented inside a parsed record and a full-width one inside a prose value left open; none for an error inside a parsed `@agent`, an empty file or a file of comments alone, but one for a malformed header after a comment; a line the token scan reads as a mandate counted once; and a mandate db identifies named before an unidentified record; refused dependencies through an `@agent` tie, a `@workspace` tie and a participant `@agent` authored only as a header a file refused whole shows; a parse error in a file declaring no mandate and a mandate refused in the installed base finding none, every resolver failing closed through a whole token with the first mandate located and the cause marked, a narrowed token disclosing nothing, the facet test, the shadowing override, the participant, scope and steward dependency cases, both dependencies of one agent and their order after a refused mandate, no fail-closed for an unrelated refused `@agent`, a never-authored participant or a refused installed `@agent`, and `admissionReport` over roots holding `&`, `(`, `$`, a backtick, a space, a quote and a non-ASCII letter; `tests/mandate-modes.test.ts` pins `where` on `mandateAuthorityOf`'s refusals.
118
122
 
@@ -120,11 +124,11 @@ R23 comment classification correction (2026-10-13): a genuine full-line attribut
120
124
 
121
125
  Body reader (2026-10-07): `src/locator.ts` reads the body behind a locator for `ia read`; the package root exports `parseLocator`, `readBody`, `SOURCE_LOCATORS` and `READ_CODES` with the `Locator`, `ReadBody`, `ReadBodyOptions`, `ReadCode`, `ReadRefusal` and `ReadResult` types, and the `./internal/locator` subpath also carries `fragmentText`, `markdownSection` and `headingAnchor`. `parseLocator(text)` returns the locator a text spells, or undefined: `<identity>` (a canonical `system/kind/facet/name` identity), `<identity>#<phase>/<Primitive>` (a cell address of the closed phases and primitives), `<identity>#<REQ-ID>` (a requirement id), or `<path>:<line>` (the last colon splitting the path from a positive safe-integer line). `readBody(handle, locator, {read, mounts?, includeRuntime?, within?})` reads in the handle's root view, or in the scope `within` names (R12 version 2 refinement), and returns `{ok: true, body: {locator, identity, kind, path?, digest, body, certified: false}}` or one `{ok: false, code, message, identity?, path?, line?, file?, reason?}` refusal; a locator that spells no form throws IA-RUNTIME-REQUEST-INVALID. A line locator reads the innermost admitted record whose source span holds the line. A cell or requirement locator reads the record, never its document: `fragmentText`, the text of the record's cells at that address in source order, or of its requirement with that id; `resolveMention` checks a request mention's fragment with the same function, so its refusal is unchanged. Otherwise a record whose word carries a source locator (`SOURCE_LOCATORS`: `work.source` for `@plan`, `@spec`, `@milestone`, `@task` and `@decision`, `reference.document` for `@authoring-guide`, `template.resource` for `@template`, each a text field its schema declares) and states it unconditionally reads the document it names, kind `document`, and any other record reads its own body (`bodyOf` in `src/render.ts`), kind `record`: the part of what recordText renders that the record states rather than structures, its `meaning.says`, a `@system`'s head `describes`, and nothing for a `@schema`. All five work schemas declare `work.source`, and each word reads it as a locator (2026-10-08, widened from `@plan` and `@spec`), since a plan's records name their sections of its document with it. A document path is canonicalized and must stay inside the record's tree, db `sourceTree` (D02a): the workspace root for the workspace's own `.ia/src`, and a package's or an installed store's directory as it is. An adopted mount's sources carry the `.ia/adopted/<id>/<revision>` label of a directory that does not exist, so its documents are read from the directory `mounts` binds that label to, which a host builds from db `adoptedBindings`; a record of an adopted mount `mounts` does not bind has an unreachable document. A document is outside an adopted mount's revision pin, which covers only the mount's `.ia/src` sources. The host supplies `read(path)`, which returns one workspace file's bytes at its canonical workspace-relative path and throws for a path it does not admit, as R10's hosts hold the root boundary; runtime itself reads no file. The bytes must be UTF-8. A `#<anchor>` on the locator of a `.md` or `.markdown` file, in any case, selects `markdownSection`: from the ATX heading whose `headingAnchor` equals it, to the next heading of the same or a higher level, a repeated anchor numbered `-1`, `-2` in document order. `headingAnchor` slugs a plain-text heading as GitHub's slugger does: an inline link keeps its text, letters are lowercased, characters other than letters, marks, decimal and letter numbers, connector punctuation, `-` and space are dropped, and spaces become `-`. The heading is not rendered first, so underscore emphasis, entity and character references, inline HTML and reference links keep their markup, and such a heading may have another anchor on GitHub. A leading byte order mark is not part of the first heading and stays in the section. Headings in fenced code are ignored, and setext headings and headings in list items or block quotes are not read. A document is read in time linear in its length, up to a logarithmic factor in how deeply its containers nest (2026-10-08): a 4 MiB document read on the long-lived MCP door must not stall it, as the regular expressions these scanners replaced did on a long run of spaces or unclosed brackets in a heading and the per-marker reread did on one line of nested list markers or on blank lines inside deeply nested items. Each line is scanned once from its end (its last character that is not a space, its last terminator, where a thematic break may start); a line is read as an ATX heading, and a heading's inline links as their text, in time linear in its length; each list or quote marker a line opens or continues is read in time linear in its own width; and a line left blank after its container prefixes continues every open list item up to the first block quote or empty item, the only containers a blank line ends (an empty item is always the innermost), found by a binary search over the open quotes. `tests/locator.test.ts` checks the growth ratio rather than a time, at sizes a quadratic reader still finishes in seconds, so a regression fails instead of stalling the suite. `digest` is the SHA-256 of the body's UTF-8 bytes, so a whole document's digest is its file's. A read never certifies its body. The refusal codes, registered in RUNTIME_CODES as `READ_CODES` and covered by compliance boundary fixtures: IA-RUNTIME-READ-UNADMITTED when no admitted record answers the locator, which for an identity a source holds whose record admission refused reads `in this workspace's sources, but admission refused it` with that record's path and line, `file` `refused` and the `reason` admission gives (db `refused`), for any other identity is `not in this workspace's sources`, and for a line names what the workspace's sources hold in its file (`file` `refused` when admission refused records there, else `admitted` when admitted records there span other lines, absent when no record of the sources is in it, a path that is absolute or escapes the workspace reads as one that is not relative to the workspace root, and the workspace root itself, `.` or another spelling of it, reads as a directory and no source); IA-RUNTIME-READ-PLACEMENT for a record at runtime placement (band 0) unless `includeRuntime` is set, judged before any fragment; IA-RUNTIME-READ-FRAGMENT when the record has no cell or requirement at the fragment; and IA-RUNTIME-READ-UNREACHABLE when the document path names no file, is a URL (a read fetches nothing, and a URL is never canonicalized into a path) or is outside the workspace or the record's tree, the record is in an adopted mount `mounts` does not bind, the host's reader throws, the bytes are not UTF-8, an anchor names a file that is not markdown, or no heading has the anchor. The Door's `read` operation (R12 version 2 refinement) reads a body through a scope.
122
126
 
123
- R18. Delivery view (2026-10-08): `src/next.ts`, exported from the package root and the `./internal/next` subpath, publishes `deliveryView(handle, within, seat?)` and `NEXT_CODES` with the `CycleRow`, `DeliveryMilestone`, `DeliveryResult`, `DeliveryTask`, `DeliveryView`, `ExitEvidence`, `NextCode`, `NextRefusal`, `Prerequisite`, `ReviewItem`, `StateDimension` and `StateLine` types. It is a pure function of the admitted records the scope token `within` reads: every read (the snapshot, directed views, one traversal, readiness) carries that token, so a narrowed scope lists only what it admits and prunes rows to it (db D09), and only a whole-workspace token (db `isCompleteScope`, PT5) also reads the admission findings it alone may disclose, `refused` and the report's COMP-PARSE findings; the view is computed per call, never stored, and nothing is written, the capture pair that `readiness` reads included; an unknown, stale or closed token keeps its database error. It returns `{ok: true, view}` or one refusal `{ok: false, code, message, next, plans?, cycle?}` whose `next` is exactly one command, as `readBody` returns its refusals as values. The plan is the seat's when a seat is given: a `@plan`, the plan a `@milestone`'s `work.plan` names, or that of a `@task`'s `work.milestone`; without one, the only admitted `@plan` at band 100. IA-RUNTIME-NEXT-SEAT refuses a seat the scope does not admit (next the view without a seat that runs: `ia next` while the scope admits one `@plan` at band 100, `ia next --seat <the first of them>` while it admits several, which `ia next` alone refuses, and `ia next --help` while it admits none) or that is not a `@plan`, `@milestone` or `@task` (next `ia position --seat <seat>`); IA-RUNTIME-NEXT-NO-PLAN a seat that belongs to no admitted plan, or no seat and no plan at band 100 (next `ia next --help`); IA-RUNTIME-NEXT-AMBIGUOUS no seat and several plans at band 100, listed in the message and in `plans` (next `ia next --seat <the first of them>`); IA-RUNTIME-NEXT-CYCLE `require` rows that form a cycle among the plan's tasks, milestones or both, listed in `cycle` as declared rows `{from, to, declaredOn, path, line}`, each `from` requiring its `to` (next `ia position --seat <the cycle's first task, else its first milestone> --shape sequence`). The runtime's own `next` keeps the commands above, which the Door and MCP callers receive; the consumer `ia next` builds its own next action (it names `ia preview plan` for a workspace that registers `@plan` and authors none, when the acting participant's mandate profile allows Verification and the word, and otherwise a command that profile allows). The plan's milestones are the `@milestone` records whose `work.plan` names it, and its tasks the `@task` records whose `work.milestone` names one of them (the reverse field index). Order: one topological sort, Kahn's algorithm, over the tasks and two vertices per milestone, its start (its prerequisites met) and its end (satisfied). A milestone's tasks follow its start and precede its end, its start precedes its end, and each declared `require` row between two records of the plan, in either spelling, makes the requiring record (a task, or a milestone's start) follow the required one (a task, or a milestone's end). Ready milestone vertices are emitted first and ready tasks by (milestone identity, task identity), so tasks come prerequisites first with ties by milestone then task: the order Kahn's algorithm gives over the task-level expansion (a task follows each task it requires, each task of a milestone it requires, and each prerequisite task of its milestone, required directly or through a required milestone's tasks), and a required milestone with no task still passes on its own prerequisites, so a cycle through it is refused too. Requirements outside the plan order nothing and remain basis lines. A relation row that carries a condition (2026-10-08), such as `requires @task guide when phase is act` or `grounds @task guide when phase is act`, counts only where its condition holds at the coordinate the scope binds, decided as graph traversal decides it: the coordinate is the phase db `resolveScope` binds the token to, or none (a scope binds no other condition axis), and graph `conditionHolds` decides each term, the condition's subject being the record that states the row (its `declaredOn`, the author graph G06 keeps as the edge's condition subject). A condition is decided where every coordinate the bound one may still be completed to (each axis it binds no value for absent, or set to each of its values) reads it alike, and undecided where two of them differ: `conditionHolds` reads provenance and artifact set from the subject alone, so the subject decides those terms; it reads severity as graph `effectiveSeverity`, the stronger of the subject's and the coordinate's (G08), so a severity term is decided only where the subject's own severity decides it at every coordinate (`when severity is blocking` on a blocking record holds everywhere, `when severity is advisory` on one fails everywhere) and is undecided otherwise, as on a record that states no severity, such as a `@task`; and a term on any other axis the scope binds no value for, such as the phase on a whole-workspace scope, is undecided. A row whose condition fails is no row: it orders nothing, is no requirement, grounding or supersession, and its declared line is not read as unanswered either. A row the scope does not decide, as one conditional on a phase on the whole-workspace scope `ia next` reads, or on a severity on any scope, is conditional with an unknown basis and is never satisfied: a conditional requirement orders nothing and is an unsatisfied prerequisite whatever its target's state, its basis `<word> <target>: conditional on <terms>, which the scope binds no <axes> to decide (unknown)`, the axes being those the bound coordinate leaves open, and one no admitted record answers reads `no admitted record answers it, conditional on …`. Intent is read at the bound coordinate with each undecided row read as no row; when that reading reads an undecided row that could change it (a grounding of the task, or of a supersedor, a supersession between two decisions grounding either, or a supersession of the task by a record that is or may be accepted), it is read again at each completion of the bound coordinate on the axes those rows leave open, where every row is decided, a record that a row holding at the bound coordinate names read before one only a conditional row names. The line that reads the same, value and basis, at every completion is the intent, since no binding the scope could take changes it and the conditional row is never read as satisfied: a decision with no choice that grounds the task only at act, beside one that grounds it with no condition and is accepted, leaves it `accepted`, and a supersession that holds, by a record one decision accepts at every completion, leaves it `superseded`. Else intent is `unknown`, its basis the first such row, `<record> grounds it conditional on …` or `<record> supersedes it conditional on …`, as it stays when the axes those rows leave open have more than 256 completions. Review items read rows that hold only. Of two rows to one counterpart the one that holds is read before a conditional one, and of two lines for one target a decided one before a conditional one. Field references carry no condition, so exit evidence, milestones, plans and owner-agents are read as before. Admission refuses a record that states a conditional `supersede` of a work record (each work-system word's supersede rule has cardinality one, which a condition would leave undecided: IA-COMP-EDGE-UNRESOLVED), so such a row is rare; one that reaches the view is read as above. A task's effective prerequisites are its own `require` targets, then its milestone's, each target once, an inherited one marked `via` that milestone. work-system consents `require` to a `@task`, `@milestone` or `@decision` target only (a `@task` that requires a `@spec` is refused at admission, IA-GRAPH-EDGE-UNCONSENTED), so no required-spec line arises; a requirement no admitted record answers, an admission warning with no row, is read from the traversal's dangling rows and is never satisfied; and a `require` the task or its milestone itself declares that gives neither a row nor a dangling edge in the scope, as when its answer is outside it (D09 prunes the row, and the traversal never crosses the scope), is never satisfied either, its state unknown. A requirement declared only on a record outside the scope is not read. A record's exit evidence is the first `@observation`, by identity, that its `work.exit-evidence` names or whose `evidence.subject` names it, whose `evidence.verdict` is success and whose `evidence.subject-revision` reads `current` under `readiness` (db D08) for that record; its evaluator is `evidence.evaluator`, and its `attribution` is `self` when that equals the identity the task's `work.owner-agent` names, `unknown` when the task states an owner-agent that no admitted `@agent` in the scope answers or the observation records no evaluator for a task that names one, else `other`. Basis lines: `decision <d>: choice made` or `no choice` (`decision.choice` stated or not); `task <t>: exit evidence <o>` or `no exit evidence`; `milestone <m>: exit evidence <o>` (its own), `every task has exit evidence`, `exit evidence missing for <n> of <k> tasks`, `no task and no exit evidence`, or `every task the view reads has exit evidence; records outside this scope are unknown` (a narrowed scope) or `…; records admission refused are unknown` (a whole-workspace scope while admission refuses a `@task`, whose `work.milestone` the view cannot read, or a file a language error refuses whole, db D03), neither of which satisfies it; `<reference>: no admitted record answers it`; `<reference>: no record in this scope answers it (unknown)`; each with ` (via <milestone>)` when inherited. The verdict `line` is `exit evidence recorded (<o>, evaluator <e>[, self-attributed | , self-attribution unknown])`, else `no declared blocker` when every effective prerequisite is satisfied, else `blocked (<each unsatisfied basis>; …)`; a record's `work.status` is printed as `status <value> (self-declared)` and is never a basis. The five state lines of each task: intent `superseded` when a record that supersedes the task is grounded by a live `@decision` stating `decision.choice` and `decision.effective-revision`, `accepted` when the task itself is, else `unknown`, naming the first live grounding decision's missing choice or effective revision, or that none grounds it (in this scope, on a narrowed one), the live decisions grounding a record being those no other of them supersedes, unless the two supersede each other through a cycle, which removes neither (revisions are compared by equality only, never ordered); definition `admitted` at the record's per-record digest, as every listed task is an admitted winner, so the plan's `rejected` cannot arise on a listed task: a `@task` admission refused has no record to list, and a whole-workspace view names it as an `admission` review item instead; realizable and realized `not applicable` (a task binds nothing and no effect owner realizes one); worked `observed success` or `observed refusal` for an observation at the current digest, `stale` for one whose subject-revision is the previous snapshot's digest, `unknown` for one at neither (or with no subject-revision, or another verdict), and `unobserved` when no observation names the task, `unknown` on a narrowed scope. Review items, each naming as owner the `head.steward` of the `@system` of the record it is about when the scope admits that system: `grounding`, two or more live `@decision` records grounding the plan or one of its milestones or tasks, the message naming those that supersede one another in a cycle; `currency`, two `@spec` records whose `work.status` is accepted, one superseding the other with no `work.replaced-scope` (a partial supersession keeps both live, and a draft or superseded spec is not current); and, on a whole-workspace scope only, `admission`, each `@plan`, `@milestone` or `@task` record admission refused that no admitted occurrence answers, with its path, line and reason, and each file a COMP-PARSE error refuses whole, without an owner, both naming `ia validate`. `next` is `ia position --seat <task> --shape sequence` for the first task in order whose verdict is `no declared blocker`, so tasks with exit evidence are skipped; it is null when every task has exit evidence or every other task is blocked, and `summary` says which, its every-task line reading `every task the view reads has exit evidence (<n> of <n>); <why>` while a task may go unread as above or admission refuses a `@milestone`, whose tasks the view then cannot list. The view is `{format: 'ia.delivery-view.v1', revision, plan, milestones, tasks, review, next, summary}`, milestones in the order their starts are emitted. `tests/next.test.ts` pins every refusal (from a `@task` seat with no admitted milestone too), the order (a cross-milestone requirement no milestone states, and a task a satisfied milestone releases ranked against tasks already ready), each verdict, refusal and inconclusive observations that are never exit evidence, stale evidence and each attribution, the later milestone's task blocked through its milestone and never recommended, an inherited requirement no admitted record answers and a target the task and its milestone both require listed once, a milestone-level cycle, skipped evidenced tasks, the all-evidenced, all-blocked and empty-plan summaries, review items (a supersede cycle, a superseded decision as no basis of intent, draft and superseded specs), a refused `@task` and a file a language error refuses, the band-100 rule, narrowed scopes (an out-of-scope requirement, task, observation, decision and owner-agent read as unknown, never met; plans and seats outside the scope neither counted nor read) that a view writes nothing, exit evidence at runtime placement (band 0) counted as authored evidence is, a conditional grounding and requirement read at orient, at act and with no phase bound, against graph traversal for the same scope and coordinate; a severity term on a record that states no severity read as traversal reads it, conditional and blocking at every phase, and provenance terms the stating record decides; a row that holds read before a conditional one, and a conditional supersession refused at admission; an intent a conditional grounding cannot change read as it reads at every phase (accepted beside the conditional grounding of a decision with no choice, or of an accepted decision earlier by identity, and superseded through a supersedor whose acceptance a conditional grounding cannot change), and one it changes read as unknown; a conditional requirement no admitted record answers, and one whose answer a narrowed scope leaves out, read only where it holds; a milestone's unconditional requirement of a target read before the task's conditional one, and satisfied once the target is evidenced; and the Door through a token `scope` binds to a phase, over `tests/fixtures/delivery/` laid over the conformance corpus, which carries no work records; tools/compliance runs one boundary fixture per code, once through `deliveryView` and once through the Door. The Door's `next` operation serves the view and its refusals unchanged (R12 version 2 refinement, next), the MCP door as `ia_next`, and the CLI as the consumer verb `ia next` (apps/cli/SPEC.md); `ia position`, which `next` and two refusals name, is a CLI verb too.
127
+ R18. Delivery view (2026-10-08): `src/next.ts`, exported from the package root and the `./internal/next` subpath, publishes `deliveryView(handle, within, seat?)` and `NEXT_CODES` with the `CycleRow`, `DeliveryMilestone`, `DeliveryResult`, `DeliveryTask`, `DeliveryView`, `ExitEvidence`, `NextCode`, `NextRefusal`, `Prerequisite`, `ReviewItem`, `StateDimension` and `StateLine` types. It is a pure function of the admitted records the scope token `within` reads: every read (the snapshot, directed views, one traversal, readiness) carries that token, so a narrowed scope lists only what it admits and prunes rows to it (db D09), and only a whole-workspace token (db `isCompleteScope`, PT5) also reads the admission findings it alone may disclose, `refused` and the report's COMP-PARSE findings; the view is computed per call, never stored, and nothing is written, the capture pair that `readiness` reads included; an unknown, stale or closed token keeps its database error. It returns `{ok: true, view}` or one refusal `{ok: false, code, message, next, plans?, cycle?}` whose `next` is exactly one command, as `readBody` returns its refusals as values. The plan is the seat's when a seat is given: a `@plan`, the plan a `@milestone`'s `work.plan` names, or that of a `@task`'s `work.milestone`; without one, the only admitted `@plan` at band 100. IA-RUNTIME-NEXT-SEAT refuses a seat the scope does not admit (next the view without a seat that runs: `ia next` while the scope admits one `@plan` at band 100, `ia next --seat <the first of them>` while it admits several, which `ia next` alone refuses, and `ia next --help` while it admits none) or that is not a `@plan`, `@milestone` or `@task` (next `ia position --seat <seat>`); IA-RUNTIME-NEXT-NO-PLAN a seat that belongs to no admitted plan, or no seat and no plan at band 100 (next `ia next --help`); IA-RUNTIME-NEXT-AMBIGUOUS no seat and several plans at band 100, listed in the message and in `plans` (next `ia next --seat <the first of them>`); IA-RUNTIME-NEXT-CYCLE `require` rows that form a cycle among the plan's tasks, milestones or both, listed in `cycle` as declared rows `{from, to, declaredOn, path, line}`, each `from` requiring its `to` (next `ia position --seat <the cycle's first task, else its first milestone> --shape sequence`). The runtime's own `next` keeps the commands above, which the Door and MCP callers receive; the consumer `ia next` builds its own next action (it names `ia preview plan` for a workspace that registers `@plan` and authors none, when the acting participant's mandate profile allows Verification and the word, and otherwise a command that profile allows). The plan's milestones are the `@milestone` records whose `work.plan` names it, and its tasks the `@task` records whose `work.milestone` names one of them (the reverse field index). Order: one topological sort, Kahn's algorithm, over the tasks and two vertices per milestone, its start (its prerequisites met) and its end (satisfied). A milestone's tasks follow its start and precede its end, its start precedes its end, and each declared `require` row between two records of the plan, in either spelling, makes the requiring record (a task, or a milestone's start) follow the required one (a task, or a milestone's end). Ready milestone vertices are emitted first and ready tasks by (milestone identity, task identity), so tasks come prerequisites first with ties by milestone then task: the order Kahn's algorithm gives over the task-level expansion (a task follows each task it requires, each task of a milestone it requires, and each prerequisite task of its milestone, required directly or through a required milestone's tasks), and a required milestone with no task still passes on its own prerequisites, so a cycle through it is refused too. Requirements outside the plan order nothing and remain basis lines. A relation row that carries a condition (2026-10-08), such as `requires @task guide when phase is act` or `grounds @task guide when phase is act`, counts only where its condition holds at the coordinate the scope binds, decided as graph traversal decides it: the coordinate is the phase db `resolveScope` binds the token to, or none (a scope binds no other condition axis), and graph `conditionHolds` decides each term, the condition's subject being the record that states the row (its `declaredOn`, the author graph G06 keeps as the edge's condition subject). A condition is decided where every coordinate the bound one may still be completed to (each axis it binds no value for absent, or set to each of its values) reads it alike, and undecided where two of them differ: `conditionHolds` reads provenance and artifact set from the subject alone, so the subject decides those terms; it reads severity as graph `effectiveSeverity`, the stronger of the subject's and the coordinate's (G08), so a severity term is decided only where the subject's own severity decides it at every coordinate (`when severity is blocking` on a blocking record holds everywhere, `when severity is advisory` on one fails everywhere) and is undecided otherwise, as on a record that states no severity, such as a `@task`; and a term on any other axis the scope binds no value for, such as the phase on a whole-workspace scope, is undecided. A row whose condition fails is no row: it orders nothing, is no requirement, grounding or supersession, and its declared line is not read as unanswered either. A row the scope does not decide, as one conditional on a phase on the whole-workspace scope `ia next` reads, or on a severity on any scope, is conditional with an unknown basis and is never satisfied: a conditional requirement orders nothing and is an unsatisfied prerequisite whatever its target's state, its basis `<word> <target>: conditional on <terms>, which the scope binds no <axes> to decide (unknown)`, the axes being those the bound coordinate leaves open, and one no admitted record answers reads `no admitted record answers it, conditional on …`. Intent is read at the bound coordinate with each undecided row read as no row; when that reading reads an undecided row that could change it (a grounding of the task, or of a supersedor, a supersession between two decisions grounding either, or a supersession of the task by a record that is or may be accepted), it is read again at each completion of the bound coordinate on the axes those rows leave open, where every row is decided, a record that a row holding at the bound coordinate names read before one only a conditional row names. The line that reads the same, value and basis, at every completion is the intent, since no binding the scope could take changes it and the conditional row is never read as satisfied: a decision with no choice that grounds the task only at act, beside one that grounds it with no condition and is accepted, leaves it `accepted`, and a supersession that holds, by a record one decision accepts at every completion, leaves it `superseded`. Else intent is `unknown`, its basis the first such row, `<record> grounds it conditional on …` or `<record> supersedes it conditional on …`, as it stays when the axes those rows leave open have more than 256 completions. Review items read rows that hold only. Of two rows to one counterpart the one that holds is read before a conditional one, and of two lines for one target a decided one before a conditional one. Field references carry no condition, so exit evidence, milestones, plans and owner-agents are read as before. Admission refuses a record that states a conditional `supersede` of a work record (each work-system word's supersede rule has cardinality one, which a condition would leave undecided: IA-COMP-EDGE-UNRESOLVED), so such a row is rare; one that reaches the view is read as above. A task's effective prerequisites are its own `require` targets, then its milestone's, each target once, an inherited one marked `via` that milestone. work-system consents `require` to a `@task`, `@milestone` or `@decision` target only (a `@task` that requires a `@spec` is refused at admission, IA-GRAPH-EDGE-UNCONSENTED), so no required-spec line arises; a requirement no admitted record answers, an admission warning with no row, is read from the traversal's dangling rows and is never satisfied; and a `require` the task or its milestone itself declares that gives neither a row nor a dangling edge in the scope, as when its answer is outside it (D09 prunes the row, and the traversal never crosses the scope), is never satisfied either, its state unknown. A requirement declared only on a record outside the scope is not read. A record's exit evidence is the first `@observation`, by identity, that its `work.exit-evidence` names or whose `evidence.subject` names it, whose `evidence.verdict` is success and whose `evidence.subject-revision` reads `current` under `readiness` (db D08) for that record; its evaluator is `evidence.evaluator`, and its `attribution` is `self` when that equals the identity the task's `work.owner-agent` names, `unknown` when the task states an owner-agent that no admitted `@agent` in the scope answers or the observation records no evaluator for a task that names one, else `other`. Basis lines: `decision <d>: choice made` or `no choice` (`decision.choice` stated or not); `task <t>: exit evidence <o>` or `no exit evidence`; `milestone <m>: exit evidence <o>` (its own), `every task has exit evidence`, `exit evidence missing for <n> of <k> tasks`, `no task and no exit evidence`, or `every task the view reads has exit evidence; records outside this scope are unknown` (a narrowed scope) or `…; records admission refused are unknown` (a whole-workspace scope while admission refuses a `@task`, whose `work.milestone` the view cannot read, or a file a language error refuses whole, db D03), neither of which satisfies it; `<reference>: no admitted record answers it`; `<reference>: no record in this scope answers it (unknown)`; each with ` (via <milestone>)` when inherited. The verdict `line` is `exit evidence recorded (<o>, evaluator <e>[, self-attributed | , self-attribution unknown])`, else `no declared blocker` when every effective prerequisite is satisfied, else `blocked (<each unsatisfied basis>; …)`; a record's `work.status` is printed as `status <value> (self-declared)` and is never a basis. The five state lines of each task: intent `superseded` when a record that supersedes the task is grounded by a live `@decision` stating `decision.choice` and `decision.effective-revision`, `accepted` when the task itself is, else `unknown`, naming the first live grounding decision's missing choice or effective revision, or that none grounds it (in this scope, on a narrowed one), the live decisions grounding a record being those no other of them supersedes, unless the two supersede each other through a cycle, which removes neither (revisions are compared by equality only, never ordered); definition `admitted` at the record's per-record digest, as every listed task is an admitted winner, so the plan's `rejected` cannot arise on a listed task: a `@task` admission refused has no record to list, and a whole-workspace view names it as an `admission` review item instead; realizable and realized `not applicable` (a task binds nothing and no effect owner realizes one); worked `observed success` or `observed refusal` for an observation at the current digest, `stale` for one whose subject-revision is the previous snapshot's digest, `unknown` for one at neither (or with no subject-revision, or another verdict), and `unobserved` when no observation names the task, `unknown` on a narrowed scope. Review items, each naming as owner the `head.steward` of the `@system` of the record it is about when the scope admits that system: `grounding`, two or more live `@decision` records grounding the plan or one of its milestones or tasks, the message naming those that supersede one another in a cycle; `currency`, two `@spec` records whose `work.status` is accepted, one superseding the other with no `work.replaced-scope` (a partial supersession keeps both live, and a draft or superseded spec is not current); and, on a whole-workspace scope only, `admission`, each `@plan`, `@milestone` or `@task` record admission refused that no admitted occurrence answers, with its path, line and reason, and each file a COMP-PARSE error refuses whole, without an owner, both naming `ia validate`. `next` is `ia position --seat <task> --shape sequence` for the first task in order whose verdict is `no declared blocker`, so tasks with exit evidence are skipped; it is null when every task has exit evidence or every other task is blocked, and `summary` says which, its every-task line reading `every task the view reads has exit evidence (<n> of <n>); <why>` while a task may go unread as above or admission refuses a `@milestone`, whose tasks the view then cannot list. The view is `{format: 'ia.delivery-view.v1', revision, plan, milestones, tasks, review, next, summary}` (`format: 'delivery-view', formatVersion: 1` once `WRITE_PLAIN_NAMES` flips), milestones in the order their starts are emitted. `tests/next.test.ts` pins every refusal (from a `@task` seat with no admitted milestone too), the order (a cross-milestone requirement no milestone states, and a task a satisfied milestone releases ranked against tasks already ready), each verdict, refusal and inconclusive observations that are never exit evidence, stale evidence and each attribution, the later milestone's task blocked through its milestone and never recommended, an inherited requirement no admitted record answers and a target the task and its milestone both require listed once, a milestone-level cycle, skipped evidenced tasks, the all-evidenced, all-blocked and empty-plan summaries, review items (a supersede cycle, a superseded decision as no basis of intent, draft and superseded specs), a refused `@task` and a file a language error refuses, the band-100 rule, narrowed scopes (an out-of-scope requirement, task, observation, decision and owner-agent read as unknown, never met; plans and seats outside the scope neither counted nor read) that a view writes nothing, exit evidence at runtime placement (band 0) counted as authored evidence is, a conditional grounding and requirement read at orient, at act and with no phase bound, against graph traversal for the same scope and coordinate; a severity term on a record that states no severity read as traversal reads it, conditional and blocking at every phase, and provenance terms the stating record decides; a row that holds read before a conditional one, and a conditional supersession refused at admission; an intent a conditional grounding cannot change read as it reads at every phase (accepted beside the conditional grounding of a decision with no choice, or of an accepted decision earlier by identity, and superseded through a supersedor whose acceptance a conditional grounding cannot change), and one it changes read as unknown; a conditional requirement no admitted record answers, and one whose answer a narrowed scope leaves out, read only where it holds; a milestone's unconditional requirement of a target read before the task's conditional one, and satisfied once the target is evidenced; and the Door through a token `scope` binds to a phase, over `tests/fixtures/delivery/` laid over the conformance corpus, which carries no work records; tools/compliance runs one boundary fixture per code, once through `deliveryView` and once through the Door. The Door's `next` operation serves the view and its refusals unchanged (R12 version 2 refinement, next), the MCP door as `ia_next`, and the CLI as the consumer verb `ia next` (apps/cli/SPEC.md); `ia position`, which `next` and two refusals name, is a CLI verb too.
124
128
 
125
- R19. Position packet (2026-10-08): `src/packet.ts`, exported from the package root and the `./internal/packet` subpath, publishes `renderPacket(handle, within, catalog)` and `entryCount(packet)` with the `PositionPacket`, `PacketCatalogRow`, `PacketSeat`, `PacketParticipant`, `PacketMandate`, `PacketSystem`, `PacketTally`, `PacketIntent`, `PacketPhase`, `PacketProvenance`, `PacketHostNote` and `PacketOutput` types; the root's `Packet` stays R03's context packet, so the position packet's type is `PositionPacket`. The packet is the one host-neutral thing a host adapter renders (an adapter may change file names, file count and markup, never content, ordering or numbers). `renderPacket` calls `position(handle, within)` (R16) once, at K0, and reads everything else through the same scope token: the snapshot and its D02a membership rows, directed views (db D09), the declared roots (db D02c) and the registered words (db D09a). A missing token is IA-RUNTIME-REQUEST-INVALID, an unknown, stale or closed one keeps its database code, and every other refusal is position's: the packet renders the records admission admitted and gates none of them, so an admitted mandate that `mandateAuthorityOf` would refuse, one with a child under an authority field or naming its participant or a scope with a fragment reference, renders as authored, and a mandate admission refuses, one declaring `moves []` among them since 2026-10-12 (compliance C05), renders as no mandate, never as a refusal. It returns the frozen `{packet, digest, hostNote}`, never merged: `digest` is graph's codec `digest` of the packet, and the host note is position's note `{revision, capturedRevision?, previousRevision?, freshness, key}` with `installed: 'unknown (no join checked here)'`, which carries no digest. The packet is `{format: 'ia.position-packet.v1', revision, body, seat, participants, mandates, systems, tallies, intents, phases, commands, lines, provenance}`. `revision` is the K0 body's and `body` position(K0)'s digest. `seat` is K0's seat, the repository's own `@workspace`: `{identity?, sources, systems, steward?, participants?}`, `identity` absent when no admitted `@workspace` is declared at the repository root (R14), `sources` its `composition.sources` entries as authored, `systems` N, `steward` its `composition.steward` reference, and `participants` the text `none (no authored @mandate names an @agent)` exactly when no participant is rendered. A reference the packet prints is the identity of the admitted record its typed field reference resolves to, or, when none does, the reference as authored (`@<word> <name>`). `mandates` are the entries of body(K0)'s `mandates` (R17) at band 100 whose `authority.participant` resolves to an admitted `@agent` at band 100, by identity, each `{identity, participant, moves?, scope, excludedWords?, covers?}`: `moves`, `excludedWords` and `covers` are its unconditional `authority.moves`, `authority.excluded-words` and `authority.covers` as authored, each present exactly when the record states the key (a declared `moves []` would be `moves: []`, but admission refuses it since 2026-10-12; `moves` absent restricts no move), and `scope` its `authority.scope` references. `participants` are those agents, each once, by identity, as `{identity, says?}` with its `meaning.says`; `composition.steward` names no participant, and P = 0 is a packet, not a refusal. `systems` holds one pointer line per `composition.systems` reference of the seat, by identity: for an admitted record `{identity, words, band, steward?, reach}`, `words` the words its `discriminators` rows (`<word> lowers to <kind>`) register, sorted, `steward` its `head.steward` when that resolves, and `reach` `ia position --seat <identity>` (a `@system` carries no source locator, so `ia read` gives only its head `describes`, not its words or steward); for a reference no admitted record answers `{identity: <the reference as authored>, words: 'unresolved', steward: 'unresolved'}`. `tallies` are `{word, count}` by word: the band-100 records whose capture membership root is one of the seat's own declared roots, R15's capture members of a workspace seat. A seat that declares no root has no tally, as body(K0)'s `sources` unknown says: its fallback closure is what a position may enter, not what the workspace captures. A fresh init's tallies so count what it authors under `.ia/src @authored` (workspace, agent and mandate, the installed base being band 90), and the conformance corpus, which declares no root, has none. `intents` are the five SHAPE_ROWS shapes in table order, `{shape, category, primitive, phase, kinds, lanes, predicates, priming, words}`: `phase` is the primitive's PRIMITIVE_ANCHORS phase, and `words` the registered words whose lowering has its kind in the shape's kinds or, over the kind and each of its facets, a graph `laneOf` lane in its lanes, as R15 seeds a record. The lowerings are read from the floor's two registrations and the admitted `@system` records' `discriminators` rows, the first by identity should two lower one word. `phases` are the four phases in cycle order, `{phase, primitives, changes}`: `primitives` are those PRIMITIVE_ANCHORS anchors at the phase, and `changes` the fixed line `--phase selects the playbook cell delivered and decides which conditional relation rows apply` (R15 and R18). `commands` are the `catalog` rows the caller passes, in its order, each copied as its five fields `{command, mode, move, refuses, next}`. The CLI's catalog is the COMMANDS rows it tags, which `packetCatalog` in apps/cli builds for its caller to pass, since this package may not import that app: apps/cli's `renderProjectionFor` passes it for `ia host`, `ia project`, `ia doctor` and the install, update and remove refresh, and `tools/projections/generate.ts` for this repository. LEGACY_OPERATIONS are no catalog rows. `lines` are the three SPEC-owned lines with `ia scope` read as `ia position`, without markup and without their `source: <CLI SPEC>@<version>` suffix, which would put a CLI version in the packet, then the session line naming the door's `ia_session`, the three lanes, `ia_catalogue` and `ia_method` (kit foundation, 2026-10-30). `provenance` is `{revision, slug?}`, `slug` the seat's name: identities stay as they are, and the repository slug is carried only here. The packet names no absolute path, scope token, time, capture state or CLI version, and no record at runtime placement is part of it (R15). Two roots so give byte-equal packets and digests, and a capture moves only the host note. `entryCount(packet)` is P participants + M mandates + 1 seat + N system lines + T tallies + 5 intent rows + 4 phase rows + C catalog rows + 1 provenance + 4 SPEC lines, the host note no entry. A fresh init (P = M = 1, T = 3) has 20 + C + N entries: 29 + N with the CLI's nine catalog rows. `tests/packet.test.ts` pins a golden packet in `tests/golden/` (revision and body digest masked and asserted apart; only `node packages/runtime/tests/golden/write.mjs` regenerates it) for the three records a fresh `ia init` authors (`tests/fixtures/packet/workspace.ia`) over the conformance corpus adopted at band 90, with 40 entries under a nine-row catalog fixture. It also pins the formula on that fixture, on the conformance corpus and on this repository's own records, its terms counted from the admitted records (N from the seat's `composition.systems`, T from the words of the band-100 membership rows under the seat's own declared roots, P and M from the band-100 mandates scoped to the seat whose participant is a band-100 agent) rather than from the packet, and pins these counts under the nine-row fixture: 29 on the conformance corpus and 54 on this repository after separating neutral examples from its live corpus, which its committed `CLAUDE.md` renders too; no participant and no refusal on the conformance corpus and for a mandate whose participant is adopted; two participants named by three mandates, each agent once and both by identity, with a mandate's excluded words and covers; a mandate declaring `moves []` refused by admission and rendered as no mandate, with position still running, and an admitted one with fragment references rendered with no refusal; an adopted mandate scoped to the seat left out; the tallies of a declared root narrower than the corpus, and none for a seat that declares no root; a narrowed scope token, which leaves out an @agent and a @system it does not admit (the system line `unresolved`, no participant or mandate, the steward as authored, no tally of the left-out word); a `@system` at runtime placement read as unresolved; a repository root no admitted `@workspace` is declared at, with no seat identity, system line, tally or slug; the frozen output, its intent rows copies of the kernel's; byte-equal packets and digests at two roots, naming neither root nor token; `body` equal to position(K0)'s digest; a capture moving the host note and neither the packet nor its digest; an unresolved `composition.systems` reference and system lines authored out of identity order; and the intent and phase tables, a word with an authority facet seeded under governance by its lane. apps/cli pins its catalog rows, each command's mode and move, a one-line refusal and one next command of COMMANDS.
129
+ R19. Position packet (2026-10-08): `src/packet.ts`, exported from the package root and the `./internal/packet` subpath, publishes `renderPacket(handle, within, catalog)` and `entryCount(packet)` with the `PositionPacket`, `PacketCatalogRow`, `PacketSeat`, `PacketParticipant`, `PacketMandate`, `PacketSystem`, `PacketTally`, `PacketIntent`, `PacketPhase`, `PacketProvenance`, `PacketHostNote` and `PacketOutput` types; the root's `Packet` stays R03's context packet, so the position packet's type is `PositionPacket`. The packet is the one host-neutral thing a host adapter renders (an adapter may change file names, file count and markup, never content, ordering or numbers). `renderPacket` calls `position(handle, within)` (R16) once, at K0, and reads everything else through the same scope token: the snapshot and its D02a membership rows, directed views (db D09), the declared roots (db D02c) and the registered words (db D09a). A missing token is IA-RUNTIME-REQUEST-INVALID, an unknown, stale or closed one keeps its database code, and every other refusal is position's: the packet renders the records admission admitted and gates none of them, so an admitted mandate that `mandateAuthorityOf` would refuse, one with a child under an authority field or naming its participant or a scope with a fragment reference, renders as authored, and a mandate admission refuses, one declaring `moves []` among them since 2026-10-12 (compliance C05), renders as no mandate, never as a refusal. It returns the frozen `{packet, digest, hostNote}`, never merged: `digest` is graph's codec `digest` of the packet, and the host note is position's note `{revision, capturedRevision?, previousRevision?, freshness, key}` with `installed: 'unknown (no join checked here)'`, which carries no digest. The packet is `{format: 'ia.position-packet.v1', revision, body, seat, participants, mandates, systems, tallies, intents, phases, commands, lines, provenance}` (`format: 'position-packet', formatVersion: 1` once `WRITE_PLAIN_NAMES` flips). `revision` is the K0 body's and `body` position(K0)'s digest. `seat` is K0's seat, the repository's own `@workspace`: `{identity?, sources, systems, steward?, participants?}`, `identity` absent when no admitted `@workspace` is declared at the repository root (R14), `sources` its `composition.sources` entries as authored, `systems` N, `steward` its `composition.steward` reference, and `participants` the text `none (no authored @mandate names an @agent)` exactly when no participant is rendered. A reference the packet prints is the identity of the admitted record its typed field reference resolves to, or, when none does, the reference as authored (`@<word> <name>`). `mandates` are the entries of body(K0)'s `mandates` (R17) at band 100 whose `authority.participant` resolves to an admitted `@agent` at band 100, by identity, each `{identity, participant, moves?, scope, excludedWords?, covers?}`: `moves`, `excludedWords` and `covers` are its unconditional `authority.moves`, `authority.excluded-words` and `authority.covers` as authored, each present exactly when the record states the key (a declared `moves []` would be `moves: []`, but admission refuses it since 2026-10-12; `moves` absent restricts no move), and `scope` its `authority.scope` references. `participants` are those agents, each once, by identity, as `{identity, says?}` with its `meaning.says`; `composition.steward` names no participant, and P = 0 is a packet, not a refusal. `systems` holds one pointer line per `composition.systems` reference of the seat, by identity: for an admitted record `{identity, words, band, steward?, reach}`, `words` the words its `discriminators` rows (`<word> lowers to <kind>`) register, sorted, `steward` its `head.steward` when that resolves, and `reach` `ia position --seat <identity>` (a `@system` carries no source locator, so `ia read` gives only its head `describes`, not its words or steward); for a reference no admitted record answers `{identity: <the reference as authored>, words: 'unresolved', steward: 'unresolved'}`. `tallies` are `{word, count}` by word: the band-100 records whose capture membership root is one of the seat's own declared roots, R15's capture members of a workspace seat. A seat that declares no root has no tally, as body(K0)'s `sources` unknown says: its fallback closure is what a position may enter, not what the workspace captures. A fresh init's tallies so count what it authors under `.ia/src @authored` (workspace, agent and mandate, the installed base being band 90), and the conformance corpus, which declares no root, has none. `intents` are the five SHAPE_ROWS shapes in table order, `{shape, category, primitive, phase, kinds, lanes, predicates, priming, words}`: `phase` is the primitive's PRIMITIVE_ANCHORS phase, and `words` the registered words whose lowering has its kind in the shape's kinds or, over the kind and each of its facets, a graph `laneOf` lane in its lanes, as R15 seeds a record. The lowerings are read from the floor's two registrations and the admitted `@system` records' `discriminators` rows, the first by identity should two lower one word. `phases` are the four phases in cycle order, `{phase, primitives, changes}`: `primitives` are those PRIMITIVE_ANCHORS anchors at the phase, and `changes` the fixed line `--phase selects the playbook cell delivered and decides which conditional relation rows apply` (R15 and R18). `commands` are the `catalog` rows the caller passes, in its order, each copied as its five fields `{command, mode, move, refuses, next}`. The CLI's catalog is the COMMANDS rows it tags, which `packetCatalog` in apps/cli builds for its caller to pass, since this package may not import that app: apps/cli's `renderProjectionFor` passes it for `ia host`, `ia project`, `ia doctor` and the install, update and remove refresh, and `tools/projections/generate.ts` for this repository. LEGACY_OPERATIONS are no catalog rows. `lines` are the three SPEC-owned lines with `ia scope` read as `ia position`, without markup and without their `source: <CLI SPEC>@<version>` suffix, which would put a CLI version in the packet, then the session line naming the door's `ia_session`, the three lanes, `ia_catalogue` and `ia_method` (kit foundation, 2026-10-30). `provenance` is `{revision, slug?}`, `slug` the seat's name: identities stay as they are, and the repository slug is carried only here. The packet names no absolute path, scope token, time, capture state or CLI version, and no record at runtime placement is part of it (R15). Two roots so give byte-equal packets and digests, and a capture moves only the host note. `entryCount(packet)` is P participants + M mandates + 1 seat + N system lines + T tallies + 5 intent rows + 4 phase rows + C catalog rows + 1 provenance + 4 SPEC lines, the host note no entry. A fresh init (P = M = 1, T = 3) has 20 + C + N entries: 29 + N with the CLI's nine catalog rows. `tests/packet.test.ts` pins a golden packet in `tests/golden/` (revision and body digest masked and asserted apart; only `node packages/runtime/tests/golden/write.mjs` regenerates it) for the three records a fresh `ia init` authors (`tests/fixtures/packet/workspace.ia`) over the conformance corpus adopted at band 90, with 40 entries under a nine-row catalog fixture. It also pins the formula on that fixture, on the conformance corpus and on this repository's own records, its terms counted from the admitted records (N from the seat's `composition.systems`, T from the words of the band-100 membership rows under the seat's own declared roots, P and M from the band-100 mandates scoped to the seat whose participant is a band-100 agent) rather than from the packet, and pins these counts under the nine-row fixture: 29 on the conformance corpus and 54 on this repository after separating neutral examples from its live corpus, which its committed `CLAUDE.md` renders too; no participant and no refusal on the conformance corpus and for a mandate whose participant is adopted; two participants named by three mandates, each agent once and both by identity, with a mandate's excluded words and covers; a mandate declaring `moves []` refused by admission and rendered as no mandate, with position still running, and an admitted one with fragment references rendered with no refusal; an adopted mandate scoped to the seat left out; the tallies of a declared root narrower than the corpus, and none for a seat that declares no root; a narrowed scope token, which leaves out an @agent and a @system it does not admit (the system line `unresolved`, no participant or mandate, the steward as authored, no tally of the left-out word); a `@system` at runtime placement read as unresolved; a repository root no admitted `@workspace` is declared at, with no seat identity, system line, tally or slug; the frozen output, its intent rows copies of the kernel's; byte-equal packets and digests at two roots, naming neither root nor token; `body` equal to position(K0)'s digest; a capture moving the host note and neither the packet nor its digest; an unresolved `composition.systems` reference and system lines authored out of identity order; and the intent and phase tables, a word with an authority facet seeded under governance by its lane. apps/cli pins its catalog rows, each command's mode and move, a one-line refusal and one next command of COMMANDS.
126
130
 
127
- R20. Host adapters (2026-10-09): `src/packet-host.ts`, exported from the package root and the `./internal/packet-host` subpath, publishes `renderHost(host, packet, digest, hostNote, target)` and `PACKET_MARKER` with the `PacketHost` (`claude` or `codex`), `PacketTarget` (`repository` or `consumer`), `HostFile`, `PacketReceipt` and `HostOutput` types. It renders one R19 packet, with the digest and host note `renderPacket` returned beside it, as the host's files and returns the frozen `HostOutput` `{files, receipt}`, each file `{path, text}` with a workspace-relative path. It is a pure function of its arguments and the package's own version, which it reads from its manifest: it reads no workspace and writes, deletes and plans no file, which the caller that applies does: apps/cli's `applyHostProjection` for a consumer workspace and `tools/projections/generate.ts` for this repository. An unknown host or target, or a `digest` that is not graph's codec digest of `packet`, is IA-RUNTIME-REQUEST-INVALID. No host is rendered an agent file (the system stewards are pointer lines, never agent definitions). The files by host and target: claude `consumer` `.claude/rules/ia-workspace.md` and `.claude/skills/ia-authoring/SKILL.md`; claude `repository` `CLAUDE.md`, `.claude/skills/ia-authoring/SKILL.md` and `.agents/skills/ia-authoring/SKILL.md`, the files this repository commits, which hold no steward agent; codex `AGENTS.md` and `.agents/skills/ia-authoring/SKILL.md` in either target, the `repository` entry file without the host note. Every file carries `PACKET_MARKER`, `<!-- Generated by ia project; edit the cited native records. -->`: first in the entry file, and in each `SKILL.md` after its YAML frontmatter and a blank line. The one generic `ia-authoring` skill per host stays (no skill is rendered per system or playbook), its text chosen by target, not host, byte for byte as compliance's 1.x renderers wrote it but for the marker line: the `repository` skill is renderHostArtifacts' and the `consumer` skill renderWorkspaceProjection's, its `Source revision` the packet's revision (both renderers are retired, compliance SPEC C22–C24). The entry file is the marker; then the packet's sections under the title `# IA position packet: <provenance slug>` (`# IA position packet` when the packet has no slug), in the packet's field order: the seat line, the participants, the mandates, the system pointer lines, the captured-record tallies, the intent table, the phase table, the command catalog and the SPEC lines, each an `## ` heading over its entries, one entry per list item or table body row, a section with no entry left out with its heading; then one provenance line `ia-generated <revision> <packet digest> <adapter>`, `<adapter>` being `ia-claude` or `ia-codex`, followed by `@<the package version>` in the `consumer` target only, so this repository's committed `CLAUDE.md` does not move when a release bumps the version; then, in the `consumer` target only, the section `## Host note (not part of the packet)` with the note's freshness, installed state and key, the key as `ia position` prints it (a location seat `''` as `.`). The entry file so renders exactly `entryCount(packet)` entries, the provenance line among them and the host note none. The rendering is markup only (an adapter changes file names, file count and markup, never content, ordering or numbers): every section value is printed in the packet's field order, except that the title prints the provenance slug, and `format`, `revision` and `body` are not printed apart, since the provenance line's revision and packet digest cover them and the receipt carries `body` as `bodyDigest`; identities, references, sources, covers paths and commands are code spans, each fenced past the backticks it holds; each bare IA word token in free text (an `@` and a word as the language spells one, `[a-z][a-z0-9-]*`, with no letter, digit, `_`, `.`, `-`, `/`, `@` or backtick before it and no word character, `-`, `/`, `@` or backtick after it, so neither an address, a scoped package such as `@inventarch/db` nor a token touching a backtick, which no fence could wrap without joining that run, and outside every authored code span, found as CommonMark finds one: a whole backtick run, its text and the next run of the same length) is a code span too, its fence one backtick or, when the value holds a backtick run no span closes, longer than every such run, and the authored span is kept as written whatever tokens it holds, so neither the committed `CLAUDE.md` nor a consumer file renders `@workspace` or `@plan` as a GitHub mention unless the author wrote it touching a backtick, the packet's values and entries unchanged; a line break in a value is printed as one space, so an entry stays one line; line folding scans in linear time even when long space/tab runs have no following line break, retaining all other bytes and the existing whitespace boundaries; a pipe in a table cell is escaped; an empty list prints `none`; and a seat without an identity prints `workspace undeclared`. The sections are byte-identical for both hosts and both targets: in one target the claude and codex entry files differ only in the adapter the provenance line names. The receipt is `{format: 'ia.packet-receipt.v1', host, cli, adapter, revision, slug, packetDigest, bodyDigest, entries, files, removed, foreign, guard, hostNote, participants, mandates, writtenAt}`: `adapter` the adapter id with the package version in either target, `revision` the packet's, `slug` the packet's provenance slug or null when it has none (the repository slug is kept in provenance and receipts, never in identities), `packetDigest` the digest passed, `bodyDigest` the packet's `body`, `entries` entryCount(packet), `files` each rendered file as `{path, sha256}` in render order with the SHA-256 of its UTF-8 text, `hostNote` a copy of the note, and `participants` and `mandates` the packet's identities. renderHost leaves `removed` and `foreign` empty, `guard` `none`, and `cli` and `writtenAt` null: the caller that applies the files sets them to the owned legacy files it deleted (each `{path, sha256}`), the files it left in place as foreign, `retired` when it retired a steward-guard registration first, its own id@version (only the applying CLI knows it) and the time it wrote, and writes the receipt beside the projection state (apps/cli `applyHostProjection`). The receipt carries no source digests and no consumer id@version per command invoked. `tests/packet-host.test.ts` pins both hosts and both targets on R19's fresh-init fixture packet and on this repository's own records: the file paths, none under `.claude/agents`; the title naming the slug; the marker first in each entry file and after each skill's frontmatter and a blank line; `entryCount(packet)` rendered entries with the sections in the packet's field order; byte-equal sections across hosts and targets; and each receipt's file digests. It also pins the repository skills equal to this repository's committed files, which `pnpm projections:generate` renders with this adapter and runtime:test hashes as inputs (tools/testing's `host-adapters` input profile); this repository's one participant and one mandate entry; on a fresh init, the consumer skill's text, the adapter version and the host note in the consumer target alone, and the receipt's adapter version in both; a hand-built packet rendered to exact text, with an unresolved system line, a multi-line non-ASCII `says`, a backtick in a path and a pipe in a catalog row, and one with no participant, seat identity, system line, tally or command; the host note's key with an identity seat and a word and with two location seats, the root printed `.`, and a code span a backtick starts or ends padded inside its fence; frozen output, byte-equal at two fresh-init roots and naming neither, the caller's note left unfrozen; each bare IA word token in a participant's `says`, a catalog row's refusal and a SPEC line rendered as a code span in every host and target, an address, a scoped package and a token already in an authored code span, opening it, after a space or a `[` inside it or beside another token in a double-backtick span, left as they are with the span, a token after a backtick no run closes fenced past it, and one touching such a backtick left as authored, no bare token left in the seat line of a packet without a participant or in this repository's packet, the entry count and the packet unchanged, and the receipt's slug null for a packet without one; and the three refusals.
131
+ R20. Host adapters (2026-10-09): `src/packet-host.ts`, exported from the package root and the `./internal/packet-host` subpath, publishes `renderHost(host, packet, digest, hostNote, target)` and `PACKET_MARKER` with the `PacketHost` (`claude` or `codex`), `PacketTarget` (`repository` or `consumer`), `HostFile`, `PacketReceipt` and `HostOutput` types. It renders one R19 packet, with the digest and host note `renderPacket` returned beside it, as the host's files and returns the frozen `HostOutput` `{files, receipt}`, each file `{path, text}` with a workspace-relative path. It is a pure function of its arguments and the package's own version, which it reads from its manifest: it reads no workspace and writes, deletes and plans no file, which the caller that applies does: apps/cli's `applyHostProjection` for a consumer workspace and `tools/projections/generate.ts` for this repository. An unknown host or target, or a `digest` that is not graph's codec digest of `packet`, is IA-RUNTIME-REQUEST-INVALID. No host is rendered an agent file (the system stewards are pointer lines, never agent definitions). The files by host and target: claude `consumer` `.claude/rules/ia-workspace.md` and `.claude/skills/ia-authoring/SKILL.md`; claude `repository` `CLAUDE.md`, `.claude/skills/ia-authoring/SKILL.md` and `.agents/skills/ia-authoring/SKILL.md`, the files this repository commits, which hold no steward agent; codex `AGENTS.md` and `.agents/skills/ia-authoring/SKILL.md` in either target, the `repository` entry file without the host note. Every file carries `PACKET_MARKER`, `<!-- Generated by ia project; edit the cited native records. -->`: first in the entry file, and in each `SKILL.md` after its YAML frontmatter and a blank line. The one generic `ia-authoring` skill per host stays (no skill is rendered per system or playbook), its text chosen by target, not host, byte for byte as compliance's 1.x renderers wrote it but for the marker line: the `repository` skill is renderHostArtifacts' and the `consumer` skill renderWorkspaceProjection's, its `Source revision` the packet's revision (both renderers are retired, compliance SPEC C22–C24). The entry file is the marker; then the packet's sections under the title `# IA position packet: <provenance slug>` (`# IA position packet` when the packet has no slug), in the packet's field order: the seat line, the participants, the mandates, the system pointer lines, the captured-record tallies, the intent table, the phase table, the command catalog and the SPEC lines, each an `## ` heading over its entries, one entry per list item or table body row, a section with no entry left out with its heading; then one provenance line `ia-generated <revision> <packet digest> <adapter>`, `<adapter>` being `ia-claude` or `ia-codex`, followed by `@<the package version>` in the `consumer` target only, so this repository's committed `CLAUDE.md` does not move when a release bumps the version; then, in the `consumer` target only, the section `## Host note (not part of the packet)` with the note's freshness, installed state and key, the key as `ia position` prints it (a location seat `''` as `.`). The entry file so renders exactly `entryCount(packet)` entries, the provenance line among them and the host note none. The rendering is markup only (an adapter changes file names, file count and markup, never content, ordering or numbers): every section value is printed in the packet's field order, except that the title prints the provenance slug, and `format`, `revision` and `body` are not printed apart, since the provenance line's revision and packet digest cover them and the receipt carries `body` as `bodyDigest`; identities, references, sources, covers paths and commands are code spans, each fenced past the backticks it holds; each bare IA word token in free text (an `@` and a word as the language spells one, `[a-z][a-z0-9-]*`, with no letter, digit, `_`, `.`, `-`, `/`, `@` or backtick before it and no word character, `-`, `/`, `@` or backtick after it, so neither an address, a scoped package such as `@inventarch/db` nor a token touching a backtick, which no fence could wrap without joining that run, and outside every authored code span, found as CommonMark finds one: a whole backtick run, its text and the next run of the same length) is a code span too, its fence one backtick or, when the value holds a backtick run no span closes, longer than every such run, and the authored span is kept as written whatever tokens it holds, so neither the committed `CLAUDE.md` nor a consumer file renders `@workspace` or `@plan` as a GitHub mention unless the author wrote it touching a backtick, the packet's values and entries unchanged; a line break in a value is printed as one space, so an entry stays one line; line folding scans in linear time even when long space/tab runs have no following line break, retaining all other bytes and the existing whitespace boundaries; a pipe in a table cell is escaped; an empty list prints `none`; and a seat without an identity prints `workspace undeclared`. The sections are byte-identical for both hosts and both targets: in one target the claude and codex entry files differ only in the adapter the provenance line names. The receipt is `{format: 'ia.packet-receipt.v1', host, cli, adapter, revision, slug, packetDigest, bodyDigest, entries, files, removed, foreign, guard, hostNote, participants, mandates, writtenAt}` (`format: 'packet-receipt', formatVersion: 1` once `WRITE_PLAIN_NAMES` flips): `adapter` the adapter id with the package version in either target, `revision` the packet's, `slug` the packet's provenance slug or null when it has none (the repository slug is kept in provenance and receipts, never in identities), `packetDigest` the digest passed, `bodyDigest` the packet's `body`, `entries` entryCount(packet), `files` each rendered file as `{path, sha256}` in render order with the SHA-256 of its UTF-8 text, `hostNote` a copy of the note, and `participants` and `mandates` the packet's identities. renderHost leaves `removed` and `foreign` empty, `guard` `none`, and `cli` and `writtenAt` null: the caller that applies the files sets them to the owned legacy files it deleted (each `{path, sha256}`), the files it left in place as foreign, `retired` when it retired a steward-guard registration first, its own id@version (only the applying CLI knows it) and the time it wrote, and writes the receipt beside the projection state (apps/cli `applyHostProjection`). The receipt carries no source digests and no consumer id@version per command invoked. `tests/packet-host.test.ts` pins both hosts and both targets on R19's fresh-init fixture packet and on this repository's own records: the file paths, none under `.claude/agents`; the title naming the slug; the marker first in each entry file and after each skill's frontmatter and a blank line; `entryCount(packet)` rendered entries with the sections in the packet's field order; byte-equal sections across hosts and targets; and each receipt's file digests. It also pins the repository skills equal to this repository's committed files, which `pnpm projections:generate` renders with this adapter and runtime:test hashes as inputs (tools/testing's `host-adapters` input profile); this repository's one participant and one mandate entry; on a fresh init, the consumer skill's text, the adapter version and the host note in the consumer target alone, and the receipt's adapter version in both; a hand-built packet rendered to exact text, with an unresolved system line, a multi-line non-ASCII `says`, a backtick in a path and a pipe in a catalog row, and one with no participant, seat identity, system line, tally or command; the host note's key with an identity seat and a word and with two location seats, the root printed `.`, and a code span a backtick starts or ends padded inside its fence; frozen output, byte-equal at two fresh-init roots and naming neither, the caller's note left unfrozen; each bare IA word token in a participant's `says`, a catalog row's refusal and a SPEC line rendered as a code span in every host and target, an address, a scoped package and a token already in an authored code span, opening it, after a space or a `[` inside it or beside another token in a double-backtick span, left as they are with the span, a token after a backtick no run closes fenced past it, and one touching such a backtick left as authored, no bare token left in the seat line of a packet without a participant or in this repository's packet, the entry count and the packet unchanged, and the receipt's slug null for a packet without one; and the three refusals.
128
132
 
129
133
  R20 authored-generation refinement (2026-10-11): `PacketReceipt` gains five optional sections, `generated` (`GeneratedRow`: identity, word `agent-profile` or `playbook`, path and SHA-256 of each generated file), `definitions` (`PacketDefinition`, a union of `{word: 'operation', definition: OperationDefinition}` and `{word: 'harness', definition: HarnessDefinition}`, whose registration rows are `RegistrationRow` and `HostHookDeclaration`), `hooks` (`HookGroupRow`: each registered group's `@hook` identity, the tools that hook declares and the SHA-256 of the group as written), `removedHooks` (`RemovedHookRow`: each group the apply removed, by `@hook` and the SHA-256 of the group as last registered) and `unsupported` (`UnsupportedRow`: identity, word `agent-profile`, `playbook` or `hook`, and reason), and `HostOutput` an optional `hooks` (`HostHookDeclaration`: identity, `PreToolUse`, the edit tools, the path selections and the message, from which a registration derives a fixed command and never authored shell text); the word unions (`GeneratedFileWord`, `GeneratedRecordWord`, `DefinitionWord`, `HookToolName`) are stated once, and the types are exported from the package root. `renderHost` fills none of them and its output is unchanged; ownership stays the projection state, and the CLI's projection writer, which applies the generated set, fills them; `removed` then also lists the generated files it deleted. The `./internal/packet-host` subpath exports `inline`, `code` and `prose`, the linear line folding, code span and IA-word code span helpers the entry file is written with, which workspace-runtime's host generators reuse so generated files write free text as the packet does.
130
134
 
package/dist/index.d.ts CHANGED
@@ -10,7 +10,7 @@ export { position, positionBody } from './position.js';
10
10
  export type { AppliesByWord, Freshness, FrontierTally, HostNote, LoadedEntry, LoadedPlace, LoadedRecord, OmittedRule, PointerTally, PositionBody, PositionCell, PositionCounts, PositionOutput, PositionPointer, PositionRecord, PositionUnknown, PositionVia, PositionWidening, RuleRecord, SubjectMatch, } from './position.js';
11
11
  export { entryCount, renderPacket } from './packet.js';
12
12
  export type { PacketCatalogRow, PacketHostNote, PacketIntent, PacketMandate, PacketOutput, PacketParticipant, PacketPhase, PacketProvenance, PacketSeat, PacketSystem, PacketTally, PositionPacket, } from './packet.js';
13
- export { PACKET_MARKER, renderHost } from './packet-host.js';
13
+ export { PACKET_HOSTS, PACKET_MARKER, renderHost } from './packet-host.js';
14
14
  export type { DefinitionWord, GeneratedFileWord, GeneratedRecordWord, GeneratedRow, HarnessDefinition, HookGroupRow, RemovedHookRow, HookToolName, UnsupportedRow, HostFile, HostOutput, HostHookDeclaration, OperationDefinition, PacketDefinition, PacketHost, PacketReceipt, PacketTarget, RegistrationRow, } from './packet-host.js';
15
15
  export { context, DEFAULT_TOKENIZER } from './context.js';
16
16
  export type { ContextRequest, ContextResult, ContextOptions, Budget, Tokenizer, Packet, Entry, Clause, Citation, Omission, Refusal, } from './types.js';
@@ -32,7 +32,7 @@ export type { CandidateEnvelope, CandidateScope, CandidateValidation } from './c
32
32
  export { PUBLICATION_CODES, PublicationError, portableDraftPath, qualifyPublicationRoot, preparePublication, inspectPublication, } from './publication.js';
33
33
  export type { PublicationFile, PreparedPublication, PublicationStatus } from './publication.js';
34
34
  export { isEntry } from './entry.js';
35
- export { MANDATE_CODES, MODES, MODE_MOVES, MOVES, defaultActor, governingMandates, isAdmissionRefusal, isMode, mandateAuthorityOf, mandateRefusal, profileRefusal, refusedDependencies, refusedMandates, requireMandatesAdmitted, rootWorkspace, seatedWorkspace, } from './mandate-modes.js';
35
+ export { MANDATE_CODES, MODES, MODE_MOVES, MOVES, defaultActor, governingMandates, governingWorkspace, isAdmissionRefusal, isMode, mandateAuthorityOf, mandateRefusal, profileRefusal, refusedDependencies, refusedMandates, requireMandatesAdmitted, rootWorkspace, seatedWorkspace, } from './mandate-modes.js';
36
36
  export type { DefaultActor, GoverningMandate, GoverningOptions, MandateAuthority, MandateCode, MandateRefusal, Mode, Move, ProfileMandate, ProfileVerdict, RefusedDependency, RefusedMandate, } from './mandate-modes.js';
37
37
  export { READ_CODES, SOURCE_LOCATORS, parseLocator, readBody } from './locator.js';
38
38
  export type { Locator, ReadBody, ReadBodyOptions, ReadCode, ReadRefusal, ReadResult } from './locator.js';
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC/E,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACzE,YAAY,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACxE,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACzF,OAAO,EAAE,EAAE,EAAE,cAAc,EAAE,iBAAiB,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACtG,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/E,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AACvD,YAAY,EACV,aAAa,EACb,SAAS,EACT,aAAa,EACb,QAAQ,EACR,WAAW,EACX,WAAW,EACX,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,cAAc,EACd,eAAe,EACf,cAAc,EACd,eAAe,EACf,WAAW,EACX,gBAAgB,EAChB,UAAU,EACV,YAAY,GACb,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACvD,YAAY,EACV,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,WAAW,EACX,gBAAgB,EAChB,UAAU,EACV,YAAY,EACZ,WAAW,EACX,cAAc,GACf,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC7D,YAAY,EACV,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,YAAY,EACZ,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,cAAc,EACd,QAAQ,EACR,UAAU,EACV,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,UAAU,EACV,aAAa,EACb,YAAY,EACZ,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAC1D,YAAY,EACV,cAAc,EACd,aAAa,EACb,cAAc,EACd,MAAM,EACN,SAAS,EACT,MAAM,EACN,KAAK,EACL,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,OAAO,GACR,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EAAE,IAAI,IAAI,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACtD,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACtG,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACtE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,YAAY,EACV,UAAU,EACV,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,GAChB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC3D,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC5E,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAClH,YAAY,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACpF,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC7F,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,sBAAsB,EACtB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,eAAe,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAChG,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EACL,aAAa,EACb,KAAK,EACL,UAAU,EACV,KAAK,EACL,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAClB,MAAM,EACN,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,uBAAuB,EACvB,aAAa,EACb,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,IAAI,EACJ,IAAI,EACJ,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,cAAc,GACf,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACnF,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1G,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACrD,YAAY,EACV,QAAQ,EACR,iBAAiB,EACjB,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,UAAU,EACV,cAAc,EACd,SAAS,GACV,MAAM,WAAW,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC/E,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACzE,YAAY,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACxE,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACzF,OAAO,EAAE,EAAE,EAAE,cAAc,EAAE,iBAAiB,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACtG,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/E,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AACvD,YAAY,EACV,aAAa,EACb,SAAS,EACT,aAAa,EACb,QAAQ,EACR,WAAW,EACX,WAAW,EACX,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,cAAc,EACd,eAAe,EACf,cAAc,EACd,eAAe,EACf,WAAW,EACX,gBAAgB,EAChB,UAAU,EACV,YAAY,GACb,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACvD,YAAY,EACV,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,WAAW,EACX,gBAAgB,EAChB,UAAU,EACV,YAAY,EACZ,WAAW,EACX,cAAc,GACf,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC3E,YAAY,EACV,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,YAAY,EACZ,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,cAAc,EACd,QAAQ,EACR,UAAU,EACV,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,UAAU,EACV,aAAa,EACb,YAAY,EACZ,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAC1D,YAAY,EACV,cAAc,EACd,aAAa,EACb,cAAc,EACd,MAAM,EACN,SAAS,EACT,MAAM,EACN,KAAK,EACL,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,OAAO,GACR,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EAAE,IAAI,IAAI,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACtD,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACtG,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACtE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,YAAY,EACV,UAAU,EACV,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,GAChB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC3D,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC5E,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAClH,YAAY,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACpF,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC7F,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,sBAAsB,EACtB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,eAAe,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAChG,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EACL,aAAa,EACb,KAAK,EACL,UAAU,EACV,KAAK,EACL,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,MAAM,EACN,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,uBAAuB,EACvB,aAAa,EACb,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,IAAI,EACJ,IAAI,EACJ,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,cAAc,GACf,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACnF,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1G,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACrD,YAAY,EACV,QAAQ,EACR,iBAAiB,EACjB,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,UAAU,EACV,cAAc,EACd,SAAS,GACV,MAAM,WAAW,CAAC"}
package/dist/index.js CHANGED
@@ -4,7 +4,7 @@ export { prepareCoordinate, COORDINATE_DOMAINS } from './coordinate.js';
4
4
  export { K0, SCOPE_KEY_CAPS, normalizeScopeKey, resolveScopeKey, rootRelative } from './scope-key.js';
5
5
  export { position, positionBody } from './position.js';
6
6
  export { entryCount, renderPacket } from './packet.js';
7
- export { PACKET_MARKER, renderHost } from './packet-host.js';
7
+ export { PACKET_HOSTS, PACKET_MARKER, renderHost } from './packet-host.js';
8
8
  export { context, DEFAULT_TOKENIZER } from './context.js';
9
9
  export { select } from './select.js';
10
10
  export { open as openDatabase } from '@inventarch/db';
@@ -16,7 +16,7 @@ export { admissionReport, inertCommandRoot, evaluateMandateGuard, mandateGuardSe
16
16
  export { validateCandidate } from './candidate.js';
17
17
  export { PUBLICATION_CODES, PublicationError, portableDraftPath, qualifyPublicationRoot, preparePublication, inspectPublication, } from './publication.js';
18
18
  export { isEntry } from './entry.js';
19
- export { MANDATE_CODES, MODES, MODE_MOVES, MOVES, defaultActor, governingMandates, isAdmissionRefusal, isMode, mandateAuthorityOf, mandateRefusal, profileRefusal, refusedDependencies, refusedMandates, requireMandatesAdmitted, rootWorkspace, seatedWorkspace, } from './mandate-modes.js';
19
+ export { MANDATE_CODES, MODES, MODE_MOVES, MOVES, defaultActor, governingMandates, governingWorkspace, isAdmissionRefusal, isMode, mandateAuthorityOf, mandateRefusal, profileRefusal, refusedDependencies, refusedMandates, requireMandatesAdmitted, rootWorkspace, seatedWorkspace, } from './mandate-modes.js';
20
20
  // The markdown and fragment helpers stay on the ./internal/locator subpath; the root names the reader and its terms.
21
21
  export { READ_CODES, SOURCE_LOCATORS, parseLocator, readBody } from './locator.js';
22
22
  export { NEXT_CODES, deliveryView } from './next.js';
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE/E,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEzE,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAExE,OAAO,EAAE,EAAE,EAAE,cAAc,EAAE,iBAAiB,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEtG,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAuBvD,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAevD,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAqB7D,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAc1D,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EAAE,IAAI,IAAI,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEtD,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACtE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAQzD,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE3D,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAElH,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnD,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,sBAAsB,EACtB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EACL,aAAa,EACb,KAAK,EACL,UAAU,EACV,KAAK,EACL,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAClB,MAAM,EACN,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,uBAAuB,EACvB,aAAa,EACb,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAe5B,qHAAqH;AACrH,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAEnF,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE/E,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEzE,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAExE,OAAO,EAAE,EAAE,EAAE,cAAc,EAAE,iBAAiB,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEtG,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAuBvD,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAevD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAqB3E,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAc1D,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EAAE,IAAI,IAAI,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEtD,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACtE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAQzD,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE3D,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAElH,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnD,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,sBAAsB,EACtB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EACL,aAAa,EACb,KAAK,EACL,UAAU,EACV,KAAK,EACL,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,MAAM,EACN,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,uBAAuB,EACvB,aAAa,EACb,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAe5B,qHAAqH;AACrH,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAEnF,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC"}
@@ -1 +1 @@
1
- {"version":3,"file":"machine-protocol.d.ts","sourceRoot":"","sources":["../src/machine-protocol.ts"],"names":[],"mappings":"AAgBA,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAC3D,MAAM,WAAW,eAAe;IAC9B,mFAAmF;IACnF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AACD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,SAAS,eAAe,EAAE,CAAC;IAC9C,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACpD,wFAAwF;IACxF,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B;;;OAGG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,sGAAsG;IACtG,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AACD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AACD,MAAM,WAAW,eAAe;IAC9B,sGAAsG;IACtG,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAClD,QAAQ,CAAC,WAAW,EAAE,SAAS,kBAAkB,EAAE,CAAC;CACrD;AAuID,sGAAsG;AACtG,eAAO,MAAM,gBAAgB,EAAE,eAoZ7B,CAAC"}
1
+ {"version":3,"file":"machine-protocol.d.ts","sourceRoot":"","sources":["../src/machine-protocol.ts"],"names":[],"mappings":"AAiBA,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAC3D,MAAM,WAAW,eAAe;IAC9B,mFAAmF;IACnF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AACD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,SAAS,eAAe,EAAE,CAAC;IAC9C,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACpD,wFAAwF;IACxF,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B;;;OAGG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,sGAAsG;IACtG,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AACD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AACD,MAAM,WAAW,eAAe;IAC9B,sGAAsG;IACtG,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAClD,QAAQ,CAAC,WAAW,EAAE,SAAS,kBAAkB,EAAE,CAAC;CACrD;AAuID,sGAAsG;AACtG,eAAO,MAAM,gBAAgB,EAAE,eAwZ7B,CAAC"}