@lapxo/bound 0.2.0 → 0.2.1

package/dist/host/refusals.d.ts

@@ -0,0 +1,14 @@
+export interface RefusalEntry {
+    readonly code: string;
+    readonly category: string;
+    readonly meaning: string;
+    readonly next: string;
+}
+/** Stable code assigned at the cause. Details are diagnostic, never parsed as policy. */
+export declare class BoundRefusal extends Error {
+    readonly code: string;
+    constructor(code: string, diagnostic: string);
+}
+/** Pure machine contract reader. A catalog is data, never an authority grant. */
+export declare function readRefusalCatalog(text: string): readonly RefusalEntry[];
+export declare function describeRefusal(error: BoundRefusal, catalog: readonly RefusalEntry[]): RefusalEntry;

package/dist/host/refusals.js

@@ -0,0 +1,43 @@
+import { parse, canonical } from '@lapxo/topos/wire';
+/** Stable code assigned at the cause. Details are diagnostic, never parsed as policy. */
+export class BoundRefusal extends Error {
+    constructor(code, diagnostic) { super(diagnostic); this.name = 'BoundRefusal'; this.code = code; }
+}
+/** Pure machine contract reader. A catalog is data, never an authority grant. */
+export function readRefusalCatalog(text) {
+    const groups = new Map();
+    let profile = false;
+    for (const line of text.trimEnd().split('\n')) {
+        const parsed = parse(line);
+        if (parsed.kind !== 'fact' || canonical(parsed.value.fields) !== line)
+            throw new BoundRefusal('catalog/invalid', 'REFUSE·invalid refusal catalog line');
+        const f = parsed.value.fields;
+        if (f.scope === 'refusal/catalog' && f.measure === 'id' && f.value === 'bound-refusals@1' && f.role === 'writes' && f.form === 'alphabet' && !profile) {
+            profile = true;
+            continue;
+        }
+        if (f.role !== 'writes' || f.form !== 'alphabet' || !f.scope?.startsWith('refusal/') || !['code', 'class', 'next'].includes(f.measure ?? ''))
+            throw new BoundRefusal('catalog/invalid', 'REFUSE·invalid refusal catalog record');
+        const group = groups.get(f.scope) ?? new Map();
+        if (group.has(f.measure))
+            throw new BoundRefusal('catalog/invalid', 'REFUSE·duplicate refusal catalog field');
+        group.set(f.measure, f);
+        groups.set(f.scope, group);
+    }
+    const entries = [];
+    for (const [scope, group] of groups) {
+        const code = group.get('code')?.value, category = group.get('class')?.value, meaning = group.get('class')?.about, next = group.get('next')?.value;
+        if (group.size !== 3 || !code || scope !== 'refusal/' + code || !category || !meaning || !next)
+            throw new BoundRefusal('catalog/invalid', 'REFUSE·incomplete refusal catalog entry');
+        entries.push(Object.freeze({ code, category, meaning, next }));
+    }
+    if (!profile || !entries.length)
+        throw new BoundRefusal('catalog/invalid', 'REFUSE·missing refusal catalog profile');
+    return Object.freeze(entries);
+}
+export function describeRefusal(error, catalog) {
+    const entry = catalog.find(row => row.code === error.code);
+    if (!entry)
+        throw new BoundRefusal('catalog/invalid', 'REFUSE·undeclared refusal code');
+    return entry;
+}

package/dist/host/signing.js

@@ -1,3 +1,4 @@
+import { invokeSigningPort } from "../engine/ports.js";
 import { readFileSync } from 'node:fs';
 import { parse, signerSelection, signerRequestBytes, signerResponseBytes, signerResponseOf } from '@lapxo/topos/wire';
 import { invokeSigner, SigningFailure } from "./ports/signing.js";
@@ -31,11 +32,16 @@ function binding(name, keyFile) {
     }
 }
 /** Resolve data before acquisition; all mechanisms use one wire protocol and verification path. */
-export function signerFor(lines, keyId, selected, keyFile) {
+export function signerFor(lines, keyId, selected, keyFile, injected) {
     const fields = lines.flatMap(line => { const got = parse(line); return got.kind === 'fact' ? [got.value.fields] : []; });
     const declaration = signerSelection(fields, keyId);
     if (selected !== undefined && selected !== declaration.name)
         throw new SigningFailure(`REFUSE·signer ${keyId} CLI selection conflicts with declaration`);
+    if (injected) {
+        if (injected.name !== declaration.name || keyFile)
+            throw new SigningFailure('REFUSE·signer injected host binding conflicts with declaration or key file');
+        return (lot) => invokeSigningPort(lot, injected.sign, { timeoutMs: declaration.timeoutMs, maxBytes: declaration.responseBytes });
+    }
     const mechanism = binding(declaration.name, keyFile);
     const protocol = { request: signerRequestBytes, response: signerResponseBytes, reply: signerResponseOf };
     return (lot) => invokeSigner(lot, mechanism, protocol, declaration);

package/dist/observe/files.js

@@ -24,7 +24,17 @@ function bytesAt(at) {
     const held = seen.get(at);
     if (held?.stamp === stamp)
         return held.bytes;
-    const bytes = readFileSync(at);
+    let bytes;
+    try {
+        bytes = readFileSync(at);
+    }
+    catch (error) {
+        // A concurrent act can retire a coordinate after its stamp was read.
+        if (error.code !== 'ENOENT')
+            throw error;
+        seen.delete(at);
+        return undefined;
+    }
     seen.set(at, { stamp, bytes });
     return bytes;
 }

package/dist/wasm/object.js

@@ -10,9 +10,9 @@ export function usesWasmObject(configuration) {
     const rows = configuration.filter(f => f.scope === 'engine/object' && f.value !== 'withdraw');
     if (!rows.length)
         return false;
-    if (rows.length !== 1 || rows[0].role !== 'writes' || rows[0].measure !== 'id' || rows[0].form !== 'alphabet' || rows[0].value !== 'wasm@1')
+    if (rows.length !== 1 || rows[0].role !== 'writes' || rows[0].measure !== 'id' || rows[0].form !== 'alphabet' || !['esm@1', 'wasm@1'].includes(rows[0].value ?? ''))
         refuse('unique declared backend required');
-    return true;
+    return rows[0].value === 'wasm@1';
 }
 function limit(configuration, name, measure) {
     const rows = configuration.filter(f => f.scope === 'engine/wasm/' + name && f.value !== 'withdraw');

package/docs/contracts/authenticated-reference.publication.json

@@ -4,7 +4,7 @@
     {
       "role": "contract",
       "path": "docs/contracts/reference-port.md",
-      "digest": "sha256:ae500aaec7e94dc9bc7c4d45e3294b212b0ad5ade7647e3ce24807ca7a0ea7cc"
+      "digest": "sha256:d6198b9ab177086cb334e9e9cd7adb5c67b0af7165a79d23812aa2496d17674c"
     },
     {
       "role": "yes",
@@ -14,7 +14,7 @@
     {
       "role": "vector",
       "path": "vectors/native/authenticated-reference.vector.json",
-      "digest": "sha256:297c4942a847c42eb9d2cf000ab38d8a5f38b64e2e4a469919f0dfc88c9d8bd1"
+      "digest": "sha256:9aba7121fbbb98e63259dea78e52377cd71c628e0d17be20c9a51da27f2b31de"
     },
     {
       "role": "no",

package/docs/contracts/host-ports.md

@@ -0,0 +1,23 @@
+# Public host ports
+
+`/engine` and `/reference` export `readContent`, `retainContent` and `invokeSigningPort`, with `ContentReadPort`, `PersistencePort`, `SigningPort`, `DigestPort` and `PortLimits`. There is no default network, store, account or signer. `objectFold` remains pure and never calls a port.
+
+Every operation takes an explicit positive safe-integer `timeoutMs` and `maxBytes`, and an optional AbortSignal. Invalid limits and pre-cancellation refuse before the callback. Acquisition, digest calculation and retention share the operation lifetime. A timeout aborts the supplied signal and returns no successful result. This is a cooperative host boundary, not preemption of synchronous JavaScript or sandbox confinement.
+
+`readContent(source, digest, ports, limits, signal)` invokes the supplied read callback and SHA-256 callback, checks byte bounds before copying/hashing, rejects shared buffers, and verifies an owned snapshot against the requested digest. Location carries no authority.
+
+`retainContent(digest, bytes, ports, limits, signal)` checks identity before calling the host's atomic byte-retention callback. Its acknowledgement contains only digest and byte count. It is not a signed receipt, admission or permission to reuse a response. The host must implement atomic retention and cooperate with cancellation. A callback that ignores cancellation may finish retaining bytes after the caller has refused; no success, act or authority follows from those bytes. Opening and projection never retain automatically.
+
+`invokeSigningPort(lot, sign, limits, signal)` uses the existing Topos signing request/response framing. It acquires protocol-shaped signatures; it does not decide authority or certify them cryptographically. Native export can receive `hostSigner: {name, sign}` through `/reference/native`. The name must match the admitted signer selection, and cannot be combined with a key-file override. The existing consent path verifies every returned signature against the admitted key, era, scope and epoch before returning a carrier. No key material enters the engine.
+
+Native opening accepts `content: {name, read}`. Its name must match the admitted transport selection, with that selection's existing byte and lifetime bounds. The host callback cannot be chosen by a carrier, reference or repository. The existing inspector verifies the returned carrier again and the selected backend projects only verified records. There is no backend fallback.
+
+Public port failures use the machine refusal catalog: `host-port/budget`, `cancelled`, `timeout`, `failed`, `integrity`, `response`. Native acquisition failures retain their enclosing reference refusal. Host diagnostics are not returned as authority or parsed as codes.
+
+Native vector output, in two real admitted places:
+
+```text
+PORTS owned content · verified retention · signer content persistence failures · budget integrity cancellation timeout refused
+HOST host-sensor · declared signer and content injected · real signature verified · wrong binding refused · no commit
+HOST host-editorial · declared signer and content injected · real signature verified · wrong binding refused · no commit
+```

package/docs/contracts/host-ports.publication.json

@@ -0,0 +1,25 @@
+{
+  "scope": "contract/published/host-ports",
+  "members": [
+    {
+      "role": "contract",
+      "path": "docs/contracts/host-ports.md",
+      "digest": "sha256:f3d646da2399c719469a37293b329d53b72b0478ca97f961b90c1f4e6adc2ae6"
+    },
+    {
+      "role": "yes",
+      "path": "samples/host-ports/yes.json",
+      "digest": "sha256:f8dc3c6939bd8f4bb91cb57e3e9b52a865645cc80ee0f5ce5a11570ef3f31ce3"
+    },
+    {
+      "role": "vector",
+      "path": "vectors/native/host-ports.vector.json",
+      "digest": "sha256:58425f81fb4f1ef6e392d8fa3a5ee3a287ef6fbcbfb11e512fd2e30f24f465e6"
+    },
+    {
+      "role": "no",
+      "path": "samples/host-ports/no.json",
+      "digest": "sha256:ffc9dbb29743d4faa16c5c29eb73a7e0f24cf4da3255a979f628f5c3d8f4b7c1"
+    }
+  ]
+}

package/docs/contracts/native-publication.inventory.json

@@ -3,6 +3,12 @@
   "scope": "contract/published/native",
   "surface": [
     "contract/published/optional-wasm-adapter",
-    "contract/published/authenticated-reference"
+    "contract/published/authenticated-reference",
+    "contract/published/reference-export",
+    "contract/published/reference-backend",
+    "contract/published/standing",
+    "contract/published/refusals",
+    "contract/published/host-ports",
+    "contract/published/readme"
   ]
 }

package/docs/contracts/optional-wasm-adapter.publication.json

@@ -14,7 +14,7 @@
     {
       "role": "vector",
       "path": "vectors/wasm-object.cli.json",
-      "digest": "sha256:5f761fabd0592d7f8e9b95a9fc80583424a8e83fb7cb3c4b4905b62eca43db9e"
+      "digest": "sha256:f0b970ede31b99e00e94f249970aa8c714880dccb03ed7952a3cf01bf24a7c17"
     },
     {
       "role": "no",

package/docs/contracts/readme.publication.json

@@ -0,0 +1,25 @@
+{
+  "scope": "contract/published/readme",
+  "members": [
+    {
+      "role": "contract",
+      "path": "README.md",
+      "digest": "sha256:183fe27e7a8bfdb04f4aefaa785f2b1845da1c5a93562a06a300175a960c72da"
+    },
+    {
+      "role": "yes",
+      "path": "samples/readme/yes.json",
+      "digest": "sha256:37449e6ec4867f034463ca20218d370fe40c1d5dec759871c398fd73109f9f6e"
+    },
+    {
+      "role": "vector",
+      "path": "vectors/native/readme.vector.json",
+      "digest": "sha256:b97b50e102fb6c34851d2769d6029663fb4838e2eb70a9bdb4c168141b8964f3"
+    },
+    {
+      "role": "no",
+      "path": "samples/readme/no.json",
+      "digest": "sha256:6bb243445b009fd94ba021342fca34ea00cf4c5257378d9d7c05840c13166f73"
+    }
+  ]
+}

package/docs/contracts/reference-backend.md

@@ -0,0 +1,24 @@
+# Authenticated native reference opening
+
+`@lapxo/bound/reference/native` exports `exportAuthenticatedReference` and `openAuthenticatedReference`. This is the Node host boundary. The platform-free inspector stays in `/reference`; the pure projector stays in `/engine`.
+
+The receiver admits one `engine/object` declaration: `esm@1` or `wasm@1`. Missing, ambiguous and unknown selections refuse. WASM never falls back to ESM. The native route shares one context preparation, authenticates the received original records, then calls the existing selected projector. It introduces no algebra or alternate interpreter.
+
+The host admits `reference/snapshot`, `reference/epoch`, `reference/proof-scope`, `reference/policy`, `reference/form-implementation`, `reference/records`, and the standing/refusal contract digests. The policy is the independently accepted export policy, not a policy invented from the received carrier. The prepared form implementation must match the admitted expectation, and both interpretation contracts must match the installed bytes. A carrier's accompanying context is public data, not an authority anchor.
+
+Content goes through the declared transport and its existing byte/time limits. The snapshot binds the declared public context, including resource budgets. The native opener accepts an AbortSignal and checks interruption before download and projection; the WASM worker uses its existing cancellation and lifetime contract. This does not claim cancellation of an in-flight native download, browser persistence or arbitrary browser capsules.
+
+WASM uses the installed asset manifest, runtime, guest and exact supported form standings. The caller cannot replace that manifest with a convenient fixture. Its memory, stack, execution, worker-lifetime and response budgets remain explicit admitted interval lines. A form outside that installed closure refuses by name.
+
+The positive fixture uses the previously published native reader archive named in `samples/reference-backend/world-fixture.json`, or the same supported standing and closed modules already laid by digest. Preparation verifies every byte before timed opening. The fixture archive is fetched or retained outside opening measurements; no private store or checkout path identifies it. No provider code executes during archive preparation.
+
+The native quartet opens one signed reference in two unrelated places, once through each explicitly selected backend. It compares authenticated standing, records and canonical projection bytes. Authority-context identity describes authentication, not an execution receipt: equal outputs never authorize reuse of a receipt across implementations. Neither opening signs or commits an act.
+
+Captured semantic markers:
+
+```text
+WASM water-level-reference · authenticated download · same standing · same records · byte-equal ESM projection · altered carrier refused · no commit
+WASM editorial-reference · authenticated download · same standing · same records · byte-equal ESM projection · altered carrier refused · no commit
+```
+
+The no sample changes the carrier while retaining its reference. Integrity refuses before projection. Existing vectors also retain unknown-backend, unsupported-form, byte-budget, authority and cancellation boundaries. The quartet descriptor is `reference-backend.publication.json`; installed-archive release acceptance and L6 remain separate obligations.

package/docs/contracts/reference-backend.publication.json

@@ -0,0 +1,25 @@
+{
+  "scope": "contract/published/reference-backend",
+  "members": [
+    {
+      "role": "contract",
+      "path": "docs/contracts/reference-backend.md",
+      "digest": "sha256:c69fbaac11276efcd8a436f242e07d4fda18137c9987f8bba183fe6d6ea801c6"
+    },
+    {
+      "role": "yes",
+      "path": "samples/reference-backend/yes.json",
+      "digest": "sha256:67657bf32a0b85053bf3778f8e1dc13478aaf7386e39200d6967cc9ff2ef5e6f"
+    },
+    {
+      "role": "vector",
+      "path": "vectors/native/reference-backend.vector.json",
+      "digest": "sha256:05257cf22466c859eb01e1abf660927afb5a9a160d3865053ebdf8649f0f5392"
+    },
+    {
+      "role": "no",
+      "path": "samples/reference-backend/no.json",
+      "digest": "sha256:a4e3dd23533925d117954666eb68c4f54165af3263317c330beed6d13a216626"
+    }
+  ]
+}

package/docs/contracts/reference-export.md

@@ -0,0 +1,31 @@
+# Native authenticated reference export
+
+`bound sign --as reference <source-url> --key <key-id>` exports a public snapshot from an admitted local place. The selected host signer is the place's existing signer port. File signing additionally requires its explicitly supplied `--key-file`; command signing uses the host registry. There is no implicit signer, network fetch or private export runner.
+
+The command prints one JSON value with profile `reference-export@1`, a `reference`, the exact `carrier` text and a public `context`. It neither lands the proof nor advances the place's epoch. It does not publish, write an output directory or alter TARGET, ledgers or receipts. The caller chooses where to deliver these bytes.
+
+The place declares `reference/authentication=authenticated-standing@1`, `reference/proof-scope`, `reference/records`, and an interval `reference/export-bytes` measured in bytes. It also pins `reference/contracts/refusals` and `reference/contracts/standing` to the exact installed contract files. Missing, conflicting or unauthenticated declarations refuse. These are place declarations, not increased general ceilings.
+
+The exporter uses Bound's authenticated Root standing and existing context preparation. It preserves typed effective history and applies the existing configuration projection; it does not implement another fold. If the current carrier profile cannot represent historical authority, it refuses as `reference-export/history` instead of dropping originals or forging a new admission. The separate B3 quartet covers complete public standing across declared classes and committed acts; this carrier still refuses historical authority it cannot represent.
+
+The carrier retains `authenticated-standing@1` framing. Its proof commits to the original canonical signed lines. The proof's witness snapshot also commits, through `reference-export-context@1`, to semantic standing identity, epoch, proof scope, policy, form implementation, public signers, signature algorithms, the refusal-catalog digest, the standing-contract digest, and the declared byte and record budgets. Blob identity remains separate from semantic standing identity and source location.
+
+The exported context is public data, not an authority anchor. A consumer independently accepts its keys, policy and interpretation contracts, then supplies these expectations to `inspectAuthenticatedReference`. When `contracts` is supplied, that existing API verifies the context snapshot before requesting bytes. Altering either contract digest or a resource budget invalidates that snapshot. Existing callers without the new context retain their 0.2.0 inspection contract; that compatibility does not assert verification of the added interpretation contracts.
+
+`/engine` remains pure. Exporting a reference does not select WASM, and B1 does not claim B2's backend composition. Signature, authority and context checks precede projection. `next` recommendations from `refusals.bound` grant no permission to execute, repair or sign.
+
+## Conformance quartet
+
+- Positive data: `samples/reference-export/yes.json`. The native test bootstraps a real Root with a disposable key and admits its cell and claim through `bound land`. It then executes this public signing command and verifies the result through the public reference API and unchanged engine.
+- Negative data: `samples/reference-export/no.json`. Changing a carrier byte refuses on blob integrity before projection.
+- Vector: `vectors/native/reference-export.vector.json`. It runs the tracked conformance test, which invokes the actual CLI for bootstrap, admission and export. No private runner or pre-signed fixture stands in for those operations.
+- Additional boundaries: changed contract identities, changed byte budget, invalid source, unauthorized key and invalid signer response. Export and refusal leave the real Root's TARGET and complete ledger inventory unchanged.
+
+Captured semantic markers from the native run:
+
+```text
+EXPORT real-admission · contracts-bound · signatures-verified · REQUIRED · no commit
+REFUSE altered-carrier · blob integrity
+```
+
+Keys are generated outside the repository and discarded by the test. Captures contain no private key, local path or successful receipt for a failed export. Fixture preparation and each CLI invocation have their own existing bounds; the enclosing conformance runner's lifetime is not a cost claim for any individual reading. Release admission, portable release receipts and exact-artifact acceptance remain separate from this quartet.

package/docs/contracts/reference-export.publication.json

@@ -0,0 +1,25 @@
+{
+  "scope": "contract/published/reference-export",
+  "members": [
+    {
+      "role": "contract",
+      "path": "docs/contracts/reference-export.md",
+      "digest": "sha256:08e12bbed83729f42f905e03f090126181df952b678a92fe06a0e24eefc106f4"
+    },
+    {
+      "role": "yes",
+      "path": "samples/reference-export/yes.json",
+      "digest": "sha256:550baaffd4a431c550a613bdfa146eea1ef7630e80a6db9bec39bffb5d51cce6"
+    },
+    {
+      "role": "vector",
+      "path": "vectors/native/reference-export.vector.json",
+      "digest": "sha256:54546281a22234178664cb77996df8e059fd4080e1381a64d51b87513f620bc9"
+    },
+    {
+      "role": "no",
+      "path": "samples/reference-export/no.json",
+      "digest": "sha256:b4351ab6dd579c6c37bd34323228cb6bd992a478b9ccbce2b1ad60abafa78760"
+    }
+  ]
+}

package/docs/contracts/reference-port.md

@@ -24,10 +24,17 @@ Without the authenticated profile, the existing CLI reference branch remains exp
 
 ### Native authenticated opening
 
-The same reference command consumes `reference/authentication form=alphabet measure=id value=authenticated-standing@1` from the selected local place. Without that declaration the existing inspection remains explicitly unauthenticated. With it the host requires unique authenticated declarations for `reference/snapshot`, `reference/epoch`, `reference/proof-scope` and `reference/records` (all `measure=id`); the snapshot is a typed SHA-256 digest, epoch and record budget are safe integers, and the record budget is positive. The declared transport supplies its own existing byte and lifetime bounds.
+The same reference command consumes `reference/authentication form=alphabet measure=id value=authenticated-standing@1` from the selected local place. Without that declaration the existing inspection remains explicitly unauthenticated. With it the host requires unique authenticated declarations for `engine/object` (`esm@1` or `wasm@1`), `reference/snapshot`, `reference/epoch`, `reference/proof-scope`, `reference/records`, `reference/policy`, `reference/form-implementation`, `reference/contracts/refusals` and `reference/contracts/standing` (all `measure=id`); the snapshot is a typed SHA-256 digest, epoch and record budget are safe integers, and the record budget is positive. The declared transport supplies its own existing byte and lifetime bounds.
 
 Trust comes from the local place's admitted keys, signature eras, snapshot and selected object interpretation, including origin and witness grants. No key, grant or verifier supplied by the carrier becomes host authority. The public path delegates signatures, historical authority, wire interpretation, effective order and context admission to the existing SDK and projects admitted records through the existing engine. Signature, coverage, era, effective-order, blob-integrity and semantic-identity failures refuse before any authenticated result or cell output.
 
 Opening prints the source, authenticated semantic standing, object results and authority-context identity. It does not land an act or emit a successful partial result. Existing private content-cache stamps and store accounting may be updated; those are distinct from the public place, its signed authority and its committed history. Inspection does not grant permission to reuse an old response as a current one.
 
 For the opt-in `authenticated-standing@1` profile, the host checks the selected context offer’s SHA-256 `restsOn` members and uses the existing `moduleClosure` before importing that context. A missing, altered, undeclared or unresolved import refuses before context code executes. The same preparation applies when the explicit object view selects `wasm@1`; absent these opt-in profiles, the existing path is unchanged. Import closure proves neither correctness nor sandbox confinement, creates no authority, and does not authorize current-answer reuse.
+
+
+### Compatibility of published 0.2.0 carriers
+
+The original weather and editorial carriers, their signatures and effective-order counterexamples remain byte-identical. `inspectAuthenticatedReference` accepts their independently supplied legacy trust tuple without inventing the newer contract commitments. Its native vector verifies both positive carriers and their arrival-equivalent projection, and rejects signature, coverage, era, effective-order, blob and semantic-standing failures. Authority and context preparation use the existing host and SDK; no replacement verifier or form algebra is supplied by the carrier.
+
+This preserves the carrier/API contract, not an implicit native backend. The historical receiver TARGETs omit the explicit backend and interpretation-contract lines required by native opening in 0.2.1. They therefore refuse with `reference/backend` before transport; the vector asserts that refusal instead of re-signing or weakening the fixtures. No automatic ESM fallback is added. Native positive opening with the complete admitted context is demonstrated separately by the reference-export and reference-backend quartets, including ESM/WASM equality and altered-byte refusal. `compatibility.json` records every inherited condition and expected result; the no sample still contains the original bad signature.

package/docs/contracts/reference-port.publication.json

@@ -4,7 +4,7 @@
     {
       "role": "contract",
       "path": "docs/contracts/reference-port.md",
-      "digest": "sha256:ae500aaec7e94dc9bc7c4d45e3294b212b0ad5ade7647e3ce24807ca7a0ea7cc"
+      "digest": "sha256:d6198b9ab177086cb334e9e9cd7adb5c67b0af7165a79d23812aa2496d17674c"
     },
     {
       "role": "yes",

package/docs/contracts/refusals.bound

@@ -0,0 +1,94 @@
+bound-lock/1 at=policy:bound-reference-export by=target form=alphabet measure=id role=writes scope=refusal/catalog value=bound-refusals@1
+bound-lock/1 at=policy:bound-reference-export by=target form=alphabet measure=code role=writes scope=refusal/reference-export/source value=reference-export/source
+bound-lock/1 about="The source URL is not a canonical standing-reference location." at=policy:bound-reference-export by=target form=alphabet measure=class role=writes scope=refusal/reference-export/source value=input
+bound-lock/1 at=policy:bound-reference-export by=target form=alphabet measure=next role=writes scope=refusal/reference-export/source value=check-source
+bound-lock/1 at=policy:bound-reference-export by=target form=alphabet measure=code role=writes scope=refusal/reference-export/context value=reference-export/context
+bound-lock/1 about="Required admitted export policy or exact contract bytes are missing or conflicting." at=policy:bound-reference-export by=target form=alphabet measure=class role=writes scope=refusal/reference-export/context value=interpretation
+bound-lock/1 at=policy:bound-reference-export by=target form=alphabet measure=next role=writes scope=refusal/reference-export/context value=inspect-standing
+bound-lock/1 at=policy:bound-reference-export by=target form=alphabet measure=code role=writes scope=refusal/reference-export/budget value=reference-export/budget
+bound-lock/1 about="The export exceeds or lacks its explicitly declared record or byte budget." at=policy:bound-reference-export by=target form=alphabet measure=class role=writes scope=refusal/reference-export/budget value=resource
+bound-lock/1 at=policy:bound-reference-export by=target form=alphabet measure=next role=writes scope=refusal/reference-export/budget value=inspect-resource-lines
+bound-lock/1 at=policy:bound-reference-export by=target form=alphabet measure=code role=writes scope=refusal/reference-export/authority value=reference-export/authority
+bound-lock/1 about="The selected key is not authorized for the snapshot proof at this epoch." at=policy:bound-reference-export by=target form=alphabet measure=class role=writes scope=refusal/reference-export/authority value=authority
+bound-lock/1 at=policy:bound-reference-export by=target form=alphabet measure=next role=writes scope=refusal/reference-export/authority value=inspect-authority
+bound-lock/1 at=policy:bound-reference-export by=target form=alphabet measure=code role=writes scope=refusal/reference-export/signer value=reference-export/signer
+bound-lock/1 about="The selected signer failed or returned a signature that does not verify." at=policy:bound-reference-export by=target form=alphabet measure=class role=writes scope=refusal/reference-export/signer value=host
+bound-lock/1 at=policy:bound-reference-export by=target form=alphabet measure=next role=writes scope=refusal/reference-export/signer value=inspect-signer
+bound-lock/1 at=policy:bound-reference-export by=target form=alphabet measure=code role=writes scope=refusal/reference-export/history value=reference-export/history
+bound-lock/1 about="The current carrier profile cannot represent this historical authority; no original is silently removed." at=policy:bound-reference-export by=target form=alphabet measure=class role=writes scope=refusal/reference-export/history value=authority
+bound-lock/1 at=policy:bound-reference-export by=target form=alphabet measure=next role=writes scope=refusal/reference-export/history value=inspect-standing-contract
+bound-lock/1 at=policy:bound-reference-export by=target form=alphabet measure=code role=writes scope=refusal/catalog/invalid value=catalog/invalid
+bound-lock/1 about="The refusal catalog is malformed, duplicated or incomplete." at=policy:bound-reference-export by=target form=alphabet measure=class role=writes scope=refusal/catalog/invalid value=interpretation
+bound-lock/1 at=policy:bound-reference-export by=target form=alphabet measure=next role=writes scope=refusal/catalog/invalid value=resolve-catalog
+bound-lock/1 at=policy:bound-reference-export by=target form=alphabet measure=code role=writes scope=refusal/reference/format value=reference/format
+bound-lock/1 about="The reference has an unsupported or noncanonical shape." at=policy:bound-reference-export by=target form=alphabet measure=class role=writes scope=refusal/reference/format value=input
+bound-lock/1 at=policy:bound-reference-export by=target form=alphabet measure=next role=writes scope=refusal/reference/format value=check-reference
+bound-lock/1 at=policy:bound-reference-export by=target form=alphabet measure=code role=writes scope=refusal/standing/view value=standing/view
+bound-lock/1 about="The place has not declared the public standing view." at=policy:bound-reference-export by=target form=alphabet measure=class role=writes scope=refusal/standing/view value=interpretation
+bound-lock/1 at=policy:bound-reference-export by=target form=alphabet measure=next role=writes scope=refusal/standing/view value=declare-standing-view
+bound-lock/1 at=policy:bound-reference-export by=target form=alphabet measure=code role=writes scope=refusal/standing/query value=standing/query
+bound-lock/1 about="Standing accepts only the local committed projection." at=policy:bound-reference-export by=target form=alphabet measure=class role=writes scope=refusal/standing/query value=input
+bound-lock/1 at=policy:bound-reference-export by=target form=alphabet measure=next role=writes scope=refusal/standing/query value=query-local-standing
+bound-lock/1 at=policy:bound-reference-export by=target form=alphabet measure=code role=writes scope=refusal/reference-export/usage value=reference-export/usage
+bound-lock/1 about="Reference export requires exactly one source and explicit signing options." at=policy:bound-reference-export by=target form=alphabet measure=class role=writes scope=refusal/reference-export/usage value=input
+bound-lock/1 at=policy:bound-reference-export by=target form=alphabet measure=next role=writes scope=refusal/reference-export/usage value=check-export-arguments
+bound-lock/1 at=policy:bound-reference-export by=target form=alphabet measure=code role=writes scope=refusal/authenticated-reference/context value=authenticated-reference/context
+bound-lock/1 about="The supplied interpretation context or snapshot binding is inconsistent." at=policy:bound-reference-export by=target form=alphabet measure=class role=writes scope=refusal/authenticated-reference/context value=interpretation
+bound-lock/1 at=policy:bound-reference-export by=target form=alphabet measure=next role=writes scope=refusal/authenticated-reference/context value=resolve-public-context
+bound-lock/1 at=policy:bound-reference-export by=target form=alphabet measure=code role=writes scope=refusal/authenticated-reference/budget value=authenticated-reference/budget
+bound-lock/1 about="The declared record or byte budget is invalid or exceeded." at=policy:bound-reference-export by=target form=alphabet measure=class role=writes scope=refusal/authenticated-reference/budget value=resource
+bound-lock/1 at=policy:bound-reference-export by=target form=alphabet measure=next role=writes scope=refusal/authenticated-reference/budget value=inspect-resource-lines
+bound-lock/1 at=policy:bound-reference-export by=target form=alphabet measure=code role=writes scope=refusal/authenticated-reference/transport value=authenticated-reference/transport
+bound-lock/1 about="The content port failed or returned shared mutable bytes." at=policy:bound-reference-export by=target form=alphabet measure=class role=writes scope=refusal/authenticated-reference/transport value=host
+bound-lock/1 at=policy:bound-reference-export by=target form=alphabet measure=next role=writes scope=refusal/authenticated-reference/transport value=inspect-content-port
+bound-lock/1 at=policy:bound-reference-export by=target form=alphabet measure=code role=writes scope=refusal/authenticated-reference/integrity value=authenticated-reference/integrity
+bound-lock/1 about="Carrier bytes or the snapshot commitment differ from their declared digest." at=policy:bound-reference-export by=target form=alphabet measure=class role=writes scope=refusal/authenticated-reference/integrity value=integrity
+bound-lock/1 at=policy:bound-reference-export by=target form=alphabet measure=next role=writes scope=refusal/authenticated-reference/integrity value=resolve-exact-bytes
+bound-lock/1 at=policy:bound-reference-export by=target form=alphabet measure=code role=writes scope=refusal/authenticated-reference/framing value=authenticated-reference/framing
+bound-lock/1 about="The carrier is not the canonical supported UTF-8 frame." at=policy:bound-reference-export by=target form=alphabet measure=class role=writes scope=refusal/authenticated-reference/framing value=input
+bound-lock/1 at=policy:bound-reference-export by=target form=alphabet measure=next role=writes scope=refusal/authenticated-reference/framing value=check-carrier
+bound-lock/1 at=policy:bound-reference-export by=target form=alphabet measure=code role=writes scope=refusal/authenticated-reference/wire value=authenticated-reference/wire
+bound-lock/1 about="An original record is not canonical supported wire." at=policy:bound-reference-export by=target form=alphabet measure=class role=writes scope=refusal/authenticated-reference/wire value=input
+bound-lock/1 at=policy:bound-reference-export by=target form=alphabet measure=next role=writes scope=refusal/authenticated-reference/wire value=check-original-records
+bound-lock/1 at=policy:bound-reference-export by=target form=alphabet measure=code role=writes scope=refusal/authenticated-reference/authority value=authenticated-reference/authority
+bound-lock/1 about="The proof or an original lacks admitted authority under the supplied context." at=policy:bound-reference-export by=target form=alphabet measure=class role=writes scope=refusal/authenticated-reference/authority value=authority
+bound-lock/1 at=policy:bound-reference-export by=target form=alphabet measure=next role=writes scope=refusal/authenticated-reference/authority value=inspect-authority
+bound-lock/1 at=policy:bound-reference-export by=target form=alphabet measure=code role=writes scope=refusal/authenticated-reference/history value=authenticated-reference/history
+bound-lock/1 about="This carrier profile cannot authenticate configuration withdrawal history." at=policy:bound-reference-export by=target form=alphabet measure=class role=writes scope=refusal/authenticated-reference/history value=interpretation
+bound-lock/1 at=policy:bound-reference-export by=target form=alphabet measure=next role=writes scope=refusal/authenticated-reference/history value=request-admitted-standing
+bound-lock/1 at=policy:bound-reference-export by=target form=alphabet measure=code role=writes scope=refusal/authenticated-reference/object-context value=authenticated-reference/object-context
+bound-lock/1 about="The existing object validator refused the declared form or context." at=policy:bound-reference-export by=target form=alphabet measure=class role=writes scope=refusal/authenticated-reference/object-context value=interpretation
+bound-lock/1 at=policy:bound-reference-export by=target form=alphabet measure=next role=writes scope=refusal/authenticated-reference/object-context value=inspect-object-context
+bound-lock/1 at=policy:bound-reference-export by=target form=alphabet measure=code role=writes scope=refusal/authenticated-reference/identity value=authenticated-reference/identity
+bound-lock/1 about="The semantic standing differs from the reference identity." at=policy:bound-reference-export by=target form=alphabet measure=class role=writes scope=refusal/authenticated-reference/identity value=integrity
+bound-lock/1 at=policy:bound-reference-export by=target form=alphabet measure=next role=writes scope=refusal/authenticated-reference/identity value=resolve-standing
+bound-lock/1 at=policy:bound-reference-export by=target form=alphabet measure=code role=writes scope=refusal/operation/failed value=operation/failed
+bound-lock/1 about="An operation failed without a more specific public code; details are diagnostic only." at=policy:bound-reference-export by=target form=alphabet measure=class role=writes scope=refusal/operation/failed value=host
+bound-lock/1 at=policy:bound-reference-export by=target form=alphabet measure=next role=writes scope=refusal/operation/failed value=inspect-diagnostic
+bound-lock/1 at=policy:bound-reference-export by=target form=alphabet measure=code role=writes scope=refusal/operation/usage value=operation/usage
+bound-lock/1 about="The command arguments do not describe a supported public operation." at=policy:bound-reference-export by=target form=alphabet measure=class role=writes scope=refusal/operation/usage value=input
+bound-lock/1 at=policy:bound-reference-export by=target form=alphabet measure=next role=writes scope=refusal/operation/usage value=check-arguments
+bound-lock/1 at=policy:bound-reference-export by=target form=alphabet measure=code role=writes scope=refusal/reference/backend value=reference/backend
+bound-lock/1 about="The host did not select a supported explicit reference backend." at=policy:bound-reference-export by=target form=alphabet measure=class role=writes scope=refusal/reference/backend value=interpretation
+bound-lock/1 at=policy:bound-reference-export by=target form=alphabet measure=next role=writes scope=refusal/reference/backend value=select-reference-backend
+bound-lock/1 at=policy:bound-reference-export by=target form=alphabet measure=code role=writes scope=refusal/reference/cancelled value=reference/cancelled
+bound-lock/1 about="The opening was interrupted before a complete result." at=policy:bound-reference-export by=target form=alphabet measure=class role=writes scope=refusal/reference/cancelled value=host
+bound-lock/1 at=policy:bound-reference-export by=target form=alphabet measure=next role=writes scope=refusal/reference/cancelled value=inspect-interruption
+bound-lock/1 at=policy:bound-host-ports by=target form=alphabet measure=code role=writes scope=refusal/host-port/budget value=host-port/budget
+bound-lock/1 about="A host port lacks a valid finite budget or exceeds its byte bound." at=policy:bound-host-ports by=target form=alphabet measure=class role=writes scope=refusal/host-port/budget value=resource
+bound-lock/1 at=policy:bound-host-ports by=target form=alphabet measure=next role=writes scope=refusal/host-port/budget value=inspect-resource-lines
+bound-lock/1 at=policy:bound-host-ports by=target form=alphabet measure=code role=writes scope=refusal/host-port/cancelled value=host-port/cancelled
+bound-lock/1 about="A host operation was cancelled before a complete result." at=policy:bound-host-ports by=target form=alphabet measure=class role=writes scope=refusal/host-port/cancelled value=host
+bound-lock/1 at=policy:bound-host-ports by=target form=alphabet measure=next role=writes scope=refusal/host-port/cancelled value=inspect-interruption
+bound-lock/1 at=policy:bound-host-ports by=target form=alphabet measure=code role=writes scope=refusal/host-port/timeout value=host-port/timeout
+bound-lock/1 about="A host operation exceeded its declared lifetime." at=policy:bound-host-ports by=target form=alphabet measure=class role=writes scope=refusal/host-port/timeout value=host
+bound-lock/1 at=policy:bound-host-ports by=target form=alphabet measure=next role=writes scope=refusal/host-port/timeout value=inspect-host-port
+bound-lock/1 at=policy:bound-host-ports by=target form=alphabet measure=code role=writes scope=refusal/host-port/failed value=host-port/failed
+bound-lock/1 about="A declared host callback failed; no successful result is returned." at=policy:bound-host-ports by=target form=alphabet measure=class role=writes scope=refusal/host-port/failed value=host
+bound-lock/1 at=policy:bound-host-ports by=target form=alphabet measure=next role=writes scope=refusal/host-port/failed value=inspect-host-port
+bound-lock/1 at=policy:bound-host-ports by=target form=alphabet measure=code role=writes scope=refusal/host-port/integrity value=host-port/integrity
+bound-lock/1 about="Content bytes differ from the requested SHA-256 identity." at=policy:bound-host-ports by=target form=alphabet measure=class role=writes scope=refusal/host-port/integrity value=integrity
+bound-lock/1 at=policy:bound-host-ports by=target form=alphabet measure=next role=writes scope=refusal/host-port/integrity value=resolve-exact-bytes
+bound-lock/1 at=policy:bound-host-ports by=target form=alphabet measure=code role=writes scope=refusal/host-port/response value=host-port/response
+bound-lock/1 about="A host response has an unsupported shape or shared mutable bytes." at=policy:bound-host-ports by=target form=alphabet measure=class role=writes scope=refusal/host-port/response value=host
+bound-lock/1 at=policy:bound-host-ports by=target form=alphabet measure=next role=writes scope=refusal/host-port/response value=inspect-host-port

package/docs/contracts/refusals.md

@@ -0,0 +1,47 @@
+# Public refusal catalog
+
+Source of truth: `refusals.bound` (`bound-refusals@1`), read through the existing wire parser. `readRefusalCatalog` and `describeRefusal` are exported from `/reference`; resolve `@lapxo/bound/refusals` for the published lines. The digest of these exact lines is bound into the authenticated reference context.
+
+`BoundRefusal.code` is stable; diagnostic text is not a code. Native CLI refusals retain the diagnostic and emit a `bound-refusal@1` JSON record with code, category, meaning, next and catalog digest. Recommendations grant no authority and execute nothing. If the installed catalog cannot be read or validated, the CLI emits `catalog/invalid` with metadata explicitly `unmeasured`; it never fabricates a catalog digest or recursively formats that failure. A consumer checks the catalog bytes against its independently accepted context digest before parsing; parsing alone proves no authority. Legacy operations without a specific public code use `operation/failed`; no diagnostic is classified by regex. This does not claim a distinct code for every historical diagnostic. Successful four-state results remain results, never refusal codes.
+
+| Code | Class | Meaning | Suggested next |
+| --- | --- | --- | --- |
+| reference-export/source | input | The source URL is not a canonical standing-reference location. | check-source |
+| reference-export/context | interpretation | Required admitted export policy or exact contract bytes are missing or conflicting. | inspect-standing |
+| reference-export/budget | resource | The export exceeds or lacks its explicitly declared record or byte budget. | inspect-resource-lines |
+| reference-export/authority | authority | The selected key is not authorized for the snapshot proof at this epoch. | inspect-authority |
+| reference-export/signer | host | The selected signer failed or returned a signature that does not verify. | inspect-signer |
+| reference-export/history | authority | The current carrier profile cannot represent this historical authority; no original is silently removed. | inspect-standing-contract |
+| catalog/invalid | interpretation | The refusal catalog is malformed, duplicated or incomplete. | resolve-catalog |
+| reference/format | input | The reference has an unsupported or noncanonical shape. | check-reference |
+| standing/view | interpretation | The place has not declared the public standing view. | declare-standing-view |
+| standing/query | input | Standing accepts only the local committed projection. | query-local-standing |
+| reference-export/usage | input | Reference export requires exactly one source and explicit signing options. | check-export-arguments |
+| authenticated-reference/context | interpretation | The supplied interpretation context or snapshot binding is inconsistent. | resolve-public-context |
+| authenticated-reference/budget | resource | The declared record or byte budget is invalid or exceeded. | inspect-resource-lines |
+| authenticated-reference/transport | host | The content port failed or returned shared mutable bytes. | inspect-content-port |
+| authenticated-reference/integrity | integrity | Carrier bytes or the snapshot commitment differ from their declared digest. | resolve-exact-bytes |
+| authenticated-reference/framing | input | The carrier is not the canonical supported UTF-8 frame. | check-carrier |
+| authenticated-reference/wire | input | An original record is not canonical supported wire. | check-original-records |
+| authenticated-reference/authority | authority | The proof or an original lacks admitted authority under the supplied context. | inspect-authority |
+| authenticated-reference/history | interpretation | This carrier profile cannot authenticate configuration withdrawal history. | request-admitted-standing |
+| authenticated-reference/object-context | interpretation | The existing object validator refused the declared form or context. | inspect-object-context |
+| authenticated-reference/identity | integrity | The semantic standing differs from the reference identity. | resolve-standing |
+| operation/failed | host | An operation failed without a more specific public code; details are diagnostic only. | inspect-diagnostic |
+| operation/usage | input | The command arguments do not describe a supported public operation. | check-arguments |
+| reference/backend | interpretation | The host did not select a supported explicit reference backend. | select-reference-backend |
+| reference/cancelled | host | The opening was interrupted before a complete result. | inspect-interruption |
+| host-port/budget | resource | A host port lacks a valid finite budget or exceeds its byte bound. | inspect-resource-lines |
+| host-port/cancelled | host | A host operation was cancelled before a complete result. | inspect-interruption |
+| host-port/timeout | host | A host operation exceeded its declared lifetime. | inspect-host-port |
+| host-port/failed | host | A declared host callback failed; no successful result is returned. | inspect-host-port |
+| host-port/integrity | integrity | Content bytes differ from the requested SHA-256 identity. | resolve-exact-bytes |
+| host-port/response | host | A host response has an unsupported shape or shared mutable bytes. | inspect-host-port |
+
+Native quartet: `refusals.publication.json`. `vectors/native/refusals.vector.json` checks the wire catalog, its derived page, duplicate/missing records, and real export/inspection refusals in two places. No failed operation becomes a successful receipt. The captured semantic marker is:
+
+```text
+REFUSALS lines · unique codes · exact metadata · duplicate refused
+```
+
+Specific producers cover reference syntax, standing query/view, native export usage/source/context/budget/authority/signer/history, and authenticated inspection context/budget/transport/integrity/framing/wire/authority/history/object-context/identity. Numeric CLI usage and uncoded legacy failures use the explicitly generic codes above; diagnostics remain unclassified. B2/B5 may add codes only by changing these versioned contract bytes and their vectors.

package/docs/contracts/refusals.publication.json

@@ -0,0 +1,25 @@
+{
+  "scope": "contract/published/refusals",
+  "members": [
+    {
+      "role": "contract",
+      "path": "docs/contracts/refusals.md",
+      "digest": "sha256:ed549322f385e184b0defe705eac62cf546b8617ecb7f9fbe3f727431820f10c"
+    },
+    {
+      "role": "yes",
+      "path": "samples/refusals/yes.json",
+      "digest": "sha256:ea1c792b30ac00df4390343fe51359efe4e569964cd4da25daa5492b6db4dd03"
+    },
+    {
+      "role": "vector",
+      "path": "vectors/native/refusals.vector.json",
+      "digest": "sha256:2e2833bc6388784e030b50232bd99f84ccb05b0fd6ed86f6db0a5a0b1dc38e05"
+    },
+    {
+      "role": "no",
+      "path": "samples/refusals/no.json",
+      "digest": "sha256:731fc1240064d52b90ca04f627821a1f241382cf159fa33d3d1e18e7fc778a70"
+    }
+  ]
+}

package/docs/contracts/standing.bound

@@ -0,0 +1,9 @@
+bound-lock/1 at=policy:bound-reference-export by=target form=alphabet measure=id role=writes scope=standing/contract value=authenticated-standing-projection@1
+bound-lock/1 about="Standing is authenticated under admission snapshots across declared key classes." at=policy:bound-reference-export by=target form=alphabet measure=id role=writes scope=standing/classes value=all-declared
+bound-lock/1 about="Exact redelivery does not establish another origin." at=policy:bound-reference-export by=target form=alphabet measure=id role=writes scope=standing/duplicates value=preserve-attribution
+bound-lock/1 about="Exact configuration withdrawals are applied before publication; typed records retain their admitted effective history." at=policy:bound-reference-export by=target form=alphabet measure=id role=writes scope=standing/withdrawals value=exact
+bound-lock/1 about="Incompatible admitted declarations are preserved; no first-wins selection." at=policy:bound-reference-export by=target form=alphabet measure=id role=writes scope=standing/conflicts value=preserve
+bound-lock/1 about="Historical receipts are evidence, not current authority or a current response." at=policy:bound-reference-export by=target form=alphabet measure=id role=writes scope=standing/history value=distinct
+bound-lock/1 about="Public current configuration omits withdrawal markers; authenticated historical records remain available through evidence and act views." at=policy:bound-reference-export by=target form=alphabet measure=id role=writes scope=standing/publication value=live-configuration
+bound-lock/1 about="The contextual carrier separates Root, legacy places and committed place contexts; clocks are never flattened." at=policy:bound-reference-export by=target form=alphabet measure=id role=writes scope=standing/namespaces value=preserve
+bound-lock/1 about="Typed records retain admitted effective order; standing is evidence rather than a new grant of authority." at=policy:bound-reference-export by=target form=alphabet measure=id role=writes scope=standing/effective-order value=admitted