@inventarch/runtime 3.4.1 → 3.5.1
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/SPEC.md +8 -2
- package/dist/method/bindings.d.ts +51 -0
- package/dist/method/bindings.d.ts.map +1 -0
- package/dist/method/bindings.js +166 -0
- package/dist/method/bindings.js.map +1 -0
- package/dist/method/catalogue.d.ts +39 -0
- package/dist/method/catalogue.d.ts.map +1 -0
- package/dist/method/catalogue.js +126 -0
- package/dist/method/catalogue.js.map +1 -0
- package/dist/method/errors.d.ts +28 -0
- package/dist/method/errors.d.ts.map +1 -0
- package/dist/method/errors.js +39 -0
- package/dist/method/errors.js.map +1 -0
- package/dist/method/index.d.ts +30 -0
- package/dist/method/index.d.ts.map +1 -0
- package/dist/method/index.js +16 -0
- package/dist/method/index.js.map +1 -0
- package/dist/method/installed-kits.d.ts +49 -0
- package/dist/method/installed-kits.d.ts.map +1 -0
- package/dist/method/installed-kits.js +194 -0
- package/dist/method/installed-kits.js.map +1 -0
- package/dist/method/kit-root.d.ts +31 -0
- package/dist/method/kit-root.d.ts.map +1 -0
- package/dist/method/kit-root.js +120 -0
- package/dist/method/kit-root.js.map +1 -0
- package/dist/method/kits.d.ts +130 -0
- package/dist/method/kits.d.ts.map +1 -0
- package/dist/method/kits.js +381 -0
- package/dist/method/kits.js.map +1 -0
- package/dist/method/packet.d.ts +51 -0
- package/dist/method/packet.d.ts.map +1 -0
- package/dist/method/packet.js +62 -0
- package/dist/method/packet.js.map +1 -0
- package/dist/method/pin.d.ts +71 -0
- package/dist/method/pin.d.ts.map +1 -0
- package/dist/method/pin.js +164 -0
- package/dist/method/pin.js.map +1 -0
- package/dist/method/reader.d.ts +38 -0
- package/dist/method/reader.d.ts.map +1 -0
- package/dist/method/reader.js +97 -0
- package/dist/method/reader.js.map +1 -0
- package/dist/method/registry.d.ts +39 -0
- package/dist/method/registry.d.ts.map +1 -0
- package/dist/method/registry.js +129 -0
- package/dist/method/registry.js.map +1 -0
- package/dist/method/releases.d.ts +47 -0
- package/dist/method/releases.d.ts.map +1 -0
- package/dist/method/releases.js +104 -0
- package/dist/method/releases.js.map +1 -0
- package/dist/method/resolve.d.ts +44 -0
- package/dist/method/resolve.d.ts.map +1 -0
- package/dist/method/resolve.js +448 -0
- package/dist/method/resolve.js.map +1 -0
- package/dist/method/retained.d.ts +8 -0
- package/dist/method/retained.d.ts.map +1 -0
- package/dist/method/retained.js +182 -0
- package/dist/method/retained.js.map +1 -0
- package/dist/method/root.d.ts +12 -0
- package/dist/method/root.d.ts.map +1 -0
- package/dist/method/root.js +43 -0
- package/dist/method/root.js.map +1 -0
- package/dist/method/session.d.ts +64 -0
- package/dist/method/session.d.ts.map +1 -0
- package/dist/method/session.js +109 -0
- package/dist/method/session.js.map +1 -0
- package/dist/packet-host.d.ts +1 -1
- package/dist/packet-host.d.ts.map +1 -1
- package/dist/packet.d.ts +1 -1
- package/dist/packet.d.ts.map +1 -1
- package/dist/packet.js +3 -2
- package/dist/packet.js.map +1 -1
- package/package.json +8 -4
package/SPEC.md
CHANGED
|
@@ -2,6 +2,12 @@
|
|
|
2
2
|
|
|
3
3
|
`inertCommandRoot(root)` identifies roots whose letters, numbers, spaces and `._-/:` punctuation can be repeated in a shell command, with spaces double-quoted. Windows path separators are accepted on Windows except a UNC backslash prefix, whose JSON quoting does not preserve its path meaning across native shells. Other characters require a caller to omit the root and explicitly request execution from the workspace directory. This helper supplies no authority and changes no mandate decision. `admissionReport` retains its stricter unquoted-root contract.
|
|
4
4
|
|
|
5
|
+
## Method kits and packets
|
|
6
|
+
|
|
7
|
+
`@inventarch/runtime/method` is the shared method resolver the MCP door reads kits through, in process. It reads kit folders (`.ia/release.json`, `.ia/src`, the lock, `releases.json` in format 1 or format 2 with `releases/<version>.json`, and the `checks.json`, `delivery.json`, `bindings.json` and `onwrite.json` sidecars) from a bundled folder and then `<IA home>/kits/<folder>/<version>/`; selects a repository's binding from `.ia/bindings.json` (exact, wildcard, default, then precedence); keeps task pins (format 3, format 1 read as format 3) under `<IA home>/work-v1/<project>/<task>/`; retains exact method bytes under the closure store; restores kit read roots under `<IA home>/kit-roots-v1/` unless the caller names a cache; and assembles the packet with the digest over its sorted-key canonical form, the envelope and binding excluded. `resolveMethod` follows the `ia` plugin's `resolve.mjs` step for step, reading position bodies, records, inbound rows and cell bodies through db and this package instead of the CLI. Its caller supplies the native restore that installs a kit's language base into the kit's read root, so this package gains no distribution dependency. `laneCatalogue`, `openSession`, `readRegistry`, `registerWorkspace` and `checkRoot` serve the door's catalogue, session log, workspace registry (format `ia-workspace-locations-2`, reading `personal-workspace-locations-1` and Studio's format 1, writing format 2 only) and per-root mandate check. Lanes, keys, words and phases are closed tokens; a subject is carried as the caller gives it and never reaches a position.
|
|
8
|
+
|
|
9
|
+
Installed kits (2026-10-31, contract C7b, ia-kb `dec-133` and `dec-117`): a workspace lock's `package` entries (`lockedPackageKits`) name kit releases the engine installs as ordinary releases in `.ia/distributions/store/<archive>/`; npm is transport only, and no kit is read from an npm package folder. `installedPackageKits` reads each from the store: its `distribution.json` must hash to the manifest digest the lock pins and name that release, and its pinned files are copied, each checked against its SHA-256, into `<IA home>/installed-kits-v1/<archive>/` with a format 1 `releases.json` of its one release and a `.ia/distributions.lock.json` that pins its dependencies exactly as the workspace lock does, so retention, read roots and the door's restore treat it as any kit folder (origin `installed`). `workspaceKits` lists a workspace's kits: the bundled ones, each installed kit, then the home's; a kit an entry names is taken from no other source, so `resolveMethod` refuses a binding to one the store lacks `IA-CORE-KIT-RESTORE-REQUIRED` ("run ia restore"; a pinned task may still read its retained bytes), and a kit no source provides still refuses `IA-CORE-KIT-UNKNOWN`. `installedKit` counts an entry kit as installed, so its packet's laws are the repository's position's and `envelope.kitInstalled` is true. `openSession` takes the kits the store lacks and adds `restore: {kits, message}` and a "Kits not restored" briefing line. `checkRoot` keeps the installation's refusal reason (`restore-required`, `lock-drift`) on its error. A lock without entries changes none of this.
|
|
10
|
+
|
|
5
11
|
## Optional topical context assembly
|
|
6
12
|
|
|
7
13
|
`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.
|
|
@@ -66,7 +72,7 @@ R13. Steward-write evaluation is a bounded pure consumer over admitted compiled
|
|
|
66
72
|
|
|
67
73
|
R14. Scope key. `src/scope-key.ts` holds it: the package root exports `K0`, `SCOPE_KEY_CAPS`, `normalizeScopeKey`, `resolveScopeKey` and `rootRelative` with the `ScopeKey`, `ResolvedSeat` and `ResolvedScopeKey` types, and the `./internal/scope-key` subpath carries the module; `scopeCoordinate` (R01) is in `src/coordinate.ts`, on the `./internal/coordinate` subpath only. `ScopeKey` is K = (seat, shape, phase, depth, budget, word), with an optional primitive override: `shape` one of the five SHAPE_ROWS shapes, `phase` one of the four phases, `depth` an integer in 0..2, `budget` an integer in 0..64 and `word` optional; `SCOPE_KEY_CAPS` exports the two caps, and `K0` is the frozen key (no seat, context, orient, 0, 0, no word). Three seat notions are kept apart, each named once here. The key's `seat` is what a caller names: absent for the repository's own `@workspace`, a record identity, or `{path}` for a location. The resolved seat (`ResolvedSeat`) is what that names once read through the scope: `{kind, identity?, path?, unknown?}`, kind `workspace` for no seat (identity the repository's `@workspace`), `record` for an identity (identity that record) and `location` for a path (path its canonical workspace-relative path; a location is not a record and has no identity). The database's `SeatResolution.seat` (db D02b) is the record a path is declared at, a `@system` or `@workspace`; it stays in the result's `resolution` with the rule `by` and the path's claimants, and is never a location's resolved seat. `normalizeScopeKey(partial?)` completes a partial key with its defaults, the one place every host applies them: a partial that names no part (a part whose value is undefined is not named) is K0; otherwise `shape` defaults to context, `phase` to the anchor of the explicit primitive or the shape's primitive, PRIMITIVE_ANCHORS[primitive ?? SHAPE_ROWS[shape].primitive] (context orient, governance plan, execution act, sequence plan, learning learn), `depth` to 1 and `budget` to 16, and a seat, word or primitive override stays absent unless named. It reads nothing, so it checks the key's form and leaves the word and the seat to resolution. `resolveScopeKey(handle, within, key)` requires a scope token like every runtime read, checks a complete key and returns a frozen `{key, seat, resolution?, coordinate}`: `key` copies the validated parts in K order, a location as the canonical path it resolved to, so a key never carries the root; `seat` is the resolved seat; `resolution` is the database's resolution of the repository root `''` or of the path, for a workspace or location seat; and `coordinate` is scopeCoordinate's (R01), shape and phase declared, category derived, primitive declared when supplied and otherwise derived. Every key refusal is IA-RUNTIME-REQUEST-INVALID naming the closed set or bound: an unknown part, a shape, phase or primitive outside its closed set, a depth or budget outside its cap or not an integer, a seat that is neither an identity nor `{path}`, a word the read's view does not register for its admitted systems (db D09a `words`), the refusal listing those it does, an identity that is not an admitted record in the scope, and a path outside the workspace root or escaping it. The key's parts, closed sets, caps and seat form are checked before any read, so a key malformed in them is refused whatever the token. An absolute path reads by `rootRelative(root, path)`, the one absolute-path rule, which `ia read` also reads the path of a `<path>:<line>` locator with (2026-10-08, which gave the two one rule): the path from the handle's root that Node's `path.relative` gives (on Windows without case, with either separator), `/`-separated, and the root itself, however it is spelled, as `''`, the location that `.` also names (`ia read`, whose line locator needs a path, spells it `.`). It names no path inside the root, so it is undefined and the path goes on as given, refused below, when that path's first segment is `..`, a check made segment by segment, so an in-root name that only begins with `..`, such as `..cache`, is inside the root whichever way it is spelled, or when the path is on another drive, which has no path from the root. A relative path goes as given to the database's `resolveSeat` (db D02b), as does the path `rootRelative` reads, and the database canonicalises it segment by segment and names one that escapes the workspace `outside`, refused here: a `..` segment escapes. No seat takes the seat the database resolves for `''`: the `@workspace` declaring a `sources` root of the whole repository, else the repository's own `@workspace` as D02b decides it. When no admitted record in the scope is declared at a workspace or location seat, the resolved seat names `unknown: 'undeclared'`, and a workspace seat then has no identity: K0 is the empty composition with the unknown named, never a refusal (db D02b). Database token failures (SCOPE-UNAVAILABLE, STALE, CLOSED) keep their IA-DB codes on every read the resolution makes: the word's, the identity's and the path's. This row types, completes, validates and resolves the key; R15 assembles the body a resolved key gives (seeding, pointers to 48 then tallies, the word's restriction of seeds and tallies, blockers reserved outside the budget), and `position` (R16) completes, resolves and assembles a key with its digest and host note. The Door's `position` operation reads a key (R12 refinement, position); the nine version 1 Door routes, `context` and `select` included, and `ia scope` neither read nor accept one, and the consumer verb is `ia position`. Each key refusal's `RuntimeError` carries `next`, the one command to run: the closed set of a shape or phase, the cap of a depth or budget, `ia vocabulary` for a word, and `ia position`, K0, for a key that is no object or names an unknown part and for a seat of another form, outside the scope or outside the workspace. `RuntimeError` gains the optional `next` for it, absent from every other refusal. `tests/scope-key.test.ts` pins the caps and K0; the defaults, an empty partial being K0 and every shape's anchor phase; a key naming only a shape resolved, and depth 3 and budget 65 refused; a key completed from shape and phase alone for every shape and phase; the unchanged version 1 refusal bytes of a context or select request that declares only shape and phase; the closed sets, caps and seat form refused by both functions, an unknown part and a key that is no object naming `ia position` as `next`, and the key's form refused before a forged token is read; the token on every seat form and the word, a forged, stale or closed one keeping its database code; the registered word checked in the scope's own view; each seat form and a location pruned by a narrower scope; absolute paths inside the root, in native, forward and mixed separators (and on Windows with the drive letter in either case), read as the relative path, the root in every spelling as the location `''`, an in-root name beginning with `..` read alike in both spellings, and absolute paths outside the root (a sibling whose name extends the root's among them), escaping paths and another drive refused; `rootRelative` itself on each of those spellings, a relative path returned as given; K0 seated by a workspace that declares the whole repository as a root; and K0 with the repository workspace undecided.
|
|
68
74
|
|
|
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 selected primitive, the condition's subject being the record that states the row (its `declaredOn`, the author graph G06 keeps as an edge's condition subject), so the body agrees with graph traversal for the same coordinate. A row that does not hold is not followed and its counterpart is not reached through it: it is no hop, primes no record, names no out-of-focus pointer and counts in no frontier, while a field reference carries no condition. The phase can so change the loaded set; a body whose rows carry no condition 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, primitive?, depth: 1, budget: 16}}`, to be seated at any pointer, no seat being the repository's workspace. `position` (R16) returns the body with its digest and host note; R17 adds the applies-by-word section, the playbook cells and the mandates; and the Door's version-2 `position` operation and the MCP tool `ia_position` serve it (R12), as does the `ia position` CLI verb (apps/cli/SPEC.md). `tests/position.test.ts` pins, over the conformance corpus, golden bodies of K0, governance at the fixture law (at plan, where its conditional `enforced-by` row does not hold, and at act, where it does), sequence at depth 2 from the workspace and the word law at the governance-system seat, in `tests/golden/` with the revision masked and asserted apart (only `node packages/runtime/tests/golden/write.mjs` regenerates them); K0's single loaded seat, five system pointer lines from `composition.systems`, frontier and named missing sources; byte-equal bodies for equal keys through every whole-workspace token and handle of one revision, and a token selecting every admitted identity differing only by the `unread` note; hops in either direction, out-of-focus pointers and a seed a later hop reaches keeping hop 0; each order key deciding in turn (band, then hop, then lane in the other shapes; prime, then band, an adopted record against a local one, then hop, then sev in governance) and two blocking laws in `rules` in the governance order under governance and context; seeds picked by kind and by lane (an authority-facet contract); the counts of a budget below |Σ ∪ C| and one tally past 48 per word and owner system; the word law loading the seat and only laws, waypoints and only-law pointers, tallies and frontier; a location seat claimed only through `subject.covers` by a blocking law at budget 0, the law in `rules`, not a pointer, the seat alone loaded; a location nothing claims, and one claimed but declared at no record; a record of another workspace's root never entered and named as a pointer, whether a hop or the seat's `composition.systems` reaches it, and not listed under a word it is not of; a location in that root's system folder, closed in that workspace; an adopted `@system` seated in the repository's workspace though its adopted `@workspace` declares the root it sits in, the repository's own blocking law of its word reserved; a conditional row followed at each phase exactly where graph traversal follows it for the key's coordinate, from either side and with its severity term read from the record that states it, and a task reached through a conditional requirement only at the phase it names; the narrowed location unknown; K0 with the repository workspace undecided; a seat no declared root holds, under the fallback closure and named, its blocking law still in `rules`; on a whole-workspace scope, missing targets, unconsented rows and missing field references named on the loaded record whose span holds them, never on an earlier record of the file or on a pointer, and the `unread` note on a narrowed one; and the token. `tests/purity.test.ts` pins the runtime-placement rule (R16). The conformance corpus places no source at runtime, so the rule leaves the golden bodies unchanged.
|
|
75
|
+
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. D02b's unique init entry point keeps the repository seat decidable when local domain workspaces declare sources; this does not widen a closure. A repository and a domain that need the same local records must both declare those membership roots explicitly, and private domain roots remain outside other closures. A workspace's closure is every floor (band 10) and adopted (band 90) record, plus the members of its own declared roots or, while it declares none, every record whose membership root no workspace declares; when no workspace holds the seat, the closure is that fallback. Reading the closure as the declared members alone would leave a repository without a declared root (the conformance corpus, and every repository an earlier `ia init` made, which declared none) unable to reach any record of its own; and falling back to the repository's workspace whatever its roots would, when none of them holds the seat record, leave the seat outside its own closure (the seat S always resolves inside it) and its own system's blocking governance out of `rules`. Both fallbacks are named under `unknowns`. A record outside the closure is never entered: it is a pointer that names, as `workspace`, the `@workspace` whose declared root holds it, when one does. The composition C0, at cost 0 and one level from the seat, is the seat's field references both ways (directed-view `field-ref` rows); a `@workspace` seat's capture members, the membership rows under its own declared roots; a `@system` seat's word members, the admitted records whose owner system it is; and a location's declared-at record and claimants from `resolution`. A location is no record and has no fields, and a workspace seat no record declares has an empty composition. The first class that reaches a C0 record is its `via`, unless a hop reaches it (below): `field` (`from`, `field`, `direction`, read from `from`'s side), `membership` (`root`), `word` (`system`), `declared-at` (`rule`) or `claim` (`matches`); C0 counts only what the closure admits, a composition record a hop reaches included. The seeds Σ are the seat and the C0 records whose kind is in SHAPE_ROWS[shape].kinds or whose lane, graph `laneOf` (G05), is in its lanes. Hops 1..depth start from Σ and follow directed-view edge rows only, declared or derived inverse, in either direction, whose predicate is in SHAPE_ROWS[shape].predicates, never leaving the closure; each record other than the seat and the seeds that a hop reaches, a C0 record among them, keeps the first row that reaches it, from the seat, then the seeds and each later hop in identity order, as `via: {by: 'row', from, predicate, spelling, declaredBy}`, and is in C. A row that carries a condition is a row of the body only where its condition holds at the key's coordinate (2026-10-08): graph `conditionHolds` over the coordinate R14's scopeCoordinate builds, the key's shape and phase with the derived category and selected primitive, the condition's subject being the record that states the row (its `declaredOn`, the author graph G06 keeps as an edge's condition subject), so the body agrees with graph traversal for the same coordinate. A row that does not hold is not followed and its counterpart is not reached through it: it is no hop, primes no record, names no out-of-focus pointer and counts in no frontier, while a field reference carries no condition. The phase can so change the loaded set; a body whose rows carry no condition 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, primitive?, depth: 1, budget: 16}}`, to be seated at any pointer, no seat being the repository's workspace. `position` (R16) returns the body with its digest and host note; R17 adds the applies-by-word section, the playbook cells and the mandates; and the Door's version-2 `position` operation and the MCP tool `ia_position` serve it (R12), as does the `ia position` CLI verb (apps/cli/SPEC.md). `tests/position.test.ts` pins, over the conformance corpus, golden bodies of K0, governance at the fixture law (at plan, where its conditional `enforced-by` row does not hold, and at act, where it does), sequence at depth 2 from the workspace and the word law at the governance-system seat, in `tests/golden/` with the revision masked and asserted apart (only `node packages/runtime/tests/golden/write.mjs` regenerates them); K0's single loaded seat, five system pointer lines from `composition.systems`, frontier and named missing sources; byte-equal bodies for equal keys through every whole-workspace token and handle of one revision, and a token selecting every admitted identity differing only by the `unread` note; hops in either direction, out-of-focus pointers and a seed a later hop reaches keeping hop 0; each order key deciding in turn (band, then hop, then lane in the other shapes; prime, then band, an adopted record against a local one, then hop, then sev in governance) and two blocking laws in `rules` in the governance order under governance and context; seeds picked by kind and by lane (an authority-facet contract); the counts of a budget below |Σ ∪ C| and one tally past 48 per word and owner system; the word law loading the seat and only laws, waypoints and only-law pointers, tallies and frontier; a location seat claimed only through `subject.covers` by a blocking law at budget 0, the law in `rules`, not a pointer, the seat alone loaded; a location nothing claims, and one claimed but declared at no record; a record of another workspace's root never entered and named as a pointer, whether a hop or the seat's `composition.systems` reaches it, and not listed under a word it is not of; a location in that root's system folder, closed in that workspace; an adopted `@system` seated in the repository's workspace though its adopted `@workspace` declares the root it sits in, the repository's own blocking law of its word reserved; a conditional row followed at each phase exactly where graph traversal follows it for the key's coordinate, from either side and with its severity term read from the record that states it, and a task reached through a conditional requirement only at the phase it names; the narrowed location unknown; K0 with the repository workspace undecided; a seat no declared root holds, under the fallback closure and named, its blocking law still in `rules`; on a whole-workspace scope, missing targets, unconsented rows and missing field references named on the loaded record whose span holds them, never on an earlier record of the file or on a pointer, and the `unread` note on a narrowed one; and the token. `tests/purity.test.ts` pins the runtime-placement rule (R16). The conformance corpus places no source at runtime, so the rule leaves the golden bodies unchanged.
|
|
70
76
|
|
|
71
77
|
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
78
|
|
|
@@ -106,7 +112,7 @@ Body reader (2026-10-07): `src/locator.ts` reads the body behind a locator for `
|
|
|
106
112
|
|
|
107
113
|
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
114
|
|
|
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 +
|
|
115
|
+
R19. Position packet (2026-10-08): `src/packet.ts`, exported from the package root and the `./internal/packet` subpath, publishes `renderPacket(handle, within, catalog)` and `entryCount(packet)` with the `PositionPacket`, `PacketCatalogRow`, `PacketSeat`, `PacketParticipant`, `PacketMandate`, `PacketSystem`, `PacketTally`, `PacketIntent`, `PacketPhase`, `PacketProvenance`, `PacketHostNote` and `PacketOutput` types; the root's `Packet` stays R03's context packet, so the position packet's type is `PositionPacket`. The packet is the one host-neutral thing a host adapter renders (an adapter may change file names, file count and markup, never content, ordering or numbers). `renderPacket` calls `position(handle, within)` (R16) once, at K0, and reads everything else through the same scope token: the snapshot and its D02a membership rows, directed views (db D09), the declared roots (db D02c) and the registered words (db D09a). A missing token is IA-RUNTIME-REQUEST-INVALID, an unknown, stale or closed one keeps its database code, and every other refusal is position's: the packet renders the records admission admitted and gates none of them, so an admitted mandate that `mandateAuthorityOf` would refuse, one with a child under an authority field or naming its participant or a scope with a fragment reference, renders as authored, and a mandate admission refuses, one declaring `moves []` among them since 2026-10-12 (compliance C05), renders as no mandate, never as a refusal. It returns the frozen `{packet, digest, hostNote}`, never merged: `digest` is graph's codec `digest` of the packet, and the host note is position's note `{revision, capturedRevision?, previousRevision?, freshness, key}` with `installed: 'unknown (no join checked here)'`, which carries no digest. The packet is `{format: 'ia.position-packet.v1', revision, body, seat, participants, mandates, systems, tallies, intents, phases, commands, lines, provenance}`. `revision` is the K0 body's and `body` position(K0)'s digest. `seat` is K0's seat, the repository's own `@workspace`: `{identity?, sources, systems, steward?, participants?}`, `identity` absent when no admitted `@workspace` is declared at the repository root (R14), `sources` its `composition.sources` entries as authored, `systems` N, `steward` its `composition.steward` reference, and `participants` the text `none (no authored @mandate names an @agent)` exactly when no participant is rendered. A reference the packet prints is the identity of the admitted record its typed field reference resolves to, or, when none does, the reference as authored (`@<word> <name>`). `mandates` are the entries of body(K0)'s `mandates` (R17) at band 100 whose `authority.participant` resolves to an admitted `@agent` at band 100, by identity, each `{identity, participant, moves?, scope, excludedWords?, covers?}`: `moves`, `excludedWords` and `covers` are its unconditional `authority.moves`, `authority.excluded-words` and `authority.covers` as authored, each present exactly when the record states the key (a declared `moves []` would be `moves: []`, but admission refuses it since 2026-10-12; `moves` absent restricts no move), and `scope` its `authority.scope` references. `participants` are those agents, each once, by identity, as `{identity, says?}` with its `meaning.says`; `composition.steward` names no participant, and P = 0 is a packet, not a refusal. `systems` holds one pointer line per `composition.systems` reference of the seat, by identity: for an admitted record `{identity, words, band, steward?, reach}`, `words` the words its `discriminators` rows (`<word> lowers to <kind>`) register, sorted, `steward` its `head.steward` when that resolves, and `reach` `ia position --seat <identity>` (a `@system` carries no source locator, so `ia read` gives only its head `describes`, not its words or steward); for a reference no admitted record answers `{identity: <the reference as authored>, words: 'unresolved', steward: 'unresolved'}`. `tallies` are `{word, count}` by word: the band-100 records whose capture membership root is one of the seat's own declared roots, R15's capture members of a workspace seat. A seat that declares no root has no tally, as body(K0)'s `sources` unknown says: its fallback closure is what a position may enter, not what the workspace captures. A fresh init's tallies so count what it authors under `.ia/src @authored` (workspace, agent and mandate, the installed base being band 90), and the conformance corpus, which declares no root, has none. `intents` are the five SHAPE_ROWS shapes in table order, `{shape, category, primitive, phase, kinds, lanes, predicates, priming, words}`: `phase` is the primitive's PRIMITIVE_ANCHORS phase, and `words` the registered words whose lowering has its kind in the shape's kinds or, over the kind and each of its facets, a graph `laneOf` lane in its lanes, as R15 seeds a record. The lowerings are read from the floor's two registrations and the admitted `@system` records' `discriminators` rows, the first by identity should two lower one word. `phases` are the four phases in cycle order, `{phase, primitives, changes}`: `primitives` are those PRIMITIVE_ANCHORS anchors at the phase, and `changes` the fixed line `--phase selects the playbook cell delivered and decides which conditional relation rows apply` (R15 and R18). `commands` are the `catalog` rows the caller passes, in its order, each copied as its five fields `{command, mode, move, refuses, next}`. The CLI's catalog is the COMMANDS rows it tags, which `packetCatalog` in apps/cli builds for its caller to pass, since this package may not import that app: apps/cli's `renderProjectionFor` passes it for `ia host`, `ia project`, `ia doctor` and the install, update and remove refresh, and `tools/projections/generate.ts` for this repository. LEGACY_OPERATIONS are no catalog rows. `lines` are the three SPEC-owned lines with `ia scope` read as `ia position`, without markup and without their `source: <CLI SPEC>@<version>` suffix, which would put a CLI version in the packet, then the session line naming the door's `ia_session`, the three lanes, `ia_catalogue` and `ia_method` (kit foundation, 2026-10-30). `provenance` is `{revision, slug?}`, `slug` the seat's name: identities stay as they are, and the repository slug is carried only here. The packet names no absolute path, scope token, time, capture state or CLI version, and no record at runtime placement is part of it (R15). Two roots so give byte-equal packets and digests, and a capture moves only the host note. `entryCount(packet)` is P participants + M mandates + 1 seat + N system lines + T tallies + 5 intent rows + 4 phase rows + C catalog rows + 1 provenance + 4 SPEC lines, the host note no entry. A fresh init (P = M = 1, T = 3) has 20 + C + N entries: 29 + N with the CLI's nine catalog rows. `tests/packet.test.ts` pins a golden packet in `tests/golden/` (revision and body digest masked and asserted apart; only `node packages/runtime/tests/golden/write.mjs` regenerates it) for the three records a fresh `ia init` authors (`tests/fixtures/packet/workspace.ia`) over the conformance corpus adopted at band 90, with 40 entries under a nine-row catalog fixture. It also pins the formula on that fixture, on the conformance corpus and on this repository's own records, its terms counted from the admitted records (N from the seat's `composition.systems`, T from the words of the band-100 membership rows under the seat's own declared roots, P and M from the band-100 mandates scoped to the seat whose participant is a band-100 agent) rather than from the packet, and pins these counts under the nine-row fixture: 29 on the conformance corpus and 54 on this repository after separating neutral examples from its live corpus, which its committed `CLAUDE.md` renders too; no participant and no refusal on the conformance corpus and for a mandate whose participant is adopted; two participants named by three mandates, each agent once and both by identity, with a mandate's excluded words and covers; a mandate declaring `moves []` refused by admission and rendered as no mandate, with position still running, and an admitted one with fragment references rendered with no refusal; an adopted mandate scoped to the seat left out; the tallies of a declared root narrower than the corpus, and none for a seat that declares no root; a narrowed scope token, which leaves out an @agent and a @system it does not admit (the system line `unresolved`, no participant or mandate, the steward as authored, no tally of the left-out word); a `@system` at runtime placement read as unresolved; a repository root no admitted `@workspace` is declared at, with no seat identity, system line, tally or slug; the frozen output, its intent rows copies of the kernel's; byte-equal packets and digests at two roots, naming neither root nor token; `body` equal to position(K0)'s digest; a capture moving the host note and neither the packet nor its digest; an unresolved `composition.systems` reference and system lines authored out of identity order; and the intent and phase tables, a word with an authority facet seeded under governance by its lane. apps/cli pins its catalog rows, each command's mode and move, a one-line refusal and one next command of COMMANDS.
|
|
110
116
|
|
|
111
117
|
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
118
|
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Bindings: which kit and capability answer an entry point's activity in a repository, read from the interim sidecar
|
|
3
|
+
* `<repo>/.ia/bindings.json`:
|
|
4
|
+
* `{ format: 1, bindings: { "<entry>.<activity>": binding | [binding, ...] }, precedence?: [kit id, ...], defaults?: { <entry>: binding } }`,
|
|
5
|
+
* where a binding is `{ kit, capability, profile? }`. `<entry>.*` answers every activity of the entry without an exact
|
|
6
|
+
* key, and `defaults.<entry>` answers when neither does. Several candidates for one key conflict unless `precedence`
|
|
7
|
+
* orders them. The entry points are Work, Delivery and Knowledge; Delivery took Development's place.
|
|
8
|
+
*/
|
|
9
|
+
export declare const ENTRIES: readonly ["work", "delivery", "knowledge"];
|
|
10
|
+
export type Entry = (typeof ENTRIES)[number];
|
|
11
|
+
export declare const RENAMED: Readonly<Record<string, string>>;
|
|
12
|
+
export declare const renamedMessage: (entry: string) => string;
|
|
13
|
+
export interface Binding {
|
|
14
|
+
readonly kit: string;
|
|
15
|
+
readonly capability: string;
|
|
16
|
+
readonly profile?: string;
|
|
17
|
+
}
|
|
18
|
+
export interface Bindings {
|
|
19
|
+
readonly format: 1;
|
|
20
|
+
readonly path: string;
|
|
21
|
+
readonly bindings: Readonly<Record<string, readonly Binding[]>>;
|
|
22
|
+
readonly precedence: readonly string[];
|
|
23
|
+
readonly defaults: Readonly<Record<string, Binding>>;
|
|
24
|
+
}
|
|
25
|
+
export interface SelectedBinding extends Binding {
|
|
26
|
+
readonly key: string;
|
|
27
|
+
readonly via: string;
|
|
28
|
+
}
|
|
29
|
+
export declare const bindingsPath: (root: string) => string;
|
|
30
|
+
/** The parsed sidecar, or null when the repository has none. */
|
|
31
|
+
export declare function readBindings(root: string): Bindings | null;
|
|
32
|
+
/** The one binding for `<entry>.<activity>`, with how it was chosen: exact, wildcard or default, then precedence. */
|
|
33
|
+
export declare function selectBinding(data: Bindings | null, entry: string, activity: string): SelectedBinding;
|
|
34
|
+
/** The nearest folder at or above `from` that holds `.ia/src`, or null. */
|
|
35
|
+
export declare function findWorkspace(from: string): string | null;
|
|
36
|
+
/**
|
|
37
|
+
* The scope key each entry point's activity states to the position: a shape (the intent) and a phase (the moment). An
|
|
38
|
+
* activity the table does not name takes its entry's default; an explicit shape or phase overrides either.
|
|
39
|
+
*/
|
|
40
|
+
export declare const SCOPE_KEYS: Readonly<Record<Entry, Readonly<Record<string, readonly [string, string]>>>>;
|
|
41
|
+
export declare const SHAPES: readonly ["context", "governance", "execution", "sequence", "learning"];
|
|
42
|
+
export declare const PHASES: readonly ["orient", "plan", "act", "learn"];
|
|
43
|
+
export declare function scopeKey(entry: string, activity: string, overrides?: {
|
|
44
|
+
readonly shape?: string | undefined;
|
|
45
|
+
readonly phase?: string | undefined;
|
|
46
|
+
}): {
|
|
47
|
+
readonly shape: string;
|
|
48
|
+
readonly phase: string;
|
|
49
|
+
readonly mapped: boolean;
|
|
50
|
+
};
|
|
51
|
+
//# sourceMappingURL=bindings.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"bindings.d.ts","sourceRoot":"","sources":["../../src/method/bindings.ts"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AACH,eAAO,MAAM,OAAO,4CAA6C,CAAC;AAClE,MAAM,MAAM,KAAK,GAAG,CAAC,OAAO,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;AAC7C,eAAO,MAAM,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAA+B,CAAC;AACrF,eAAO,MAAM,cAAc,GAAI,OAAO,MAAM,KAAG,MAC0D,CAAC;AAE1G,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AACD,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,CAAC,CAAC,CAAC;IAChE,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACtD;AACD,MAAM,WAAW,eAAgB,SAAQ,OAAO;IAC9C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,YAAY,GAAI,MAAM,MAAM,KAAG,MAA4C,CAAC;AAkBzF,gEAAgE;AAChE,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAsC1D;AAED,qHAAqH;AACrH,wBAAgB,aAAa,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,eAAe,CAsCrG;AAED,2EAA2E;AAC3E,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAczD;AAED;;;GAGG;AACH,eAAO,MAAM,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CA4BnG,CAAC;AACF,eAAO,MAAM,MAAM,yEAA0E,CAAC;AAC9F,eAAO,MAAM,MAAM,6CAA8C,CAAC;AAElE,wBAAgB,QAAQ,CACtB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,SAAS,GAAE;IAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAO,GAC3F;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAc9E"}
|
|
@@ -0,0 +1,166 @@
|
|
|
1
|
+
import { existsSync, readFileSync, realpathSync } from 'node:fs';
|
|
2
|
+
import { dirname, join, resolve } from 'node:path';
|
|
3
|
+
import { MethodError } from './errors.js';
|
|
4
|
+
/**
|
|
5
|
+
* Bindings: which kit and capability answer an entry point's activity in a repository, read from the interim sidecar
|
|
6
|
+
* `<repo>/.ia/bindings.json`:
|
|
7
|
+
* `{ format: 1, bindings: { "<entry>.<activity>": binding | [binding, ...] }, precedence?: [kit id, ...], defaults?: { <entry>: binding } }`,
|
|
8
|
+
* where a binding is `{ kit, capability, profile? }`. `<entry>.*` answers every activity of the entry without an exact
|
|
9
|
+
* key, and `defaults.<entry>` answers when neither does. Several candidates for one key conflict unless `precedence`
|
|
10
|
+
* orders them. The entry points are Work, Delivery and Knowledge; Delivery took Development's place.
|
|
11
|
+
*/
|
|
12
|
+
export const ENTRIES = ['work', 'delivery', 'knowledge'];
|
|
13
|
+
export const RENAMED = { development: 'delivery' };
|
|
14
|
+
export const renamedMessage = (entry) => `the ${entry} entry point is now ${RENAMED[entry]}: write ${RENAMED[entry]} where ${entry} was written`;
|
|
15
|
+
export const bindingsPath = (root) => join(root, '.ia', 'bindings.json');
|
|
16
|
+
function checkBinding(value, where) {
|
|
17
|
+
const row = value;
|
|
18
|
+
if (typeof row !== 'object' ||
|
|
19
|
+
row === null ||
|
|
20
|
+
typeof row['kit'] !== 'string' ||
|
|
21
|
+
typeof row['capability'] !== 'string')
|
|
22
|
+
throw new MethodError(`${where} needs { kit, capability }`, 'IA-CORE-BINDINGS-MALFORMED');
|
|
23
|
+
return {
|
|
24
|
+
kit: row['kit'],
|
|
25
|
+
capability: row['capability'],
|
|
26
|
+
...(row['profile'] ? { profile: row['profile'] } : {}),
|
|
27
|
+
};
|
|
28
|
+
}
|
|
29
|
+
/** The parsed sidecar, or null when the repository has none. */
|
|
30
|
+
export function readBindings(root) {
|
|
31
|
+
const path = bindingsPath(root);
|
|
32
|
+
if (!existsSync(path))
|
|
33
|
+
return null;
|
|
34
|
+
let parsed;
|
|
35
|
+
try {
|
|
36
|
+
parsed = JSON.parse(readFileSync(path, 'utf8'));
|
|
37
|
+
}
|
|
38
|
+
catch (error) {
|
|
39
|
+
throw new MethodError(`${path} is not JSON: ${error.message}`, 'IA-CORE-BINDINGS-MALFORMED');
|
|
40
|
+
}
|
|
41
|
+
const declared = parsed['bindings'];
|
|
42
|
+
if (parsed['format'] !== 1 || typeof declared !== 'object' || declared === null)
|
|
43
|
+
throw new MethodError(`${path} needs format 1 and a bindings object`, 'IA-CORE-BINDINGS-MALFORMED');
|
|
44
|
+
const bindings = {};
|
|
45
|
+
for (const [key, value] of Object.entries(declared)) {
|
|
46
|
+
if (!/^[a-z]+\.(?:[a-z][a-z0-9-]*|\*)$/.test(key))
|
|
47
|
+
throw new MethodError(`${path}: key ${key} is not <entry>.<activity>`, 'IA-CORE-BINDINGS-MALFORMED');
|
|
48
|
+
const entry = key.slice(0, key.indexOf('.'));
|
|
49
|
+
if (RENAMED[entry])
|
|
50
|
+
throw new MethodError(`${path}: key ${key}: ${renamedMessage(entry)}, so ${RENAMED[entry]}${key.slice(entry.length)}`, 'IA-CORE-BINDINGS-MALFORMED', { key });
|
|
51
|
+
bindings[key] = (Array.isArray(value) ? value : [value]).map((v, i) => checkBinding(v, `${path}: ${key}[${i}]`));
|
|
52
|
+
}
|
|
53
|
+
const precedence = parsed['precedence'] ?? [];
|
|
54
|
+
if (!Array.isArray(precedence) || !precedence.every((p) => typeof p === 'string'))
|
|
55
|
+
throw new MethodError(`${path}: precedence must be a list of kit ids`, 'IA-CORE-BINDINGS-MALFORMED');
|
|
56
|
+
const defaults = {};
|
|
57
|
+
for (const [entry, value] of Object.entries((parsed['defaults'] ?? {}))) {
|
|
58
|
+
if (RENAMED[entry])
|
|
59
|
+
throw new MethodError(`${path}: defaults.${entry}: ${renamedMessage(entry)}, so defaults.${RENAMED[entry]}`, 'IA-CORE-BINDINGS-MALFORMED');
|
|
60
|
+
defaults[entry] = checkBinding(value, `${path}: defaults.${entry}`);
|
|
61
|
+
}
|
|
62
|
+
return { format: 1, path, bindings, precedence: precedence, defaults };
|
|
63
|
+
}
|
|
64
|
+
/** The one binding for `<entry>.<activity>`, with how it was chosen: exact, wildcard or default, then precedence. */
|
|
65
|
+
export function selectBinding(data, entry, activity) {
|
|
66
|
+
if (RENAMED[entry])
|
|
67
|
+
throw new MethodError(renamedMessage(entry), 'IA-CORE-USAGE');
|
|
68
|
+
if (!ENTRIES.includes(entry))
|
|
69
|
+
throw new MethodError(`unknown entry point ${entry}; the entry points are ${ENTRIES.join(', ')}`, 'IA-CORE-USAGE');
|
|
70
|
+
const key = `${entry}.${activity}`;
|
|
71
|
+
const none = () => new MethodError(`no method is bound for ${key} in this repository: .ia/bindings.json names no ${key}, no ${entry}.*, and no defaults.${entry}. List the kits with kit.mjs list and bind one with bind.mjs set ${key} <kit> <capability>`, 'IA-CORE-NO-METHOD', { key });
|
|
72
|
+
if (!data)
|
|
73
|
+
throw none();
|
|
74
|
+
let candidates, via;
|
|
75
|
+
const exact = data.bindings[key], wildcard = data.bindings[`${entry}.*`], fallback = data.defaults[entry];
|
|
76
|
+
if (exact?.length) {
|
|
77
|
+
candidates = exact;
|
|
78
|
+
via = 'exact';
|
|
79
|
+
}
|
|
80
|
+
else if (wildcard?.length) {
|
|
81
|
+
candidates = wildcard;
|
|
82
|
+
via = 'wildcard';
|
|
83
|
+
}
|
|
84
|
+
else if (fallback) {
|
|
85
|
+
candidates = [fallback];
|
|
86
|
+
via = 'default';
|
|
87
|
+
}
|
|
88
|
+
else
|
|
89
|
+
throw none();
|
|
90
|
+
if (candidates.length === 1)
|
|
91
|
+
return { ...candidates[0], key, via };
|
|
92
|
+
const ranked = candidates
|
|
93
|
+
.map((c) => ({ c, rank: data.precedence.indexOf(c.kit) }))
|
|
94
|
+
.filter((r) => r.rank >= 0)
|
|
95
|
+
.sort((a, b) => a.rank - b.rank);
|
|
96
|
+
if (ranked.length === 0 || (ranked.length > 1 && ranked[0].rank === ranked[1].rank))
|
|
97
|
+
throw new MethodError(`${key} is bound to ${candidates.length} methods and precedence does not order them: ${candidates.map((c) => `${c.kit}#${c.capability}`).join(', ')}. Run bind.mjs precedence <kit...> to rank the kits, or bind.mjs set ${key} <kit> <capability> to keep one`, 'IA-CORE-CONFLICT', { key, candidates: candidates.map((c) => ({ kit: c.kit, capability: c.capability })) });
|
|
98
|
+
return { ...ranked[0].c, key, via: `${via}+precedence` };
|
|
99
|
+
}
|
|
100
|
+
/** The nearest folder at or above `from` that holds `.ia/src`, or null. */
|
|
101
|
+
export function findWorkspace(from) {
|
|
102
|
+
let dir = resolve(from);
|
|
103
|
+
try {
|
|
104
|
+
dir = realpathSync.native(dir);
|
|
105
|
+
}
|
|
106
|
+
catch {
|
|
107
|
+
dir = resolve(from);
|
|
108
|
+
}
|
|
109
|
+
for (let i = 0; i < 64; i++) {
|
|
110
|
+
if (existsSync(join(dir, '.ia', 'src')))
|
|
111
|
+
return dir;
|
|
112
|
+
const parent = dirname(dir);
|
|
113
|
+
if (parent === dir)
|
|
114
|
+
return null;
|
|
115
|
+
dir = parent;
|
|
116
|
+
}
|
|
117
|
+
return null;
|
|
118
|
+
}
|
|
119
|
+
/**
|
|
120
|
+
* The scope key each entry point's activity states to the position: a shape (the intent) and a phase (the moment). An
|
|
121
|
+
* activity the table does not name takes its entry's default; an explicit shape or phase overrides either.
|
|
122
|
+
*/
|
|
123
|
+
export const SCOPE_KEYS = {
|
|
124
|
+
work: {
|
|
125
|
+
default: ['governance', 'plan'],
|
|
126
|
+
task: ['governance', 'plan'],
|
|
127
|
+
decision: ['governance', 'plan'],
|
|
128
|
+
dependencies: ['sequence', 'plan'],
|
|
129
|
+
delegation: ['execution', 'act'],
|
|
130
|
+
progress: ['context', 'orient'],
|
|
131
|
+
completion: ['learning', 'learn'],
|
|
132
|
+
},
|
|
133
|
+
delivery: {
|
|
134
|
+
default: ['execution', 'act'],
|
|
135
|
+
understand: ['context', 'orient'],
|
|
136
|
+
design: ['governance', 'plan'],
|
|
137
|
+
change: ['execution', 'act'],
|
|
138
|
+
diagnose: ['context', 'orient'],
|
|
139
|
+
review: ['learning', 'learn'],
|
|
140
|
+
deliver: ['learning', 'learn'],
|
|
141
|
+
},
|
|
142
|
+
knowledge: {
|
|
143
|
+
default: ['context', 'orient'],
|
|
144
|
+
find: ['context', 'orient'],
|
|
145
|
+
explain: ['context', 'orient'],
|
|
146
|
+
packet: ['context', 'orient'],
|
|
147
|
+
place: ['governance', 'plan'],
|
|
148
|
+
reconcile: ['learning', 'learn'],
|
|
149
|
+
maintain: ['execution', 'act'],
|
|
150
|
+
},
|
|
151
|
+
};
|
|
152
|
+
export const SHAPES = ['context', 'governance', 'execution', 'sequence', 'learning'];
|
|
153
|
+
export const PHASES = ['orient', 'plan', 'act', 'learn'];
|
|
154
|
+
export function scopeKey(entry, activity, overrides = {}) {
|
|
155
|
+
const table = Object.hasOwn(SCOPE_KEYS, entry) ? SCOPE_KEYS[entry] : null;
|
|
156
|
+
if (!table)
|
|
157
|
+
throw new MethodError(`unknown entry point ${entry}; the entry points are ${Object.keys(SCOPE_KEYS).join(', ')}`, 'IA-CORE-USAGE');
|
|
158
|
+
const mapped = Object.hasOwn(table, activity);
|
|
159
|
+
const [shape, phase] = (mapped ? table[activity] : table['default']);
|
|
160
|
+
if (overrides.shape && !SHAPES.includes(overrides.shape))
|
|
161
|
+
throw new MethodError(`--shape must be one of ${SHAPES.join(', ')}`, 'IA-CORE-USAGE');
|
|
162
|
+
if (overrides.phase && !PHASES.includes(overrides.phase))
|
|
163
|
+
throw new MethodError(`--phase must be one of ${PHASES.join(', ')}`, 'IA-CORE-USAGE');
|
|
164
|
+
return { shape: overrides.shape ?? shape, phase: overrides.phase ?? phase, mapped };
|
|
165
|
+
}
|
|
166
|
+
//# sourceMappingURL=bindings.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"bindings.js","sourceRoot":"","sources":["../../src/method/bindings.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
import type { Entry } from './bindings.js';
|
|
2
|
+
import type { Kit } from './kits.js';
|
|
3
|
+
/**
|
|
4
|
+
* A lane's catalogue: the activities a model can map a request to, each a key it then hands to `resolveMethod`. Its
|
|
5
|
+
* sources are each kit's `bindings.json` recommendations for the lane, the workspace's `.ia/bindings.json`, and each
|
|
6
|
+
* lane kit's `delivery.json` whole capabilities no key yet names. An item is `bound` when the workspace binds its key,
|
|
7
|
+
* else `installed`; `entitled` is an account connector's and never this catalogue's. No free text is read: the lane,
|
|
8
|
+
* word and phase are closed tokens.
|
|
9
|
+
*/
|
|
10
|
+
export type CatalogueState = 'bound' | 'installed' | 'entitled';
|
|
11
|
+
export interface CatalogueItem {
|
|
12
|
+
readonly key: string;
|
|
13
|
+
readonly display: string;
|
|
14
|
+
readonly kit: string;
|
|
15
|
+
readonly version: string | null;
|
|
16
|
+
readonly capability?: string;
|
|
17
|
+
readonly profile?: string;
|
|
18
|
+
readonly description: string;
|
|
19
|
+
readonly state: CatalogueState;
|
|
20
|
+
}
|
|
21
|
+
export interface Catalogue {
|
|
22
|
+
readonly lane: Entry;
|
|
23
|
+
readonly items: readonly CatalogueItem[];
|
|
24
|
+
}
|
|
25
|
+
export declare const DESCRIPTION_LIMIT = 200;
|
|
26
|
+
/** `ia-<lane>:<activity>`, and `ia-<lane>` for the lane's own `<lane>.*` key. */
|
|
27
|
+
export declare const displayName: (key: string) => string;
|
|
28
|
+
/** Each `@capability` record's `meaning.says` in a kit's sources, by name, read as text without opening the kit. */
|
|
29
|
+
export declare function capabilityDescriptions(kitDir: string): ReadonlyMap<string, string>;
|
|
30
|
+
/** The catalogue of one lane, for a workspace root (or none) and the kits a resolve can read. */
|
|
31
|
+
export declare function laneCatalogue(request: {
|
|
32
|
+
readonly lane: string;
|
|
33
|
+
readonly word?: string;
|
|
34
|
+
readonly phase?: string;
|
|
35
|
+
}, context: {
|
|
36
|
+
readonly root: string | null;
|
|
37
|
+
readonly kits: readonly Kit[];
|
|
38
|
+
}): Catalogue;
|
|
39
|
+
//# sourceMappingURL=catalogue.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"catalogue.d.ts","sourceRoot":"","sources":["../../src/method/catalogue.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAG3C,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAErC;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,WAAW,GAAG,UAAU,CAAC;AAChE,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;CAChC;AACD,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;CAC1C;AACD,eAAO,MAAM,iBAAiB,MAAM,CAAC;AAErC,iFAAiF;AACjF,eAAO,MAAM,WAAW,GAAI,KAAK,MAAM,KAAG,MAGzC,CAAC;AASF,oHAAoH;AACpH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAoBlF;AAMD,iGAAiG;AACjG,wBAAgB,aAAa,CAC3B,OAAO,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,EACnF,OAAO,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,EAAE,CAAA;CAAE,GACvE,SAAS,CAuEX"}
|