@inventarch/runtime 3.1.1 → 3.2.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.
package/LANGUAGE.md CHANGED
@@ -22,7 +22,7 @@ Spec source locators do not load documents. Resource capture and disclosure requ
22
22
  | @convention | governance-system | Declares a convention in the shared governance shape. |
23
23
  | @decision | work-system | Represents a choice that is needed or has been made: the question, options and decider, and once made, the choice and rationale. |
24
24
  | @dimension | taxonomy | Defines a supported record dimension used by conditions and lookup. |
25
- | @distribution | workspace-system | Declares root records from which a distributable closure is selected. |
25
+ | @distribution | workspace-system | Declares root records from which a distributable closure is selected, and optionally the host plugin product it describes. |
26
26
  | @execution-binding | agent-composition-system | Connects a native target to a host-installed entry or operation descriptor. |
27
27
  | @harness | agent-composition-system | Composes profiles and execution bindings in a workspace under a host contract. |
28
28
  | @hook | hook-authoring-system | Represents a host event, tool/path selection and guard message. Registration and executing a guard require a host adapter. |
@@ -40,7 +40,7 @@ Spec source locators do not load documents. Resource capture and disclosure requ
40
40
  | @placement | taxonomy | Defines source authority and reach metadata. |
41
41
  | @plan | work-system | Represents an arrangement of milestones toward an intent; it heads the work hierarchy and has no parent. Plans do not nest. |
42
42
  | @playbook | governance-system | Represents a procedure as phase/primitive cells. Cell delivery is generic; the authored method belongs to its author. |
43
- | @predicate | taxonomy | Defines a directed relationship and its inverse spelling. |
43
+ | @predicate | taxonomy | Defines a directed relationship, its inverse spelling and its present phrase. |
44
44
  | @primitive | taxonomy | Defines a cognitive primitive coordinate; a cell is selected using its phase and primitive. |
45
45
  | @principle | governance-system | Declares a governing rationale in the shared governance shape. |
46
46
  | @run | session-system | Represents a governed run identity, declared phase, status and owner. Declaration does not start execution. |
package/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # @inventarch/runtime
2
2
 
3
- [![npm](https://img.shields.io/npm/v/@inventarch/runtime?label=npm)](https://www.npmjs.com/package/@inventarch/runtime) [![Public quality](https://github.com/inventarch/ia/actions/workflows/platform-quality.yml/badge.svg?branch=main)](https://github.com/inventarch/ia/actions/workflows/platform-quality.yml) [![License](https://img.shields.io/badge/license-Apache--2.0-green)](LICENSE) [![Node](https://img.shields.io/badge/node-22.x-brightgreen)](package.json)
3
+ [![npm](https://img.shields.io/npm/v/@inventarch/runtime?label=npm)](https://www.npmjs.com/package/@inventarch/runtime) [![Public quality](https://github.com/inventarch/ia/actions/workflows/platform-quality.yml/badge.svg?branch=main)](https://github.com/inventarch/ia/actions/workflows/platform-quality.yml) [![License](https://img.shields.io/badge/license-Apache--2.0-green)](LICENSE) [![Node](https://img.shields.io/badge/node-%3E%3D22.22.0%20%3C23-brightgreen)](package.json)
4
4
 
5
5
  > `@inventarch/runtime` turns scoped [`@inventarch/db`](../db/README.md) reads into what agents and hosts consume: position bodies, plan delivery views, record bodies, the position packet for Claude Code and Codex, mandate resolution and the Door machine protocol. `ia position`, `ia next` and `ia read`, the MCP server and the VS Code extension are built on it.
6
6
 
@@ -16,7 +16,7 @@ Read a position and a plan's delivery view from the workspace in the [root READM
16
16
  import { open } from '@inventarch/db';
17
17
  import { deliveryView, position } from '@inventarch/runtime';
18
18
 
19
- const workspace = open('path/to/your-project', { cache: false, checks: 'structural' });
19
+ const workspace = open('path/to/your-project', { cache: false });
20
20
  try {
21
21
  const { token } = workspace.resolveScope();
22
22
  const { body } = position(workspace, token, {
@@ -39,7 +39,7 @@ plan [
39
39
  ia position --seat work-system/definition/task/write-schema --shape sequence
40
40
  ```
41
41
 
42
- `position` completes a partial scope key (the `sequence` shape implies the `plan` phase, with depth 1 and budget 16 by default) and returns `{body, digest, hostNote}`. The body and its digest are a pure function of the key and the admitted records; the host note carries the revisions and capture freshness outside the digest. `deliveryView` returns `{ok: true, view}`, or a refusal that names the one command to run next.
42
+ `position` completes a partial scope key (the `sequence` shape implies the `plan` phase, with depth 1 and budget 16 by default) and returns `{body, digest, hostNote}`. The body and its digest are a pure function of the key and the admitted records; the host note carries the revisions and capture freshness outside the digest. `deliveryView` returns `{ok: true, view}`, or a refusal that names the one command to run next. `open` admits `@check` records strictly by default, as `ia position` and `ia next` do, so the script reads what those commands print.
43
43
 
44
44
  ## 🧭 What it does
45
45
 
@@ -48,11 +48,12 @@ ia position --seat work-system/definition/task/write-schema --shape sequence
48
48
  | `position`, `positionBody`, `normalizeScopeKey`, `resolveScopeKey`, `K0`, `SCOPE_KEY_CAPS` | The body `ia position` prints for a scope key of seat, shape, phase, depth, budget and word. |
49
49
  | `deliveryView`, `NEXT_CODES` | The plan view `ia next` prints: tasks in prerequisite order, each with a verdict from recorded exit evidence, and the next `ia position` command. |
50
50
  | `readBody`, `parseLocator` | The body behind an identity, cell, requirement or source locator, with its SHA-256, as `ia read` prints it. |
51
- | `Door`, `MACHINE_PROTOCOL` | The structured read protocol behind the CLI's machine commands and the MCP server: nine version 1 operations, plus `read`, `next` and `position` since version 2. |
51
+ | `Door`, `MACHINE_PROTOCOL` | The structured read protocol behind the CLI's machine commands and the MCP server: nine version 1 operations, plus `read`, `next` and `position` since version 2. `new Door(root, options)` owns a handle; `door.request({operation, params})` returns `{ok: true, result}` or a refusal, and `door.close()` ends it. |
52
+ | `RuntimeError`, `RUNTIME_CODES` | Thrown refusals. Each has a `code` from `RUNTIME_CODES`; a scope-key refusal adds `next`, the one command to run, and a mandate refusal adds `where`. `readBody` and `deliveryView` return their own refusals as `{ok: false, code, message, …}` values, the Door returns every refusal that way, and a token failure keeps its `IA-DB-*` code. |
52
53
  | `context`, `select`, `prepareCoordinate`, `classify` | Coordinate-based context packets that reserve blocking governance first, and selection among explicit candidates. |
53
54
  | `renderPacket`, `renderHost`, `PACKET_MARKER` | Build the host-neutral position packet and render it for `claude` or `codex` as files and a receipt. |
54
55
  | `governingMandates`, `defaultActor`, `profileRefusal`, `evaluateMandateGuard`, `MOVES`, `MODE_MOVES` | Resolve the `@mandate` records that govern an actor, and judge a command mode or a guarded edit against them. |
55
- | `preparePublication`, `inspectPublication`, `validateCandidate` | Publish generated drafts create-only, and validate candidate files against the sources a host disclosed. |
56
+ | `preparePublication`, `inspectPublication`, `validateCandidate` | Publish generated drafts create-only on a local Windows NTFS volume, and validate candidate files against the sources a host disclosed. `qualifyPublicationRoot` checks a root first; every other platform or filesystem refuses with `IA-PUBLICATION-UNAVAILABLE`. |
56
57
  | `@inventarch/runtime/editor` | `EditorWorkspace` for editors (overlays, diagnostics, completion and source actions), with language's single-record edit helpers. |
57
58
  | `@inventarch/runtime/authoring` | Version 1 remote authoring request, proposal, receipt, event and chat contracts, and a bounded HTTPS client. |
58
59
  | `@inventarch/runtime/authoring-execution` | Guarded dispatch of authoring operations from a fixed catalog the host supplies. |
@@ -62,8 +63,8 @@ The `./internal/*` subpaths serve specific toolchain consumers and are not a sta
62
63
 
63
64
  ## ⚖️ What it does not do
64
65
 
65
- - **It writes no source.** `position`, `deliveryView`, `readBody`, `renderPacket` and `renderHost` write nothing; the CLI writes projection files. Publication is the one writer: create-only files under a host-selected `.ia/work/generated/<id>` directory, never `.ia/src`.
66
- - **It runs nothing.** The Door makes no source writes, model calls, sessions or capability dispatch. A delivery view reads verdicts from recorded evidence and never executes a task, and what a scope does not read never counts as met.
66
+ - **It writes no source.** `position`, `deliveryView`, `readBody`, `renderPacket` and `renderHost` write nothing; the CLI writes projection files. Publication is the one writer: create-only files under a host-selected `.ia/work/generated/<id>` directory, staged in `.ia/work/generated/.stage-*` under a per-destination SQLite lock in `.ia/work/publication-locks/`, never `.ia/src`.
67
+ - **Its reads run nothing.** The Door makes no source writes, model calls, sessions or capability dispatch. A delivery view reads verdicts from recorded evidence and never executes a task, and what a scope does not read never counts as met. Only `./authoring-execution` calls the handlers a host's catalog supplies, `gitFiles` runs `git ls-files`, `qualifyPublicationRoot` runs a PowerShell volume probe, and `./authoring` makes HTTPS requests to the service a host configures.
67
68
  - **A position takes no free text.** Request text is refused as a scope key part, so nothing text-driven decides what a position loads.
68
69
  - **Mandates are cooperative restrictions.** Mandate resolution reads authored declarations; it authenticates no one and grants no host permission. A `@mandate` that fails admission fails every mandate-gated decision closed.
69
70
  - **Remote authoring needs a separate service.** `./authoring` validates and transports messages; the service owns authentication, authorization, persisted runs and model execution, and the application owns credentials and effects.
package/SPEC.md CHANGED
@@ -6,17 +6,17 @@
6
6
 
7
7
  `context` accepts `ContextOptions.ranking` and the Door accepts `params.ranking`: `native` (default) preserves the existing procedure-first order; `topical` reserves all applicable blocking governance first, then orders other admitted candidates by the existing scoped text-search score, using native entry order for ties. Packets identify this opt-in mode with `ranking: "topical"`. It changes neither candidate eligibility, scope, coordinate validation, blocker overflow refusal nor exclusive execution selection. It is a retrieval option, not a semantic accuracy guarantee.
8
8
 
9
- ## P3 managed publication contract
9
+ ## Managed publication contract
10
10
 
11
- `preparePublication` and `inspectPublication` own the local create-only draft primitive; the upper composition package supplies engine authorization and exact review/provenance. Outputs are bounded UTF-8 files under one host-selected `.ia/work/generated/<id>` directory, never `.ia/src`. Portable paths, case-folded collisions, reserved `result.json`, parent/leaf aliases and unsupported filesystems refuse. The first qualified profile is a local Windows NTFS volume, verified through the installed fixed volume probe; other filesystems/platforms refuse until separately qualified.
11
+ `preparePublication` and `inspectPublication` own the local create-only draft primitive; `@inventarch/workspace-runtime` supplies engine authorization and exact review/provenance. Outputs are bounded UTF-8 files under one host-selected `.ia/work/generated/<id>` directory, never `.ia/src`. Portable paths, case-folded collisions, reserved `result.json`, parent/leaf aliases and unsupported filesystems refuse. The first qualified profile is a local Windows NTFS volume, verified through the installed fixed volume probe; other filesystems/platforms refuse until separately qualified.
12
12
 
13
- P4 exports the same read-only `qualifyPublicationRoot` check so a host can reject an unsupported or aliased root before starting an artifact task. It returns the canonical supported root without creating draft, lock or session files. Publication and inspection repeat this check at their actual boundary; host qualification is not a reusable grant.
13
+ The package root also exports the same read-only `qualifyPublicationRoot` check so a host can reject an unsupported or aliased root before starting an artifact task. It returns the canonical supported root without creating draft, lock or session files. Publication and inspection repeat this check at their actual boundary; host qualification is not a reusable grant.
14
14
 
15
- A separate per-destination SQLite transaction lock is held from staging through publication or inspection, across sessions. No PID/time-based lock stealing. Staged files and metadata are flushed, the destination is claimed with exclusive directory creation, files are linked create-only, and `result.json` is linked last as the completion marker. Existing destinations are never replaced, including empty directories. Inspecting under the same lock establishes quiescence for cooperating publishers, then checks the exact manifest bytes, complete file inventory and every content digest. Absent, applied, partial and conflicting/unknown results remain distinct. Partial outputs are retained for remediation; automatic repair/overwrite and abandoned-stage garbage collection are outside this packet.
15
+ A separate per-destination SQLite transaction lock is held from staging through publication or inspection, across sessions. No PID/time-based lock stealing. Staged files and metadata are flushed, the destination is claimed with exclusive directory creation, files are linked create-only, and `result.json` is linked last as the completion marker. Existing destinations are never replaced, including empty directories. Inspecting under the same lock establishes quiescence for cooperating publishers, then checks the exact manifest bytes, complete file inventory and every content digest. Absent, applied, partial and conflicting/unknown results remain distinct. Partial outputs are retained for remediation; automatic repair/overwrite and abandoned-stage garbage collection are outside this contract.
16
16
 
17
- The host owns the workspace and managed area; other users cannot mutate ancestors, lock databases or draft files. This is protection against competing cooperating processes and process death, not a sandbox against malicious same-user filesystem mutation. File flushes and process-kill tests do not establish hardware power-loss durability. The shared primitive is also consumed by the existing Stage E publisher while preserving its output paths and result format.
17
+ The host owns the workspace and managed area; other users cannot mutate ancestors, lock databases or draft files. This is protection against competing cooperating processes and process death, not a sandbox against malicious same-user filesystem mutation. File flushes and process-kill tests do not establish hardware power-loss durability. The repository's `tools/systems/publish.ts` also uses the shared primitive while preserving its output paths and result format.
18
18
 
19
- P2 candidate admission: `validateCandidate(input, candidate, scope)` validates an exact source-set/base vector, intended system/discriminator, bounded UTF-8 files with SHA-256 digests and cited source ranges. The trusted host supplies only the source closure disclosed to this run, permitted systems and exact candidate paths. Runtime builds admission views from those bytes without filesystem reads/writes, refuses authority changes, existing paths, shadowing, bad references and invalid citations, and returns bounded diagnostic codes with candidate-only locations. This is a read, distinct from generation, managed publication and source application. The upper composition package exposes its engine adapter; foundation packages gain no reverse dependency.
19
+ Candidate admission: `validateCandidate(input, candidate, scope)` validates an exact source-set/base vector, intended system/discriminator, bounded UTF-8 files with SHA-256 digests and cited source ranges. The trusted host supplies only the source closure disclosed to this run, permitted systems and exact candidate paths. Runtime builds admission views from those bytes without filesystem reads/writes, refuses authority changes, existing paths, shadowing, bad references and invalid citations, and returns bounded diagnostic codes with candidate-only locations. This is a read, distinct from generation, managed publication and source application. `@inventarch/workspace-runtime` exposes its engine adapter; foundation packages gain no reverse dependency.
20
20
 
21
21
  Editor extension contract (2026-09-18): public `/editor` composes language projections and database memory readers. It owns disposable per-root owner sessions, monotonic generations, saved/view revisions, occurrence-aware action handles, bounded graph/inspection projections and candidate validation. It exposes no cloud credentials or workspace execution. Host foundation imports go through this facade; semantic interpretation, discovery and admission remain with their existing owners.
22
22
 
@@ -28,7 +28,7 @@ Implementation contract for the runtime and its hosts. Depends only on language,
28
28
 
29
29
  R01. Request coordinates use graph's closed axes and canonical values. Runtime accepts text, explicit axes, optional subject/follow and a database within token. Validate declared/profile/classifier values; never silently ignore an unknown axis. prepareCoordinate returns values plus declared/profile/derived/absent for every ConditionAxis and native shape focus lists. Declared values win over a supplied profile, which wins over derivation; phase and primitive must be declared by the request and cannot come from profile or classifier. Derive only shape and category; shape-row kind/lane/predicate arrays remain explicit focus hints, not scalar selector constraints. Profile cannot impersonate declared phase/primitive. Category gloss fields on records are never read for matching. A scope key (R14) is the one exception, on its own path only: scopeCoordinate declares the key's shape and phase and derives category and the primitive, SHAPE_ROWS[shape].primitive, marked derived, so a key with a shape and a phase is never coordinate-incomplete. prepareCoordinate is unchanged and leaves an undeclared primitive absent, and every version 1 context and select request without one is still refused as coordinate-incomplete.
30
30
 
31
- R02. classify(text) is a deterministic replaceable keyword seam over request prose only. Port the donor matrix/classify signals, select greatest signal count then native SHAPE_ROWS tiePrecedence, use context for no signal. Unknown custom output is COORDINATE-VALUE-UNKNOWN, not a fallback. A custom classifier is called only when shape is absent from request/profile. Mark supplied shape declared/profile and inferred shape derived. Explicit primitive and move participate unchanged in graph selector matching.
31
+ R02. classify(text) is a deterministic replaceable keyword seam over request prose only. Use fixed keyword signals per shape, select greatest signal count then native SHAPE_ROWS tiePrecedence, use context for no signal. Unknown custom output is COORDINATE-VALUE-UNKNOWN, not a fallback. A custom classifier is called only when shape is absent from request/profile. Mark supplied shape declared/profile and inferred shape derived. Explicit primitive and move participate unchanged in graph selector matching.
32
32
 
33
33
  R03. context(handle, request, budget, options?) derives a phase-bound child of request.within and reads only through that token. Missing declared phase or primitive returns coordinate-incomplete; source token failures retain database codes. No hidden graph/registry/diagnostics are fetched for ranking. Packet records revision, child scope, coordinate provenance, included/omitted entries, followed/gated/dangling edges and measured limits. All public products are immutable. The opaque child token may differ between equivalent calls; semantic payload/order is deterministic.
34
34
 
@@ -38,7 +38,7 @@ R05. Steps1/2 order by descending band then identity; steps4-6 by selector speci
38
38
 
39
39
  R06. A subject is a canonical identity, sigil ref or unambiguous exact name in the allowed pool. Request prose mentions may be typed sigils, canonical four-slot identities or kind/name forms; resolve against allowed records with exact cardinality, never first-match. Unresolved/ambiguous subjects/mentions produce attributable omission observations, not hidden-corpus queries. Request mention recognition is not IA source parsing. An explicit subject cell/requirement fragment is validated against the admitted node; missing fragments refuse the requested address.
40
40
 
41
- R07. Budget tokens measure the sum of delivered text using an injectable named count(text); a cell entry's purpose (its record's says and answers) is delivered text only when the caller asks for it, and is then counted with the cell; default byte-estimate is ceil(UTF8 bytes/4), minimum1 for nonempty text, zero for empty. Budget records count distinct identities, not entries. Limits expose budgets, used text tokens, identity count, estimator name and serialized-envelope byte estimate separately. These are text estimates; host/model wrappers own their extra overhead. Negative/noninteger budgets or invalid estimator counts are IA-RUNTIME-BUDGET-INVALID. Reserve every applicable governance entry whose effective severity is blocking before optional admission. If blockers alone overflow, return IA-GRAPH-BUDGET-BLOCKING-OVERFLOW with minimum required budgets and the smallest number of blocking identities whose removal would fit; calculate that suggestion by descending per-identity token total, identity tie-break. This suggestion grants no permission to drop obligations. Fill remaining budget greedily in semantic order; omitted entries name budget as the cause. Display included entries in semantic order after reservation. This is the budget of `context` and the version 1 Door alone. A scope key's `budget` (R14) is a different bound, capped with its `depth`: n counts entries a body may load beyond the seat, 0..64 and 16 unless the key names it, blocking entries are reserved outside it and never counted against it, and n = 0 loads none, so K0 (budget 0) is pointers only; depth caps hops at 0..2, 1 unless named and 0 in K0. This release validates both caps and applies the defaults (normalizeScopeKey) and assembles no body for a key.
41
+ R07. Budget tokens measure the sum of delivered text using an injectable named count(text); a cell entry's purpose (its record's says and answers) is delivered text only when the caller asks for it, and is then counted with the cell; default byte-estimate is ceil(UTF8 bytes/4), minimum1 for nonempty text, zero for empty. Budget records count distinct identities, not entries. Limits expose budgets, used text tokens, identity count, estimator name and serialized-envelope byte estimate separately. These are text estimates; host/model wrappers own their extra overhead. Negative/noninteger budgets or invalid estimator counts are IA-RUNTIME-BUDGET-INVALID. Reserve every applicable governance entry whose effective severity is blocking before optional admission. If blockers alone overflow, return IA-GRAPH-BUDGET-BLOCKING-OVERFLOW with minimum required budgets and the smallest number of blocking identities whose removal would fit; calculate that suggestion by descending per-identity token total, identity tie-break. This suggestion grants no permission to drop obligations. Fill remaining budget greedily in semantic order; omitted entries name budget as the cause. Display included entries in semantic order after reservation. This is the budget of `context` and the version 1 Door alone. A scope key's `budget` (R14) is a different bound, capped with its `depth`: n counts entries a body may load beyond the seat, 0..64 and 16 unless the key names it, blocking entries are reserved outside it and never counted against it, and n = 0 loads none, so K0 (budget 0) is pointers only; depth caps hops at 0..2, 1 unless named and 0 in K0. normalizeScopeKey validates both caps and applies the defaults (R14), and positionBody assembles the body for a key (R15).
42
42
 
43
43
  R08. Follow from included identities at depth1, scoped by the same token and request coordinate. Explicit follow overrides native shape predicate focus, including an empty list. Convert each native predicate focus to its language-table active verb phrase; do not invent suffixes. Return graph's followed/gated/dangling products with deduplication and total order. Traversed neighbours are evidence, not automatically delivered text or execution grants.
44
44
 
@@ -48,9 +48,9 @@ R10. The door is a structured adapter over scope/context/select/get/search/trave
48
48
 
49
49
  R11. Runtime exports its refusal inventory, including the shared specification's IA-GRAPH-BUDGET-BLOCKING-OVERFLOW and coordinate-incomplete/deny-wins-tie/no-candidate escalation results. Every outcome gets native fixture success/refusal evidence. Full loop acceptance includes database admission/schema restoration/cache/identity, exact and primary cells, advisory law variants and conditional inverse edges, declared category, gloss independence, selection ties/incomplete coordinate, coverage/fragments and the separately owned steward hook. All package tests/typecheck/build and built consumer evidence are required before R closure.
50
50
 
51
- Historical scope checkpoint, before the first delivery: no runtime code had been delivered. All R01–R13 clauses are now implemented; the readiness guide maps the completed loop and host evidence.
51
+ Historical scope checkpoint, before the first delivery: no runtime code had been delivered. All R01–R13 clauses are now implemented.
52
52
 
53
- First delivery: replaceable donor keyword classifier with native tie precedence; closed coordinate validation, declared/profile/derived/absent marks for every axis and separate native focus lists. Required phase/primitive never come from profile or derivation. Fourteen tests cover all shapes, precedence, custom/malformed outputs, unknown axes and immutable copied results.1534workspace tests/57files, typecheck/build/kernel/dependencies pass. Scoped packet assembly and budget semantics next.
53
+ First delivery: replaceable keyword classifier with native tie precedence; closed coordinate validation, declared/profile/derived/absent marks for every axis and separate native focus lists. Required phase/primitive never come from profile or derivation. Fourteen tests cover all shapes, precedence, custom/malformed outputs, unknown axes and immutable copied results.1534workspace tests/57files, typecheck/build/kernel/dependencies pass. Scoped packet assembly and budget semantics next.
54
54
 
55
55
  Second delivery: scoped phase-child packet collection, native exact/primary/governance/selector/subject/text ordering, decoded body rendering without losing clauses, source citations, condition-aware one-hop traversal and text-budget blocker reservation. Eleven native-corpus tests cover advisory severity raising, no gloss matching, partial selectors, scoped mentions, phase-before-band authority, immutable deterministic payloads and minimum-count blocker reductions.1545workspace tests/58files,typecheck/build/kernel/dependencies pass. Selection, door and complete loop fixtures remain for the third delivery.
56
56
 
@@ -64,11 +64,11 @@ R12 host metadata refinement: COORDINATE_DOMAINS exports immutable copied native
64
64
 
65
65
  R13. Steward-write evaluation is a bounded pure consumer over admitted compiled records. Given a canonical system name and a trusted actor (operator or agent identity), resolve the direct @system declaration's typed steward reference to one admitted @agent inside that system folder. Missing/ambiguous owners refuse; only that identity or an explicitly trusted operator passes. Return expected steward identity/name and owner source attribution. No source parsing, filesystem write or tool execution occurs. The Claude host adapter owns input trust and never treats a default/missing agent as operator. Hook refusal codes are exported for fixture coverage and preserve the IA-HOOK namespace.
66
66
 
67
- 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): `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 phase of the shape's primitive, PRIMITIVE_ANCHORS[SHAPE_ROWS[shape].primitive] (context orient, governance plan, execution act, sequence plan, learning learn), `depth` to 1 and `budget` to 16, and a seat or word 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 and primitive derived. Every key refusal is IA-RUNTIME-REQUEST-INVALID naming the closed set or bound: an unknown part (a key never declares a primitive), a shape or phase 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 will be `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.
67
+ 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): `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 phase of the shape's primitive, PRIMITIVE_ANCHORS[SHAPE_ROWS[shape].primitive] (context orient, governance plan, execution act, sequence plan, learning learn), `depth` to 1 and `budget` to 16, and a seat or word 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 and primitive derived. Every key refusal is IA-RUNTIME-REQUEST-INVALID naming the closed set or bound: an unknown part (a key never declares a primitive), a shape or phase 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.
68
68
 
69
- 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. Three 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. And the body's `revision`, which hashes every source, a runtime-band one included (R16). It is `{format: 'ia.position-body.v1', revision, key, seat, loaded, rules, 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. 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 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 is unchanged by it. 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 `rules` is R, 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), in the governance order and never counted against the budget, 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 `rules`, 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, 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.
69
+ 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, 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. 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 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 is unchanged by it. 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 `rules` is R, 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), in the governance order and never counted against the budget, 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 `rules`, 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, 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.
70
70
 
71
- 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 root revision (`handle.revision`); `capturedRevision` the revision of the capture at `.ia/work/snapshot/current.json` (db D08a) and `previousRevision` that 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 byte-equal but for its `revision`, the graph revision of the view the scope reads. That revision hashes every source at its placement, a runtime-band one included (graph revisionOf), so it and the digest still move when only a runtime-band source changes, and so does `handle.revision`, which turns the note `stale` against a capture taken before. 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. Runtime-band evidence is to be excluded from the authored revision: until an admission view leaves runtime-band sources out, both for the revision and for the findings the body reads, evidence an `ia validate` writes cannot leave body(K) and its digest byte-equal, nor a capture current. 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) changing each body only in its revision, and so its digest, 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.
71
+ 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.
72
72
 
73
73
  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 R reserves in `rules` (R15). The body delivers R in full, as it does `loaded`, so making a rule blocking keeps what applies to it, 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 R, 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. `rules` is R (R15) plus 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` stays in the governance order and outside the budget, and none of its entries is in `appliesByWord`, `pointers` or the frontier. So a blocking rule 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 R only, never to a candidate the budget truncated. `cells` holds, for each `@playbook` of `appliesByWord` in its order, up to c = 4 (a rendering constant), its cell at (P, primitive(H)): P the key's phase, and primitive(H) 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), 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.
74
74
 
@@ -78,7 +78,7 @@ The public `/editor` `EditorWorkspace.composition(stamp)` projection describes a
78
78
 
79
79
  Entry contract (2026-09-24): `/entry` exports `isEntry(argv1, moduleUrl)`, which a package binary calls with `process.argv[1]` and `import.meta.url` to decide whether it is the process entry. The invoked path is compared first and real paths only when it misses, because npm's `.bin` entries, global installs and pnpm's store links reach an entry through a link while Node loads it from its real path. A path that names no file (missing, through a file, or with a name too long) is not the entry; any other failure to resolve one throws rather than answering "not the entry". An argument Node resolves further, such as an extensionless path or a package directory, names no file itself, so a binary started that way does not recognise itself as the entry and exits 0 having done nothing. It imports only Node built-ins, and the root index re-exports it. `tools/entry/is-entry.mjs` repeats it without package dependencies and its parity test compares their complete function bodies.
80
80
 
81
- Machine protocol description (2026-09-29, the R12 Door protocol): `MACHINE_PROTOCOL` (`src/machine-protocol.ts`, exported from the package root) describes the Door operations: the nine of version 1, and since version 2 `read`, `next` and `position` (R12 version 2 refinements below). For each it records a summary, a description, the parameter JSON Schema, the result, the refusals with their next action, an example that returns `ok: true` on `packages/compliance/fixtures/loop` (for `next`, which that fixture's records give no plan to read, on `tests/fixtures/delivery/base` laid over the conformance corpus), and the MCP tool that serves it. CLI help and the MCP door's `tools/list` project it, and in this source tree so does the generated `docs/reference/cli/machine-protocol.md`, which the public candidate does not carry. It is data and never validates; the Door keeps its own checks. `tests/select-door.test.ts` fails when the table's operation names or parameter keys, nested ones included, differ from the ones the Door names when it refuses an unknown key.
81
+ Machine protocol description (2026-09-29, the R12 Door protocol): `MACHINE_PROTOCOL` (`src/machine-protocol.ts`, exported from the package root) describes the Door operations: the nine of version 1, and since version 2 `read`, `next` and `position` (R12 version 2 refinements below). For each it records a summary, a description, the parameter JSON Schema, the result, the refusals with their next action, an example that returns `ok: true` on `packages/compliance/fixtures/loop` (for `next`, which that fixture's records give no plan to read, on `tests/fixtures/delivery/base` laid over the conformance corpus), and the MCP tool that serves it. CLI help and the MCP door's `tools/list` project it. It is data and never validates; the Door keeps its own checks. `tests/select-door.test.ts` fails when the table's operation names or parameter keys, nested ones included, differ from the ones the Door names when it refuses an unknown key.
82
82
 
83
83
  R12 protocol version 2 refinement (2026-10-08): the Door also accepts `read`, its params `{within?, locator, includeRuntime?}` closed as every operation's are, and answers `{ok: true, result}` with the `ReadBody` `readBody` returns, or that function's refusal. It always reads through a token, the initial one when `within` is omitted, and passes it to `readBody` as `ReadBodyOptions.within`, so every lookup (`get` and `records`) is in that scope and the boundary is by identity: an identity, a fragment or a `path:line` that no admitted record in the scope answers, whether its record is outside the scope, refused by admission or absent, is, through a token narrower than the whole workspace, one plain IA-RUNTIME-READ-UNADMITTED, `{ok: false, code, message: 'The locator is not in this scope'}`, which names no path, line, identity or refused record. Through a whole-workspace token (db `isCompleteScope`, PT5: one whose scope, and every scope it was issued under, is at the workspace root with no `phase` or `identities`, such as the initial token of a door opened without a `boundary`, or with one that sets none of them, and a token `scope` issues from such a token without setting them; a root below the workspace root, a phase or identities make a token narrower), which reads what the root view reads, a miss is the root view's refusal: an identity a source holds whose record admission refused reads `in this workspace's sources, but admission refused it` with that record's path, line, `file` `refused` and the `reason` admission gives, any other identity `not in this workspace's sources`, and a line what the workspace's sources hold in its file (2026-10-08: one disclosure rule for the version 2 operations, the one `next` follows, R18). Without `within`, `readBody` reads in the root view as before, its refused-identity refusal now also carrying that `reason`, and `ia read`, which prints no `reason`, is unchanged. A record in the scope reads as `readBody` reads it, its fragment, placement and unreachable refusals included. The Door reads a document through `DoorOptions.read`, by default db `readWorkspaceBytes` (D01a) over its root bounded at the CLI workspace file reader's 4 MiB, which admits the paths that reader's portable rule admits. The default reader's refusals name a document by its workspace-relative path and never the server's root: those of `readWorkspaceBytes` already do (a link or junction, a nonportable path, an irregular, missing or oversized file), `readBody` refuses a document path outside the workspace before any read, and a root that can no longer be opened, as when the workspace moves while the door serves, which db names by the root, is refused IA-RUNTIME-READ-UNREACHABLE, as every failure of the reader is, its message carrying the reader's IA-DB-ROOT-INVALID, `The workspace can no longer be opened to read <path>`, which names the document alone; the CLI's own reader names a link by its absolute local path. It binds adopted mounts once, when it opens, from db `adoptedBindings` over the manifest `open` has just read, as `ia read` binds them when its session opens, so they match the handle's snapshot and a manifest rewritten while the door serves changes no read; a door opened with explicit `adopted` captures, which name no directory, binds none. `includeRuntime` must be a boolean, and a locator that spells no form is IA-RUNTIME-REQUEST-INVALID. `DoorOptions.protocol` is the `MACHINE_PROTOCOL` version the door serves, by default the table's, and one that is not an integer from 1 to it is a TypeError: a door at version 1 refuses `read` before reading its params, as the unknown operation 1.1.0's door refused it, byte for byte, and binds no mounts. An unknown operation's refusal lists the operations the door serves in table order, `read` after the version 1 operations from version 2. `MACHINE_PROTOCOL` is version 2: `ProtocolOperation` gains an optional `since`, absent on the nine version 1 rows, whose JSON stays byte-identical to what tag v1.1.0 exported (`tests/golden/machine-protocol-v1.json`; `src/machine-protocol.ts` was unchanged since the tag when it was taken), and the `read` row is appended with `since: 2` and `mcp: 'ia_read'`, with one flow line saying so. The version 1 parameter digest is still over the nine rows, and version 2's is over every row. The CLI's machine routes stay the version 1 operations: `runCli`, which the `ia` binary's nine routes, `@inventarch/cli/internal/main` and the host launcher's `door` mode run, opens its door at protocol version 1, and `LEGACY_OPERATIONS`, the usage line and `ia <operation> --help` and `--schema`, which describe the routes at version 1 as 1.1.0 did, are unchanged; `ia read` remains the consumer verb, which returns the Door's body and digest and refuses a document the Door refuses with the same code. The MCP door serves `ia_read` from the row. `tests/door-read.test.ts` pins in-scope reads, the plain refusal for each locator form outside a narrowed boundary with no path named, the whole workspace's token answering a refused record with its path, line and reason, an identity no source holds and a line as `readBody` answers them in the root view, as do tokens `scope` issues with `{}`, `{root: ''}` and `{phase: null}` and the initial token of a door opened with `boundary: {}`, while tokens `scope` issues with `identities` admitting every admitted record, a phase or a root below the workspace root, and a door opened with that `identities` boundary, answer each with the plain refusal, a link, an escape and a moved root refused with no spelling of the server's root or the link's target, one source holding an in-scope, an out-of-scope and a refused record, a token narrowing reads in one door, the db reader's link and hard-link refusals, an injected reader, a mount bound from the manifest when the door opens, which a manifest rewritten later does not change, and none for explicit captures, and the `read` row's example on the loop fixture, its required parameter and its refusals proven both ways; `tests/select-door.test.ts` the golden, both digests and a version 1 door's operations and refusal; `apps/cli/tests/cli.test.ts` that `runCli` refuses `read` and an unknown operation with 1.1.0's bytes; `apps/cli/tests/read.test.ts` that the Door and `ia read --json` agree on body and digest for corpus locators, an adopted document and a document of exactly the 4 MiB bound, and refuse a link, a decomposed (NFD) name, a colon and a document one byte over the bound with the same code, for the same record and document path and with the same reason up to each reader's own words, while a runtime-placement refusal is compared with `readBody` under the CLI's own `readOptions` on a handle opened with the placement, since the session `ia read` opens places no source at runtime; and tools/compliance runs a boundary fixture per read code through the Door.
84
84
 
@@ -90,23 +90,23 @@ R12 protocol version 2 refinement, position (2026-10-08): the Door also accepts
90
90
 
91
91
  `@inventarch/runtime/authoring-execution` owns shared authoring operation context/errors, input and artifact helpers, and guarded dispatch. A trusted host supplies its fixed catalog; no decoded request may supply handlers or widen effects. Dispatch preserves exact admitted operation/source identity, declared handler/input/output/effects, steward authorization, safe unique artifact paths, read-only output refusal and final source freshness. This factors the existing tools/systems mechanics without a private catalog, architecture packet, quality codec or queue dependency. Existing tools imports remain compatibility wrappers. This API does not authenticate arbitrary catalogs or authorize filesystem publication; each host owns its selected catalog and grants.
92
92
 
93
- This boundary also owns the neutral repository inventory helpers used by existing documentation and private review consumers. `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. Status (LKI-01, implemented at 22cc1d8d, not qualified): `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 again; the mapping and both exports are unchanged. Evidence: `tools/testing/inventory.test.ts` failed at 3f0e9853 (`runtime:test` classified as a CI-configuration reader) and passes at 22cc1d8d.
93
+ 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.
94
94
 
95
- 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. No CLI command consults a mandate yet: the authoring verbs land in a later milestone, and a mandate adds closed restrictions only; it never grants host permissions.
95
+ 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.
96
96
 
97
97
  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.
98
98
 
99
- R22. Mandate guard (2026-10-11, revised after the guard reviews): `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.
99
+ 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.
100
100
 
101
- 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; revised after review and its rechecks). 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 spec 3.1's identity), 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` (the probes showed a refused steward or participant switching the default actor to a looser participant, and a refused workspace leaving 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.
101
+ 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.
102
102
 
103
- R23 comment classification correction (2026-10-13, revised after its review): a genuine full-line attribution comment is not a declaration and does not supply a refused mandate through db D15's raw-token reading. The guard itself is unchanged. Unidentified lines, including conflict markers and disguised declarations, still fail closed across the workspace, as do refused mandate identity facets and agent/workspace resolution dependencies. A parse error anywhere in the attributed file, the attributed record included, continues to appear in admission findings without fabricating a mandate from its attribution. Where db D15 still lists the comment's `@mandate`, a genuine attribution still fails the workspace closed: in a file that holds a bare CR anywhere, inside `"""` prose (as after a `"""` no line closes), and on line 1 after a byte-order mark in a file with no pragma. `tests/mandate-resolution.test.ts` verifies the original restrictive profile remains effective, and that the unidentified/dependency refusals survive a preceding attribution comment and name the record after it, never the comment.
103
+ R23 comment classification correction (2026-10-13): a genuine full-line attribution comment is not a declaration and does not supply a refused mandate through db D15's raw-token reading. The guard itself is unchanged. Unidentified lines, including conflict markers and disguised declarations, still fail closed across the workspace, as do refused mandate identity facets and agent/workspace resolution dependencies. A parse error anywhere in the attributed file, the attributed record included, continues to appear in admission findings without fabricating a mandate from its attribution. Where db D15 still lists the comment's `@mandate`, a genuine attribution still fails the workspace closed: in a file that holds a bare CR anywhere, inside `"""` prose (as after a `"""` no line closes), and on line 1 after a byte-order mark in a file with no pragma. `tests/mandate-resolution.test.ts` verifies the original restrictive profile remains effective, and that the unidentified/dependency refusals survive a preceding attribution comment and name the record after it, never the comment.
104
104
 
105
105
  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.
106
106
 
107
107
  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.
108
108
 
109
- 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. `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 + 3 SPEC lines, the host note no entry. A fresh init (P = M = 1, T = 3) has 19 + C + N entries: 26 + N with the CLI's seven catalog rows, `ia project` the seventh, and 28 + N with `ia preview` and `ia author` the eighth and ninth. `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 39 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: 28 on the conformance corpus and 53 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.
109
+ 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. `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 + 3 SPEC lines, the host note no entry. A fresh init (P = M = 1, T = 3) has 19 + C + N entries: 28 + 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 39 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: 28 on the conformance corpus and 53 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.
110
110
 
111
111
  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.
112
112
 
@@ -3,7 +3,7 @@
3
3
  * its purpose, parameter schema, result, refusals with a next action, and an example that returns `ok: true` on
4
4
  * packages/compliance/fixtures/loop, or for `next`, as that fixture authors no @plan, on the delivery fixture
5
5
  * packages/runtime/tests/fixtures/delivery/base laid over the conformance corpus. `ia <operation> --help` (the version
6
- * 1 operations, which are the CLI's machine routes), the MCP door's tools/list and docs/reference/cli/machine-protocol.md
6
+ * 1 operations, which are the CLI's machine routes) and the MCP door's tools/list
7
7
  * are projections of this table. It describes the frozen wire format and changes none of it: the Door validates every
8
8
  * request itself, and tests/select-door.test.ts, tests/door-read.test.ts, tests/next.test.ts,
9
9
  * tests/door-position.test.ts and apps/cli/tests/cli.test.ts hold this table to what the Door admits and refuses. A
@@ -72,8 +72,8 @@ export declare function mandateRefusal(mandate: MandateAuthority | CompiledRecor
72
72
  /** One authored `@mandate` that failed admission, and the admission finding that refused it. */
73
73
  export interface RefusedMandate {
74
74
  /**
75
- * Its canonical identity, when db compiled the record or spec 3.1 names its parsed header; absent for a header only
76
- * the source text shows.
75
+ * Its canonical identity, when db compiled the record or language `identityOf` names its parsed header (db D15);
76
+ * absent for a header only the source text shows.
77
77
  */
78
78
  readonly identity?: string;
79
79
  readonly path: string;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@inventarch/runtime",
3
- "version": "3.1.1",
3
+ "version": "3.2.0",
4
4
  "type": "module",
5
5
  "main": "./dist/index.js",
6
6
  "types": "./dist/index.d.ts",
@@ -167,9 +167,9 @@
167
167
  "LANGUAGE.md"
168
168
  ],
169
169
  "dependencies": {
170
- "@inventarch/language": "3.1.1",
171
- "@inventarch/graph": "3.1.1",
172
- "@inventarch/db": "3.1.1"
170
+ "@inventarch/language": "3.2.0",
171
+ "@inventarch/graph": "3.2.0",
172
+ "@inventarch/db": "3.2.0"
173
173
  },
174
174
  "devDependencies": {
175
175
  "@types/node": "^22.19.0",