diff --git a/.agents/skills/coding-standards/SKILL.md b/.agents/skills/coding-standards/SKILL.md new file mode 100644 index 00000000..72c01adc --- /dev/null +++ b/.agents/skills/coding-standards/SKILL.md @@ -0,0 +1,143 @@ +--- +name: coding-standards +description: Obtain the engineering standards that apply to a coding task from the Standards Engine application tools. Use at the start of any task that plans, writes, changes, reviews, tests, builds, documents, commits or releases code, before planning or editing, and again when the task grows. Not for maintaining the standards themselves; that is the standards-engine authoring skill. +--- + +# Coding Standards + +The Standards Engine holds the engineering standards as modules. You state facts +about your task; it returns every module that applies, with its full text. Read +them before you plan or edit, then follow them. + +Use the application-purpose Standards Engine MCP tools. The tool-name prefix +depends on the client (for example `mcp__standards-engine__route`); the operation +names below are exact. + +## The Sequence + +1. **Get the vocabulary once.** Call `routing_facts` with no arguments. It lists + every fact: its exact name, meaning and allowed values. Keep the `snapshot` it + returns. +2. **Route.** Call `route` with that snapshot, the facts that are true of your + task, and `content: {}`. +3. **Read every page.** `reading_plan` lists every module that applies. + `content.items` holds the full text of the modules on this page. While + `content.next` is present, call `route` again with exactly the arguments in + `content.next`. +4. **Work from what you hold.** Pass the same `snapshot` in every later call. A + module you already hold at that snapshot has not changed; do not read it + again. + +## Worked Example + +Task: implement a Rust function that is called from C. + +`route` request: + +```json +{ + "snapshot": {"kind": "snapshot-handle", "id": "snapshot:v1:...", "schema_version": 5}, + "facts": { + "routing.activities": ["implementation"], + "routing.languages": ["rust"], + "routing.boundaries": ["interop"] + }, + "content": {} +} +``` + +Response outline (nine modules apply; this first page carries two of them): + +```text +kind: application-route-result +snapshot: the same handle; keep passing it +status: needs-facts +reading_plan: + core review_state: current + router review_state: current + workflow.verification review_state: current + topic.contracts review_state: current + topic.security review_state: current + profile.boundary.interop review_state: not-reviewed + profile.language.rust review_state: current + profile.language.rust.interop review_state: not-reviewed + workflow.implementation review_state: current +unresolved_questions: routing.applications, routing.details, routing.frameworks, + routing.topics, routing.workflow-profiles +content: + offset: 0 + total: 9 + items: + - policy.id: core review_state: current content: "# Core Standards ..." + - policy.id: router review_state: current content: "# Standards Router ..." + next: {snapshot, facts, content: {offset: 2, limit: 8}} +``` + +Call `route` with `content.next` exactly as given, and repeat until a page has no +`next`. All nine modules, including the two labelled `not-reviewed`, are then in +hand. + +`status: needs-facts` means some facts were not stated, so the selection may be +incomplete. Look at `unresolved_questions`: if one of those facts is true of your +task, route again with it added and the same snapshot. The modules already +returned still apply. + +## Choosing Facts + +- Supply what is true of the task. Copy names and values exactly from + `routing_facts`; a near spelling is rejected, never guessed. +- Omit what you do not know. An omitted fact stays unknown and comes back in + `unresolved_questions`. +- `[]` states that none of the values apply. Supply it only when you know that; + do not use it to silence a question. +- Do not delete a true fact to make a call succeed or to shrink the result. A + rejection tells you what to correct. Fewer facts means missing standards. +- When the task grows (another language, a new boundary), route again with the + added facts and the same snapshot. Read only the modules you do not yet hold. + +## Reading In Small Batches + +Most clients show about 50 KB of a tool result inline and divert anything larger +to a file. Route pages are sized to fit: about 40 KB each, and always at least +one whole module. Follow `content.next` until it is absent. + +Use `read` for one module by ID and `read_many` for a few. Ask `read_many` for +two or three modules per call so the whole result is shown. IDs come from a +`route`, `read` or `related` result; use them exactly. + +## Snapshot Reuse + +- Every result returns a `snapshot`. Pass it unchanged in later calls so that + everything you read comes from one version of the standards. +- Omitting `snapshot` captures the current accepted standards afresh. Do that at + the start of a new task, not in the middle of one. +- Text held at a snapshot never changes. Do not re-read it to be safe. + +## Review Labels + +Every `reading_plan` entry and every delivered module carries `review_state`. + +| Label | Meaning | +| --- | --- | +| `current` | This exact text was approved for application use. | +| `changed-since-review` | The text was edited after it was approved. | +| `not-reviewed` | The text has never been approved for application use. | + +All three are delivered and all apply to your task. The label tells you how +settled the wording is; it is not permission to skip a module. If a module's +wording is unclear, or two modules seem to disagree, tell the user which modules +and what their labels are instead of silently choosing. + +## When A Call Is Rejected + +| Code | What to do | +| --- | --- | +| `APPLICATION.INPUT_INVALID` | Correct the field named in `input_feedback`. Check fact names and values against `routing_facts`. Keep the facts that are true. | +| `APPLICATION.UNKNOWN_TARGET` | The ID is not registered. Use an ID exactly as `route`, `read` or `related` returned it. | +| `APPLICATION.UNKNOWN_GROUP`, `APPLICATION.TRAVERSAL_NOT_PERMITTED` | Use a group and direction that `relationship_groups` lists. | +| `APPLICATION.RESULT_LIMIT` | Ask for fewer modules in one call. | +| `APPLICATION.INTERNAL_UNAVAILABLE`, `APPLICATION.UNSUPPORTED_CAPTURE` | The server could not answer. Report it to the user; do not guess the standards. | + +`related` and `relationship_groups` show how modules relate when you need to +follow a prerequisite. `describe_input` shows an exact argument shape when your +client abbreviates one. diff --git a/.agents/skills/standards-engine/SKILL.md b/.agents/skills/standards-engine/SKILL.md index a072f79d..0934d18a 100644 --- a/.agents/skills/standards-engine/SKILL.md +++ b/.agents/skills/standards-engine/SKILL.md @@ -6,8 +6,8 @@ description: Maintain this repository's coding standards through an authoring-pu # Standards Engine Authoring This skill is maintenance material for standards authors. Ordinary application -agents use their application-purpose tool catalog and approved guidance, rather -than loading this authoring skill. +agents use their application-purpose tool catalog and the `coding-standards` +skill, rather than loading this authoring skill. Use the generated public Interface. The Engine is the sole writer of standards Markdown, metadata, supplementary projections, SQLite state, and local Git diff --git a/.agents/skills/standards-engine/references/authoring.md b/.agents/skills/standards-engine/references/authoring.md index d6df3f89..f1df3319 100644 --- a/.agents/skills/standards-engine/references/authoring.md +++ b/.agents/skills/standards-engine/references/authoring.md @@ -231,8 +231,10 @@ and templates support `revise-operational-artifact`. After material review, call authoring `preview_application` with the exact revision and an application read, route or related request. Inspect the complete returned -content, required closure, relationship filtering and qualification results. Repair -missing qualifications or retain authoring-only material outside application exposure. +content, selected closure, relationship filtering and each item's `review_state` +label. The preview delivers every registered item an application agent would +receive; approve or withdraw exposure to change a label, and keep authoring-only +reasoning in provenance records, which the application view never returns. Candidate previews remain bound to the revision and do not publish a snapshot. Refresh the client catalog after an engine update and inspect initialization's @@ -337,7 +339,7 @@ for the code-to-content handoff. Read operational aids to obtain their captured authoring target. Submit provenance content and an explicit exposure decision in the same coherent change as applicable; the Engine binds final candidate content. Provenance-only maintenance retains unchanged normative revisions. -Application eligibility starts empty and becomes active only after reviewed +An approval changes an item's application `review_state` label only after reviewed publication, not after merely creating a draft. diff --git a/.agents/skills/standards-engine/references/environment.md b/.agents/skills/standards-engine/references/environment.md index 9b2b9524..4995210a 100644 --- a/.agents/skills/standards-engine/references/environment.md +++ b/.agents/skills/standards-engine/references/environment.md @@ -38,6 +38,13 @@ new application session after authoring. The Engine cannot erase prior context. } ``` +Add `"--route-page-bytes", "N"` to the application arguments only when the client +shows more or less than about 50 KB of a tool result inline. The default page +budget is 40,960 bytes of result JSON, the range is 8,192–2,097,152, a page always +holds at least one whole module, and the option is a launch error for authoring. +Application agents use the `coding-standards` skill in +`.agents/skills/coding-standards/`; this authoring skill is for maintainers. + These are separate intended audiences, not two registrations every agent should receive. Translate the command, arguments and environment to the client's actual configuration format. Restart the Engine and reconnect after the interface-41 @@ -51,7 +58,7 @@ configured purpose. The local server remains synchronous MCP stdio with protocol `2025-11-25`; requests execute serially and immutable Engine handles survive reconnection. -The current implementation is 0.2.0 and Engine interface 44. No network listener, +The current implementation is 0.2.0 and Engine interface 49. No network listener, paid model turn, remote publication or extra server dependency is introduced. The existing local authoring authorization adapter is owner-operated and always-allow; explicit user authorization still governs requested changes. @@ -63,11 +70,12 @@ remote multi-user permission service. ## Bootstrap and cutover -New automatic snapshots read accepted local `main`. The code release initially -contains empty application-approval and provenance manifests. Application reads -therefore return a bounded unavailable result until the separate content work -reviews and publishes the required material. Authoring can read the unchanged -standards once the code candidate is integrated into accepted main. +New automatic snapshots read accepted local `main`. The application-approval +manifest records which exact material was reviewed for application use. Since +interface 49 it labels delivered material (`current`, `changed-since-review` or +`not-reviewed`) and never withholds it, so application reads and routes work +before, during and after the separate content review. Authoring can read the +unchanged standards once the code candidate is integrated into accepted main. Use a disposable clone with candidate `main` for pre-merge qualification. Preserve active installed proposals and recovery obligations before cutover. Old Analysis diff --git a/.agents/skills/standards-engine/references/navigation.md b/.agents/skills/standards-engine/references/navigation.md index e05bdf58..4c283677 100644 --- a/.agents/skills/standards-engine/references/navigation.md +++ b/.agents/skills/standards-engine/references/navigation.md @@ -18,7 +18,9 @@ MCP tool definitions supplied by the client; invoke the tools directly. group the selected policies into `read_many` with the returned snapshot and ordered `items` such as `[{"target":"core"}]`. Select up to 32 unique read items per call. The complete result is bounded to 2 MiB and any - unavailable item rejects the whole group; narrow the selection on a limit. + unregistered or failed item rejects the whole group; narrow the selection on a + limit. Two or three modules per call keep a result within what most clients + show inline. Grouping preserves the same exact text, authority and detail options as `read`. 5. Use returned inspect operations and handles when more detail is needed. `inspect` accepts opaque handles, not repository locators. @@ -47,16 +49,23 @@ selected, deduplicated target order. `content.total` counts all selected targets `route` request, preserving its facts and snapshot. Nonzero offsets require an explicit snapshot. Changing facts intentionally starts a different selection. -The complete route result, including its plan, questions, items and continuation, -is limited to 2 MiB. Byte pressure returns fewer whole reads. A first record that -cannot fit returns a typed limit rejection, never clipped policy text. Request a -selection-only route and explicitly `read` that target when the client can receive -it. An unavailable selected dependency or a failed read rejects the result; -partial prefixes are not returned as success. An offset equal to the selected -count returns an empty final page; a larger offset is invalid. - -All content uses the same captured authority and ordinary read/qualification -rules. Missing facts remain unresolved even when selected text is returned. +The complete authoring route result, including its plan, questions, items and +continuation, is limited to 2 MiB. Byte pressure returns fewer whole reads. A first +record that cannot fit returns a typed limit rejection, never clipped policy text. +Request a selection-only route and explicitly `read` that target when the client can +receive it. A failed read rejects the result; partial prefixes are not returned as +success. An offset equal to the selected count returns an empty final page; a +larger offset is invalid. + +Application route pages are sized for inline display instead: 40 KiB of result +JSON by default, or the application server's `--route-page-bytes` value +(8,192–2,097,152). A page always holds at least one whole read, so a module larger +than the budget arrives alone rather than as a rejection. Every selected module is +delivered with its `review_state` label (`current`, `changed-since-review` or +`not-reviewed`); approval state never withholds a selected module. + +All content uses the same captured authority and ordinary read rules. Missing +facts remain unresolved even when selected text is returned. Only selected content is paged. Compact plans contain the complete selected closure; all fact questions remain present. The full explanation additionally includes unresolved-policy rows. Content continuations preserve the requested detail. @@ -95,8 +104,8 @@ do not rebuild them from stale spellings or a different snapshot. Malformed common JSON shapes fail before capture. A vocabulary-dependent error can occur after capture when the snapshot was omitted; it returns invalid field feedback, not a successful route or authoring change. Correct the field or consult the -snapshot-bound vocabulary. Unqualified application Router content remains unavailable -before its vocabulary is interpreted or disclosed. +snapshot-bound vocabulary. Application routing interprets the vocabulary whatever +the Router's review label is. Focused authoring `route` defaults to `compact-route-result`: canonicalized supplied facts, selected reading entries and required dependencies, every typed @@ -110,7 +119,7 @@ Each unanswered question carries its registered fact definition. Supply empty sets only when the task establishes absence, rather than to silence questions. Full rule expressions describe evaluated applicability, not inferred policy prose. Required dependency reasons identify their graph edge and source. Several reasons -may select the same standard. Application purpose retains the same qualified +may select the same standard. Application purpose retains the same labelled selection and all questions even when full detail is requested; private authoring rule explanations are not exposed. @@ -127,7 +136,8 @@ traversal policy, without reading policy text merely to find a group name. Reuse its snapshot with `related`. An omitted snapshot captures accepted authority; nonzero page offsets require the returned snapshot. Pages contain up to 32 whole records (default 8), with a 16 KiB page limit; follow `next` unchanged. Application -vocabulary comes only from its permitted graph and requires qualified Router content. +vocabulary comes only from its permitted graph: every registered material, in the +five application relationship groups. An unknown focused group returns `GRAPH.UNKNOWN_GROUP` (application: `APPLICATION.UNKNOWN_GROUP`) and `relationship_groups`, the same bounded first @@ -135,7 +145,10 @@ vocabulary page. Choose a returned ID explicitly. A registered group can have no edges for the selected target; that is a successful empty query. Traversal directions and transitivity describe the group's traversal policy, not a claim of existing relationships. Authoring provenance groups are excluded from application vocabulary. -Native authoring queries and draft previews keep their existing rejection contracts. +A traversal the group does not permit returns `APPLICATION.TRAVERSAL_NOT_PERMITTED` +in application purpose; an unregistered target returns `APPLICATION.UNKNOWN_TARGET`. +Native authoring queries keep their existing rejection contracts; draft previews +return the application codes bound to their revision. ## Accepted-Snapshot Analysis @@ -172,6 +185,6 @@ instruction to infer an impact decision. Use `describe_input` for argument shapes, not policy text. It observes only the running purpose-qualified catalog and needs no snapshot. Application connections -can discover their own reviewed-guidance navigation inputs but cannot discover +can discover their own navigation inputs but cannot discover unpublished authoring operations or definitions. `route`, `read`, and `related` remain the owners of policy selection, text and relationships. diff --git a/.github/workflows/purpose-separated-engine.yml b/.github/workflows/purpose-separated-engine.yml index 02fcd779..bafc584b 100644 --- a/.github/workflows/purpose-separated-engine.yml +++ b/.github/workflows/purpose-separated-engine.yml @@ -4,20 +4,10 @@ on: workflow_dispatch: push: branches: [main, implementation/purpose-separated-standards-engine] + # No path filter: the suite-input manifest pins the list of tracked files, so + # adding, removing or renaming a file anywhere can make it stale. pull_request: branches: [main] - paths: - - 'tools/**' - - '.agents/skills/standards-engine/**' - - 'evaluation/standards-effectiveness/**' - - '*.md' - - 'workflows/**' - - 'topics/**' - - 'profiles/**' - - 'reference/**' - - 'prompts/**' - - 'templates/**' - - '.github/workflows/purpose-separated-engine.yml' permissions: contents: read @@ -73,5 +63,7 @@ jobs: "$python" -m unittest discover -s tools/standards_contracts/tests "$python" -m unittest discover -s tools/standards_analysis/tests PYTHONPATH=.:tools/standards_verifier "$python" -m unittest discover -s tools/standards_verifier/tests - "$python" -m unittest discover -s tools/standards_engine/tests + # One unittest process per Engine test module, as many at a time as the runner has cores. + # It fails if any module fails or if fewer tests run than a serial discovery finds. + "$python" -m tools.standards_engine.tests.parallel_unittest --durations 25 PYTHONPATH=.:tools/standards_verifier "$python" tools/standards_verifier/verify.py --complete diff --git a/evaluation/standards-effectiveness/fixtures/development/routing-decisions.tsv b/evaluation/standards-effectiveness/fixtures/development/routing-decisions.tsv index be17dc92..e7ac5974 100644 --- a/evaluation/standards-effectiveness/fixtures/development/routing-decisions.tsv +++ b/evaluation/standards-effectiveness/fixtures/development/routing-decisions.tsv @@ -1,6 +1,6 @@ -case uncertainty_reduction planning facts expected_development expected_planning expected_route -uncertainty_only yes no complete select exclude route -planning_only no yes complete exclude select route -both yes yes complete select select route -neither no no complete exclude exclude route -missing yes yes missing unresolved unresolved unresolved +case routing.activities expected_development expected_planning expected_route +uncertainty_only uncertainty-reduction select exclude route +planning_only planning exclude select route +both planning,uncertainty-reduction select select route +neither none exclude exclude route +missing unknown unresolved unresolved unresolved diff --git a/evaluation/standards-effectiveness/fixtures/routing/generated-contract-decisions.tsv b/evaluation/standards-effectiveness/fixtures/routing/generated-contract-decisions.tsv index 187fc24e..2bc4ca4a 100644 --- a/evaluation/standards-effectiveness/fixtures/routing/generated-contract-decisions.tsv +++ b/evaluation/standards-effectiveness/fixtures/routing/generated-contract-decisions.tsv @@ -1,8 +1,8 @@ -case program_consumer generated_source cross_language process_boundary durable_state diagnostics security facts expected_generated_contract expected_language_binding expected_ipc expected_persistence expected_diagnostics expected_security expected_route -generated_program_contract yes yes no no no no no complete select exclude exclude exclude exclude exclude route -generated_cross_language_contract yes yes yes no no no no complete select select exclude exclude exclude exclude route -generated_process_contract yes yes no yes no no no complete select exclude select exclude exclude exclude route -generated_durable_contract yes yes no no yes no no complete select exclude exclude select exclude exclude route -generated_security_diagnostics yes yes no no no yes yes complete select exclude exclude exclude select select route -generated_text_only no yes no no no no no complete exclude exclude exclude exclude exclude exclude route -missing_boundary_facts unknown unknown unknown unknown unknown unknown unknown missing unresolved unresolved unresolved unresolved unresolved unresolved unresolved +case routing.activities routing.applications routing.boundaries routing.topics expected_generated_contract expected_language_binding expected_ipc expected_persistence expected_diagnostics expected_security expected_route +generated_program_contract build,documentation,implementation,planning,tooling,verification library generated-contract architecture,contracts,dependencies select exclude exclude exclude exclude exclude route +generated_cross_language_contract build,documentation,implementation,planning,tooling,verification library generated-contract,language-bindings architecture,contracts,dependencies select select exclude exclude exclude exclude route +generated_process_contract build,documentation,implementation,planning,tooling,verification library generated-contract,ipc architecture,contracts,dependencies select exclude select exclude exclude exclude route +generated_durable_contract build,documentation,implementation,planning,tooling,verification library generated-contract,persistence architecture,contracts,dependencies select exclude exclude select exclude exclude route +generated_security_diagnostics build,documentation,implementation,planning,tooling,verification library generated-contract architecture,contracts,dependencies,diagnostics,security select exclude exclude exclude select select route +generated_text_only build,documentation,implementation,planning,tooling,verification library none architecture,contracts,dependencies exclude exclude exclude exclude exclude exclude route +missing_boundary_facts build,documentation,implementation,planning,tooling,verification library unknown unknown unresolved unresolved unresolved unresolved unresolved unresolved unresolved diff --git a/evaluation/standards-effectiveness/fixtures/routing/generated-contract-routes.tsv b/evaluation/standards-effectiveness/fixtures/routing/generated-contract-routes.tsv index c3efacfe..b791c4dc 100644 --- a/evaluation/standards-effectiveness/fixtures/routing/generated-contract-routes.tsv +++ b/evaluation/standards-effectiveness/fixtures/routing/generated-contract-routes.tsv @@ -1,8 +1,8 @@ case direct_modules requires_closure -generated_program_contract profile.application.library,profile.boundary.generated-contract,router,topic.architecture,topic.contracts,topic.dependencies,workflow.build,workflow.documentation,workflow.implementation,workflow.planning,workflow.tooling,workflow.verification core,profile.application.library,router,workflow.documentation,workflow.implementation,workflow.verification,topic.contracts,topic.architecture,topic.contracts.schemas,topic.dependencies,workflow.build,profile.boundary.generated-contract,workflow.development-proportionality,workflow.planning,workflow.tooling -generated_cross_language_contract profile.application.library,profile.boundary.generated-contract,profile.boundary.language-bindings,router,topic.architecture,topic.contracts,topic.dependencies,workflow.build,workflow.documentation,workflow.implementation,workflow.planning,workflow.tooling,workflow.verification core,profile.application.library,router,workflow.documentation,workflow.implementation,workflow.verification,topic.contracts,topic.architecture,topic.contracts.schemas,topic.dependencies,topic.security,profile.boundary.interop,profile.boundary.language-bindings,workflow.build,profile.boundary.generated-contract,workflow.development-proportionality,workflow.planning,workflow.tooling -generated_process_contract profile.application.library,profile.boundary.generated-contract,profile.boundary.ipc,router,topic.architecture,topic.contracts,topic.dependencies,workflow.build,workflow.documentation,workflow.implementation,workflow.planning,workflow.tooling,workflow.verification core,profile.application.library,router,workflow.documentation,workflow.implementation,workflow.verification,topic.contracts,topic.architecture,topic.contracts.protocols,topic.contracts.schemas,topic.dependencies,topic.security,profile.boundary.ipc,workflow.build,profile.boundary.generated-contract,workflow.development-proportionality,workflow.planning,workflow.tooling -generated_durable_contract profile.application.library,profile.boundary.generated-contract,profile.boundary.persistence,router,topic.architecture,topic.contracts,topic.dependencies,workflow.build,workflow.documentation,workflow.implementation,workflow.planning,workflow.tooling,workflow.verification core,profile.application.library,router,workflow.documentation,workflow.implementation,workflow.verification,topic.contracts,topic.architecture,topic.contracts.evolution,profile.boundary.persistence,topic.contracts.schemas,topic.dependencies,workflow.build,profile.boundary.generated-contract,workflow.development-proportionality,workflow.planning,workflow.tooling -generated_security_diagnostics profile.application.library,profile.boundary.generated-contract,router,topic.architecture,topic.contracts,topic.dependencies,topic.diagnostics,topic.security,workflow.build,workflow.documentation,workflow.implementation,workflow.planning,workflow.tooling,workflow.verification core,profile.application.library,router,workflow.documentation,workflow.implementation,workflow.verification,topic.contracts,topic.architecture,topic.contracts.schemas,topic.dependencies,topic.diagnostics,topic.security,workflow.build,profile.boundary.generated-contract,workflow.development-proportionality,workflow.planning,workflow.tooling -generated_text_only profile.application.library,router,topic.architecture,topic.contracts,topic.dependencies,workflow.build,workflow.documentation,workflow.implementation,workflow.planning,workflow.tooling,workflow.verification core,profile.application.library,router,workflow.documentation,workflow.implementation,workflow.verification,topic.contracts,topic.architecture,topic.dependencies,workflow.build,workflow.development-proportionality,workflow.planning,workflow.tooling +generated_program_contract profile.application.library,profile.boundary.generated-contract,router,topic.architecture,topic.code-design,topic.contracts,topic.contracts.schemas,topic.dependencies,workflow.build,workflow.documentation,workflow.implementation,workflow.planning,workflow.tooling,workflow.verification core,profile.application.library,router,topic.code-design,workflow.documentation,workflow.implementation,workflow.verification,topic.contracts,topic.architecture,topic.contracts.schemas,topic.dependencies,workflow.build,profile.boundary.generated-contract,workflow.development-proportionality,workflow.planning,workflow.tooling +generated_cross_language_contract profile.application.library,profile.boundary.generated-contract,profile.boundary.language-bindings,router,topic.architecture,topic.code-design,topic.contracts,topic.contracts.evolution,topic.contracts.schemas,topic.dependencies,workflow.build,workflow.documentation,workflow.implementation,workflow.planning,workflow.tooling,workflow.verification core,profile.application.library,router,topic.code-design,workflow.documentation,workflow.implementation,workflow.verification,topic.contracts,topic.architecture,topic.contracts.evolution,topic.contracts.schemas,topic.dependencies,topic.security,profile.boundary.interop,profile.boundary.language-bindings,workflow.build,profile.boundary.generated-contract,workflow.development-proportionality,workflow.planning,workflow.tooling +generated_process_contract profile.application.library,profile.boundary.generated-contract,profile.boundary.ipc,router,topic.architecture,topic.code-design,topic.contracts,topic.contracts.protocols,topic.contracts.schemas,topic.dependencies,workflow.build,workflow.documentation,workflow.implementation,workflow.planning,workflow.tooling,workflow.verification core,profile.application.library,router,topic.code-design,workflow.documentation,workflow.implementation,workflow.verification,topic.contracts,topic.architecture,topic.contracts.protocols,topic.contracts.schemas,topic.dependencies,topic.security,profile.boundary.ipc,workflow.build,profile.boundary.generated-contract,workflow.development-proportionality,workflow.planning,workflow.tooling +generated_durable_contract profile.application.library,profile.boundary.generated-contract,profile.boundary.persistence,router,topic.architecture,topic.code-design,topic.contracts,topic.contracts.evolution,topic.contracts.schemas,topic.dependencies,workflow.build,workflow.documentation,workflow.implementation,workflow.planning,workflow.tooling,workflow.verification core,profile.application.library,router,topic.code-design,workflow.documentation,workflow.implementation,workflow.verification,topic.contracts,topic.architecture,topic.contracts.evolution,profile.boundary.persistence,topic.contracts.schemas,topic.dependencies,workflow.build,profile.boundary.generated-contract,workflow.development-proportionality,workflow.planning,workflow.tooling +generated_security_diagnostics profile.application.library,profile.boundary.generated-contract,router,topic.architecture,topic.code-design,topic.contracts,topic.contracts.schemas,topic.dependencies,topic.diagnostics,topic.security,workflow.build,workflow.documentation,workflow.implementation,workflow.planning,workflow.tooling,workflow.verification core,profile.application.library,router,topic.code-design,workflow.documentation,workflow.implementation,workflow.verification,topic.contracts,topic.architecture,topic.contracts.schemas,topic.dependencies,topic.diagnostics,topic.security,workflow.build,profile.boundary.generated-contract,workflow.development-proportionality,workflow.planning,workflow.tooling +generated_text_only profile.application.library,router,topic.architecture,topic.code-design,topic.contracts,topic.dependencies,workflow.build,workflow.documentation,workflow.implementation,workflow.planning,workflow.tooling,workflow.verification core,profile.application.library,router,topic.code-design,workflow.documentation,workflow.implementation,workflow.verification,topic.contracts,topic.architecture,topic.dependencies,workflow.build,workflow.development-proportionality,workflow.planning,workflow.tooling missing_boundary_facts unresolved unresolved diff --git a/evaluation/standards-effectiveness/fixtures/routing/verifier-change-decisions.tsv b/evaluation/standards-effectiveness/fixtures/routing/verifier-change-decisions.tsv index 8b931065..7bc7656b 100644 --- a/evaluation/standards-effectiveness/fixtures/routing/verifier-change-decisions.tsv +++ b/evaluation/standards-effectiveness/fixtures/routing/verifier-change-decisions.tsv @@ -1,10 +1,6 @@ -case module_boundary dependency_direction performance_concern migration_lifecycle planning_scope facts expected_architecture expected_performance expected_planning expected_route -shared_interface_boundary changed changed none none bounded complete select exclude exclude route -local_check_existing_module unchanged unchanged none none bounded complete exclude exclude exclude route -independent_authority_parser changed changed none none bounded complete select exclude exclude route -repository_graph_composition unchanged changed none none bounded complete select exclude exclude route -measured_loading_claim unchanged unchanged changed none bounded complete exclude select exclude route -migration_only_retirement unchanged unchanged none changed material complete exclude exclude select route -local_migration_mechanic unchanged unchanged none changed bounded complete exclude exclude exclude route -unknown_authority unknown unknown none none unknown missing unresolved unresolved unresolved unresolved -unknown_workload unchanged unchanged unknown none unknown missing unresolved unresolved unresolved unresolved +case routing.activities routing.topics expected_architecture expected_performance expected_planning expected_route +boundary_or_dependency_change implementation,verification architecture select exclude exclude route +local_check_existing_module implementation,verification none exclude exclude exclude route +measured_loading_claim implementation,verification performance exclude select exclude route +material_planning_scope implementation,planning,verification none exclude exclude select route +unknown_concerns_and_scope unknown unknown unresolved unresolved unresolved unresolved diff --git a/evaluation/standards-effectiveness/fixtures/routing/verifier-change-routes.tsv b/evaluation/standards-effectiveness/fixtures/routing/verifier-change-routes.tsv index 48768961..2d5f7b51 100644 --- a/evaluation/standards-effectiveness/fixtures/routing/verifier-change-routes.tsv +++ b/evaluation/standards-effectiveness/fixtures/routing/verifier-change-routes.tsv @@ -1,10 +1,6 @@ case direct_modules requires_closure -shared_interface_boundary topic.architecture,workflow.implementation,workflow.verification core,workflow.implementation,workflow.verification,topic.contracts,topic.architecture -local_check_existing_module workflow.implementation,workflow.verification core,workflow.implementation,workflow.verification -independent_authority_parser topic.architecture,workflow.implementation,workflow.verification core,workflow.implementation,workflow.verification,topic.contracts,topic.architecture -repository_graph_composition topic.architecture,workflow.implementation,workflow.verification core,workflow.implementation,workflow.verification,topic.contracts,topic.architecture -measured_loading_claim topic.performance,workflow.implementation,workflow.verification core,workflow.implementation,workflow.verification,topic.performance -migration_only_retirement workflow.implementation,workflow.planning,workflow.verification core,workflow.implementation,workflow.verification,workflow.development-proportionality,workflow.planning -local_migration_mechanic workflow.implementation,workflow.verification core,workflow.implementation,workflow.verification -unknown_authority unresolved unresolved -unknown_workload unresolved unresolved +boundary_or_dependency_change router,topic.architecture,topic.code-design,workflow.implementation,workflow.verification core,router,topic.code-design,workflow.implementation,workflow.verification,topic.contracts,topic.architecture +local_check_existing_module router,workflow.implementation,workflow.verification core,router,workflow.implementation,workflow.verification +measured_loading_claim router,topic.performance,workflow.implementation,workflow.verification core,router,workflow.implementation,workflow.verification,topic.performance +material_planning_scope router,workflow.implementation,workflow.planning,workflow.verification core,router,workflow.implementation,workflow.verification,workflow.development-proportionality,workflow.planning +unknown_concerns_and_scope unresolved unresolved diff --git a/evaluation/standards-effectiveness/generated/suite-inputs.json b/evaluation/standards-effectiveness/generated/suite-inputs.json index d12e6834..90d13614 100644 --- a/evaluation/standards-effectiveness/generated/suite-inputs.json +++ b/evaluation/standards-effectiveness/generated/suite-inputs.json @@ -2,7 +2,7 @@ "contract": "standards-metadata:suite-input-manifest:v1", "files": [ { - "digest": "sha256:be12934a0e6534ead4da95bef3c6af40a8062ad0352166800b10aec30c72809a", + "digest": "sha256:90dec32a6de5d9b66a8d3428f68ce957cec0a05bebc3a0006956b3ad2ad57c1d", "path": ".agents/skills/standards-engine/references/authoring.md", "state": "present", "uses": [ @@ -14,7 +14,7 @@ ] }, { - "digest": "sha256:418191d37a77028f7e287b165f9ee69eee20f8207af5a4f5ba7f792f0fcfae06", + "digest": "sha256:f87192dfc79ab5011bba220351faa1a13940a3162f812770149553acc210c437", "path": ".agents/skills/standards-engine/references/environment.md", "state": "present", "uses": [ @@ -99,110 +99,25 @@ "state": "present", "uses": [ { - "check": "metadata", + "check": "canonical-corpus", "role": "metadata", - "suite": "architecture-pattern-reference-owner" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "concurrency-policy" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "contract-http-outcome-projection" + "suite": "canonical-corpus-metadata" }, { "check": "coding-route-destinations", "role": "target", "suite": "contract-ownership" }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "cross-language-contract" - }, { "check": "local-links", "role": "link-target", "suite": "development-proportionality" }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "development-proportionality" - }, { "check": "routing-closure", "role": "canonical-module", "suite": "development-proportionality" }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "documentation-changelog-closure" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "documentation-policy-consolidation" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "documentation-reference" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "filesystem-containment-policy" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "frontend-rendering-synchronization" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "input-validation-authority" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "interop-boundary-policy" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "interop-event-registration" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "ipc-payload-validation" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "language-binding-boundary" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "language-binding-wire-representation" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "network-transport-policy" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "persistence-owner-contract" - }, { "check": "current-structure", "role": "registered-policy-impact", @@ -213,46 +128,11 @@ "role": "canonical-policy-impact", "suite": "policy-semantic-impact" }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-artifact-policy" - }, { "check": "metadata-closure", "role": "metadata", "suite": "release-maintenance-policy" }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-pipeline-policy" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-procedure-policy" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-publication-policy" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-recovery-policy" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-reference-closure" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-workflow-foundation" - }, { "check": "root-links", "role": "link-target", @@ -268,141 +148,6 @@ "role": "link-target", "suite": "router-legacy-route-closure" }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "runtime-decoding-policy" - }, - { - "check": "metadata", - "role": "metadata", - "suite": "rust-api-owner-contract" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-async-blocking-mutex" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-async-boundary" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-async-cancellation-observability" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-async-lifecycle" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-architecture" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-callback-task" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-conversions" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-enum-representation" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-error-mapping" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-event-delivery" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-executor-delegation" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-runtime" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-boundary-arithmetic" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-dependency-candidate-inspection" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-dependency-owner-contract" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-external-input-queue" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-filesystem-authority" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-interop-memory" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-listener-lifecycle" - }, - { - "check": "rust-profile-metadata", - "role": "metadata", - "suite": "rust-profile-authority-closure" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-release-owner-contract" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-security-panic-boundary" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-tooling-owner-contract" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-unsafe-contracts" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-wire-representation" - }, { "check": "local-links", "role": "link-target", @@ -413,11 +158,6 @@ "role": "markdown", "suite": "s1-routing" }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "s1-routing" - }, { "check": "verifier-change-route-closure", "role": "canonical-module", @@ -438,20 +178,10 @@ "role": "link-target", "suite": "source-index-closures" }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "standards-recovery-routing" - }, { "check": "requires-closure", "role": "canonical-module", "suite": "standards-recovery-routing" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "validation-proof-lifetime" } ] }, @@ -627,6 +357,11 @@ "path": "STANDARDS-ROUTER.md", "state": "present", "uses": [ + { + "check": "canonical-corpus", + "role": "metadata", + "suite": "canonical-corpus-metadata" + }, { "check": "architecture-contract-authority-destinations", "role": "target", @@ -647,11 +382,6 @@ "role": "markdown", "suite": "development-proportionality" }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "development-proportionality" - }, { "check": "routing-closure", "role": "canonical-module", @@ -697,11 +427,6 @@ "role": "markdown", "suite": "s1-routing" }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "s1-routing" - }, { "check": "verifier-change-route-closure", "role": "canonical-module", @@ -782,11 +507,6 @@ "role": "link-target", "suite": "source-index-closures" }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "standards-recovery-routing" - }, { "check": "requires-closure", "role": "canonical-module", @@ -915,6 +635,11 @@ "path": "evaluation/standards-effectiveness/canonical-module-corpus.toml", "state": "present", "uses": [ + { + "check": "canonical-corpus", + "role": "canonical-module-corpus", + "suite": "canonical-corpus-metadata" + }, { "check": "routing-closure", "role": "canonical-module-corpus", @@ -984,7 +709,7 @@ ] }, { - "digest": "sha256:52e4f2d3057fcffd984efd87e4d9f49062d3a17c5c64c04d0a7cec06dfef6432", + "digest": "sha256:805e3c588b26c4e2335d501873b29543fc359caf3916930335da9c40ff7e0920", "path": "evaluation/standards-effectiveness/fixtures/development/routing-decisions.tsv", "state": "present", "uses": [ @@ -1644,7 +1369,7 @@ ] }, { - "digest": "sha256:fab55008b888463280123abb32699b17e0e7898a9f4d9961eda147dceaa55f20", + "digest": "sha256:bfdca5f62ddaac67e41a8e1f83f1a20757bea325324fef4114ac756e7935d7f3", "path": "evaluation/standards-effectiveness/fixtures/routing/generated-contract-decisions.tsv", "state": "present", "uses": [ @@ -1661,7 +1386,7 @@ ] }, { - "digest": "sha256:acaf8e60acd4b322dff9238f17b0d660c9a231c2b26c04509b0b893aaf1e4eb2", + "digest": "sha256:0363c6072f96a76449bfb2ba81ebb38a3382f1d911af25f9811d7782a798e66f", "path": "evaluation/standards-effectiveness/fixtures/routing/generated-contract-routes.tsv", "state": "present", "uses": [ @@ -1678,7 +1403,7 @@ ] }, { - "digest": "sha256:0d9371f0c2b76b3f417a1043cc98759789211d985339d46917aeabaa4e03dcc6", + "digest": "sha256:b217846dd43a3539834c396e829a3806f38bc6ac0babde42eae9145f5e0075d8", "path": "evaluation/standards-effectiveness/fixtures/routing/verifier-change-decisions.tsv", "state": "present", "uses": [ @@ -1690,7 +1415,7 @@ ] }, { - "digest": "sha256:078308398ff5447ce76df5a774285518149b74e33093e36bddce263dff0e2d61", + "digest": "sha256:6f1646c36cc54eefc9cad018ae744822e75d6f6f7157bf883702bf09ed52ce15", "path": "evaluation/standards-effectiveness/fixtures/routing/verifier-change-routes.tsv", "state": "present", "uses": [ @@ -2410,15 +2135,30 @@ "path": "evaluation/standards-effectiveness/router-projection.toml", "state": "present", "uses": [ + { + "check": "routing-closure", + "role": "router-projection", + "suite": "development-proportionality" + }, { "check": "current-structure", "role": "registered-policy-impact", "suite": "policy-semantic-impact" + }, + { + "check": "verifier-change-route-closure", + "role": "router-projection", + "suite": "s1-routing" + }, + { + "check": "requires-closure", + "role": "router-projection", + "suite": "standards-recovery-routing" } ] }, { - "digest": "sha256:8c0b2f96659a45ed04e42a22501395a6ac62f522093cb9b18985e8c5d5a1794c", + "digest": "sha256:af8f30134a34385b211429c7d325b9f0c233839ec8d49aee03f882f67aa69ca5", "path": "evaluation/standards-effectiveness/suite-registry.toml", "state": "present", "uses": [ @@ -2454,8 +2194,8 @@ ] }, { - "digest": "sha256:fe33581eec327e25acb81b76aa6cabaca87029cdd0346223afc978f91b210ca6", - "path": "evaluation/standards-effectiveness/suites/architecture-pattern-reference-owner.toml", + "digest": "sha256:8f57462615fe61d89cc6d1c5e59d7754ab7ceb8302572888e122f558049b5c9b", + "path": "evaluation/standards-effectiveness/suites/canonical-corpus-metadata.toml", "state": "present", "uses": [ { @@ -2466,8 +2206,8 @@ ] }, { - "digest": "sha256:87b3601ecb7352ccba001878233666c5981f56eb3339b35daa6fe939e92be8f6", - "path": "evaluation/standards-effectiveness/suites/concurrency-policy.toml", + "digest": "sha256:8152e0dd7fc5b3997f9c1f7be58a29ec19cac0e92337d55757b62768f3319f3e", + "path": "evaluation/standards-effectiveness/suites/contract-ownership.toml", "state": "present", "uses": [ { @@ -2478,8 +2218,8 @@ ] }, { - "digest": "sha256:4908cffe925ed6f64c5bade4efda3aee71bd9f1416ef3bd95ed8cf449141fe7d", - "path": "evaluation/standards-effectiveness/suites/contract-http-outcome-projection.toml", + "digest": "sha256:08dab633d8a18eb6a503658c62473e962f7794fe1c077ca8171edc3c7d18e978", + "path": "evaluation/standards-effectiveness/suites/development-proportionality.toml", "state": "present", "uses": [ { @@ -2490,8 +2230,8 @@ ] }, { - "digest": "sha256:8152e0dd7fc5b3997f9c1f7be58a29ec19cac0e92337d55757b62768f3319f3e", - "path": "evaluation/standards-effectiveness/suites/contract-ownership.toml", + "digest": "sha256:5e0a87023ae7154caa35443d98501cecde9c1947b57560712f0b0d51c463b394", + "path": "evaluation/standards-effectiveness/suites/language-index-closure.toml", "state": "present", "uses": [ { @@ -2502,8 +2242,8 @@ ] }, { - "digest": "sha256:5e46fb2e608fe6860e5b5c03117b72a80c2807057ccfd37b4e59d5dccf8804cc", - "path": "evaluation/standards-effectiveness/suites/cross-language-contract.toml", + "digest": "sha256:192f1c1b252e78191daf2ad707e77c6d0d7d5bdee3827ff36b599df77684f613", + "path": "evaluation/standards-effectiveness/suites/metadata-fixtures.toml", "state": "present", "uses": [ { @@ -2514,8 +2254,8 @@ ] }, { - "digest": "sha256:9ba7154751917ef53bfa6d4596847f4cda3004947b3086af2ac15875462065a4", - "path": "evaluation/standards-effectiveness/suites/development-proportionality.toml", + "digest": "sha256:8c81ed8a896454155b6aab3836eca711a643eaad14972a7a21423b01bb2cc0a5", + "path": "evaluation/standards-effectiveness/suites/planning-consolidation.toml", "state": "present", "uses": [ { @@ -2526,8 +2266,8 @@ ] }, { - "digest": "sha256:a57d965e86ce3ddb1b840f49833d95ab1ff8a66afb16f58f1b7fe8b160494320", - "path": "evaluation/standards-effectiveness/suites/documentation-changelog-closure.toml", + "digest": "sha256:8627a4c38122d45ebfe1dba5411b2903a96c8a779ec4f0366d0a3ab3f934b90e", + "path": "evaluation/standards-effectiveness/suites/policy-semantic-impact.toml", "state": "present", "uses": [ { @@ -2538,8 +2278,8 @@ ] }, { - "digest": "sha256:e5093b5f7b1f966c794d602e7fa9e73de261f5aa8bd3408e3352aec23cc21642", - "path": "evaluation/standards-effectiveness/suites/documentation-policy-consolidation.toml", + "digest": "sha256:61760956e55a27d2333794a36514cdabf23ca2d73722a6f71c00fb7ffda53ea8", + "path": "evaluation/standards-effectiveness/suites/release-maintenance-policy.toml", "state": "present", "uses": [ { @@ -2550,8 +2290,8 @@ ] }, { - "digest": "sha256:7e6c4dfda782068c7ffe8d3af35fca6e2f7e36ec865993d9d1be98c67576b7e0", - "path": "evaluation/standards-effectiveness/suites/documentation-reference.toml", + "digest": "sha256:7fea2ba620f744cee21fbd96edfff1fe2f88f43ce5d277a2edf4e0a3e979e9f7", + "path": "evaluation/standards-effectiveness/suites/release-reference-closure.toml", "state": "present", "uses": [ { @@ -2562,8 +2302,8 @@ ] }, { - "digest": "sha256:852b43dbb3eb73a2dba287f88d988abba41540319072123cd662c7e871865e09", - "path": "evaluation/standards-effectiveness/suites/filesystem-containment-policy.toml", + "digest": "sha256:4f02b0a6cc1d7b20d5325abe0b6ac0398cd8795ddb1cf0678c3760b854e22554", + "path": "evaluation/standards-effectiveness/suites/root-index-closure.toml", "state": "present", "uses": [ { @@ -2574,8 +2314,8 @@ ] }, { - "digest": "sha256:9654c91342b49eacf415eb6477d87642df284b74982bd00b859c4d462802d720", - "path": "evaluation/standards-effectiveness/suites/frontend-rendering-synchronization.toml", + "digest": "sha256:ebb8c05e9bf3c40e1d2c47dd40f2a145b387fd26754aff047a0e0e9013cd5f8b", + "path": "evaluation/standards-effectiveness/suites/router-legacy-route-closure.toml", "state": "present", "uses": [ { @@ -2586,8 +2326,8 @@ ] }, { - "digest": "sha256:4da1e26abcb7245be74ce24e928f36233234e19153652aadae99571d3e1de4f4", - "path": "evaluation/standards-effectiveness/suites/input-validation-authority.toml", + "digest": "sha256:de52a56f5d3a854b9478be295f9c8b22ab46535c16e5b618e270c41f8080963e", + "path": "evaluation/standards-effectiveness/suites/rust-api-rustdoc.toml", "state": "present", "uses": [ { @@ -2598,8 +2338,8 @@ ] }, { - "digest": "sha256:1b06478d82d260ad8effc46bddf89fb6b9a0f01b60d1dc3adeb43345c4baaa1d", - "path": "evaluation/standards-effectiveness/suites/interop-boundary-policy.toml", + "digest": "sha256:01188b91c387a9b4013d6c0fa262d8a1268163b61b7e8d5363f9d93637649cf9", + "path": "evaluation/standards-effectiveness/suites/rust-dependency-build-cost.toml", "state": "present", "uses": [ { @@ -2610,8 +2350,8 @@ ] }, { - "digest": "sha256:47edd12aca4ef13810043ead4a25541ba4903d5f8c635b692f4d4d2df7be3ca0", - "path": "evaluation/standards-effectiveness/suites/interop-event-registration.toml", + "digest": "sha256:6304c413733928e233dbc69b8cfdafcc6be120a7070d3e0948cd7d3a55f90ae3", + "path": "evaluation/standards-effectiveness/suites/rust-profile-authority-closure.toml", "state": "present", "uses": [ { @@ -2622,8 +2362,8 @@ ] }, { - "digest": "sha256:7d9da77f7e7f3508b379534697e41e1bc6a1895f575dd3bdc57e9aa86853b9cf", - "path": "evaluation/standards-effectiveness/suites/ipc-payload-validation.toml", + "digest": "sha256:1a8101282ec9601a73719b9510e4a732f5ffa8a7da4680a9a6a276c4e4b1d2e4", + "path": "evaluation/standards-effectiveness/suites/rust-release-evidence.toml", "state": "present", "uses": [ { @@ -2634,8 +2374,8 @@ ] }, { - "digest": "sha256:fdb7aeededde0c448a6877ef0eefac3996c76e4c28f16e2310061594acad7826", - "path": "evaluation/standards-effectiveness/suites/language-binding-boundary.toml", + "digest": "sha256:867212fed1906068d19f503fc8f9579031b0a63ca5f4547377d22ffc15954b7b", + "path": "evaluation/standards-effectiveness/suites/rust-target-configuration.toml", "state": "present", "uses": [ { @@ -2646,8 +2386,8 @@ ] }, { - "digest": "sha256:d7109e373cdf655e3f76409019967537e9d988529c27ce958655c20a44843724", - "path": "evaluation/standards-effectiveness/suites/language-binding-wire-representation.toml", + "digest": "sha256:63cca2ceac227aacccf33a964801a645bb4083719e5011a46a313308f2628026", + "path": "evaluation/standards-effectiveness/suites/s1-routing.toml", "state": "present", "uses": [ { @@ -2658,8 +2398,8 @@ ] }, { - "digest": "sha256:5e0a87023ae7154caa35443d98501cecde9c1947b57560712f0b0d51c463b394", - "path": "evaluation/standards-effectiveness/suites/language-index-closure.toml", + "digest": "sha256:823c0b11b169e39ed02db8f64e70c8887932fa08143c7312ff270e4209518039", + "path": "evaluation/standards-effectiveness/suites/source-index-closures.toml", "state": "present", "uses": [ { @@ -2670,8 +2410,8 @@ ] }, { - "digest": "sha256:192f1c1b252e78191daf2ad707e77c6d0d7d5bdee3827ff36b599df77684f613", - "path": "evaluation/standards-effectiveness/suites/metadata-fixtures.toml", + "digest": "sha256:3d9838e58ca4728da7bda9c3a670fd5070e0b2e795e45302624efa90622b5a9f", + "path": "evaluation/standards-effectiveness/suites/standards-recovery-routing.toml", "state": "present", "uses": [ { @@ -2682,8 +2422,8 @@ ] }, { - "digest": "sha256:a9928475098c48bb93451d9c5eccef6e6962bdbe8edce8ca6a40f87ef2f924b4", - "path": "evaluation/standards-effectiveness/suites/network-transport-policy.toml", + "digest": "sha256:aa91b543cbc1403ce7778c5f73f50456f05ed894b9c26044780f2480bbdcc2c6", + "path": "evaluation/standards-effectiveness/suites/tooling-ci-workflow-reference.toml", "state": "present", "uses": [ { @@ -2694,8 +2434,8 @@ ] }, { - "digest": "sha256:bb25b83b069e31d1a15c9ea2d0d3ba0bc53c30e9f581da0fdf110e01646cdf97", - "path": "evaluation/standards-effectiveness/suites/persistence-owner-contract.toml", + "digest": "sha256:e797a4f7c882d2a8cbdcf29d3353221d4511e0cc2909cace73000575a3fe1b9f", + "path": "evaluation/standards-effectiveness/suites/tooling-reference-recipes.toml", "state": "present", "uses": [ { @@ -2706,8 +2446,8 @@ ] }, { - "digest": "sha256:8c81ed8a896454155b6aab3836eca711a643eaad14972a7a21423b01bb2cc0a5", - "path": "evaluation/standards-effectiveness/suites/planning-consolidation.toml", + "digest": "sha256:85d4f162dccaef2a01ae20208743db015c968fcf1dc03f8b1b8d54f6e0ccc619", + "path": "evaluation/standards-effectiveness/suites/verification-ownership.toml", "state": "present", "uses": [ { @@ -2718,8 +2458,8 @@ ] }, { - "digest": "sha256:8627a4c38122d45ebfe1dba5411b2903a96c8a779ec4f0366d0a3ab3f934b90e", - "path": "evaluation/standards-effectiveness/suites/policy-semantic-impact.toml", + "digest": "sha256:4d212c42db077be329c1ba0200f06b0d6837996b510dd98fa9d99d2142e02af4", + "path": "evaluation/standards-effectiveness/verification-guide.md", "state": "present", "uses": [ { @@ -2730,677 +2470,998 @@ ] }, { - "digest": "sha256:e98fd44783399a6fbeb5deb5a26d2d530c03d42ecb3a70baf159b63c3718e21b", - "path": "evaluation/standards-effectiveness/suites/release-artifact-policy.toml", + "digest": "sha256:4f598a27e509756ab02cbcb2c5cd0893277544e04b375d3bd97f03c57cb62c33", + "path": "languages/README.md", "state": "present", "uses": [ { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" + "check": "language-index-links", + "role": "markdown", + "suite": "language-index-closure" } ] }, { - "digest": "sha256:61760956e55a27d2333794a36514cdabf23ca2d73722a6f71c00fb7ffda53ea8", - "path": "evaluation/standards-effectiveness/suites/release-maintenance-policy.toml", + "digest": "sha256:ae4c075dc0f9ff7fa060dd6a132d3f488a3a77db067230e19209f59a569f8eb0", + "path": "languages/rust/RUST-API-STANDARDS.md", "state": "present", "uses": [ { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" + "check": "source-index-destinations", + "role": "markdown", + "suite": "rust-api-rustdoc" } ] }, { - "digest": "sha256:db00c577bea185cc27d9d0285beeb4c2ae869ca51621227a9f93129c5b86d03e", - "path": "evaluation/standards-effectiveness/suites/release-pipeline-policy.toml", + "digest": "sha256:26e2a150ed6af810a93943a25d6d141e6c8a40c6475f4d4b683e235a0dec6855", + "path": "languages/rust/RUST-CROSS-PLATFORM-STANDARDS.md", "state": "present", "uses": [ { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" + "check": "exact-migration-index-destinations", + "role": "markdown", + "suite": "rust-target-configuration" } ] }, { - "digest": "sha256:c41ae05a24d41550a79f28c86bafe3a439422e6a06ccb4e6d55ac1f5d48933ac", - "path": "evaluation/standards-effectiveness/suites/release-procedure-policy.toml", + "digest": "sha256:8444d36bd9ca1f38bfa6aa2cb36b843de8772e3a232d9da0d6f544e9daa1451c", + "path": "languages/rust/RUST-DEPENDENCY-STANDARDS.md", "state": "present", "uses": [ { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" + "check": "source-index-destinations", + "role": "markdown", + "suite": "rust-dependency-build-cost" } ] }, { - "digest": "sha256:d3e9f3866322d3239362c02e9f3dd8cd35ed2facf3dd06e0f5c73f897abd8774", - "path": "evaluation/standards-effectiveness/suites/release-publication-policy.toml", + "digest": "sha256:352ce949773d86cb756632b84a41a8047a5c7cf240cd576e1631e337951c2c93", + "path": "languages/rust/RUST-LANGUAGE-BINDINGS-STANDARDS.md", "state": "present", "uses": [ { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" + "check": "rust-binding-contract-authority-destinations", + "role": "markdown", + "suite": "contract-ownership" } ] }, { - "digest": "sha256:c2cb117c3b841b7ae035616b71fa425b4d7b0807071d6942e38069c117d2bd8e", - "path": "evaluation/standards-effectiveness/suites/release-recovery-policy.toml", + "digest": "sha256:ffccd89c26be9069d6cfe502b73d2d8309f8f3cd3231d3e53ddb1c985504799c", + "path": "languages/rust/RUST-RELEASE-STANDARDS.md", "state": "present", "uses": [ { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" + "check": "source-index-destinations", + "role": "markdown", + "suite": "rust-release-evidence" } ] }, { - "digest": "sha256:b672f405b9cb72f567bd5d79d1a936422c4b80a39283bef4ca6c33a4211b2196", - "path": "evaluation/standards-effectiveness/suites/release-reference-closure.toml", + "digest": "sha256:32ab0d4e9f24dfcd48661f8fd3ea7547c0b6f7fc995b6c8e1d3bc0938606797b", + "path": "profiles/applications/frontend.md", "state": "present", "uses": [ { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" - } - ] - }, - { - "digest": "sha256:ddd9d0f582873114775fdf1d23cf5505ebe0d47f06e7850ec61a15d8eb3f4fbb", - "path": "evaluation/standards-effectiveness/suites/release-workflow-foundation.toml", - "state": "present", - "uses": [ + "check": "canonical-corpus", + "role": "metadata", + "suite": "canonical-corpus-metadata" + }, { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" - } - ] - }, - { - "digest": "sha256:4f02b0a6cc1d7b20d5325abe0b6ac0398cd8795ddb1cf0678c3760b854e22554", - "path": "evaluation/standards-effectiveness/suites/root-index-closure.toml", - "state": "present", - "uses": [ + "check": "architecture-contract-authority-destinations", + "role": "target", + "suite": "contract-ownership" + }, + { + "check": "coding-route-destinations", + "role": "target", + "suite": "contract-ownership" + }, + { + "check": "local-links", + "role": "link-target", + "suite": "development-proportionality" + }, + { + "check": "routing-closure", + "role": "canonical-module", + "suite": "development-proportionality" + }, { "check": "current-structure", "role": "registered-policy-impact", "suite": "policy-semantic-impact" - } - ] - }, - { - "digest": "sha256:ebb8c05e9bf3c40e1d2c47dd40f2a145b387fd26754aff047a0e0e9013cd5f8b", - "path": "evaluation/standards-effectiveness/suites/router-legacy-route-closure.toml", - "state": "present", - "uses": [ + }, { - "check": "current-structure", - "role": "registered-policy-impact", + "check": "negative-fixtures", + "role": "canonical-policy-impact", "suite": "policy-semantic-impact" + }, + { + "check": "root-router-routes", + "role": "link-target", + "suite": "root-index-closure" + }, + { + "check": "root-router-routes", + "role": "member-content", + "suite": "root-index-closure" + }, + { + "check": "router-links", + "role": "link-target", + "suite": "router-legacy-route-closure" + }, + { + "check": "local-links", + "role": "link-target", + "suite": "s1-routing" + }, + { + "check": "verifier-change-route-closure", + "role": "canonical-module", + "suite": "s1-routing" + }, + { + "check": "coding-routes", + "role": "link-target", + "suite": "source-index-closures" + }, + { + "check": "coding-routes", + "role": "member-content", + "suite": "source-index-closures" + }, + { + "check": "frontend-routes", + "role": "link-target", + "suite": "source-index-closures" + }, + { + "check": "frontend-routes", + "role": "member-content", + "suite": "source-index-closures" + }, + { + "check": "source-links", + "role": "link-target", + "suite": "source-index-closures" + }, + { + "check": "requires-closure", + "role": "canonical-module", + "suite": "standards-recovery-routing" + }, + { + "check": "former-source-destinations", + "role": "target", + "suite": "tooling-ci-workflow-reference" + }, + { + "check": "former-source-destinations", + "role": "target", + "suite": "tooling-reference-recipes" + }, + { + "check": "testing-route-and-legacy-removal-destinations", + "role": "target", + "suite": "verification-ownership" + }, + { + "check": "tooling-route-and-legacy-removal-destinations", + "role": "target", + "suite": "verification-ownership" } ] }, { - "digest": "sha256:c0fdf0dc5d9f4a41cd3944181a87c7377e0844acb8baf7c071e0ac7d91b91afa", - "path": "evaluation/standards-effectiveness/suites/runtime-decoding-policy.toml", + "digest": "sha256:f4229bd7d628ad50dc65132652432ca77ef7d0a50790931942469608fd6401e2", + "path": "profiles/applications/launcher.md", "state": "present", "uses": [ + { + "check": "canonical-corpus", + "role": "metadata", + "suite": "canonical-corpus-metadata" + }, + { + "check": "local-links", + "role": "link-target", + "suite": "development-proportionality" + }, + { + "check": "routing-closure", + "role": "canonical-module", + "suite": "development-proportionality" + }, { "check": "current-structure", "role": "registered-policy-impact", "suite": "policy-semantic-impact" - } - ] - }, - { - "digest": "sha256:a465e91f30c5803dbd6c829e68d03b466a634a830dd87094db960334386a2f3b", - "path": "evaluation/standards-effectiveness/suites/rust-api-owner-contract.toml", - "state": "present", - "uses": [ + }, { - "check": "current-structure", - "role": "registered-policy-impact", + "check": "negative-fixtures", + "role": "canonical-policy-impact", "suite": "policy-semantic-impact" - } - ] - }, - { - "digest": "sha256:de52a56f5d3a854b9478be295f9c8b22ab46535c16e5b618e270c41f8080963e", - "path": "evaluation/standards-effectiveness/suites/rust-api-rustdoc.toml", - "state": "present", - "uses": [ + }, { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" - } - ] - }, - { - "digest": "sha256:93bc3acf6122f977034961bba5d8cae43453c45052ea0d8935f794d561bc78d3", - "path": "evaluation/standards-effectiveness/suites/rust-async-blocking-mutex.toml", - "state": "present", - "uses": [ + "check": "root-router-routes", + "role": "link-target", + "suite": "root-index-closure" + }, { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" + "check": "root-router-routes", + "role": "member-content", + "suite": "root-index-closure" + }, + { + "check": "router-links", + "role": "link-target", + "suite": "router-legacy-route-closure" + }, + { + "check": "local-links", + "role": "link-target", + "suite": "s1-routing" + }, + { + "check": "verifier-change-route-closure", + "role": "canonical-module", + "suite": "s1-routing" + }, + { + "check": "requires-closure", + "role": "canonical-module", + "suite": "standards-recovery-routing" + }, + { + "check": "launcher-route-destinations", + "role": "target", + "suite": "verification-ownership" } ] }, { - "digest": "sha256:7bb1602aa91eac60b8e12df55daa54f95b2730b4be39e46ea267a16b95795a57", - "path": "evaluation/standards-effectiveness/suites/rust-async-boundary.toml", + "digest": "sha256:ae605d474a922b213257916824344dadadf505aee9c585e055198208f7b8e834", + "path": "profiles/applications/library.md", "state": "present", "uses": [ + { + "check": "canonical-corpus", + "role": "metadata", + "suite": "canonical-corpus-metadata" + }, + { + "check": "local-links", + "role": "link-target", + "suite": "development-proportionality" + }, + { + "check": "routing-closure", + "role": "canonical-module", + "suite": "development-proportionality" + }, { "check": "current-structure", "role": "registered-policy-impact", "suite": "policy-semantic-impact" - } - ] - }, - { - "digest": "sha256:8679e434eca610c36d8b78117cec74c394a780cfdbacc80fb0908957810e8107", - "path": "evaluation/standards-effectiveness/suites/rust-async-cancellation-observability.toml", - "state": "present", - "uses": [ + }, { - "check": "current-structure", - "role": "registered-policy-impact", + "check": "negative-fixtures", + "role": "canonical-policy-impact", "suite": "policy-semantic-impact" + }, + { + "check": "root-router-routes", + "role": "link-target", + "suite": "root-index-closure" + }, + { + "check": "router-links", + "role": "link-target", + "suite": "router-legacy-route-closure" + }, + { + "check": "source-index-destinations", + "role": "target", + "suite": "rust-api-rustdoc" + }, + { + "check": "local-links", + "role": "link-target", + "suite": "s1-routing" + }, + { + "check": "local-links", + "role": "markdown", + "suite": "s1-routing" + }, + { + "check": "verifier-change-route-closure", + "role": "canonical-module", + "suite": "s1-routing" + }, + { + "check": "requires-closure", + "role": "canonical-module", + "suite": "standards-recovery-routing" } ] }, { - "digest": "sha256:7507ae9af0da2d3bcbd27a3708485953a19e9b0bfdfb12dada1d32135b3f65eb", - "path": "evaluation/standards-effectiveness/suites/rust-async-lifecycle.toml", + "digest": "sha256:f60172051d187b1d3107706eb64fc94cff622d5e6840ec868686e5eb62b45c69", + "path": "profiles/boundaries/generated-contract.md", "state": "present", "uses": [ + { + "check": "canonical-corpus", + "role": "metadata", + "suite": "canonical-corpus-metadata" + }, + { + "check": "local-links", + "role": "link-target", + "suite": "development-proportionality" + }, + { + "check": "routing-closure", + "role": "canonical-module", + "suite": "development-proportionality" + }, { "check": "current-structure", "role": "registered-policy-impact", "suite": "policy-semantic-impact" - } - ] - }, - { - "digest": "sha256:a250180c069e73edca8d283d609254022cbffd4c55308cad8b95dcfd1f52e054", - "path": "evaluation/standards-effectiveness/suites/rust-binding-architecture.toml", - "state": "present", - "uses": [ + }, { - "check": "current-structure", - "role": "registered-policy-impact", + "check": "negative-fixtures", + "role": "canonical-policy-impact", "suite": "policy-semantic-impact" + }, + { + "check": "root-router-routes", + "role": "link-target", + "suite": "root-index-closure" + }, + { + "check": "router-links", + "role": "link-target", + "suite": "router-legacy-route-closure" + }, + { + "check": "local-links", + "role": "link-target", + "suite": "s1-routing" + }, + { + "check": "verifier-change-route-closure", + "role": "canonical-module", + "suite": "s1-routing" + }, + { + "check": "requires-closure", + "role": "canonical-module", + "suite": "standards-recovery-routing" } ] }, { - "digest": "sha256:d1c30ddaed6e789c75a43a720890f66e0e41dadf1624f24a9be63a0e4c332188", - "path": "evaluation/standards-effectiveness/suites/rust-binding-callback-task.toml", + "digest": "sha256:85dc7f9b39ebea867d721436bc40b4b0407be564a3e04ef2f798d6bae19b471f", + "path": "profiles/boundaries/interop.md", "state": "present", "uses": [ + { + "check": "canonical-corpus", + "role": "metadata", + "suite": "canonical-corpus-metadata" + }, + { + "check": "interop-route-destinations", + "role": "target", + "suite": "contract-ownership" + }, + { + "check": "local-links", + "role": "link-target", + "suite": "development-proportionality" + }, + { + "check": "routing-closure", + "role": "canonical-module", + "suite": "development-proportionality" + }, { "check": "current-structure", "role": "registered-policy-impact", "suite": "policy-semantic-impact" - } - ] - }, - { - "digest": "sha256:89bfa1ca30bedf2bc372fdbdb06eee71cbf635f86a13674492501648b5fb5da5", - "path": "evaluation/standards-effectiveness/suites/rust-binding-conversions.toml", - "state": "present", - "uses": [ + }, { - "check": "current-structure", - "role": "registered-policy-impact", + "check": "negative-fixtures", + "role": "canonical-policy-impact", "suite": "policy-semantic-impact" + }, + { + "check": "root-router-routes", + "role": "link-target", + "suite": "root-index-closure" + }, + { + "check": "root-router-routes", + "role": "member-content", + "suite": "root-index-closure" + }, + { + "check": "router-links", + "role": "link-target", + "suite": "router-legacy-route-closure" + }, + { + "check": "local-links", + "role": "link-target", + "suite": "s1-routing" + }, + { + "check": "verifier-change-route-closure", + "role": "canonical-module", + "suite": "s1-routing" + }, + { + "check": "requires-closure", + "role": "canonical-module", + "suite": "standards-recovery-routing" } ] }, { - "digest": "sha256:6d4dfa2eb18c32b51cb642c6b48ab7e3d3d6c941923c8302e871743970c985c4", - "path": "evaluation/standards-effectiveness/suites/rust-binding-enum-representation.toml", + "digest": "sha256:2f6d0391e6a01fecf259386f314daccdcd0ed5c0b58ac0fadc6816b8171347e4", + "path": "profiles/boundaries/ipc.md", "state": "present", "uses": [ + { + "check": "canonical-corpus", + "role": "metadata", + "suite": "canonical-corpus-metadata" + }, + { + "check": "architecture-contract-authority-destinations", + "role": "target", + "suite": "contract-ownership" + }, + { + "check": "interop-route-destinations", + "role": "target", + "suite": "contract-ownership" + }, + { + "check": "local-links", + "role": "link-target", + "suite": "development-proportionality" + }, + { + "check": "routing-closure", + "role": "canonical-module", + "suite": "development-proportionality" + }, { "check": "current-structure", "role": "registered-policy-impact", "suite": "policy-semantic-impact" - } - ] - }, - { - "digest": "sha256:3668679df83d85d2004e28a1f5a4826f9b4d2d93e0f502292273d9036f4a3b64", - "path": "evaluation/standards-effectiveness/suites/rust-binding-error-mapping.toml", - "state": "present", - "uses": [ + }, { - "check": "current-structure", - "role": "registered-policy-impact", + "check": "negative-fixtures", + "role": "canonical-policy-impact", "suite": "policy-semantic-impact" - } - ] - }, - { - "digest": "sha256:4ead7e6e2be6488b661a1cdbf73255b3c96537ceeea5daffe4f40b08b83e0874", - "path": "evaluation/standards-effectiveness/suites/rust-binding-event-delivery.toml", - "state": "present", - "uses": [ + }, { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" - } - ] - }, - { - "digest": "sha256:74c3b83e09afb7f14c6645dfcf8eadb8c280130b790f8dca8f59e5b208251452", - "path": "evaluation/standards-effectiveness/suites/rust-binding-executor-delegation.toml", - "state": "present", - "uses": [ + "check": "root-router-routes", + "role": "link-target", + "suite": "root-index-closure" + }, { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" - } - ] - }, - { - "digest": "sha256:049224f8dc9d0b6245a710ab827e1558d595810d63425b738eceb58f08ed2550", - "path": "evaluation/standards-effectiveness/suites/rust-binding-runtime.toml", - "state": "present", - "uses": [ + "check": "root-router-routes", + "role": "member-content", + "suite": "root-index-closure" + }, { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" - } - ] - }, - { - "digest": "sha256:a248cac0db36d6555405a14a56e95809412bb5fdf8958f5a618a385626c6cf2c", - "path": "evaluation/standards-effectiveness/suites/rust-boundary-arithmetic.toml", - "state": "present", - "uses": [ + "check": "router-links", + "role": "link-target", + "suite": "router-legacy-route-closure" + }, { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" - } - ] - }, - { - "digest": "sha256:01188b91c387a9b4013d6c0fa262d8a1268163b61b7e8d5363f9d93637649cf9", - "path": "evaluation/standards-effectiveness/suites/rust-dependency-build-cost.toml", - "state": "present", - "uses": [ + "check": "local-links", + "role": "link-target", + "suite": "s1-routing" + }, { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" + "check": "verifier-change-route-closure", + "role": "canonical-module", + "suite": "s1-routing" + }, + { + "check": "security-routes", + "role": "link-target", + "suite": "source-index-closures" + }, + { + "check": "security-routes", + "role": "member-content", + "suite": "source-index-closures" + }, + { + "check": "source-links", + "role": "link-target", + "suite": "source-index-closures" + }, + { + "check": "requires-closure", + "role": "canonical-module", + "suite": "standards-recovery-routing" } ] }, { - "digest": "sha256:c39b918d6e48f0fe627f38ea3c4b7683bad94032cafa5999b4af1b4f63e8da02", - "path": "evaluation/standards-effectiveness/suites/rust-dependency-candidate-inspection.toml", + "digest": "sha256:c63f9d48fe8cbae4d6f685f54e72b81de60201453ce6f5752c7a75c38bc15072", + "path": "profiles/boundaries/language-bindings.md", "state": "present", "uses": [ + { + "check": "canonical-corpus", + "role": "metadata", + "suite": "canonical-corpus-metadata" + }, + { + "check": "binding-route-destinations", + "role": "target", + "suite": "contract-ownership" + }, + { + "check": "interop-route-destinations", + "role": "target", + "suite": "contract-ownership" + }, + { + "check": "rust-binding-contract-authority-destinations", + "role": "target", + "suite": "contract-ownership" + }, + { + "check": "local-links", + "role": "link-target", + "suite": "development-proportionality" + }, + { + "check": "routing-closure", + "role": "canonical-module", + "suite": "development-proportionality" + }, { "check": "current-structure", "role": "registered-policy-impact", "suite": "policy-semantic-impact" - } - ] - }, - { - "digest": "sha256:406b90e3ea1e2bd5e7cdfa22603b53fb8f3099419a77fccfe1b9c051c4674ed2", - "path": "evaluation/standards-effectiveness/suites/rust-dependency-owner-contract.toml", - "state": "present", - "uses": [ + }, { - "check": "current-structure", - "role": "registered-policy-impact", + "check": "negative-fixtures", + "role": "canonical-policy-impact", "suite": "policy-semantic-impact" + }, + { + "check": "root-router-routes", + "role": "link-target", + "suite": "root-index-closure" + }, + { + "check": "root-router-routes", + "role": "member-content", + "suite": "root-index-closure" + }, + { + "check": "router-links", + "role": "link-target", + "suite": "router-legacy-route-closure" + }, + { + "check": "local-links", + "role": "link-target", + "suite": "s1-routing" + }, + { + "check": "verifier-change-route-closure", + "role": "canonical-module", + "suite": "s1-routing" + }, + { + "check": "requires-closure", + "role": "canonical-module", + "suite": "standards-recovery-routing" + }, + { + "check": "testing-route-and-legacy-removal-destinations", + "role": "target", + "suite": "verification-ownership" } ] }, { - "digest": "sha256:402e1f8118071a3faf4a4d6109593664a2028a872f3d046ac16ac2ccfc1d95a8", - "path": "evaluation/standards-effectiveness/suites/rust-external-input-queue.toml", + "digest": "sha256:9ec9473c865a4293433d0f22d0b82b6089fce9a72b47c7f735612a20faf1734b", + "path": "profiles/boundaries/persistence.md", "state": "present", "uses": [ + { + "check": "canonical-corpus", + "role": "metadata", + "suite": "canonical-corpus-metadata" + }, + { + "check": "architecture-contract-authority-destinations", + "role": "target", + "suite": "contract-ownership" + }, + { + "check": "local-links", + "role": "link-target", + "suite": "development-proportionality" + }, + { + "check": "routing-closure", + "role": "canonical-module", + "suite": "development-proportionality" + }, { "check": "current-structure", "role": "registered-policy-impact", "suite": "policy-semantic-impact" - } - ] - }, - { - "digest": "sha256:ebe0845f6b7a3cc776349ad54c0d0796715c5a1f8df5a8157eceafeb0c83825b", - "path": "evaluation/standards-effectiveness/suites/rust-filesystem-authority.toml", - "state": "present", - "uses": [ + }, { - "check": "current-structure", - "role": "registered-policy-impact", + "check": "negative-fixtures", + "role": "canonical-policy-impact", "suite": "policy-semantic-impact" + }, + { + "check": "root-router-routes", + "role": "link-target", + "suite": "root-index-closure" + }, + { + "check": "root-router-routes", + "role": "member-content", + "suite": "root-index-closure" + }, + { + "check": "router-links", + "role": "link-target", + "suite": "router-legacy-route-closure" + }, + { + "check": "local-links", + "role": "link-target", + "suite": "s1-routing" + }, + { + "check": "verifier-change-route-closure", + "role": "canonical-module", + "suite": "s1-routing" + }, + { + "check": "requires-closure", + "role": "canonical-module", + "suite": "standards-recovery-routing" } ] }, { - "digest": "sha256:f9ea6220d9523f654146694a74b71db3a1dccad6781ab5f4c045fe46d0ab3882", - "path": "evaluation/standards-effectiveness/suites/rust-interop-memory.toml", + "digest": "sha256:4481df92a00c8a14e2c5fd0deda83878d6c31f65f9e56aea3f394330c9588e65", + "path": "profiles/frameworks/godot.md", "state": "present", "uses": [ + { + "check": "canonical-corpus", + "role": "metadata", + "suite": "canonical-corpus-metadata" + }, + { + "check": "local-links", + "role": "link-target", + "suite": "development-proportionality" + }, + { + "check": "routing-closure", + "role": "canonical-module", + "suite": "development-proportionality" + }, { "check": "current-structure", "role": "registered-policy-impact", "suite": "policy-semantic-impact" - } - ] - }, - { - "digest": "sha256:5db963df29645eec64741ed16d64e81e9acde5aafa1cb7a4af0f6d0ad637e900", - "path": "evaluation/standards-effectiveness/suites/rust-listener-lifecycle.toml", - "state": "present", - "uses": [ + }, { - "check": "current-structure", - "role": "registered-policy-impact", + "check": "negative-fixtures", + "role": "canonical-policy-impact", "suite": "policy-semantic-impact" - } - ] - }, - { - "digest": "sha256:ef26cc7f741c03651849af77d29d53635e060cbbae39fea530c903ab8f56deb9", - "path": "evaluation/standards-effectiveness/suites/rust-profile-authority-closure.toml", - "state": "present", - "uses": [ + }, { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" + "check": "root-router-routes", + "role": "link-target", + "suite": "root-index-closure" + }, + { + "check": "root-router-routes", + "role": "member-content", + "suite": "root-index-closure" + }, + { + "check": "router-links", + "role": "link-target", + "suite": "router-legacy-route-closure" + }, + { + "check": "local-links", + "role": "link-target", + "suite": "s1-routing" + }, + { + "check": "verifier-change-route-closure", + "role": "canonical-module", + "suite": "s1-routing" + }, + { + "check": "concurrency-routes", + "role": "link-target", + "suite": "source-index-closures" + }, + { + "check": "concurrency-routes", + "role": "member-content", + "suite": "source-index-closures" + }, + { + "check": "source-links", + "role": "link-target", + "suite": "source-index-closures" + }, + { + "check": "requires-closure", + "role": "canonical-module", + "suite": "standards-recovery-routing" } ] }, { - "digest": "sha256:1a8101282ec9601a73719b9510e4a732f5ffa8a7da4680a9a6a276c4e4b1d2e4", - "path": "evaluation/standards-effectiveness/suites/rust-release-evidence.toml", + "digest": "sha256:a276e54d170e2f090d3ff6fc5fc92dba41e606d3000c1a6d24731d4869ada6bb", + "path": "profiles/languages/csharp/async.md", "state": "present", "uses": [ + { + "check": "canonical-corpus", + "role": "metadata", + "suite": "canonical-corpus-metadata" + }, + { + "check": "local-links", + "role": "link-target", + "suite": "development-proportionality" + }, + { + "check": "routing-closure", + "role": "canonical-module", + "suite": "development-proportionality" + }, { "check": "current-structure", "role": "registered-policy-impact", "suite": "policy-semantic-impact" - } - ] - }, - { - "digest": "sha256:6bf9eb6f99cfab91e5faa7ac9236f961bca5d7796b682be482064b2a4e41326e", - "path": "evaluation/standards-effectiveness/suites/rust-release-owner-contract.toml", - "state": "present", - "uses": [ + }, { - "check": "current-structure", - "role": "registered-policy-impact", + "check": "negative-fixtures", + "role": "canonical-policy-impact", "suite": "policy-semantic-impact" + }, + { + "check": "root-router-routes", + "role": "link-target", + "suite": "root-index-closure" + }, + { + "check": "root-router-routes", + "role": "member-content", + "suite": "root-index-closure" + }, + { + "check": "router-links", + "role": "link-target", + "suite": "router-legacy-route-closure" + }, + { + "check": "local-links", + "role": "link-target", + "suite": "s1-routing" + }, + { + "check": "verifier-change-route-closure", + "role": "canonical-module", + "suite": "s1-routing" + }, + { + "check": "concurrency-routes", + "role": "link-target", + "suite": "source-index-closures" + }, + { + "check": "concurrency-routes", + "role": "member-content", + "suite": "source-index-closures" + }, + { + "check": "source-links", + "role": "link-target", + "suite": "source-index-closures" + }, + { + "check": "requires-closure", + "role": "canonical-module", + "suite": "standards-recovery-routing" } ] }, { - "digest": "sha256:b7caccafeeac8442df5e38ab2069c9f39f9cea1c421a49276b2d9d9adfb13b8f", - "path": "evaluation/standards-effectiveness/suites/rust-security-panic-boundary.toml", + "digest": "sha256:a65e24c6969a7bad1276420c3759bb32ed5acdc73b03de7c1edb06c672077237", + "path": "profiles/languages/rust/README.md", "state": "present", "uses": [ + { + "check": "canonical-corpus", + "role": "metadata", + "suite": "canonical-corpus-metadata" + }, + { + "check": "local-links", + "role": "link-target", + "suite": "development-proportionality" + }, + { + "check": "routing-closure", + "role": "canonical-module", + "suite": "development-proportionality" + }, + { + "check": "language-index-links", + "role": "link-target", + "suite": "language-index-closure" + }, { "check": "current-structure", "role": "registered-policy-impact", "suite": "policy-semantic-impact" - } - ] - }, - { - "digest": "sha256:867212fed1906068d19f503fc8f9579031b0a63ca5f4547377d22ffc15954b7b", - "path": "evaluation/standards-effectiveness/suites/rust-target-configuration.toml", - "state": "present", - "uses": [ + }, { - "check": "current-structure", - "role": "registered-policy-impact", + "check": "negative-fixtures", + "role": "canonical-policy-impact", "suite": "policy-semantic-impact" + }, + { + "check": "root-router-routes", + "role": "link-target", + "suite": "root-index-closure" + }, + { + "check": "router-links", + "role": "link-target", + "suite": "router-legacy-route-closure" + }, + { + "check": "rust-profile-links", + "role": "markdown", + "suite": "rust-profile-authority-closure" + }, + { + "check": "local-links", + "role": "link-target", + "suite": "s1-routing" + }, + { + "check": "local-links", + "role": "markdown", + "suite": "s1-routing" + }, + { + "check": "verifier-change-route-closure", + "role": "canonical-module", + "suite": "s1-routing" + }, + { + "check": "requires-closure", + "role": "canonical-module", + "suite": "standards-recovery-routing" } ] }, { - "digest": "sha256:7561c909672665d201d0c221a59077cce9ff86b3f67c16fa6dfb34f12e560133", - "path": "evaluation/standards-effectiveness/suites/rust-tooling-owner-contract.toml", + "digest": "sha256:ac03ecf806d8d2c64bc45f94642b9ea9256c37d33c94b754ec61e8cda2cb966b", + "path": "profiles/languages/rust/api.md", "state": "present", "uses": [ + { + "check": "canonical-corpus", + "role": "metadata", + "suite": "canonical-corpus-metadata" + }, + { + "check": "local-links", + "role": "link-target", + "suite": "development-proportionality" + }, + { + "check": "routing-closure", + "role": "canonical-module", + "suite": "development-proportionality" + }, { "check": "current-structure", "role": "registered-policy-impact", "suite": "policy-semantic-impact" + }, + { + "check": "negative-fixtures", + "role": "canonical-policy-impact", + "suite": "policy-semantic-impact" + }, + { + "check": "root-router-routes", + "role": "link-target", + "suite": "root-index-closure" + }, + { + "check": "router-links", + "role": "link-target", + "suite": "router-legacy-route-closure" + }, + { + "check": "source-index-destinations", + "role": "target", + "suite": "rust-api-rustdoc" + }, + { + "check": "source-index-destinations", + "role": "target", + "suite": "rust-dependency-build-cost" + }, + { + "check": "rust-profile-links", + "role": "link-target", + "suite": "rust-profile-authority-closure" + }, + { + "check": "local-links", + "role": "link-target", + "suite": "s1-routing" + }, + { + "check": "verifier-change-route-closure", + "role": "canonical-module", + "suite": "s1-routing" + }, + { + "check": "requires-closure", + "role": "canonical-module", + "suite": "standards-recovery-routing" } ] }, { - "digest": "sha256:8810692f6a1da8adcb912ff9c7f28a12499cc5bdc3fee4186b40f9fd407af71f", - "path": "evaluation/standards-effectiveness/suites/rust-unsafe-contracts.toml", + "digest": "sha256:dab13f7a7d75b950431392c93cdd43b14546f5d83e0768f108f0c6ca881d16fc", + "path": "profiles/languages/rust/async.md", "state": "present", "uses": [ { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" - } - ] - }, - { - "digest": "sha256:809fb407d3a0f40fa6f3d49772d399463709f8f511b4dad846f23463bfb1dfa5", - "path": "evaluation/standards-effectiveness/suites/rust-wire-representation.toml", - "state": "present", - "uses": [ - { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" - } - ] - }, - { - "digest": "sha256:0d38d373f07548a92f37c2ecd2a8f7d5b907de3b134664726a23a787b4266678", - "path": "evaluation/standards-effectiveness/suites/s1-routing.toml", - "state": "present", - "uses": [ - { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" - } - ] - }, - { - "digest": "sha256:823c0b11b169e39ed02db8f64e70c8887932fa08143c7312ff270e4209518039", - "path": "evaluation/standards-effectiveness/suites/source-index-closures.toml", - "state": "present", - "uses": [ - { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" - } - ] - }, - { - "digest": "sha256:d8f87d528b0340c1676aa0bbcaea20df03b4da856580b645986c1825768f0006", - "path": "evaluation/standards-effectiveness/suites/standards-recovery-routing.toml", - "state": "present", - "uses": [ - { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" - } - ] - }, - { - "digest": "sha256:aa91b543cbc1403ce7778c5f73f50456f05ed894b9c26044780f2480bbdcc2c6", - "path": "evaluation/standards-effectiveness/suites/tooling-ci-workflow-reference.toml", - "state": "present", - "uses": [ - { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" - } - ] - }, - { - "digest": "sha256:e797a4f7c882d2a8cbdcf29d3353221d4511e0cc2909cace73000575a3fe1b9f", - "path": "evaluation/standards-effectiveness/suites/tooling-reference-recipes.toml", - "state": "present", - "uses": [ - { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" - } - ] - }, - { - "digest": "sha256:aaa28d7f83777bbb60336b0b5157597a7b425b39ba0a72bd425350cdfea78925", - "path": "evaluation/standards-effectiveness/suites/validation-proof-lifetime.toml", - "state": "present", - "uses": [ - { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" - } - ] - }, - { - "digest": "sha256:85d4f162dccaef2a01ae20208743db015c968fcf1dc03f8b1b8d54f6e0ccc619", - "path": "evaluation/standards-effectiveness/suites/verification-ownership.toml", - "state": "present", - "uses": [ - { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" - } - ] - }, - { - "digest": "sha256:4d212c42db077be329c1ba0200f06b0d6837996b510dd98fa9d99d2142e02af4", - "path": "evaluation/standards-effectiveness/verification-guide.md", - "state": "present", - "uses": [ - { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" - } - ] - }, - { - "digest": "sha256:4f598a27e509756ab02cbcb2c5cd0893277544e04b375d3bd97f03c57cb62c33", - "path": "languages/README.md", - "state": "present", - "uses": [ - { - "check": "language-index-links", - "role": "markdown", - "suite": "language-index-closure" - } - ] - }, - { - "digest": "sha256:ae4c075dc0f9ff7fa060dd6a132d3f488a3a77db067230e19209f59a569f8eb0", - "path": "languages/rust/RUST-API-STANDARDS.md", - "state": "present", - "uses": [ - { - "check": "source-index-destinations", - "role": "markdown", - "suite": "rust-api-rustdoc" - } - ] - }, - { - "digest": "sha256:26e2a150ed6af810a93943a25d6d141e6c8a40c6475f4d4b683e235a0dec6855", - "path": "languages/rust/RUST-CROSS-PLATFORM-STANDARDS.md", - "state": "present", - "uses": [ - { - "check": "exact-migration-index-destinations", - "role": "markdown", - "suite": "rust-target-configuration" - } - ] - }, - { - "digest": "sha256:8444d36bd9ca1f38bfa6aa2cb36b843de8772e3a232d9da0d6f544e9daa1451c", - "path": "languages/rust/RUST-DEPENDENCY-STANDARDS.md", - "state": "present", - "uses": [ - { - "check": "source-index-destinations", - "role": "markdown", - "suite": "rust-dependency-build-cost" - } - ] - }, - { - "digest": "sha256:352ce949773d86cb756632b84a41a8047a5c7cf240cd576e1631e337951c2c93", - "path": "languages/rust/RUST-LANGUAGE-BINDINGS-STANDARDS.md", - "state": "present", - "uses": [ - { - "check": "rust-binding-contract-authority-destinations", - "role": "markdown", - "suite": "contract-ownership" - } - ] - }, - { - "digest": "sha256:ffccd89c26be9069d6cfe502b73d2d8309f8f3cd3231d3e53ddb1c985504799c", - "path": "languages/rust/RUST-RELEASE-STANDARDS.md", - "state": "present", - "uses": [ - { - "check": "source-index-destinations", - "role": "markdown", - "suite": "rust-release-evidence" - } - ] - }, - { - "digest": "sha256:32ab0d4e9f24dfcd48661f8fd3ea7547c0b6f7fc995b6c8e1d3bc0938606797b", - "path": "profiles/applications/frontend.md", - "state": "present", - "uses": [ - { - "check": "architecture-contract-authority-destinations", - "role": "target", - "suite": "contract-ownership" + "check": "canonical-corpus", + "role": "metadata", + "suite": "canonical-corpus-metadata" }, { - "check": "coding-route-destinations", + "check": "rust-binding-contract-authority-destinations", "role": "target", "suite": "contract-ownership" }, @@ -3414,11 +3475,6 @@ "role": "canonical-module", "suite": "development-proportionality" }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "frontend-rendering-synchronization" - }, { "check": "current-structure", "role": "registered-policy-impact", @@ -3444,6 +3500,11 @@ "role": "link-target", "suite": "router-legacy-route-closure" }, + { + "check": "rust-profile-links", + "role": "link-target", + "suite": "rust-profile-authority-closure" + }, { "check": "local-links", "role": "link-target", @@ -3455,22 +3516,12 @@ "suite": "s1-routing" }, { - "check": "coding-routes", - "role": "link-target", - "suite": "source-index-closures" - }, - { - "check": "coding-routes", - "role": "member-content", - "suite": "source-index-closures" - }, - { - "check": "frontend-routes", + "check": "concurrency-routes", "role": "link-target", "suite": "source-index-closures" }, { - "check": "frontend-routes", + "check": "concurrency-routes", "role": "member-content", "suite": "source-index-closures" }, @@ -3483,34 +3534,19 @@ "check": "requires-closure", "role": "canonical-module", "suite": "standards-recovery-routing" - }, - { - "check": "former-source-destinations", - "role": "target", - "suite": "tooling-ci-workflow-reference" - }, - { - "check": "former-source-destinations", - "role": "target", - "suite": "tooling-reference-recipes" - }, - { - "check": "testing-route-and-legacy-removal-destinations", - "role": "target", - "suite": "verification-ownership" - }, - { - "check": "tooling-route-and-legacy-removal-destinations", - "role": "target", - "suite": "verification-ownership" } ] }, { - "digest": "sha256:f4229bd7d628ad50dc65132652432ca77ef7d0a50790931942469608fd6401e2", - "path": "profiles/applications/launcher.md", + "digest": "sha256:3c0e6d192dd9789b0919c18afd943c6073a4b1150b08cd5a42dca6e32c7a3476", + "path": "profiles/languages/rust/binding-lifecycle.md", "state": "present", "uses": [ + { + "check": "canonical-corpus", + "role": "metadata", + "suite": "canonical-corpus-metadata" + }, { "check": "local-links", "role": "link-target", @@ -3536,11 +3572,6 @@ "role": "link-target", "suite": "root-index-closure" }, - { - "check": "root-router-routes", - "role": "member-content", - "suite": "root-index-closure" - }, { "check": "router-links", "role": "link-target", @@ -3560,21 +3591,26 @@ "check": "requires-closure", "role": "canonical-module", "suite": "standards-recovery-routing" - }, - { - "check": "launcher-route-destinations", - "role": "target", - "suite": "verification-ownership" } ] }, { - "digest": "sha256:ae605d474a922b213257916824344dadadf505aee9c585e055198208f7b8e834", - "path": "profiles/applications/library.md", + "digest": "sha256:1b30a6385f91af4d3b4a3e33eb72fb9b067339f5237f44297817fa3bec55998d", + "path": "profiles/languages/rust/cross-platform.md", "state": "present", "uses": [ { - "check": "local-links", + "check": "canonical-corpus", + "role": "metadata", + "suite": "canonical-corpus-metadata" + }, + { + "check": "rust-binding-contract-authority-destinations", + "role": "target", + "suite": "contract-ownership" + }, + { + "check": "local-links", "role": "link-target", "suite": "development-proportionality" }, @@ -3598,36 +3634,31 @@ "role": "link-target", "suite": "root-index-closure" }, + { + "check": "root-router-routes", + "role": "member-content", + "suite": "root-index-closure" + }, { "check": "router-links", "role": "link-target", "suite": "router-legacy-route-closure" }, { - "check": "metadata", - "role": "metadata", - "suite": "rust-api-owner-contract" + "check": "rust-profile-links", + "role": "link-target", + "suite": "rust-profile-authority-closure" }, { - "check": "source-index-destinations", + "check": "exact-migration-index-destinations", "role": "target", - "suite": "rust-api-rustdoc" + "suite": "rust-target-configuration" }, { "check": "local-links", "role": "link-target", "suite": "s1-routing" }, - { - "check": "local-links", - "role": "markdown", - "suite": "s1-routing" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "s1-routing" - }, { "check": "verifier-change-route-closure", "role": "canonical-module", @@ -3641,10 +3672,15 @@ ] }, { - "digest": "sha256:f60172051d187b1d3107706eb64fc94cff622d5e6840ec868686e5eb62b45c69", - "path": "profiles/boundaries/generated-contract.md", + "digest": "sha256:a94b2b6b549009b3ffca0176230594e8258dae4bfa0fed58397fd85a37cc734b", + "path": "profiles/languages/rust/dependencies.md", "state": "present", "uses": [ + { + "check": "canonical-corpus", + "role": "metadata", + "suite": "canonical-corpus-metadata" + }, { "check": "local-links", "role": "link-target", @@ -3670,11 +3706,31 @@ "role": "link-target", "suite": "root-index-closure" }, + { + "check": "root-router-routes", + "role": "member-content", + "suite": "root-index-closure" + }, { "check": "router-links", "role": "link-target", "suite": "router-legacy-route-closure" }, + { + "check": "source-index-destinations", + "role": "target", + "suite": "rust-dependency-build-cost" + }, + { + "check": "rust-profile-links", + "role": "link-target", + "suite": "rust-profile-authority-closure" + }, + { + "check": "source-index-destinations", + "role": "target", + "suite": "rust-release-evidence" + }, { "check": "local-links", "role": "link-target", @@ -3685,11 +3741,6 @@ "role": "canonical-module", "suite": "s1-routing" }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "standards-recovery-routing" - }, { "check": "requires-closure", "role": "canonical-module", @@ -3698,12 +3749,17 @@ ] }, { - "digest": "sha256:85dc7f9b39ebea867d721436bc40b4b0407be564a3e04ef2f798d6bae19b471f", - "path": "profiles/boundaries/interop.md", + "digest": "sha256:fecc60fddd0d93706adc49055a4aa93183b7a7bda5d05ee975a11acb4e54abd9", + "path": "profiles/languages/rust/interop.md", "state": "present", "uses": [ { - "check": "interop-route-destinations", + "check": "canonical-corpus", + "role": "metadata", + "suite": "canonical-corpus-metadata" + }, + { + "check": "rust-binding-contract-authority-destinations", "role": "target", "suite": "contract-ownership" }, @@ -3717,26 +3773,6 @@ "role": "canonical-module", "suite": "development-proportionality" }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "interop-boundary-policy" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "interop-event-registration" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "language-binding-boundary" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "language-binding-wire-representation" - }, { "check": "current-structure", "role": "registered-policy-impact", @@ -3752,65 +3788,15 @@ "role": "link-target", "suite": "root-index-closure" }, - { - "check": "root-router-routes", - "role": "member-content", - "suite": "root-index-closure" - }, { "check": "router-links", "role": "link-target", "suite": "router-legacy-route-closure" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-architecture" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-callback-task" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-conversions" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-enum-representation" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-error-mapping" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-event-delivery" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-executor-delegation" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-runtime" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-interop-memory" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-wire-representation" + "check": "rust-profile-links", + "role": "link-target", + "suite": "rust-profile-authority-closure" }, { "check": "local-links", @@ -3830,17 +3816,17 @@ ] }, { - "digest": "sha256:2f6d0391e6a01fecf259386f314daccdcd0ed5c0b58ac0fadc6816b8171347e4", - "path": "profiles/boundaries/ipc.md", + "digest": "sha256:91c26196e5a976dcf20759cc6d787605dc327a0704d08929cce05b71acadf1b9", + "path": "profiles/languages/rust/language-bindings.md", "state": "present", "uses": [ { - "check": "architecture-contract-authority-destinations", - "role": "target", - "suite": "contract-ownership" + "check": "canonical-corpus", + "role": "metadata", + "suite": "canonical-corpus-metadata" }, { - "check": "interop-route-destinations", + "check": "rust-binding-contract-authority-destinations", "role": "target", "suite": "contract-ownership" }, @@ -3854,16 +3840,6 @@ "role": "canonical-module", "suite": "development-proportionality" }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "ipc-payload-validation" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "network-transport-policy" - }, { "check": "current-structure", "role": "registered-policy-impact", @@ -3879,16 +3855,16 @@ "role": "link-target", "suite": "root-index-closure" }, - { - "check": "root-router-routes", - "role": "member-content", - "suite": "root-index-closure" - }, { "check": "router-links", "role": "link-target", "suite": "router-legacy-route-closure" }, + { + "check": "rust-profile-links", + "role": "link-target", + "suite": "rust-profile-authority-closure" + }, { "check": "local-links", "role": "link-target", @@ -3899,21 +3875,6 @@ "role": "canonical-module", "suite": "s1-routing" }, - { - "check": "security-routes", - "role": "link-target", - "suite": "source-index-closures" - }, - { - "check": "security-routes", - "role": "member-content", - "suite": "source-index-closures" - }, - { - "check": "source-links", - "role": "link-target", - "suite": "source-index-closures" - }, { "check": "requires-closure", "role": "canonical-module", @@ -3922,24 +3883,14 @@ ] }, { - "digest": "sha256:c63f9d48fe8cbae4d6f685f54e72b81de60201453ce6f5752c7a75c38bc15072", - "path": "profiles/boundaries/language-bindings.md", + "digest": "sha256:83046b90ebebd76de9db7838150c5533853d748d063ff342cfa90c1fa9b4e9a0", + "path": "profiles/languages/rust/release.md", "state": "present", "uses": [ { - "check": "binding-route-destinations", - "role": "target", - "suite": "contract-ownership" - }, - { - "check": "interop-route-destinations", - "role": "target", - "suite": "contract-ownership" - }, - { - "check": "rust-binding-contract-authority-destinations", - "role": "target", - "suite": "contract-ownership" + "check": "canonical-corpus", + "role": "metadata", + "suite": "canonical-corpus-metadata" }, { "check": "local-links", @@ -3951,16 +3902,6 @@ "role": "canonical-module", "suite": "development-proportionality" }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "language-binding-boundary" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "language-binding-wire-representation" - }, { "check": "current-structure", "role": "registered-policy-impact", @@ -3987,49 +3928,14 @@ "suite": "router-legacy-route-closure" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-architecture" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-callback-task" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-conversions" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-enum-representation" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-error-mapping" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-event-delivery" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-executor-delegation" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-runtime" + "check": "rust-profile-links", + "role": "link-target", + "suite": "rust-profile-authority-closure" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-wire-representation" + "check": "source-index-destinations", + "role": "target", + "suite": "rust-release-evidence" }, { "check": "local-links", @@ -4045,23 +3951,18 @@ "check": "requires-closure", "role": "canonical-module", "suite": "standards-recovery-routing" - }, - { - "check": "testing-route-and-legacy-removal-destinations", - "role": "target", - "suite": "verification-ownership" } ] }, { - "digest": "sha256:9ec9473c865a4293433d0f22d0b82b6089fce9a72b47c7f735612a20faf1734b", - "path": "profiles/boundaries/persistence.md", + "digest": "sha256:b2dd9fbdce8496cad999c6963f13992e0384d6a4bd2d4bd1e971153e07f6257e", + "path": "profiles/languages/rust/security.md", "state": "present", "uses": [ { - "check": "architecture-contract-authority-destinations", - "role": "target", - "suite": "contract-ownership" + "check": "canonical-corpus", + "role": "metadata", + "suite": "canonical-corpus-metadata" }, { "check": "local-links", @@ -4073,11 +3974,6 @@ "role": "canonical-module", "suite": "development-proportionality" }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "persistence-owner-contract" - }, { "check": "current-structure", "role": "registered-policy-impact", @@ -4093,16 +3989,16 @@ "role": "link-target", "suite": "root-index-closure" }, - { - "check": "root-router-routes", - "role": "member-content", - "suite": "root-index-closure" - }, { "check": "router-links", "role": "link-target", "suite": "router-legacy-route-closure" }, + { + "check": "rust-profile-links", + "role": "link-target", + "suite": "rust-profile-authority-closure" + }, { "check": "local-links", "role": "link-target", @@ -4113,6 +4009,21 @@ "role": "canonical-module", "suite": "s1-routing" }, + { + "check": "concurrency-routes", + "role": "link-target", + "suite": "source-index-closures" + }, + { + "check": "concurrency-routes", + "role": "member-content", + "suite": "source-index-closures" + }, + { + "check": "source-links", + "role": "link-target", + "suite": "source-index-closures" + }, { "check": "requires-closure", "role": "canonical-module", @@ -4121,10 +4032,15 @@ ] }, { - "digest": "sha256:4481df92a00c8a14e2c5fd0deda83878d6c31f65f9e56aea3f394330c9588e65", - "path": "profiles/frameworks/godot.md", + "digest": "sha256:2b28ef71141b860f0497f8379701027e4e1aaa9aabb40720e875725933d33652", + "path": "profiles/languages/rust/tooling.md", "state": "present", "uses": [ + { + "check": "canonical-corpus", + "role": "metadata", + "suite": "canonical-corpus-metadata" + }, { "check": "local-links", "role": "link-target", @@ -4160,6 +4076,11 @@ "role": "link-target", "suite": "router-legacy-route-closure" }, + { + "check": "rust-profile-links", + "role": "link-target", + "suite": "rust-profile-authority-closure" + }, { "check": "local-links", "role": "link-target", @@ -4171,19 +4092,71 @@ "suite": "s1-routing" }, { - "check": "concurrency-routes", + "check": "requires-closure", + "role": "canonical-module", + "suite": "standards-recovery-routing" + } + ] + }, + { + "digest": "sha256:2093d5d2945dcc8423802e56df0a6651036167d35edf23e663b8725d7b94f25c", + "path": "profiles/languages/rust/unsafe.md", + "state": "present", + "uses": [ + { + "check": "canonical-corpus", + "role": "metadata", + "suite": "canonical-corpus-metadata" + }, + { + "check": "local-links", "role": "link-target", - "suite": "source-index-closures" + "suite": "development-proportionality" }, { - "check": "concurrency-routes", - "role": "member-content", - "suite": "source-index-closures" + "check": "routing-closure", + "role": "canonical-module", + "suite": "development-proportionality" }, { - "check": "source-links", + "check": "current-structure", + "role": "registered-policy-impact", + "suite": "policy-semantic-impact" + }, + { + "check": "negative-fixtures", + "role": "canonical-policy-impact", + "suite": "policy-semantic-impact" + }, + { + "check": "root-router-routes", "role": "link-target", - "suite": "source-index-closures" + "suite": "root-index-closure" + }, + { + "check": "router-links", + "role": "link-target", + "suite": "router-legacy-route-closure" + }, + { + "check": "source-index-destinations", + "role": "target", + "suite": "rust-api-rustdoc" + }, + { + "check": "rust-profile-links", + "role": "link-target", + "suite": "rust-profile-authority-closure" + }, + { + "check": "local-links", + "role": "link-target", + "suite": "s1-routing" + }, + { + "check": "verifier-change-route-closure", + "role": "canonical-module", + "suite": "s1-routing" }, { "check": "requires-closure", @@ -4193,10 +4166,20 @@ ] }, { - "digest": "sha256:a276e54d170e2f090d3ff6fc5fc92dba41e606d3000c1a6d24731d4869ada6bb", - "path": "profiles/languages/csharp/async.md", + "digest": "sha256:b40eef63e3fe3fd066827cf3d1ac86a5402e8bdf27c54dea7ff1912a4cfd496e", + "path": "profiles/languages/typescript.md", "state": "present", "uses": [ + { + "check": "canonical-corpus", + "role": "metadata", + "suite": "canonical-corpus-metadata" + }, + { + "check": "coding-route-destinations", + "role": "target", + "suite": "contract-ownership" + }, { "check": "local-links", "role": "link-target", @@ -4243,12 +4226,22 @@ "suite": "s1-routing" }, { - "check": "concurrency-routes", + "check": "coding-routes", "role": "link-target", "suite": "source-index-closures" }, { - "check": "concurrency-routes", + "check": "coding-routes", + "role": "member-content", + "suite": "source-index-closures" + }, + { + "check": "frontend-routes", + "role": "link-target", + "suite": "source-index-closures" + }, + { + "check": "frontend-routes", "role": "member-content", "suite": "source-index-closures" }, @@ -4261,14 +4254,49 @@ "check": "requires-closure", "role": "canonical-module", "suite": "standards-recovery-routing" + }, + { + "check": "former-source-destinations", + "role": "target", + "suite": "tooling-ci-workflow-reference" + }, + { + "check": "reference-destinations", + "role": "target", + "suite": "tooling-ci-workflow-reference" + }, + { + "check": "former-source-destinations", + "role": "target", + "suite": "tooling-reference-recipes" + }, + { + "check": "reference-destinations", + "role": "target", + "suite": "tooling-reference-recipes" + }, + { + "check": "tooling-route-and-legacy-removal-destinations", + "role": "target", + "suite": "verification-ownership" } ] }, { - "digest": "sha256:a65e24c6969a7bad1276420c3759bb32ed5acdc73b03de7c1edb06c672077237", - "path": "profiles/languages/rust/README.md", + "digest": "sha256:8f7c6995b6d11fb2a2459cb42742f11dd5ce156dfb4a6afa00eab3b1280add2d", + "path": "profiles/languages/typescript/async.md", "state": "present", "uses": [ + { + "check": "canonical-corpus", + "role": "metadata", + "suite": "canonical-corpus-metadata" + }, + { + "check": "coding-route-destinations", + "role": "target", + "suite": "contract-ownership" + }, { "check": "local-links", "role": "link-target", @@ -4279,11 +4307,6 @@ "role": "canonical-module", "suite": "development-proportionality" }, - { - "check": "language-index-links", - "role": "link-target", - "suite": "language-index-closure" - }, { "check": "current-structure", "role": "registered-policy-impact", @@ -4295,13 +4318,13 @@ "suite": "policy-semantic-impact" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-procedure-policy" + "check": "root-router-routes", + "role": "link-target", + "suite": "root-index-closure" }, { "check": "root-router-routes", - "role": "link-target", + "role": "member-content", "suite": "root-index-closure" }, { @@ -4310,154 +4333,179 @@ "suite": "router-legacy-route-closure" }, { - "check": "metadata", - "role": "metadata", - "suite": "rust-api-owner-contract" + "check": "local-links", + "role": "link-target", + "suite": "s1-routing" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-async-blocking-mutex" + "check": "verifier-change-route-closure", + "role": "canonical-module", + "suite": "s1-routing" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-async-boundary" + "check": "coding-routes", + "role": "link-target", + "suite": "source-index-closures" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-async-cancellation-observability" + "check": "coding-routes", + "role": "member-content", + "suite": "source-index-closures" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-async-lifecycle" + "check": "concurrency-routes", + "role": "link-target", + "suite": "source-index-closures" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-architecture" + "check": "concurrency-routes", + "role": "member-content", + "suite": "source-index-closures" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-callback-task" + "check": "frontend-routes", + "role": "link-target", + "suite": "source-index-closures" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-conversions" + "check": "frontend-routes", + "role": "member-content", + "suite": "source-index-closures" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-enum-representation" + "check": "source-links", + "role": "link-target", + "suite": "source-index-closures" }, { - "check": "metadata-closure", + "check": "requires-closure", + "role": "canonical-module", + "suite": "standards-recovery-routing" + } + ] + }, + { + "digest": "sha256:813dfc2487ddc83e91e572fcd0e4a54ebaf79efe7fca7ec58defc765f888b294", + "path": "profiles/workflows/concurrent-plan-integration.md", + "state": "present", + "uses": [ + { + "check": "canonical-corpus", "role": "metadata", - "suite": "rust-binding-error-mapping" + "suite": "canonical-corpus-metadata" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-event-delivery" + "check": "local-links", + "role": "link-target", + "suite": "development-proportionality" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-executor-delegation" + "check": "routing-closure", + "role": "canonical-module", + "suite": "development-proportionality" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-runtime" + "check": "current-structure", + "role": "registered-policy-impact", + "suite": "policy-semantic-impact" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-boundary-arithmetic" + "check": "negative-fixtures", + "role": "canonical-policy-impact", + "suite": "policy-semantic-impact" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-dependency-candidate-inspection" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-dependency-owner-contract" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-external-input-queue" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-filesystem-authority" + "check": "root-router-routes", + "role": "link-target", + "suite": "root-index-closure" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-interop-memory" + "check": "router-links", + "role": "link-target", + "suite": "router-legacy-route-closure" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-listener-lifecycle" + "check": "local-links", + "role": "link-target", + "suite": "s1-routing" }, { - "check": "rust-profile-links", - "role": "markdown", - "suite": "rust-profile-authority-closure" + "check": "verifier-change-route-closure", + "role": "canonical-module", + "suite": "s1-routing" }, { - "check": "rust-profile-metadata", - "role": "metadata", - "suite": "rust-profile-authority-closure" - }, + "check": "requires-closure", + "role": "canonical-module", + "suite": "standards-recovery-routing" + } + ] + }, + { + "digest": "sha256:df535110fd7979b20ecb0aaa2ce0b09a40fbaec93d1c14bbdfc36c39cf02218a", + "path": "prompts/full-codebase-standards-refactor.md", + "state": "present", + "uses": [ { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-release-owner-contract" - }, + "check": "current-structure", + "role": "registered-policy-impact", + "suite": "policy-semantic-impact" + } + ] + }, + { + "digest": "sha256:576b3754ec46242f21964589ca89e5b4d10b5a73065f539c063d856f8423230b", + "path": "prompts/implement-plan.md", + "state": "present", + "uses": [ { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-security-panic-boundary" - }, + "check": "current-structure", + "role": "registered-policy-impact", + "suite": "policy-semantic-impact" + } + ] + }, + { + "digest": "sha256:14b1cce68635a1da2690c18f87411c604e0fb0cbebd2d1fd9f58e0e310ff8246", + "path": "prompts/planning.md", + "state": "present", + "uses": [ { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-tooling-owner-contract" - }, + "check": "current-structure", + "role": "registered-policy-impact", + "suite": "policy-semantic-impact" + } + ] + }, + { + "digest": "sha256:a8c99c51686929c288f4be92e948a653e987183be628faa6c1c69dcaf3664130", + "path": "reference/patterns/architecture.md", + "state": "present", + "uses": [ { - "check": "metadata-closure", + "check": "canonical-corpus", "role": "metadata", - "suite": "rust-unsafe-contracts" + "suite": "canonical-corpus-metadata" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-wire-representation" + "check": "architecture-contract-authority-destinations", + "role": "target", + "suite": "contract-ownership" }, { - "check": "local-links", - "role": "link-target", - "suite": "s1-routing" + "check": "routing-closure", + "role": "canonical-module", + "suite": "development-proportionality" }, { - "check": "local-links", - "role": "markdown", - "suite": "s1-routing" + "check": "current-structure", + "role": "registered-policy-impact", + "suite": "policy-semantic-impact" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "s1-routing" + "check": "negative-fixtures", + "role": "canonical-policy-impact", + "suite": "policy-semantic-impact" }, { "check": "verifier-change-route-closure", @@ -4472,14 +4520,14 @@ ] }, { - "digest": "sha256:ac03ecf806d8d2c64bc45f94642b9ea9256c37d33c94b754ec61e8cda2cb966b", - "path": "profiles/languages/rust/api.md", + "digest": "sha256:fe801646da0b337d04627df3aa04ddaaa01d2b88214f05e8a361cc59d86a37f9", + "path": "reference/recipes/accessibility.md", "state": "present", "uses": [ { - "check": "local-links", - "role": "link-target", - "suite": "development-proportionality" + "check": "canonical-corpus", + "role": "metadata", + "suite": "canonical-corpus-metadata" }, { "check": "routing-closure", @@ -4496,41 +4544,6 @@ "role": "canonical-policy-impact", "suite": "policy-semantic-impact" }, - { - "check": "root-router-routes", - "role": "link-target", - "suite": "root-index-closure" - }, - { - "check": "router-links", - "role": "link-target", - "suite": "router-legacy-route-closure" - }, - { - "check": "metadata", - "role": "metadata", - "suite": "rust-api-owner-contract" - }, - { - "check": "source-index-destinations", - "role": "target", - "suite": "rust-api-rustdoc" - }, - { - "check": "source-index-destinations", - "role": "target", - "suite": "rust-dependency-build-cost" - }, - { - "check": "rust-profile-links", - "role": "link-target", - "suite": "rust-profile-authority-closure" - }, - { - "check": "local-links", - "role": "link-target", - "suite": "s1-routing" - }, { "check": "verifier-change-route-closure", "role": "canonical-module", @@ -4544,19 +4557,14 @@ ] }, { - "digest": "sha256:dab13f7a7d75b950431392c93cdd43b14546f5d83e0768f108f0c6ca881d16fc", - "path": "profiles/languages/rust/async.md", + "digest": "sha256:9c687d7381a795c2dcf5f1b6ee8cf511ca6d71f2d45401e7fb491ead3cde56b0", + "path": "reference/recipes/commits.md", "state": "present", "uses": [ { - "check": "rust-binding-contract-authority-destinations", - "role": "target", - "suite": "contract-ownership" - }, - { - "check": "local-links", - "role": "link-target", - "suite": "development-proportionality" + "check": "canonical-corpus", + "role": "metadata", + "suite": "canonical-corpus-metadata" }, { "check": "routing-closure", @@ -4574,69 +4582,98 @@ "suite": "policy-semantic-impact" }, { - "check": "root-router-routes", + "check": "verifier-change-route-closure", + "role": "canonical-module", + "suite": "s1-routing" + }, + { + "check": "commit-routes", "role": "link-target", - "suite": "root-index-closure" + "suite": "source-index-closures" }, { - "check": "root-router-routes", + "check": "commit-routes", "role": "member-content", - "suite": "root-index-closure" + "suite": "source-index-closures" }, { - "check": "router-links", + "check": "source-links", "role": "link-target", - "suite": "router-legacy-route-closure" + "suite": "source-index-closures" }, { - "check": "metadata-closure", + "check": "requires-closure", + "role": "canonical-module", + "suite": "standards-recovery-routing" + } + ] + }, + { + "digest": "sha256:ad3c747d1b70fc03d29d1563930ae49c25bd9e169ef9865e63c1eba111b4ba6e", + "path": "reference/recipes/diagnostics.md", + "state": "present", + "uses": [ + { + "check": "canonical-corpus", "role": "metadata", - "suite": "rust-async-blocking-mutex" + "suite": "canonical-corpus-metadata" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-async-boundary" + "check": "architecture-contract-authority-destinations", + "role": "target", + "suite": "contract-ownership" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-async-cancellation-observability" + "check": "routing-closure", + "role": "canonical-module", + "suite": "development-proportionality" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-async-lifecycle" + "check": "current-structure", + "role": "registered-policy-impact", + "suite": "policy-semantic-impact" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-callback-task" + "check": "negative-fixtures", + "role": "canonical-policy-impact", + "suite": "policy-semantic-impact" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-executor-delegation" + "check": "verifier-change-route-closure", + "role": "canonical-module", + "suite": "s1-routing" }, { - "check": "metadata-closure", + "check": "requires-closure", + "role": "canonical-module", + "suite": "standards-recovery-routing" + } + ] + }, + { + "digest": "sha256:002a6bc7b5732642e4ed0d22bd60fb0a1fa91b57f6925e5cf0cf0ebda006ce57", + "path": "reference/recipes/documentation.md", + "state": "present", + "uses": [ + { + "check": "canonical-corpus", "role": "metadata", - "suite": "rust-binding-runtime" + "suite": "canonical-corpus-metadata" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-listener-lifecycle" + "check": "routing-closure", + "role": "canonical-module", + "suite": "development-proportionality" }, { - "check": "rust-profile-links", - "role": "link-target", - "suite": "rust-profile-authority-closure" + "check": "current-structure", + "role": "registered-policy-impact", + "suite": "policy-semantic-impact" }, { - "check": "local-links", - "role": "link-target", - "suite": "s1-routing" + "check": "negative-fixtures", + "role": "canonical-policy-impact", + "suite": "policy-semantic-impact" }, { "check": "verifier-change-route-closure", @@ -4644,12 +4681,12 @@ "suite": "s1-routing" }, { - "check": "concurrency-routes", + "check": "documentation-routes", "role": "link-target", "suite": "source-index-closures" }, { - "check": "concurrency-routes", + "check": "documentation-routes", "role": "member-content", "suite": "source-index-closures" }, @@ -4662,18 +4699,38 @@ "check": "requires-closure", "role": "canonical-module", "suite": "standards-recovery-routing" + }, + { + "check": "former-source-destinations", + "role": "target", + "suite": "tooling-ci-workflow-reference" + }, + { + "check": "former-source-destinations", + "role": "target", + "suite": "tooling-reference-recipes" + }, + { + "check": "tooling-route-and-legacy-removal-destinations", + "role": "target", + "suite": "verification-ownership" } ] }, { - "digest": "sha256:3c0e6d192dd9789b0919c18afd943c6073a4b1150b08cd5a42dca6e32c7a3476", - "path": "profiles/languages/rust/binding-lifecycle.md", + "digest": "sha256:f9cf565f427661cca05bd3281db600472498c35e0667904a68868d5603e6f46d", + "path": "reference/recipes/frontend.md", "state": "present", "uses": [ { - "check": "local-links", - "role": "link-target", - "suite": "development-proportionality" + "check": "canonical-corpus", + "role": "metadata", + "suite": "canonical-corpus-metadata" + }, + { + "check": "architecture-contract-authority-destinations", + "role": "target", + "suite": "contract-ownership" }, { "check": "routing-closure", @@ -4691,64 +4748,61 @@ "suite": "policy-semantic-impact" }, { - "check": "root-router-routes", - "role": "link-target", - "suite": "root-index-closure" + "check": "verifier-change-route-closure", + "role": "canonical-module", + "suite": "s1-routing" }, { - "check": "router-links", + "check": "frontend-routes", "role": "link-target", - "suite": "router-legacy-route-closure" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-architecture" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-callback-task" + "suite": "source-index-closures" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-conversions" + "check": "frontend-routes", + "role": "member-content", + "suite": "source-index-closures" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-enum-representation" + "check": "source-links", + "role": "link-target", + "suite": "source-index-closures" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-error-mapping" - }, + "check": "requires-closure", + "role": "canonical-module", + "suite": "standards-recovery-routing" + } + ] + }, + { + "digest": "sha256:22703818103908f3738726a04fc96e9b851a9749049b3f661e25440abf3d22f4", + "path": "reference/recipes/http.md", + "state": "present", + "uses": [ { - "check": "metadata-closure", + "check": "canonical-corpus", "role": "metadata", - "suite": "rust-binding-event-delivery" + "suite": "canonical-corpus-metadata" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-executor-delegation" + "check": "architecture-contract-authority-destinations", + "role": "target", + "suite": "contract-ownership" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-runtime" + "check": "routing-closure", + "role": "canonical-module", + "suite": "development-proportionality" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-wire-representation" + "check": "current-structure", + "role": "registered-policy-impact", + "suite": "policy-semantic-impact" }, { - "check": "local-links", - "role": "link-target", - "suite": "s1-routing" + "check": "negative-fixtures", + "role": "canonical-policy-impact", + "suite": "policy-semantic-impact" }, { "check": "verifier-change-route-closure", @@ -4763,19 +4817,14 @@ ] }, { - "digest": "sha256:1b30a6385f91af4d3b4a3e33eb72fb9b067339f5237f44297817fa3bec55998d", - "path": "profiles/languages/rust/cross-platform.md", + "digest": "sha256:adbecd045ceb28bb9cc9f4ce4582c1f3551b6d69f1523f632b459f2d3b3d3ca1", + "path": "reference/recipes/implementation.md", "state": "present", "uses": [ { - "check": "rust-binding-contract-authority-destinations", - "role": "target", - "suite": "contract-ownership" - }, - { - "check": "local-links", - "role": "link-target", - "suite": "development-proportionality" + "check": "canonical-corpus", + "role": "metadata", + "suite": "canonical-corpus-metadata" }, { "check": "routing-closure", @@ -4793,34 +4842,61 @@ "suite": "policy-semantic-impact" }, { - "check": "root-router-routes", - "role": "link-target", - "suite": "root-index-closure" + "check": "verifier-change-route-closure", + "role": "canonical-module", + "suite": "s1-routing" }, { - "check": "root-router-routes", - "role": "member-content", - "suite": "root-index-closure" + "check": "requires-closure", + "role": "canonical-module", + "suite": "standards-recovery-routing" }, { - "check": "router-links", - "role": "link-target", - "suite": "router-legacy-route-closure" + "check": "former-source-destinations", + "role": "target", + "suite": "tooling-ci-workflow-reference" }, { - "check": "rust-profile-links", - "role": "link-target", - "suite": "rust-profile-authority-closure" + "check": "former-source-destinations", + "role": "target", + "suite": "tooling-reference-recipes" }, { - "check": "exact-migration-index-destinations", + "check": "tooling-route-and-legacy-removal-destinations", "role": "target", - "suite": "rust-target-configuration" + "suite": "verification-ownership" + } + ] + }, + { + "digest": "sha256:14dcc68c9dd307cd2ac5b380c4de6daa60421e255f54cc23d55f73a0b6f074c6", + "path": "reference/recipes/persistence.md", + "state": "present", + "uses": [ + { + "check": "canonical-corpus", + "role": "metadata", + "suite": "canonical-corpus-metadata" }, { - "check": "local-links", - "role": "link-target", - "suite": "s1-routing" + "check": "architecture-contract-authority-destinations", + "role": "target", + "suite": "contract-ownership" + }, + { + "check": "routing-closure", + "role": "canonical-module", + "suite": "development-proportionality" + }, + { + "check": "current-structure", + "role": "registered-policy-impact", + "suite": "policy-semantic-impact" + }, + { + "check": "negative-fixtures", + "role": "canonical-policy-impact", + "suite": "policy-semantic-impact" }, { "check": "verifier-change-route-closure", @@ -4835,14 +4911,24 @@ ] }, { - "digest": "sha256:a94b2b6b549009b3ffca0176230594e8258dae4bfa0fed58397fd85a37cc734b", - "path": "profiles/languages/rust/dependencies.md", + "digest": "sha256:55a721945a6e1e89b0df70cdf9bf149e4c4b288539587fcaa3f2c2ed3d722b77", + "path": "reference/recipes/releases.md", "state": "present", "uses": [ { - "check": "local-links", - "role": "link-target", - "suite": "development-proportionality" + "check": "canonical-corpus", + "role": "metadata", + "suite": "canonical-corpus-metadata" + }, + { + "check": "release-entrypoint-destinations", + "role": "target", + "suite": "contract-ownership" + }, + { + "check": "release-workflow-route-destinations", + "role": "target", + "suite": "contract-ownership" }, { "check": "routing-closure", @@ -4860,54 +4946,61 @@ "suite": "policy-semantic-impact" }, { - "check": "root-router-routes", - "role": "link-target", - "suite": "root-index-closure" + "check": "legacy-index-destinations", + "role": "target", + "suite": "release-reference-closure" }, { - "check": "root-router-routes", - "role": "member-content", - "suite": "root-index-closure" + "check": "verifier-change-route-closure", + "role": "canonical-module", + "suite": "s1-routing" }, { - "check": "router-links", - "role": "link-target", - "suite": "router-legacy-route-closure" + "check": "requires-closure", + "role": "canonical-module", + "suite": "standards-recovery-routing" }, { - "check": "source-index-destinations", + "check": "release-route-destinations", "role": "target", - "suite": "rust-dependency-build-cost" + "suite": "verification-ownership" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-dependency-candidate-inspection" - }, + "check": "release-workflow-boundary-destinations", + "role": "target", + "suite": "verification-ownership" + } + ] + }, + { + "digest": "sha256:3101a6f55ea6b8ed6ec6a57bade9c292f9cf16886b0cfca350b10e2430d8faab", + "path": "reference/recipes/rust-dependencies.md", + "state": "present", + "uses": [ { - "check": "metadata-closure", + "check": "canonical-corpus", "role": "metadata", - "suite": "rust-dependency-owner-contract" + "suite": "canonical-corpus-metadata" }, { - "check": "rust-profile-links", - "role": "link-target", - "suite": "rust-profile-authority-closure" + "check": "routing-closure", + "role": "canonical-module", + "suite": "development-proportionality" }, { - "check": "source-index-destinations", - "role": "target", - "suite": "rust-release-evidence" + "check": "current-structure", + "role": "registered-policy-impact", + "suite": "policy-semantic-impact" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-release-owner-contract" + "check": "negative-fixtures", + "role": "canonical-policy-impact", + "suite": "policy-semantic-impact" }, { - "check": "local-links", - "role": "link-target", - "suite": "s1-routing" + "check": "source-index-destinations", + "role": "target", + "suite": "rust-dependency-build-cost" }, { "check": "verifier-change-route-closure", @@ -4922,19 +5015,14 @@ ] }, { - "digest": "sha256:fecc60fddd0d93706adc49055a4aa93183b7a7bda5d05ee975a11acb4e54abd9", - "path": "profiles/languages/rust/interop.md", + "digest": "sha256:7fe2daa727bddfea1e708124606dfd4f299223fc30bf541f2cf669625fc62d01", + "path": "reference/recipes/rust-release.md", "state": "present", "uses": [ { - "check": "rust-binding-contract-authority-destinations", - "role": "target", - "suite": "contract-ownership" - }, - { - "check": "local-links", - "role": "link-target", - "suite": "development-proportionality" + "check": "canonical-corpus", + "role": "metadata", + "suite": "canonical-corpus-metadata" }, { "check": "routing-closure", @@ -4952,29 +5040,9 @@ "suite": "policy-semantic-impact" }, { - "check": "root-router-routes", - "role": "link-target", - "suite": "root-index-closure" - }, - { - "check": "router-links", - "role": "link-target", - "suite": "router-legacy-route-closure" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-interop-memory" - }, - { - "check": "rust-profile-links", - "role": "link-target", - "suite": "rust-profile-authority-closure" - }, - { - "check": "local-links", - "role": "link-target", - "suite": "s1-routing" + "check": "source-index-destinations", + "role": "target", + "suite": "rust-release-evidence" }, { "check": "verifier-change-route-closure", @@ -4989,19 +5057,14 @@ ] }, { - "digest": "sha256:91c26196e5a976dcf20759cc6d787605dc327a0704d08929cce05b71acadf1b9", - "path": "profiles/languages/rust/language-bindings.md", + "digest": "sha256:cf85a48e0e2e346ef6445e89d6a14adcf17b55dc8818661e13a1cca44f3c1d50", + "path": "reference/recipes/rust-tooling.md", "state": "present", "uses": [ { - "check": "rust-binding-contract-authority-destinations", - "role": "target", - "suite": "contract-ownership" - }, - { - "check": "local-links", - "role": "link-target", - "suite": "development-proportionality" + "check": "canonical-corpus", + "role": "metadata", + "suite": "canonical-corpus-metadata" }, { "check": "routing-closure", @@ -5018,71 +5081,6 @@ "role": "canonical-policy-impact", "suite": "policy-semantic-impact" }, - { - "check": "root-router-routes", - "role": "link-target", - "suite": "root-index-closure" - }, - { - "check": "router-links", - "role": "link-target", - "suite": "router-legacy-route-closure" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-architecture" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-callback-task" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-conversions" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-enum-representation" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-error-mapping" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-event-delivery" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-executor-delegation" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-runtime" - }, - { - "check": "rust-profile-links", - "role": "link-target", - "suite": "rust-profile-authority-closure" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-wire-representation" - }, - { - "check": "local-links", - "role": "link-target", - "suite": "s1-routing" - }, { "check": "verifier-change-route-closure", "role": "canonical-module", @@ -5096,14 +5094,14 @@ ] }, { - "digest": "sha256:83046b90ebebd76de9db7838150c5533853d748d063ff342cfa90c1fa9b4e9a0", - "path": "profiles/languages/rust/release.md", + "digest": "sha256:2e5e78f40c0c4863a6a9f473044b952d516df463027cd6a7c0cf0e944dd6ece1", + "path": "reference/recipes/tooling.md", "state": "present", "uses": [ { - "check": "local-links", - "role": "link-target", - "suite": "development-proportionality" + "check": "canonical-corpus", + "role": "metadata", + "suite": "canonical-corpus-metadata" }, { "check": "routing-closure", @@ -5121,61 +5119,66 @@ "suite": "policy-semantic-impact" }, { - "check": "root-router-routes", + "check": "verifier-change-route-closure", + "role": "canonical-module", + "suite": "s1-routing" + }, + { + "check": "frontend-routes", "role": "link-target", - "suite": "root-index-closure" + "suite": "source-index-closures" }, { - "check": "root-router-routes", + "check": "frontend-routes", "role": "member-content", - "suite": "root-index-closure" + "suite": "source-index-closures" }, { - "check": "router-links", + "check": "source-links", "role": "link-target", - "suite": "router-legacy-route-closure" + "suite": "source-index-closures" }, { - "check": "rust-profile-links", - "role": "link-target", - "suite": "rust-profile-authority-closure" + "check": "requires-closure", + "role": "canonical-module", + "suite": "standards-recovery-routing" }, { - "check": "source-index-destinations", + "check": "former-source-destinations", "role": "target", - "suite": "rust-release-evidence" + "suite": "tooling-ci-workflow-reference" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-release-owner-contract" + "check": "reference-destinations", + "role": "markdown", + "suite": "tooling-ci-workflow-reference" }, { - "check": "local-links", - "role": "link-target", - "suite": "s1-routing" + "check": "former-source-destinations", + "role": "target", + "suite": "tooling-reference-recipes" }, { - "check": "verifier-change-route-closure", - "role": "canonical-module", - "suite": "s1-routing" + "check": "reference-destinations", + "role": "markdown", + "suite": "tooling-reference-recipes" }, { - "check": "requires-closure", - "role": "canonical-module", - "suite": "standards-recovery-routing" + "check": "tooling-route-and-legacy-removal-destinations", + "role": "target", + "suite": "verification-ownership" } ] }, { - "digest": "sha256:b2dd9fbdce8496cad999c6963f13992e0384d6a4bd2d4bd1e971153e07f6257e", - "path": "profiles/languages/rust/security.md", + "digest": "sha256:251dd2badf1cad7fdf22458c0475204e25b7fe2655eb910e6a75b12f2bbb7d4c", + "path": "reference/routing/bounded-rust-repair.md", "state": "present", "uses": [ { - "check": "local-links", - "role": "link-target", - "suite": "development-proportionality" + "check": "canonical-corpus", + "role": "metadata", + "suite": "canonical-corpus-metadata" }, { "check": "routing-closure", @@ -5192,71 +5195,11 @@ "role": "canonical-policy-impact", "suite": "policy-semantic-impact" }, - { - "check": "root-router-routes", - "role": "link-target", - "suite": "root-index-closure" - }, - { - "check": "router-links", - "role": "link-target", - "suite": "router-legacy-route-closure" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-boundary-arithmetic" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-external-input-queue" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-filesystem-authority" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-listener-lifecycle" - }, - { - "check": "rust-profile-links", - "role": "link-target", - "suite": "rust-profile-authority-closure" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-security-panic-boundary" - }, - { - "check": "local-links", - "role": "link-target", - "suite": "s1-routing" - }, { "check": "verifier-change-route-closure", "role": "canonical-module", "suite": "s1-routing" }, - { - "check": "concurrency-routes", - "role": "link-target", - "suite": "source-index-closures" - }, - { - "check": "concurrency-routes", - "role": "member-content", - "suite": "source-index-closures" - }, - { - "check": "source-links", - "role": "link-target", - "suite": "source-index-closures" - }, { "check": "requires-closure", "role": "canonical-module", @@ -5265,8 +5208,8 @@ ] }, { - "digest": "sha256:2b28ef71141b860f0497f8379701027e4e1aaa9aabb40720e875725933d33652", - "path": "profiles/languages/rust/tooling.md", + "digest": "sha256:c12c0365bb558c8ef973647fc74af9678cd1c35f54d17b104afdd3ed373f4f50", + "path": "templates/PLAN-TEMPLATE.md", "state": "present", "uses": [ { @@ -5274,406 +5217,323 @@ "role": "link-target", "suite": "development-proportionality" }, - { - "check": "routing-closure", - "role": "canonical-module", - "suite": "development-proportionality" - }, { "check": "current-structure", "role": "registered-policy-impact", "suite": "policy-semantic-impact" }, { - "check": "negative-fixtures", - "role": "canonical-policy-impact", - "suite": "policy-semantic-impact" + "check": "root-links", + "role": "link-target", + "suite": "root-index-closure" }, { - "check": "root-router-routes", + "check": "planning-routes", "role": "link-target", - "suite": "root-index-closure" + "suite": "source-index-closures" }, { - "check": "root-router-routes", + "check": "planning-routes", "role": "member-content", - "suite": "root-index-closure" + "suite": "source-index-closures" }, { - "check": "router-links", + "check": "source-links", "role": "link-target", - "suite": "router-legacy-route-closure" - }, + "suite": "source-index-closures" + } + ] + }, + { + "digest": "sha256:c0f3b1d8fbbd8744a3b5d9d9bdb4c11ac747a6824ab97d4c36d6171c8ed85237", + "path": "templates/PULL_REQUEST_TEMPLATE.md", + "state": "present", + "uses": [ { - "check": "rust-profile-links", + "check": "root-links", "role": "link-target", - "suite": "rust-profile-authority-closure" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-tooling-owner-contract" - }, + "suite": "root-index-closure" + } + ] + }, + { + "digest": "sha256:7d26a2fed9d192c5595a8e4ffab8258be13f03def2e509e6d56c74db28c03b8a", + "path": "templates/README-TEMPLATE.md", + "state": "present", + "uses": [ { - "check": "local-links", + "check": "root-links", "role": "link-target", - "suite": "s1-routing" - }, + "suite": "root-index-closure" + } + ] + }, + { + "digest": "sha256:4a367fa39ae9c8ecbc92caedde00c6c107b9edf00a022cfd864d081a46e36ef2", + "path": "tools/decision_traceability/decision_traceability/__init__.py", + "state": "present", + "uses": [ { - "check": "verifier-change-route-closure", - "role": "canonical-module", - "suite": "s1-routing" - }, + "check": "python-package-contract", + "role": "package-contract-input", + "suite": "a1c-public-cutover" + } + ] + }, + { + "digest": "sha256:5228ba55c16e54a8a367b2104d860b74829a464235fa2b6dd02be21c0d5bd7c7", + "path": "tools/decision_traceability/decision_traceability/check.py", + "state": "present", + "uses": [ { - "check": "requires-closure", - "role": "canonical-module", - "suite": "standards-recovery-routing" + "check": "python-package-contract", + "role": "package-contract-input", + "suite": "a1c-public-cutover" } ] }, { - "digest": "sha256:2093d5d2945dcc8423802e56df0a6651036167d35edf23e663b8725d7b94f25c", - "path": "profiles/languages/rust/unsafe.md", + "digest": "sha256:aa7f8222a952ea4a90e6a6a8e9834b64cc9c2b0ba68c3c5ce3dbc5f838601f79", + "path": "tools/decision_traceability/pyproject.toml", "state": "present", "uses": [ { - "check": "local-links", - "role": "link-target", - "suite": "development-proportionality" - }, + "check": "python-package-contract", + "role": "package-contract-input", + "suite": "a1c-public-cutover" + } + ] + }, + { + "digest": "sha256:76b3c632590acfc922c47a6915442e1797c10b3b8608b8496f50fff8986fec85", + "path": "tools/decision_traceability/verify_contract.py", + "state": "present", + "uses": [ { - "check": "routing-closure", - "role": "canonical-module", - "suite": "development-proportionality" + "check": "python-package-contract", + "role": "package-contract-input", + "suite": "a1c-public-cutover" + } + ] + }, + { + "digest": "sha256:725648aa5f54c4a6f3177f361077f86526f26da87e51a63127f2da15ebc34cb1", + "path": "tools/graph_engine/graph_engine/__init__.py", + "state": "present", + "uses": [ + { + "check": "python-package-contract", + "role": "package-contract-input", + "suite": "a1c-public-cutover" }, { "check": "current-structure", "role": "registered-policy-impact", "suite": "policy-semantic-impact" - }, - { - "check": "negative-fixtures", - "role": "canonical-policy-impact", - "suite": "policy-semantic-impact" - }, - { - "check": "root-router-routes", - "role": "link-target", - "suite": "root-index-closure" - }, + } + ] + }, + { + "digest": "sha256:641acd59e88d4d0d9c85c384d2cb84b5b3b3295b3dd77a41f9284629249e2a8b", + "path": "tools/graph_engine/graph_engine/cli.py", + "state": "present", + "uses": [ { - "check": "router-links", - "role": "link-target", - "suite": "router-legacy-route-closure" - }, + "check": "python-package-contract", + "role": "package-contract-input", + "suite": "a1c-public-cutover" + } + ] + }, + { + "digest": "sha256:464ba32cd9752a2804cdcdf84532043c68fb752f45783c2df00bb5adb9fdcf1b", + "path": "tools/graph_engine/graph_engine/errors.py", + "state": "present", + "uses": [ { - "check": "source-index-destinations", - "role": "target", - "suite": "rust-api-rustdoc" - }, + "check": "python-package-contract", + "role": "package-contract-input", + "suite": "a1c-public-cutover" + } + ] + }, + { + "digest": "sha256:7ca7644dfd97313580e2ff8075ccdfe13dd4753075585997aced461bdbfccd1e", + "path": "tools/graph_engine/graph_engine/manifest.py", + "state": "present", + "uses": [ { - "check": "rust-profile-links", - "role": "link-target", - "suite": "rust-profile-authority-closure" - }, + "check": "python-package-contract", + "role": "package-contract-input", + "suite": "a1c-public-cutover" + } + ] + }, + { + "digest": "sha256:cbbf89a7cd22a0c990867c86ae36539f9c6a387c64bc10f0c02c5e1b5df2ce33", + "path": "tools/graph_engine/graph_engine/model.py", + "state": "present", + "uses": [ { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-unsafe-contracts" - }, + "check": "python-package-contract", + "role": "package-contract-input", + "suite": "a1c-public-cutover" + } + ] + }, + { + "digest": "sha256:7b5fbe0233db2cd906ddf4b74a1f2df833436497a51d7248bff7bbbe34ab9a48", + "path": "tools/graph_engine/graph_engine/paths.py", + "state": "present", + "uses": [ { - "check": "local-links", - "role": "link-target", - "suite": "s1-routing" - }, + "check": "python-package-contract", + "role": "package-contract-input", + "suite": "a1c-public-cutover" + } + ] + }, + { + "digest": "sha256:393b0e26ccd9c7a734d610a0f4dc418657a72fce662b3efe24e6207b565490af", + "path": "tools/graph_engine/graph_engine/projection.py", + "state": "present", + "uses": [ { - "check": "verifier-change-route-closure", - "role": "canonical-module", - "suite": "s1-routing" + "check": "python-package-contract", + "role": "package-contract-input", + "suite": "a1c-public-cutover" }, { - "check": "requires-closure", - "role": "canonical-module", - "suite": "standards-recovery-routing" + "check": "current-structure", + "role": "registered-policy-impact", + "suite": "policy-semantic-impact" } ] }, { - "digest": "sha256:b40eef63e3fe3fd066827cf3d1ac86a5402e8bdf27c54dea7ff1912a4cfd496e", - "path": "profiles/languages/typescript.md", + "digest": "sha256:7e056a801f17a8eda311db9a66f6de62a77916bd21db24401cef7780b2200d39", + "path": "tools/graph_engine/graph_engine/registry.py", "state": "present", "uses": [ { - "check": "coding-route-destinations", - "role": "target", - "suite": "contract-ownership" - }, - { - "check": "local-links", - "role": "link-target", - "suite": "development-proportionality" + "check": "python-package-contract", + "role": "package-contract-input", + "suite": "a1c-public-cutover" }, { - "check": "routing-closure", - "role": "canonical-module", - "suite": "development-proportionality" - }, + "check": "current-structure", + "role": "registered-policy-impact", + "suite": "policy-semantic-impact" + } + ] + }, + { + "digest": "sha256:2e7a61bdaced2f58a49c9dcbb3428c99c7c668538fa22dee0828efcff1c2a345", + "path": "tools/graph_engine/pyproject.toml", + "state": "present", + "uses": [ { - "check": "metadata-closure", - "role": "metadata", - "suite": "frontend-rendering-synchronization" + "check": "python-package-contract", + "role": "package-contract-input", + "suite": "a1c-public-cutover" }, { "check": "current-structure", "role": "registered-policy-impact", "suite": "policy-semantic-impact" + } + ] + }, + { + "digest": "sha256:17c9f57fee617eeac07d46ee0eabd7d7424b473b1b42f9fb330f5966de67c8bb", + "path": "tools/query_edges.py", + "state": "present", + "uses": [ + { + "check": "python-package-contract", + "role": "package-contract-input", + "suite": "a1c-public-cutover" }, { - "check": "negative-fixtures", - "role": "canonical-policy-impact", + "check": "current-structure", + "role": "registered-policy-impact", "suite": "policy-semantic-impact" - }, + } + ] + }, + { + "digest": "sha256:a0a7203e10b21fcbe220b61e524f2bcb05569c2923090b280bd170c9fb42b1fb", + "path": "tools/repository_git/pyproject.toml", + "state": "present", + "uses": [ { - "check": "root-router-routes", - "role": "link-target", - "suite": "root-index-closure" + "check": "python-package-contract", + "role": "package-contract-input", + "suite": "a1c-public-cutover" }, { - "check": "root-router-routes", - "role": "member-content", - "suite": "root-index-closure" - }, - { - "check": "router-links", - "role": "link-target", - "suite": "router-legacy-route-closure" - }, - { - "check": "local-links", - "role": "link-target", - "suite": "s1-routing" - }, - { - "check": "verifier-change-route-closure", - "role": "canonical-module", - "suite": "s1-routing" - }, - { - "check": "coding-routes", - "role": "link-target", - "suite": "source-index-closures" - }, - { - "check": "coding-routes", - "role": "member-content", - "suite": "source-index-closures" - }, - { - "check": "frontend-routes", - "role": "link-target", - "suite": "source-index-closures" - }, - { - "check": "frontend-routes", - "role": "member-content", - "suite": "source-index-closures" - }, - { - "check": "source-links", - "role": "link-target", - "suite": "source-index-closures" - }, - { - "check": "requires-closure", - "role": "canonical-module", - "suite": "standards-recovery-routing" - }, - { - "check": "former-source-destinations", - "role": "target", - "suite": "tooling-ci-workflow-reference" - }, - { - "check": "reference-destinations", - "role": "target", - "suite": "tooling-ci-workflow-reference" - }, - { - "check": "former-source-destinations", - "role": "target", - "suite": "tooling-reference-recipes" - }, - { - "check": "reference-destinations", - "role": "target", - "suite": "tooling-reference-recipes" - }, - { - "check": "tooling-route-and-legacy-removal-destinations", - "role": "target", - "suite": "verification-ownership" + "check": "current-structure", + "role": "registered-policy-impact", + "suite": "policy-semantic-impact" } ] }, { - "digest": "sha256:8f7c6995b6d11fb2a2459cb42742f11dd5ce156dfb4a6afa00eab3b1280add2d", - "path": "profiles/languages/typescript/async.md", + "digest": "sha256:c0c8001952d1f914f263e243193a56c97fd4600d51a5c0a4157133ffece83562", + "path": "tools/repository_git/repository_git/__init__.py", "state": "present", "uses": [ { - "check": "coding-route-destinations", - "role": "target", - "suite": "contract-ownership" - }, - { - "check": "local-links", - "role": "link-target", - "suite": "development-proportionality" - }, - { - "check": "routing-closure", - "role": "canonical-module", - "suite": "development-proportionality" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "frontend-rendering-synchronization" + "check": "python-package-contract", + "role": "package-contract-input", + "suite": "a1c-public-cutover" }, { "check": "current-structure", "role": "registered-policy-impact", "suite": "policy-semantic-impact" - }, - { - "check": "negative-fixtures", - "role": "canonical-policy-impact", - "suite": "policy-semantic-impact" - }, - { - "check": "root-router-routes", - "role": "link-target", - "suite": "root-index-closure" - }, - { - "check": "root-router-routes", - "role": "member-content", - "suite": "root-index-closure" - }, - { - "check": "router-links", - "role": "link-target", - "suite": "router-legacy-route-closure" - }, - { - "check": "local-links", - "role": "link-target", - "suite": "s1-routing" - }, - { - "check": "verifier-change-route-closure", - "role": "canonical-module", - "suite": "s1-routing" - }, - { - "check": "coding-routes", - "role": "link-target", - "suite": "source-index-closures" - }, - { - "check": "coding-routes", - "role": "member-content", - "suite": "source-index-closures" - }, - { - "check": "concurrency-routes", - "role": "link-target", - "suite": "source-index-closures" - }, - { - "check": "concurrency-routes", - "role": "member-content", - "suite": "source-index-closures" - }, - { - "check": "frontend-routes", - "role": "link-target", - "suite": "source-index-closures" - }, - { - "check": "frontend-routes", - "role": "member-content", - "suite": "source-index-closures" - }, - { - "check": "source-links", - "role": "link-target", - "suite": "source-index-closures" - }, - { - "check": "requires-closure", - "role": "canonical-module", - "suite": "standards-recovery-routing" } ] }, { - "digest": "sha256:813dfc2487ddc83e91e572fcd0e4a54ebaf79efe7fca7ec58defc765f888b294", - "path": "profiles/workflows/concurrent-plan-integration.md", + "digest": "sha256:45e07721da5c893ff0c4ebcbe34ed0e0e37386bdbdcc6a053aff8db5b52bf75b", + "path": "tools/repository_git/repository_git/batch.py", "state": "present", "uses": [ { - "check": "local-links", - "role": "link-target", - "suite": "development-proportionality" - }, + "check": "python-package-contract", + "role": "package-contract-input", + "suite": "a1c-public-cutover" + } + ] + }, + { + "digest": "sha256:690edf0e048ef3c63ee422aca2fdf1381cda6029e593adf5b96477b4d83e62fa", + "path": "tools/repository_git/repository_git/errors.py", + "state": "present", + "uses": [ { - "check": "routing-closure", - "role": "canonical-module", - "suite": "development-proportionality" + "check": "python-package-contract", + "role": "package-contract-input", + "suite": "a1c-public-cutover" }, { "check": "current-structure", "role": "registered-policy-impact", "suite": "policy-semantic-impact" - }, - { - "check": "negative-fixtures", - "role": "canonical-policy-impact", - "suite": "policy-semantic-impact" - }, - { - "check": "root-router-routes", - "role": "link-target", - "suite": "root-index-closure" - }, - { - "check": "router-links", - "role": "link-target", - "suite": "router-legacy-route-closure" - }, - { - "check": "local-links", - "role": "link-target", - "suite": "s1-routing" - }, - { - "check": "verifier-change-route-closure", - "role": "canonical-module", - "suite": "s1-routing" - }, - { - "check": "requires-closure", - "role": "canonical-module", - "suite": "standards-recovery-routing" } ] }, { - "digest": "sha256:df535110fd7979b20ecb0aaa2ce0b09a40fbaec93d1c14bbdfc36c39cf02218a", - "path": "prompts/full-codebase-standards-refactor.md", + "digest": "sha256:9705fdbfd512b38a62772028bd1ff5809a6af1038753ff3547a2c4c8b30ee4f7", + "path": "tools/repository_git/repository_git/model.py", "state": "present", "uses": [ + { + "check": "python-package-contract", + "role": "package-contract-input", + "suite": "a1c-public-cutover" + }, { "check": "current-structure", "role": "registered-policy-impact", @@ -5682,10 +5542,15 @@ ] }, { - "digest": "sha256:576b3754ec46242f21964589ca89e5b4d10b5a73065f539c063d856f8423230b", - "path": "prompts/implement-plan.md", + "digest": "sha256:f025feeb7e19758ab49aa6ab2b836c91cdd078f137baceedea86a7d46dba6c61", + "path": "tools/repository_git/repository_git/repository.py", "state": "present", "uses": [ + { + "check": "python-package-contract", + "role": "package-contract-input", + "suite": "a1c-public-cutover" + }, { "check": "current-structure", "role": "registered-policy-impact", @@ -5694,8 +5559,8 @@ ] }, { - "digest": "sha256:14b1cce68635a1da2690c18f87411c604e0fb0cbebd2d1fd9f58e0e310ff8246", - "path": "prompts/planning.md", + "digest": "sha256:46636d31a867331b7f900100421aed70fb39192589817b59d2a78230bd676891", + "path": "tools/repository_git/tests/test_repository.py", "state": "present", "uses": [ { @@ -5706,817 +5571,533 @@ ] }, { - "digest": "sha256:a8c99c51686929c288f4be92e948a653e987183be628faa6c1c69dcaf3664130", - "path": "reference/patterns/architecture.md", + "digest": "sha256:af0d55266eb9e970e0c7c4dd4dbdf9b2e1fe4aa12d4438144604788ceef1f523", + "path": "tools/review_evidence/pyproject.toml", "state": "present", "uses": [ { - "check": "metadata", - "role": "metadata", - "suite": "architecture-pattern-reference-owner" - }, - { - "check": "architecture-contract-authority-destinations", - "role": "target", - "suite": "contract-ownership" - }, - { - "check": "routing-closure", - "role": "canonical-module", - "suite": "development-proportionality" - }, - { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" - }, - { - "check": "negative-fixtures", - "role": "canonical-policy-impact", - "suite": "policy-semantic-impact" - }, + "check": "python-package-contract", + "role": "package-contract-input", + "suite": "a1c-public-cutover" + } + ] + }, + { + "digest": "sha256:3afb7f4bb258430837be03c1fd1448543ab811bcce805f8f7b4e1a1218f48c79", + "path": "tools/review_evidence/review_evidence/__init__.py", + "state": "present", + "uses": [ { - "check": "verifier-change-route-closure", - "role": "canonical-module", - "suite": "s1-routing" - }, + "check": "python-package-contract", + "role": "package-contract-input", + "suite": "a1c-public-cutover" + } + ] + }, + { + "digest": "sha256:307299fda7b77d22c64cb51430ec75e5f59d78e9c948786afb3b2544fe45e4b7", + "path": "tools/review_evidence/review_evidence/__main__.py", + "state": "present", + "uses": [ { - "check": "requires-closure", - "role": "canonical-module", - "suite": "standards-recovery-routing" + "check": "python-package-contract", + "role": "package-contract-input", + "suite": "a1c-public-cutover" } ] }, { - "digest": "sha256:fe801646da0b337d04627df3aa04ddaaa01d2b88214f05e8a361cc59d86a37f9", - "path": "reference/recipes/accessibility.md", + "digest": "sha256:d39c9fbaf00aacdb3c1d08b23d9b645fe72c98ac121bbd7143d2a7fe8bb0d250", + "path": "tools/review_evidence/review_evidence/cli.py", "state": "present", "uses": [ { - "check": "routing-closure", - "role": "canonical-module", - "suite": "development-proportionality" - }, + "check": "python-package-contract", + "role": "package-contract-input", + "suite": "a1c-public-cutover" + } + ] + }, + { + "digest": "sha256:2d84851dc497ecdae01eafcaf90aae12abda13a428eefa064517909af31711e2", + "path": "tools/review_evidence/review_evidence/common.py", + "state": "present", + "uses": [ { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" - }, + "check": "python-package-contract", + "role": "package-contract-input", + "suite": "a1c-public-cutover" + } + ] + }, + { + "digest": "sha256:62e5177be158a1d94304414bf4664739bd804cf5725e53e1d8178f004bba5a21", + "path": "tools/review_evidence/review_evidence/local_files.py", + "state": "present", + "uses": [ { - "check": "negative-fixtures", - "role": "canonical-policy-impact", - "suite": "policy-semantic-impact" - }, + "check": "python-package-contract", + "role": "package-contract-input", + "suite": "a1c-public-cutover" + } + ] + }, + { + "digest": "sha256:0b7cfc5e12238513ad89628a063fb993003b6a93cbda4d8204ec0a1e2bd83bb6", + "path": "tools/review_evidence/review_evidence/packet.py", + "state": "present", + "uses": [ { - "check": "verifier-change-route-closure", - "role": "canonical-module", - "suite": "s1-routing" - }, + "check": "python-package-contract", + "role": "package-contract-input", + "suite": "a1c-public-cutover" + } + ] + }, + { + "digest": "sha256:bf80886b99d6a065974b7a421a4924bd5228d696bf82b5e0a48d4e13ebb4eee9", + "path": "tools/review_evidence/review_evidence/request.py", + "state": "present", + "uses": [ { - "check": "requires-closure", - "role": "canonical-module", - "suite": "standards-recovery-routing" + "check": "python-package-contract", + "role": "package-contract-input", + "suite": "a1c-public-cutover" } ] }, { - "digest": "sha256:9c687d7381a795c2dcf5f1b6ee8cf511ca6d71f2d45401e7fb491ead3cde56b0", - "path": "reference/recipes/commits.md", + "digest": "sha256:c91ad773a879ed1c0b015dd1ff45c31f40e7a8dcf7100903db5bb98af8dc17ac", + "path": "tools/standards_analysis/pyproject.toml", "state": "present", "uses": [ { - "check": "routing-closure", - "role": "canonical-module", - "suite": "development-proportionality" + "check": "python-package-contract", + "role": "package-contract-input", + "suite": "a1c-public-cutover" }, { "check": "current-structure", "role": "registered-policy-impact", "suite": "policy-semantic-impact" - }, - { - "check": "negative-fixtures", - "role": "canonical-policy-impact", - "suite": "policy-semantic-impact" - }, - { - "check": "verifier-change-route-closure", - "role": "canonical-module", - "suite": "s1-routing" - }, - { - "check": "commit-routes", - "role": "link-target", - "suite": "source-index-closures" - }, - { - "check": "commit-routes", - "role": "member-content", - "suite": "source-index-closures" - }, + } + ] + }, + { + "digest": "sha256:b5c74d24adf157cf44ee2434cba94900c7f340a0de0b5085129a974cdf8800e8", + "path": "tools/standards_analysis/standards_analysis/__init__.py", + "state": "present", + "uses": [ { - "check": "source-links", - "role": "link-target", - "suite": "source-index-closures" + "check": "python-package-contract", + "role": "package-contract-input", + "suite": "a1c-public-cutover" }, { - "check": "requires-closure", - "role": "canonical-module", - "suite": "standards-recovery-routing" + "check": "current-structure", + "role": "registered-policy-impact", + "suite": "policy-semantic-impact" } ] }, { - "digest": "sha256:ad3c747d1b70fc03d29d1563930ae49c25bd9e169ef9865e63c1eba111b4ba6e", - "path": "reference/recipes/diagnostics.md", + "digest": "sha256:d2c0343eac19c20b3bff310325eb0f0f53dea91eb95cac2f893f7ba20c684220", + "path": "tools/standards_analysis/standards_analysis/changes.py", "state": "present", "uses": [ { - "check": "architecture-contract-authority-destinations", - "role": "target", - "suite": "contract-ownership" - }, + "check": "python-package-contract", + "role": "package-contract-input", + "suite": "a1c-public-cutover" + } + ] + }, + { + "digest": "sha256:0fdca28dadfc1f4b950d844348c7927326b33a8fb291995f45e7680842b88fa4", + "path": "tools/standards_analysis/standards_analysis/coverage.py", + "state": "present", + "uses": [ { - "check": "routing-closure", - "role": "canonical-module", - "suite": "development-proportionality" + "check": "python-package-contract", + "role": "package-contract-input", + "suite": "a1c-public-cutover" }, { "check": "current-structure", "role": "registered-policy-impact", "suite": "policy-semantic-impact" - }, - { - "check": "negative-fixtures", - "role": "canonical-policy-impact", - "suite": "policy-semantic-impact" - }, + } + ] + }, + { + "digest": "sha256:1fecafc49b9adb5516925398fdeec516e1c8cc6ae5240f7b67d329795fe50730", + "path": "tools/standards_analysis/standards_analysis/coverage_publication.py", + "state": "present", + "uses": [ { - "check": "verifier-change-route-closure", - "role": "canonical-module", - "suite": "s1-routing" + "check": "python-package-contract", + "role": "package-contract-input", + "suite": "a1c-public-cutover" }, { - "check": "requires-closure", - "role": "canonical-module", - "suite": "standards-recovery-routing" + "check": "current-structure", + "role": "registered-policy-impact", + "suite": "policy-semantic-impact" } ] }, { - "digest": "sha256:002a6bc7b5732642e4ed0d22bd60fb0a1fa91b57f6925e5cf0cf0ebda006ce57", - "path": "reference/recipes/documentation.md", + "digest": "sha256:2381dbb0d02c118196899213970ce61053e69b30a190ad830532e13fc5fa38ff", + "path": "tools/standards_analysis/standards_analysis/errors.py", "state": "present", "uses": [ { - "check": "routing-closure", - "role": "canonical-module", - "suite": "development-proportionality" - }, + "check": "python-package-contract", + "role": "package-contract-input", + "suite": "a1c-public-cutover" + } + ] + }, + { + "digest": "sha256:b7c9c93dba2080468d56a9f405fcadd9f7907ecce93876d40cf2a9d529737cf5", + "path": "tools/standards_analysis/standards_analysis/impact.py", + "state": "present", + "uses": [ { - "check": "metadata-closure", - "role": "metadata", - "suite": "documentation-reference" + "check": "python-package-contract", + "role": "package-contract-input", + "suite": "a1c-public-cutover" }, { "check": "current-structure", "role": "registered-policy-impact", "suite": "policy-semantic-impact" - }, + } + ] + }, + { + "digest": "sha256:5dd1ca9ce4eae8a75a16539fb6058d603bc72a83d21bd69324dea71deac793c9", + "path": "tools/standards_analysis/standards_analysis/kernel.py", + "state": "present", + "uses": [ { - "check": "negative-fixtures", - "role": "canonical-policy-impact", - "suite": "policy-semantic-impact" + "check": "python-package-contract", + "role": "package-contract-input", + "suite": "a1c-public-cutover" }, { - "check": "verifier-change-route-closure", - "role": "canonical-module", - "suite": "s1-routing" - }, - { - "check": "documentation-routes", - "role": "link-target", - "suite": "source-index-closures" - }, - { - "check": "documentation-routes", - "role": "member-content", - "suite": "source-index-closures" - }, - { - "check": "source-links", - "role": "link-target", - "suite": "source-index-closures" - }, - { - "check": "requires-closure", - "role": "canonical-module", - "suite": "standards-recovery-routing" - }, - { - "check": "former-source-destinations", - "role": "target", - "suite": "tooling-ci-workflow-reference" - }, - { - "check": "former-source-destinations", - "role": "target", - "suite": "tooling-reference-recipes" - }, - { - "check": "tooling-route-and-legacy-removal-destinations", - "role": "target", - "suite": "verification-ownership" + "check": "current-structure", + "role": "registered-policy-impact", + "suite": "policy-semantic-impact" } ] }, { - "digest": "sha256:f9cf565f427661cca05bd3281db600472498c35e0667904a68868d5603e6f46d", - "path": "reference/recipes/frontend.md", + "digest": "sha256:6849041b743c2c7b59010f511531c13963cb8bca5045a1dfc855cdb991d32d08", + "path": "tools/standards_analysis/standards_analysis/keys.py", "state": "present", "uses": [ { - "check": "architecture-contract-authority-destinations", - "role": "target", - "suite": "contract-ownership" - }, - { - "check": "routing-closure", - "role": "canonical-module", - "suite": "development-proportionality" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "frontend-rendering-synchronization" + "check": "python-package-contract", + "role": "package-contract-input", + "suite": "a1c-public-cutover" }, { "check": "current-structure", "role": "registered-policy-impact", "suite": "policy-semantic-impact" - }, - { - "check": "negative-fixtures", - "role": "canonical-policy-impact", - "suite": "policy-semantic-impact" - }, - { - "check": "verifier-change-route-closure", - "role": "canonical-module", - "suite": "s1-routing" - }, - { - "check": "frontend-routes", - "role": "link-target", - "suite": "source-index-closures" - }, - { - "check": "frontend-routes", - "role": "member-content", - "suite": "source-index-closures" - }, - { - "check": "source-links", - "role": "link-target", - "suite": "source-index-closures" - }, - { - "check": "requires-closure", - "role": "canonical-module", - "suite": "standards-recovery-routing" } ] }, { - "digest": "sha256:22703818103908f3738726a04fc96e9b851a9749049b3f661e25440abf3d22f4", - "path": "reference/recipes/http.md", + "digest": "sha256:22ed505a1fbe674292cc52540816274bd20f3ab6ed595112be4e8e513d39d454", + "path": "tools/standards_analysis/standards_analysis/obligations.py", "state": "present", "uses": [ { - "check": "metadata-closure", - "role": "metadata", - "suite": "contract-http-outcome-projection" - }, - { - "check": "architecture-contract-authority-destinations", - "role": "target", - "suite": "contract-ownership" - }, - { - "check": "routing-closure", - "role": "canonical-module", - "suite": "development-proportionality" + "check": "python-package-contract", + "role": "package-contract-input", + "suite": "a1c-public-cutover" }, { "check": "current-structure", "role": "registered-policy-impact", "suite": "policy-semantic-impact" - }, - { - "check": "negative-fixtures", - "role": "canonical-policy-impact", - "suite": "policy-semantic-impact" - }, - { - "check": "verifier-change-route-closure", - "role": "canonical-module", - "suite": "s1-routing" - }, - { - "check": "requires-closure", - "role": "canonical-module", - "suite": "standards-recovery-routing" } ] }, { - "digest": "sha256:adbecd045ceb28bb9cc9f4ce4582c1f3551b6d69f1523f632b459f2d3b3d3ca1", - "path": "reference/recipes/implementation.md", + "digest": "sha256:f0ebabf460240f9a80f65adc56305d792000ddd46f1a77feea93268cfa395fb7", + "path": "tools/standards_analysis/standards_analysis/reading.py", "state": "present", "uses": [ { - "check": "routing-closure", - "role": "canonical-module", - "suite": "development-proportionality" + "check": "python-package-contract", + "role": "package-contract-input", + "suite": "a1c-public-cutover" }, { "check": "current-structure", "role": "registered-policy-impact", "suite": "policy-semantic-impact" - }, - { - "check": "negative-fixtures", - "role": "canonical-policy-impact", - "suite": "policy-semantic-impact" - }, - { - "check": "verifier-change-route-closure", - "role": "canonical-module", - "suite": "s1-routing" - }, - { - "check": "requires-closure", - "role": "canonical-module", - "suite": "standards-recovery-routing" - }, + } + ] + }, + { + "digest": "sha256:82f5bb1715d5df55ed5b706e737181c237bb1bb110e742dcf7a8efa09cbfe879", + "path": "tools/standards_analysis/standards_analysis/router_guidance.py", + "state": "present", + "uses": [ { - "check": "former-source-destinations", - "role": "target", - "suite": "tooling-ci-workflow-reference" - }, + "check": "python-package-contract", + "role": "package-contract-input", + "suite": "a1c-public-cutover" + } + ] + }, + { + "digest": "sha256:50bae521cd9a0ef457d25d4ba65e24bf7d8c4eae637e9d9ad0e9de8747392815", + "path": "tools/standards_analysis/standards_analysis/routing.py", + "state": "present", + "uses": [ { - "check": "former-source-destinations", - "role": "target", - "suite": "tooling-reference-recipes" + "check": "python-package-contract", + "role": "package-contract-input", + "suite": "a1c-public-cutover" }, { - "check": "tooling-route-and-legacy-removal-destinations", - "role": "target", - "suite": "verification-ownership" + "check": "current-structure", + "role": "registered-policy-impact", + "suite": "policy-semantic-impact" } ] }, { - "digest": "sha256:14dcc68c9dd307cd2ac5b380c4de6daa60421e255f54cc23d55f73a0b6f074c6", - "path": "reference/recipes/persistence.md", + "digest": "sha256:36bd4daa08e02a148398521ca82e0f7bc88a66244b9ef620ac6897224baebd0e", + "path": "tools/standards_analysis/standards_analysis/state.py", "state": "present", "uses": [ { - "check": "architecture-contract-authority-destinations", - "role": "target", - "suite": "contract-ownership" + "check": "python-package-contract", + "role": "package-contract-input", + "suite": "a1c-public-cutover" }, { - "check": "routing-closure", - "role": "canonical-module", - "suite": "development-proportionality" - }, + "check": "current-structure", + "role": "registered-policy-impact", + "suite": "policy-semantic-impact" + } + ] + }, + { + "digest": "sha256:e4d6f239e18682a3208d1c8a128ec602cbac0ad79b3bf1b726386cc9db6761de", + "path": "tools/standards_analysis/standards_analysis/trust.py", + "state": "present", + "uses": [ { - "check": "metadata-closure", - "role": "metadata", - "suite": "persistence-owner-contract" + "check": "python-package-contract", + "role": "package-contract-input", + "suite": "a1c-public-cutover" }, { "check": "current-structure", "role": "registered-policy-impact", "suite": "policy-semantic-impact" - }, + } + ] + }, + { + "digest": "sha256:a3f6ba58a1c5d7b39b1f1b50825a80b208980ade351c3f2e4dfad783cd787ad7", + "path": "tools/standards_analysis/tests/test_coverage.py", + "state": "present", + "uses": [ { - "check": "negative-fixtures", - "role": "canonical-policy-impact", + "check": "current-structure", + "role": "registered-policy-impact", "suite": "policy-semantic-impact" - }, - { - "check": "verifier-change-route-closure", - "role": "canonical-module", - "suite": "s1-routing" - }, - { - "check": "requires-closure", - "role": "canonical-module", - "suite": "standards-recovery-routing" } ] }, { - "digest": "sha256:55a721945a6e1e89b0df70cdf9bf149e4c4b288539587fcaa3f2c2ed3d722b77", - "path": "reference/recipes/releases.md", + "digest": "sha256:e86f0d6f48dc14ad394459f262096cb4d082d810d26c4f309257d8aee8785ce1", + "path": "tools/standards_analysis/tests/test_routing.py", "state": "present", "uses": [ - { - "check": "release-entrypoint-destinations", - "role": "target", - "suite": "contract-ownership" - }, - { - "check": "release-workflow-route-destinations", - "role": "target", - "suite": "contract-ownership" - }, - { - "check": "routing-closure", - "role": "canonical-module", - "suite": "development-proportionality" - }, { "check": "current-structure", "role": "registered-policy-impact", "suite": "policy-semantic-impact" - }, - { - "check": "negative-fixtures", - "role": "canonical-policy-impact", - "suite": "policy-semantic-impact" - }, - { - "check": "legacy-index-destinations", - "role": "target", - "suite": "release-reference-closure" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-reference-closure" - }, - { - "check": "verifier-change-route-closure", - "role": "canonical-module", - "suite": "s1-routing" - }, - { - "check": "requires-closure", - "role": "canonical-module", - "suite": "standards-recovery-routing" - }, - { - "check": "release-route-destinations", - "role": "target", - "suite": "verification-ownership" - }, - { - "check": "release-workflow-boundary-destinations", - "role": "target", - "suite": "verification-ownership" } ] }, { - "digest": "sha256:3101a6f55ea6b8ed6ec6a57bade9c292f9cf16886b0cfca350b10e2430d8faab", - "path": "reference/recipes/rust-dependencies.md", + "digest": "sha256:651020e3850f01605fa954259bb32c6dd99ab7eff794a8772ad616b369427c59", + "path": "tools/standards_applicability/pyproject.toml", "state": "present", "uses": [ { - "check": "routing-closure", - "role": "canonical-module", - "suite": "development-proportionality" + "check": "python-package-contract", + "role": "package-contract-input", + "suite": "a1c-public-cutover" }, { "check": "current-structure", "role": "registered-policy-impact", "suite": "policy-semantic-impact" - }, - { - "check": "negative-fixtures", - "role": "canonical-policy-impact", - "suite": "policy-semantic-impact" - }, - { - "check": "source-index-destinations", - "role": "target", - "suite": "rust-dependency-build-cost" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-dependency-candidate-inspection" - }, - { - "check": "verifier-change-route-closure", - "role": "canonical-module", - "suite": "s1-routing" - }, - { - "check": "requires-closure", - "role": "canonical-module", - "suite": "standards-recovery-routing" } ] }, { - "digest": "sha256:7fe2daa727bddfea1e708124606dfd4f299223fc30bf541f2cf669625fc62d01", - "path": "reference/recipes/rust-release.md", + "digest": "sha256:86e2db4c3a216c2f8139981cfb32bde2876e7e1b00e0804778df51a9a54b1fa5", + "path": "tools/standards_applicability/standards_applicability/__init__.py", "state": "present", "uses": [ { - "check": "routing-closure", - "role": "canonical-module", - "suite": "development-proportionality" + "check": "python-package-contract", + "role": "package-contract-input", + "suite": "a1c-public-cutover" }, { "check": "current-structure", "role": "registered-policy-impact", "suite": "policy-semantic-impact" - }, - { - "check": "negative-fixtures", - "role": "canonical-policy-impact", - "suite": "policy-semantic-impact" - }, - { - "check": "source-index-destinations", - "role": "target", - "suite": "rust-release-evidence" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-release-owner-contract" - }, - { - "check": "verifier-change-route-closure", - "role": "canonical-module", - "suite": "s1-routing" - }, - { - "check": "requires-closure", - "role": "canonical-module", - "suite": "standards-recovery-routing" } ] }, { - "digest": "sha256:cf85a48e0e2e346ef6445e89d6a14adcf17b55dc8818661e13a1cca44f3c1d50", - "path": "reference/recipes/rust-tooling.md", + "digest": "sha256:9ebd97a04b6db1439d40f21b9796e85066bbef9ffe183453cab4b2870d14207a", + "path": "tools/standards_applicability/standards_applicability/core.py", "state": "present", "uses": [ { - "check": "routing-closure", - "role": "canonical-module", - "suite": "development-proportionality" + "check": "python-package-contract", + "role": "package-contract-input", + "suite": "a1c-public-cutover" }, { "check": "current-structure", "role": "registered-policy-impact", "suite": "policy-semantic-impact" - }, - { - "check": "negative-fixtures", - "role": "canonical-policy-impact", - "suite": "policy-semantic-impact" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-tooling-owner-contract" - }, - { - "check": "verifier-change-route-closure", - "role": "canonical-module", - "suite": "s1-routing" - }, + } + ] + }, + { + "digest": "sha256:d47c99c886eece97186e347989bec5f1929232da09082a8ab9d48e6661f01416", + "path": "tools/standards_applicability/standards_applicability/errors.py", + "state": "present", + "uses": [ { - "check": "requires-closure", - "role": "canonical-module", - "suite": "standards-recovery-routing" + "check": "python-package-contract", + "role": "package-contract-input", + "suite": "a1c-public-cutover" } ] }, { - "digest": "sha256:2e5e78f40c0c4863a6a9f473044b952d516df463027cd6a7c0cf0e944dd6ece1", - "path": "reference/recipes/tooling.md", + "digest": "sha256:7dd5ac27bc1c8b3fc10c7984ebead989a5b78cc2094917a150c240ccf747ab63", + "path": "tools/standards_contracts/pyproject.toml", "state": "present", "uses": [ { - "check": "routing-closure", - "role": "canonical-module", - "suite": "development-proportionality" + "check": "python-package-contract", + "role": "package-contract-input", + "suite": "a1c-public-cutover" }, { "check": "current-structure", "role": "registered-policy-impact", "suite": "policy-semantic-impact" - }, - { - "check": "negative-fixtures", - "role": "canonical-policy-impact", - "suite": "policy-semantic-impact" - }, - { - "check": "verifier-change-route-closure", - "role": "canonical-module", - "suite": "s1-routing" - }, - { - "check": "frontend-routes", - "role": "link-target", - "suite": "source-index-closures" - }, - { - "check": "frontend-routes", - "role": "member-content", - "suite": "source-index-closures" - }, - { - "check": "source-links", - "role": "link-target", - "suite": "source-index-closures" - }, - { - "check": "requires-closure", - "role": "canonical-module", - "suite": "standards-recovery-routing" - }, - { - "check": "former-source-destinations", - "role": "target", - "suite": "tooling-ci-workflow-reference" - }, - { - "check": "reference-destinations", - "role": "markdown", - "suite": "tooling-ci-workflow-reference" - }, - { - "check": "former-source-destinations", - "role": "target", - "suite": "tooling-reference-recipes" - }, - { - "check": "reference-destinations", - "role": "markdown", - "suite": "tooling-reference-recipes" - }, - { - "check": "tooling-route-and-legacy-removal-destinations", - "role": "target", - "suite": "verification-ownership" } ] }, { - "digest": "sha256:251dd2badf1cad7fdf22458c0475204e25b7fe2655eb910e6a75b12f2bbb7d4c", - "path": "reference/routing/bounded-rust-repair.md", + "digest": "sha256:f18775527ec2a5cde781fc61752e80a8fcc8dd39a8dec2233923122b75e04112", + "path": "tools/standards_contracts/standards_contracts/__init__.py", "state": "present", "uses": [ { - "check": "routing-closure", - "role": "canonical-module", - "suite": "development-proportionality" + "check": "python-package-contract", + "role": "package-contract-input", + "suite": "a1c-public-cutover" }, { "check": "current-structure", "role": "registered-policy-impact", "suite": "policy-semantic-impact" - }, - { - "check": "negative-fixtures", - "role": "canonical-policy-impact", - "suite": "policy-semantic-impact" - }, - { - "check": "verifier-change-route-closure", - "role": "canonical-module", - "suite": "s1-routing" - }, - { - "check": "requires-closure", - "role": "canonical-module", - "suite": "standards-recovery-routing" } ] }, { - "digest": "sha256:c12c0365bb558c8ef973647fc74af9678cd1c35f54d17b104afdd3ed373f4f50", - "path": "templates/PLAN-TEMPLATE.md", + "digest": "sha256:0a169d57599bbf726e74db01de12f1b22dcf7294c7de860ee0d4c96fa2a2101b", + "path": "tools/standards_contracts/standards_contracts/compiler.py", "state": "present", "uses": [ { - "check": "local-links", - "role": "link-target", - "suite": "development-proportionality" + "check": "python-package-contract", + "role": "package-contract-input", + "suite": "a1c-public-cutover" }, { "check": "current-structure", "role": "registered-policy-impact", "suite": "policy-semantic-impact" - }, + } + ] + }, + { + "digest": "sha256:93a6e7e22f0d918d00c2ed56a0d195057ec65c630ab004670ec7395123c13920", + "path": "tools/standards_contracts/standards_contracts/errors.py", + "state": "present", + "uses": [ { - "check": "root-links", - "role": "link-target", - "suite": "root-index-closure" + "check": "python-package-contract", + "role": "package-contract-input", + "suite": "a1c-public-cutover" }, { - "check": "planning-routes", - "role": "link-target", - "suite": "source-index-closures" - }, - { - "check": "planning-routes", - "role": "member-content", - "suite": "source-index-closures" - }, - { - "check": "source-links", - "role": "link-target", - "suite": "source-index-closures" - } - ] - }, - { - "digest": "sha256:c0f3b1d8fbbd8744a3b5d9d9bdb4c11ac747a6824ab97d4c36d6171c8ed85237", - "path": "templates/PULL_REQUEST_TEMPLATE.md", - "state": "present", - "uses": [ - { - "check": "root-links", - "role": "link-target", - "suite": "root-index-closure" - } - ] - }, - { - "digest": "sha256:7d26a2fed9d192c5595a8e4ffab8258be13f03def2e509e6d56c74db28c03b8a", - "path": "templates/README-TEMPLATE.md", - "state": "present", - "uses": [ - { - "check": "root-links", - "role": "link-target", - "suite": "root-index-closure" + "check": "current-structure", + "role": "registered-policy-impact", + "suite": "policy-semantic-impact" } ] }, { - "digest": "sha256:4a367fa39ae9c8ecbc92caedde00c6c107b9edf00a022cfd864d081a46e36ef2", - "path": "tools/decision_traceability/decision_traceability/__init__.py", + "digest": "sha256:23f65d4a0243c42abb936d20c3f5b78841923553a02dafcde2d381e4251e4ef0", + "path": "tools/standards_contracts/standards_contracts/model.py", "state": "present", "uses": [ { "check": "python-package-contract", "role": "package-contract-input", "suite": "a1c-public-cutover" - } - ] - }, - { - "digest": "sha256:5228ba55c16e54a8a367b2104d860b74829a464235fa2b6dd02be21c0d5bd7c7", - "path": "tools/decision_traceability/decision_traceability/check.py", - "state": "present", - "uses": [ + }, { - "check": "python-package-contract", - "role": "package-contract-input", - "suite": "a1c-public-cutover" + "check": "current-structure", + "role": "registered-policy-impact", + "suite": "policy-semantic-impact" } ] }, { - "digest": "sha256:aa7f8222a952ea4a90e6a6a8e9834b64cc9c2b0ba68c3c5ce3dbc5f838601f79", - "path": "tools/decision_traceability/pyproject.toml", + "digest": "sha256:41dc99455a4fb59df12e8d7a1a3dde1894ab5f8e600cb8923308d659589c2c8d", + "path": "tools/standards_contracts/standards_contracts/projection.py", "state": "present", "uses": [ { "check": "python-package-contract", "role": "package-contract-input", "suite": "a1c-public-cutover" - } - ] - }, - { - "digest": "sha256:76b3c632590acfc922c47a6915442e1797c10b3b8608b8496f50fff8986fec85", - "path": "tools/decision_traceability/verify_contract.py", - "state": "present", - "uses": [ + }, { - "check": "python-package-contract", - "role": "package-contract-input", - "suite": "a1c-public-cutover" + "check": "current-structure", + "role": "registered-policy-impact", + "suite": "policy-semantic-impact" } ] }, { - "digest": "sha256:725648aa5f54c4a6f3177f361077f86526f26da87e51a63127f2da15ebc34cb1", - "path": "tools/graph_engine/graph_engine/__init__.py", + "digest": "sha256:3e612692b20c98b502b07d1eba52efc4cf2269eaf64bd37c0509767503f36722", + "path": "tools/standards_contracts/standards_contracts/runtime.py", "state": "present", "uses": [ { @@ -6532,20 +6113,8 @@ ] }, { - "digest": "sha256:641acd59e88d4d0d9c85c384d2cb84b5b3b3295b3dd77a41f9284629249e2a8b", - "path": "tools/graph_engine/graph_engine/cli.py", - "state": "present", - "uses": [ - { - "check": "python-package-contract", - "role": "package-contract-input", - "suite": "a1c-public-cutover" - } - ] - }, - { - "digest": "sha256:464ba32cd9752a2804cdcdf84532043c68fb752f45783c2df00bb5adb9fdcf1b", - "path": "tools/graph_engine/graph_engine/errors.py", + "digest": "sha256:dc53eab107beb6e7e1eea90f40455ddbd567dba0e40fd8c5bef93a44c66beed5", + "path": "tools/standards_contracts/standards_contracts/schema_structure.py", "state": "present", "uses": [ { @@ -6556,8 +6125,8 @@ ] }, { - "digest": "sha256:7ca7644dfd97313580e2ff8075ccdfe13dd4753075585997aced461bdbfccd1e", - "path": "tools/graph_engine/graph_engine/manifest.py", + "digest": "sha256:7f03d6dca26c71b46fed6cfbff867ad58bda590c97412cfdfa912522cfc62aca", + "path": "tools/standards_contracts/standards_contracts/union_selection.py", "state": "present", "uses": [ { @@ -6568,8 +6137,8 @@ ] }, { - "digest": "sha256:cbbf89a7cd22a0c990867c86ae36539f9c6a387c64bc10f0c02c5e1b5df2ce33", - "path": "tools/graph_engine/graph_engine/model.py", + "digest": "sha256:a801fcd89046dfb1d8c126bcf97afa617cf4a62bc7736dc78a9a1097c782b976", + "path": "tools/standards_contracts/standards_contracts/validation_feedback.py", "state": "present", "uses": [ { @@ -6580,27 +6149,22 @@ ] }, { - "digest": "sha256:7b5fbe0233db2cd906ddf4b74a1f2df833436497a51d7248bff7bbbe34ab9a48", - "path": "tools/graph_engine/graph_engine/paths.py", + "digest": "sha256:8731b6a1cf9ff5e4af9b62008086d6a8e9a1a3dbcf6587140d7bd6f1818acb02", + "path": "tools/standards_engine/README.md", "state": "present", "uses": [ { - "check": "python-package-contract", - "role": "package-contract-input", - "suite": "a1c-public-cutover" + "check": "root-links", + "role": "link-target", + "suite": "root-index-closure" } ] }, { - "digest": "sha256:393b0e26ccd9c7a734d610a0f4dc418657a72fce662b3efe24e6207b565490af", - "path": "tools/graph_engine/graph_engine/projection.py", + "digest": "sha256:af72d1dc44c27b6bf064f1e0b792ec0c95fd84d15334159d607e032907de39db", + "path": "tools/standards_engine/contracts/README.md", "state": "present", "uses": [ - { - "check": "python-package-contract", - "role": "package-contract-input", - "suite": "a1c-public-cutover" - }, { "check": "current-structure", "role": "registered-policy-impact", @@ -6609,14 +6173,14 @@ ] }, { - "digest": "sha256:7e056a801f17a8eda311db9a66f6de62a77916bd21db24401cef7780b2200d39", - "path": "tools/graph_engine/graph_engine/registry.py", + "digest": "sha256:c90f4d0b4f9b7dcd1698460f9b20df411950dad3ae6a7403f77f94f93b69bc72", + "path": "tools/standards_engine/contracts/a1-contract.schema.json", "state": "present", "uses": [ { - "check": "python-package-contract", - "role": "package-contract-input", - "suite": "a1c-public-cutover" + "check": "generated-projections", + "role": "schema", + "suite": "generated-contract-semantic-conformance" }, { "check": "current-structure", @@ -6626,14 +6190,14 @@ ] }, { - "digest": "sha256:2e7a61bdaced2f58a49c9dcbb3428c99c7c668538fa22dee0828efcff1c2a345", - "path": "tools/graph_engine/pyproject.toml", + "digest": "sha256:7b5dcba11f0b6b22bad4ace83dd28ed0d9da9be7745833264cac2ce67bb0c041", + "path": "tools/standards_engine/contracts/a1-interface.toml", "state": "present", "uses": [ { - "check": "python-package-contract", - "role": "package-contract-input", - "suite": "a1c-public-cutover" + "check": "generated-projections", + "role": "interface", + "suite": "generated-contract-semantic-conformance" }, { "check": "current-structure", @@ -6643,14 +6207,14 @@ ] }, { - "digest": "sha256:17c9f57fee617eeac07d46ee0eabd7d7424b473b1b42f9fb330f5966de67c8bb", - "path": "tools/query_edges.py", + "digest": "sha256:0a9be0dced6778e95216f874654a13fdffa21ec93186077e95553e656a6531b8", + "path": "tools/standards_engine/contracts/examples/a1-examples.json", "state": "present", "uses": [ { - "check": "python-package-contract", - "role": "package-contract-input", - "suite": "a1c-public-cutover" + "check": "generated-projections", + "role": "examples", + "suite": "generated-contract-semantic-conformance" }, { "check": "current-structure", @@ -6660,14 +6224,14 @@ ] }, { - "digest": "sha256:a0a7203e10b21fcbe220b61e524f2bcb05569c2923090b280bd170c9fb42b1fb", - "path": "tools/repository_git/pyproject.toml", + "digest": "sha256:a83afeec0e46b2f2859608bc5650392e688b3d150b9635ca0a8c9e939c830497", + "path": "tools/standards_engine/contracts/generated/agent-tools.json", "state": "present", "uses": [ { - "check": "python-package-contract", - "role": "package-contract-input", - "suite": "a1c-public-cutover" + "check": "generated-projections", + "role": "generated-agent-tools", + "suite": "generated-contract-semantic-conformance" }, { "check": "current-structure", @@ -6677,15 +6241,10 @@ ] }, { - "digest": "sha256:c0c8001952d1f914f263e243193a56c97fd4600d51a5c0a4157133ffece83562", - "path": "tools/repository_git/repository_git/__init__.py", + "digest": "sha256:83adcd9383a1f6756653dd944cb83fe87fc41da74c8906fbb55da632c03d1f4f", + "path": "tools/standards_engine/contracts/identity-fixtures.json", "state": "present", "uses": [ - { - "check": "python-package-contract", - "role": "package-contract-input", - "suite": "a1c-public-cutover" - }, { "check": "current-structure", "role": "registered-policy-impact", @@ -6694,20 +6253,8 @@ ] }, { - "digest": "sha256:45e07721da5c893ff0c4ebcbe34ed0e0e37386bdbdcc6a053aff8db5b52bf75b", - "path": "tools/repository_git/repository_git/batch.py", - "state": "present", - "uses": [ - { - "check": "python-package-contract", - "role": "package-contract-input", - "suite": "a1c-public-cutover" - } - ] - }, - { - "digest": "sha256:690edf0e048ef3c63ee422aca2fdf1381cda6029e593adf5b96477b4d83e62fa", - "path": "tools/repository_git/repository_git/errors.py", + "digest": "sha256:697bd43954c31ef84ec176d42c7c750c46e73a7693076ed07f928a36947f8849", + "path": "tools/standards_engine/pyproject.toml", "state": "present", "uses": [ { @@ -6723,8 +6270,8 @@ ] }, { - "digest": "sha256:9705fdbfd512b38a62772028bd1ff5809a6af1038753ff3547a2c4c8b30ee4f7", - "path": "tools/repository_git/repository_git/model.py", + "digest": "sha256:305317ccc14c4de68e142f4912f95a1a7bb0ac616d1107de11d061f8c7b6e4c3", + "path": "tools/standards_engine/standards_engine/__init__.py", "state": "present", "uses": [ { @@ -6740,8 +6287,8 @@ ] }, { - "digest": "sha256:f025feeb7e19758ab49aa6ab2b836c91cdd078f137baceedea86a7d46dba6c61", - "path": "tools/repository_git/repository_git/repository.py", + "digest": "sha256:484763ea0780acaec11f78066e7176bab786fc2c9f68211736a4f6fafb1b3101", + "path": "tools/standards_engine/standards_engine/_generated_contract.py", "state": "present", "uses": [ { @@ -6749,6 +6296,11 @@ "role": "package-contract-input", "suite": "a1c-public-cutover" }, + { + "check": "generated-projections", + "role": "generated-python", + "suite": "generated-contract-semantic-conformance" + }, { "check": "current-structure", "role": "registered-policy-impact", @@ -6757,20 +6309,20 @@ ] }, { - "digest": "sha256:46636d31a867331b7f900100421aed70fb39192589817b59d2a78230bd676891", - "path": "tools/repository_git/tests/test_repository.py", + "digest": "sha256:63a3388f9596bde80dcebd42186c41c206e515a0b44bd2b7b11f39d6656b3716", + "path": "tools/standards_engine/standards_engine/agent_navigation.py", "state": "present", "uses": [ { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" + "check": "python-package-contract", + "role": "package-contract-input", + "suite": "a1c-public-cutover" } ] }, { - "digest": "sha256:af0d55266eb9e970e0c7c4dd4dbdf9b2e1fe4aa12d4438144604788ceef1f523", - "path": "tools/review_evidence/pyproject.toml", + "digest": "sha256:9a39d95363aec431a62fa4dbced44ed4f3d87f9b4a302852a18b4396dad5d5d9", + "path": "tools/standards_engine/standards_engine/agent_workflow.py", "state": "present", "uses": [ { @@ -6781,8 +6333,8 @@ ] }, { - "digest": "sha256:3afb7f4bb258430837be03c1fd1448543ab811bcce805f8f7b4e1a1218f48c79", - "path": "tools/review_evidence/review_evidence/__init__.py", + "digest": "sha256:a706f9214dd751411d1e158061dec8669fb03f1a2fd5fa2c72d94d9fe68c8289", + "path": "tools/standards_engine/standards_engine/analysis_projection.py", "state": "present", "uses": [ { @@ -6793,8 +6345,8 @@ ] }, { - "digest": "sha256:307299fda7b77d22c64cb51430ec75e5f59d78e9c948786afb3b2544fe45e4b7", - "path": "tools/review_evidence/review_evidence/__main__.py", + "digest": "sha256:e518ed0dc72e7c1f7f73a7523f620ff06cf83decb173636f5639ee51667b527e", + "path": "tools/standards_engine/standards_engine/authoring.py", "state": "present", "uses": [ { @@ -6805,8 +6357,8 @@ ] }, { - "digest": "sha256:d39c9fbaf00aacdb3c1d08b23d9b645fe72c98ac121bbd7143d2a7fe8bb0d250", - "path": "tools/review_evidence/review_evidence/cli.py", + "digest": "sha256:0edcdec07b5c0b11d8f34e526429df433df318a55c2aee522dc482a83b8f4173", + "path": "tools/standards_engine/standards_engine/compiled_cache.py", "state": "present", "uses": [ { @@ -6817,8 +6369,8 @@ ] }, { - "digest": "sha256:2d84851dc497ecdae01eafcaf90aae12abda13a428eefa064517909af31711e2", - "path": "tools/review_evidence/review_evidence/common.py", + "digest": "sha256:865b499b737f476a2717b0086ca4a70ae844f01d52e8964d5dae1d5e71792394", + "path": "tools/standards_engine/standards_engine/consumer_authoring.py", "state": "present", "uses": [ { @@ -6829,8 +6381,8 @@ ] }, { - "digest": "sha256:62e5177be158a1d94304414bf4664739bd804cf5725e53e1d8178f004bba5a21", - "path": "tools/review_evidence/review_evidence/local_files.py", + "digest": "sha256:5bbf14c1143a8b0def574dbadef52b7d6f416278523a28dc60be251a03992b65", + "path": "tools/standards_engine/standards_engine/context_projection.py", "state": "present", "uses": [ { @@ -6841,8 +6393,8 @@ ] }, { - "digest": "sha256:0b7cfc5e12238513ad89628a063fb993003b6a93cbda4d8204ec0a1e2bd83bb6", - "path": "tools/review_evidence/review_evidence/packet.py", + "digest": "sha256:9b6b18cc2da3e1d3dd473322108a07cc0b0315bbfd1614dd7157c045397ceb3b", + "path": "tools/standards_engine/standards_engine/contract_discovery.py", "state": "present", "uses": [ { @@ -6853,8 +6405,8 @@ ] }, { - "digest": "sha256:bf80886b99d6a065974b7a421a4924bd5228d696bf82b5e0a48d4e13ebb4eee9", - "path": "tools/review_evidence/review_evidence/request.py", + "digest": "sha256:db3061fe87b423c7d9f58248d95df2fb5c9ecfdf1ec7343ea4396dd7d1a438d2", + "path": "tools/standards_engine/standards_engine/decision_batch.py", "state": "present", "uses": [ { @@ -6865,8 +6417,8 @@ ] }, { - "digest": "sha256:c91ad773a879ed1c0b015dd1ff45c31f40e7a8dcf7100903db5bb98af8dc17ac", - "path": "tools/standards_analysis/pyproject.toml", + "digest": "sha256:771724850474e165d1d9b873e94a8fa916c06a1cfca16b3f18ae8e427bf4e6ca", + "path": "tools/standards_engine/standards_engine/engine.py", "state": "present", "uses": [ { @@ -6882,8 +6434,8 @@ ] }, { - "digest": "sha256:907a27607f06fd1b0f7a2e839eba5f089840861c06f8ee38e771526c9c0d2518", - "path": "tools/standards_analysis/standards_analysis/__init__.py", + "digest": "sha256:c9391ac17beb93cd11d0a4dccde3cb46f6f6842981536233e6d96de51948eee8", + "path": "tools/standards_engine/standards_engine/evidence_maintenance.py", "state": "present", "uses": [ { @@ -6899,8 +6451,8 @@ ] }, { - "digest": "sha256:d2c0343eac19c20b3bff310325eb0f0f53dea91eb95cac2f893f7ba20c684220", - "path": "tools/standards_analysis/standards_analysis/changes.py", + "digest": "sha256:faaedd424f81558a11724ab735f0631975ab15c1582e51cb33b28e3e46d5063b", + "path": "tools/standards_engine/standards_engine/input_feedback.py", "state": "present", "uses": [ { @@ -6911,42 +6463,44 @@ ] }, { - "digest": "sha256:0fdca28dadfc1f4b950d844348c7927326b33a8fb291995f45e7680842b88fa4", - "path": "tools/standards_analysis/standards_analysis/coverage.py", + "digest": "sha256:1a6d59145f4b8d43c67c23787fc450b60b569bbd65089fca9e6817b17848edae", + "path": "tools/standards_engine/standards_engine/interaction_observer.py", "state": "present", "uses": [ { "check": "python-package-contract", "role": "package-contract-input", "suite": "a1c-public-cutover" - }, - { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" } ] }, { - "digest": "sha256:1fecafc49b9adb5516925398fdeec516e1c8cc6ae5240f7b67d329795fe50730", - "path": "tools/standards_analysis/standards_analysis/coverage_publication.py", - "state": "present", + "digest": "sha256:bac3a3330851489f35542e775ecf61c2f04822b17d23806803b8da8d2fb4b506", + "path": "tools/standards_engine/standards_engine/logical_authoring.py", + "state": "present", "uses": [ { "check": "python-package-contract", "role": "package-contract-input", "suite": "a1c-public-cutover" - }, + } + ] + }, + { + "digest": "sha256:de84546c995f608c6774feb7e48992419d2cf57982e79fe1c0c8595ab0ac6300", + "path": "tools/standards_engine/standards_engine/mcp.py", + "state": "present", + "uses": [ { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" + "check": "python-package-contract", + "role": "package-contract-input", + "suite": "a1c-public-cutover" } ] }, { - "digest": "sha256:2381dbb0d02c118196899213970ce61053e69b30a190ad830532e13fc5fa38ff", - "path": "tools/standards_analysis/standards_analysis/errors.py", + "digest": "sha256:efa10c69d5cd5ada87a469f87af027dd98e61378bbfcff3767eb9600acc3d109", + "path": "tools/standards_engine/standards_engine/mcp_catalog.py", "state": "present", "uses": [ { @@ -6957,42 +6511,56 @@ ] }, { - "digest": "sha256:b7c9c93dba2080468d56a9f405fcadd9f7907ecce93876d40cf2a9d529737cf5", - "path": "tools/standards_analysis/standards_analysis/impact.py", + "digest": "sha256:0c8b56d1a914306f954eaa9c24fb78d56415912f8668f486d9f88982d84e57c2", + "path": "tools/standards_engine/standards_engine/navigation_indexes.py", "state": "present", "uses": [ { "check": "python-package-contract", "role": "package-contract-input", "suite": "a1c-public-cutover" - }, + } + ] + }, + { + "digest": "sha256:bcba59c19e69bcaf683c4266430933cb54c086d08c428ad0654c0f0db35c2881", + "path": "tools/standards_engine/standards_engine/operation_materials.py", + "state": "present", + "uses": [ { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" + "check": "python-package-contract", + "role": "package-contract-input", + "suite": "a1c-public-cutover" } ] }, { - "digest": "sha256:5dd1ca9ce4eae8a75a16539fb6058d603bc72a83d21bd69324dea71deac793c9", - "path": "tools/standards_analysis/standards_analysis/kernel.py", + "digest": "sha256:2188fd6ca71176ae31db92cfbf4c1be0286b09c6025d5eed75a1dac4b3af3518", + "path": "tools/standards_engine/standards_engine/projection_continuation.py", "state": "present", "uses": [ { "check": "python-package-contract", "role": "package-contract-input", "suite": "a1c-public-cutover" - }, + } + ] + }, + { + "digest": "sha256:e1039af76be923d41362e81d35fb7025c59246aae8ea0f0a106cc2aa39ce9d0e", + "path": "tools/standards_engine/standards_engine/relationship_vocabulary.py", + "state": "present", + "uses": [ { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" + "check": "python-package-contract", + "role": "package-contract-input", + "suite": "a1c-public-cutover" } ] }, { - "digest": "sha256:6849041b743c2c7b59010f511531c13963cb8bca5045a1dfc855cdb991d32d08", - "path": "tools/standards_analysis/standards_analysis/keys.py", + "digest": "sha256:53f070736d679418213878dc7cd3e6849357d1351fd621cfb6bf8c018612d4fe", + "path": "tools/standards_engine/standards_engine/rendering.py", "state": "present", "uses": [ { @@ -7008,42 +6576,44 @@ ] }, { - "digest": "sha256:22ed505a1fbe674292cc52540816274bd20f3ab6ed595112be4e8e513d39d454", - "path": "tools/standards_analysis/standards_analysis/obligations.py", + "digest": "sha256:48a61c2029c39f46e4bd533aba570cad4e481e35d8713d5d9365ade4d91bfc2a", + "path": "tools/standards_engine/standards_engine/request_evidence.py", "state": "present", "uses": [ { "check": "python-package-contract", "role": "package-contract-input", "suite": "a1c-public-cutover" - }, - { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" } ] }, { - "digest": "sha256:f0ebabf460240f9a80f65adc56305d792000ddd46f1a77feea93268cfa395fb7", - "path": "tools/standards_analysis/standards_analysis/reading.py", + "digest": "sha256:2c5ca992b532a09b4bbd343e094e3686fefac2d3e76a9accbd911be966d2b46a", + "path": "tools/standards_engine/standards_engine/routing_edits.py", "state": "present", "uses": [ { "check": "python-package-contract", "role": "package-contract-input", "suite": "a1c-public-cutover" - }, + } + ] + }, + { + "digest": "sha256:24393890b46a4f56ba0a4f59e724f924e842eb0aa764b8c9f104672e9e995fdd", + "path": "tools/standards_engine/standards_engine/routing_inputs.py", + "state": "present", + "uses": [ { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" + "check": "python-package-contract", + "role": "package-contract-input", + "suite": "a1c-public-cutover" } ] }, { - "digest": "sha256:82f5bb1715d5df55ed5b706e737181c237bb1bb110e742dcf7a8efa09cbfe879", - "path": "tools/standards_analysis/standards_analysis/router_guidance.py", + "digest": "sha256:5237dbc3ca5db69540b90c92e5f03279b2cfcad5e0cbf4fc8cf93e424f77ca1e", + "path": "tools/standards_engine/standards_engine/runtime_identity.py", "state": "present", "uses": [ { @@ -7054,25 +6624,32 @@ ] }, { - "digest": "sha256:a0b7763d137159600b01bb3bae1c94442dbb3c160e69f7a622427977fea293f1", - "path": "tools/standards_analysis/standards_analysis/routing.py", + "digest": "sha256:9e16bf974c02ad5194a02a7836a9a8c8d4eca56b4ea5da821c1ab312e2832469", + "path": "tools/standards_engine/standards_engine/supporting.py", "state": "present", "uses": [ { "check": "python-package-contract", "role": "package-contract-input", "suite": "a1c-public-cutover" - }, + } + ] + }, + { + "digest": "sha256:2f11bf3e9c85c9a5ed073c884debf3010a36a0b4d6b60c5b38a52b9cb846afd7", + "path": "tools/standards_engine/standards_engine/supporting_authoring.py", + "state": "present", + "uses": [ { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" + "check": "python-package-contract", + "role": "package-contract-input", + "suite": "a1c-public-cutover" } ] }, { - "digest": "sha256:36bd4daa08e02a148398521ca82e0f7bc88a66244b9ef620ac6897224baebd0e", - "path": "tools/standards_analysis/standards_analysis/state.py", + "digest": "sha256:4629b05fa5305fa299a814205186173de029d12ba25a960f2a7ba74a5538c293", + "path": "tools/standards_engine/standards_engine/tools.py", "state": "present", "uses": [ { @@ -7088,15 +6665,22 @@ ] }, { - "digest": "sha256:e4d6f239e18682a3208d1c8a128ec602cbac0ad79b3bf1b726386cc9db6761de", - "path": "tools/standards_analysis/standards_analysis/trust.py", + "digest": "sha256:8ce8775aab3f3ff577d1c71a9d1b40d8dd4fef3650aa5cd0221155402a48e1b4", + "path": "tools/standards_engine/standards_engine/workflow_presentation.py", "state": "present", "uses": [ { "check": "python-package-contract", "role": "package-contract-input", "suite": "a1c-public-cutover" - }, + } + ] + }, + { + "digest": "sha256:30eec6a6c472938048821b5669d17e054aa7cdee637647961b4012a380245e62", + "path": "tools/standards_engine/tests/test_analysis.py", + "state": "present", + "uses": [ { "check": "current-structure", "role": "registered-policy-impact", @@ -7105,8 +6689,8 @@ ] }, { - "digest": "sha256:a3f6ba58a1c5d7b39b1f1b50825a80b208980ade351c3f2e4dfad783cd787ad7", - "path": "tools/standards_analysis/tests/test_coverage.py", + "digest": "sha256:1a105c8d63b0b7125e41f05a2acf4a8e7f4477f94901c3976238575e5ce3de3a", + "path": "tools/standards_engine/tests/test_coverage_publication.py", "state": "present", "uses": [ { @@ -7117,8 +6701,8 @@ ] }, { - "digest": "sha256:e86f0d6f48dc14ad394459f262096cb4d082d810d26c4f309257d8aee8785ce1", - "path": "tools/standards_analysis/tests/test_routing.py", + "digest": "sha256:da6c51a02bd2a24d09d70b88acec826ad3744772553f8a49cc73fdf9d051957e", + "path": "tools/standards_engine/tests/test_evidence_maintenance.py", "state": "present", "uses": [ { @@ -7129,15 +6713,10 @@ ] }, { - "digest": "sha256:651020e3850f01605fa954259bb32c6dd99ab7eff794a8772ad616b369427c59", - "path": "tools/standards_applicability/pyproject.toml", + "digest": "sha256:b14540a5826d5f2d490a7e5c4f5791b383ad11b9dd48e4fee460dc507ccb5474", + "path": "tools/standards_engine/tests/test_navigation.py", "state": "present", "uses": [ - { - "check": "python-package-contract", - "role": "package-contract-input", - "suite": "a1c-public-cutover" - }, { "check": "current-structure", "role": "registered-policy-impact", @@ -7146,8 +6725,8 @@ ] }, { - "digest": "sha256:86e2db4c3a216c2f8139981cfb32bde2876e7e1b00e0804778df51a9a54b1fa5", - "path": "tools/standards_applicability/standards_applicability/__init__.py", + "digest": "sha256:54d7e422c84555e6123c202d4fbc98ae7e32614b333c023b8a77dff4991fb16b", + "path": "tools/standards_graph/pyproject.toml", "state": "present", "uses": [ { @@ -7163,8 +6742,8 @@ ] }, { - "digest": "sha256:9ebd97a04b6db1439d40f21b9796e85066bbef9ffe183453cab4b2870d14207a", - "path": "tools/standards_applicability/standards_applicability/core.py", + "digest": "sha256:bca9f62d323417605a3ad2e9dc77c44e95b4aa7106f59bbf53ec115153095c5f", + "path": "tools/standards_graph/standards_graph/__init__.py", "state": "present", "uses": [ { @@ -7180,8 +6759,8 @@ ] }, { - "digest": "sha256:d47c99c886eece97186e347989bec5f1929232da09082a8ab9d48e6661f01416", - "path": "tools/standards_applicability/standards_applicability/errors.py", + "digest": "sha256:153921a40d785c6fc6facb8b090d5eefdde0123166a40ee85f8237f0c122b375", + "path": "tools/standards_graph/standards_graph/metadata.py", "state": "present", "uses": [ { @@ -7192,8 +6771,20 @@ ] }, { - "digest": "sha256:7dd5ac27bc1c8b3fc10c7984ebead989a5b78cc2094917a150c240ccf747ab63", - "path": "tools/standards_contracts/pyproject.toml", + "digest": "sha256:5f7320281ce1b2ae5884b41b9e65cb4c98bd1197e0468f19689f767301c66ba5", + "path": "tools/standards_graph/standards_graph/policy_units.py", + "state": "present", + "uses": [ + { + "check": "python-package-contract", + "role": "package-contract-input", + "suite": "a1c-public-cutover" + } + ] + }, + { + "digest": "sha256:89a711ce6e71e5508d5bd2e2f79fc3e2c9189ff90fbaca81a0134cd80f25f0b5", + "path": "tools/standards_graph/standards_graph/repository.py", "state": "present", "uses": [ { @@ -7209,8 +6800,20 @@ ] }, { - "digest": "sha256:f18775527ec2a5cde781fc61752e80a8fcc8dd39a8dec2233923122b75e04112", - "path": "tools/standards_contracts/standards_contracts/__init__.py", + "digest": "sha256:1838ceb220964296fe1af9f0e25ea91b076972a8ee452c684da13e0f6db86709", + "path": "tools/standards_identity/README.md", + "state": "present", + "uses": [ + { + "check": "current-structure", + "role": "registered-policy-impact", + "suite": "policy-semantic-impact" + } + ] + }, + { + "digest": "sha256:d013e28962ada684dc0757541b935bd00686abf906e9d89718cc3248505af717", + "path": "tools/standards_identity/pyproject.toml", "state": "present", "uses": [ { @@ -7226,8 +6829,8 @@ ] }, { - "digest": "sha256:62aea45105e65acd37e0b8eab4c4d504092f7f0d89e3ec8d2c992675a2f05bdf", - "path": "tools/standards_contracts/standards_contracts/compiler.py", + "digest": "sha256:330770de68a1688aa5833d2ec01fb14684eeabd53b0a45fb6138709a98478fca", + "path": "tools/standards_identity/standards_identity/__init__.py", "state": "present", "uses": [ { @@ -7243,8 +6846,8 @@ ] }, { - "digest": "sha256:93a6e7e22f0d918d00c2ed56a0d195057ec65c630ab004670ec7395123c13920", - "path": "tools/standards_contracts/standards_contracts/errors.py", + "digest": "sha256:611655e641a65b8e7d0986f0af34a792b4b8a977523bee683553f8e0e48804f1", + "path": "tools/standards_identity/standards_identity/encoding.py", "state": "present", "uses": [ { @@ -7260,8 +6863,8 @@ ] }, { - "digest": "sha256:23f65d4a0243c42abb936d20c3f5b78841923553a02dafcde2d381e4251e4ef0", - "path": "tools/standards_contracts/standards_contracts/model.py", + "digest": "sha256:2179f8bd7b9ff5e0499b711c4be6287c5e03d3530bd164904e196e33878be56e", + "path": "tools/standards_identity/standards_identity/errors.py", "state": "present", "uses": [ { @@ -7277,8 +6880,8 @@ ] }, { - "digest": "sha256:41dc99455a4fb59df12e8d7a1a3dde1894ab5f8e600cb8923308d659589c2c8d", - "path": "tools/standards_contracts/standards_contracts/projection.py", + "digest": "sha256:596dc1dbc2778b1a3fac8cf4518c2cd4d2797252119cdc40774a8e1a2a396905", + "path": "tools/standards_metadata/pyproject.toml", "state": "present", "uses": [ { @@ -7294,8 +6897,8 @@ ] }, { - "digest": "sha256:3e612692b20c98b502b07d1eba52efc4cf2269eaf64bd37c0509767503f36722", - "path": "tools/standards_contracts/standards_contracts/runtime.py", + "digest": "sha256:7a29fe821866b34ee251969a6e976e7fc56cec9522688908d2b0015d946c68bb", + "path": "tools/standards_metadata/standards_metadata/__init__.py", "state": "present", "uses": [ { @@ -7311,20 +6914,25 @@ ] }, { - "digest": "sha256:dc53eab107beb6e7e1eea90f40455ddbd567dba0e40fd8c5bef93a44c66beed5", - "path": "tools/standards_contracts/standards_contracts/schema_structure.py", + "digest": "sha256:14719d8a568fbcf8850ee4dbd650e15808c7b07534aa9d434d647717775f7de9", + "path": "tools/standards_metadata/standards_metadata/corpus.py", "state": "present", "uses": [ { "check": "python-package-contract", "role": "package-contract-input", "suite": "a1c-public-cutover" + }, + { + "check": "current-structure", + "role": "registered-policy-impact", + "suite": "policy-semantic-impact" } ] }, { - "digest": "sha256:7f03d6dca26c71b46fed6cfbff867ad58bda590c97412cfdfa912522cfc62aca", - "path": "tools/standards_contracts/standards_contracts/union_selection.py", + "digest": "sha256:88f919d535c28a27946bb64c7670043de5529fd4dd4e43b845e37338bed02266", + "path": "tools/standards_metadata/standards_metadata/errors.py", "state": "present", "uses": [ { @@ -7335,50 +6943,55 @@ ] }, { - "digest": "sha256:a801fcd89046dfb1d8c126bcf97afa617cf4a62bc7736dc78a9a1097c782b976", - "path": "tools/standards_contracts/standards_contracts/validation_feedback.py", + "digest": "sha256:6ac65940d7c82145442e8b343201c3f2efe47f2e4f507abbc2b6bfabafced29e", + "path": "tools/standards_metadata/standards_metadata/loader.py", "state": "present", "uses": [ { "check": "python-package-contract", "role": "package-contract-input", "suite": "a1c-public-cutover" + }, + { + "check": "current-structure", + "role": "registered-policy-impact", + "suite": "policy-semantic-impact" } ] }, { - "digest": "sha256:8d8859b36d951bbf7a747da81d597df19b07b6653f1e36acc48b4b131b90c0a8", - "path": "tools/standards_engine/README.md", + "digest": "sha256:9090c26487afb5c476a660648c9a21e1934a709c437f109375efbf60f2c40a1f", + "path": "tools/standards_metadata/standards_metadata/model.py", "state": "present", "uses": [ { - "check": "root-links", - "role": "link-target", - "suite": "root-index-closure" + "check": "python-package-contract", + "role": "package-contract-input", + "suite": "a1c-public-cutover" } ] }, { - "digest": "sha256:065f284eeee398b764c8eebf151fec59727e3b0b1dad1fea942607129a110335", - "path": "tools/standards_engine/contracts/README.md", + "digest": "sha256:8b071568245437eb2f495d651ce282145db6aed0f81f8b660ea04ccf7ef0db80", + "path": "tools/standards_metadata/standards_metadata/paths.py", "state": "present", "uses": [ { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" + "check": "python-package-contract", + "role": "package-contract-input", + "suite": "a1c-public-cutover" } ] }, { - "digest": "sha256:ebaa5ddf6b8a3d8e95f4b70cef4f0116eb90168656973bd56d03ab12fd8940e2", - "path": "tools/standards_engine/contracts/a1-contract.schema.json", + "digest": "sha256:90081a9ae3a3e6d0005c34f3ae4448225ae50087b9c02ee1150fb9f39a82f047", + "path": "tools/standards_metadata/standards_metadata/policy_units.py", "state": "present", "uses": [ { - "check": "generated-projections", - "role": "schema", - "suite": "generated-contract-semantic-conformance" + "check": "python-package-contract", + "role": "package-contract-input", + "suite": "a1c-public-cutover" }, { "check": "current-structure", @@ -7388,14 +7001,14 @@ ] }, { - "digest": "sha256:09fea7fcd76652543bec933ee0e92e604bb42ba964ee332530783ffa641baadc", - "path": "tools/standards_engine/contracts/a1-interface.toml", + "digest": "sha256:d203344970e92235a06c13a7ed0b307a4611ccbe5b0ca4e55f0cb5445a56b73b", + "path": "tools/standards_metadata/standards_metadata/source.py", "state": "present", "uses": [ { - "check": "generated-projections", - "role": "interface", - "suite": "generated-contract-semantic-conformance" + "check": "python-package-contract", + "role": "package-contract-input", + "suite": "a1c-public-cutover" }, { "check": "current-structure", @@ -7405,14 +7018,14 @@ ] }, { - "digest": "sha256:489fea805dbfd6f84bcb28374b467da192d56243100c0a58d568d9acf6180e08", - "path": "tools/standards_engine/contracts/examples/a1-examples.json", + "digest": "sha256:ca59c9b44cc21fdca6bc92784581d3c40ddced5d80bae73772b7f146754e2d5c", + "path": "tools/standards_metadata/standards_metadata/suite_inputs.py", "state": "present", "uses": [ { - "check": "generated-projections", - "role": "examples", - "suite": "generated-contract-semantic-conformance" + "check": "python-package-contract", + "role": "package-contract-input", + "suite": "a1c-public-cutover" }, { "check": "current-structure", @@ -7422,25 +7035,20 @@ ] }, { - "digest": "sha256:af743a7e69652d5df3a0e010068d5557393359e5e63fda9bd97711903ad4627f", - "path": "tools/standards_engine/contracts/generated/agent-tools.json", + "digest": "sha256:e3675974a343e699e30b561a0eb394982920f4805c7d9499993f0245313c2f89", + "path": "tools/standards_metadata/standards_metadata/supporting_content.py", "state": "present", "uses": [ { - "check": "generated-projections", - "role": "generated-agent-tools", - "suite": "generated-contract-semantic-conformance" - }, - { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" + "check": "python-package-contract", + "role": "package-contract-input", + "suite": "a1c-public-cutover" } ] }, { - "digest": "sha256:83adcd9383a1f6756653dd944cb83fe87fc41da74c8906fbb55da632c03d1f4f", - "path": "tools/standards_engine/contracts/identity-fixtures.json", + "digest": "sha256:9f0c7bdb2212a46fff2318d235563d65421318eea1703e587bb000e125fc4091", + "path": "tools/standards_policy_impact/contracts/policy-impact-authoring-v2.toml", "state": "present", "uses": [ { @@ -7451,8 +7059,8 @@ ] }, { - "digest": "sha256:697bd43954c31ef84ec176d42c7c750c46e73a7693076ed07f928a36947f8849", - "path": "tools/standards_engine/pyproject.toml", + "digest": "sha256:28925b2b97f0c31fc0678fe2693cf30e78c01d7dd3b700cf83232b3bce28084b", + "path": "tools/standards_policy_impact/pyproject.toml", "state": "present", "uses": [ { @@ -7468,8 +7076,8 @@ ] }, { - "digest": "sha256:305317ccc14c4de68e142f4912f95a1a7bb0ac616d1107de11d061f8c7b6e4c3", - "path": "tools/standards_engine/standards_engine/__init__.py", + "digest": "sha256:ee4954dcfa56c051a85ad712dce52d85230cc5bdf4ff5882cf3beff1ee19af20", + "path": "tools/standards_policy_impact/standards_policy_impact/__init__.py", "state": "present", "uses": [ { @@ -7485,8 +7093,8 @@ ] }, { - "digest": "sha256:5bd60e1e3d3f0796503e2f29599a4b3b7503090d86a00fa37080554b038f5958", - "path": "tools/standards_engine/standards_engine/_generated_contract.py", + "digest": "sha256:b43946dda744f25073c39a57e11f3cb3f3493ce79bc4ed83a85cf2424c2d56eb", + "path": "tools/standards_policy_impact/standards_policy_impact/compiler.py", "state": "present", "uses": [ { @@ -7494,11 +7102,6 @@ "role": "package-contract-input", "suite": "a1c-public-cutover" }, - { - "check": "generated-projections", - "role": "generated-python", - "suite": "generated-contract-semantic-conformance" - }, { "check": "current-structure", "role": "registered-policy-impact", @@ -7507,8 +7110,8 @@ ] }, { - "digest": "sha256:e545029d0c37b3256c810a849c6fa3af8bfe4bf11415d208c4277c7e7a26b9fe", - "path": "tools/standards_engine/standards_engine/agent_navigation.py", + "digest": "sha256:3d0b1501c872ede7a78991305e6287db2d7952457769d3b5e5070af7ea5973c6", + "path": "tools/standards_policy_impact/standards_policy_impact/errors.py", "state": "present", "uses": [ { @@ -7519,8 +7122,8 @@ ] }, { - "digest": "sha256:9a39d95363aec431a62fa4dbced44ed4f3d87f9b4a302852a18b4396dad5d5d9", - "path": "tools/standards_engine/standards_engine/agent_workflow.py", + "digest": "sha256:d49cf43b7193b4c01a31b3dc4ae0dc1dbd26e72c78f32315fa9e3dd65817b793", + "path": "tools/standards_policy_impact/standards_policy_impact/model.py", "state": "present", "uses": [ { @@ -7531,8 +7134,8 @@ ] }, { - "digest": "sha256:a706f9214dd751411d1e158061dec8669fb03f1a2fd5fa2c72d94d9fe68c8289", - "path": "tools/standards_engine/standards_engine/analysis_projection.py", + "digest": "sha256:55d4198beaf10ef36c2e86970e54f7bfc4960117db75b0710a27470f386e185b", + "path": "tools/standards_policy_impact/standards_policy_impact/provenance.py", "state": "present", "uses": [ { @@ -7543,80 +7146,105 @@ ] }, { - "digest": "sha256:e518ed0dc72e7c1f7f73a7523f620ff06cf83decb173636f5639ee51667b527e", - "path": "tools/standards_engine/standards_engine/authoring.py", + "digest": "sha256:52d26a8caded1f75ac45d79c479f81985e88e9278e02df4deb362a6e5b102623", + "path": "tools/standards_snapshots/README.md", "state": "present", "uses": [ { - "check": "python-package-contract", - "role": "package-contract-input", - "suite": "a1c-public-cutover" + "check": "current-structure", + "role": "registered-policy-impact", + "suite": "policy-semantic-impact" } ] }, { - "digest": "sha256:c220a0c5dbc84c60ffd8e0d47dd50839db58a1d4c75c33cc8682ad5de733ddae", - "path": "tools/standards_engine/standards_engine/compiled_cache.py", + "digest": "sha256:bf7d9d341bb1c4e79016cac36e159369423605d8cc148d9211255dc85a5035fa", + "path": "tools/standards_snapshots/pyproject.toml", "state": "present", "uses": [ { "check": "python-package-contract", "role": "package-contract-input", "suite": "a1c-public-cutover" + }, + { + "check": "current-structure", + "role": "registered-policy-impact", + "suite": "policy-semantic-impact" } ] }, { - "digest": "sha256:865b499b737f476a2717b0086ca4a70ae844f01d52e8964d5dae1d5e71792394", - "path": "tools/standards_engine/standards_engine/consumer_authoring.py", + "digest": "sha256:bfb48d6fe1c8ffae55ad80a6e46e3a4ec5c78ffcc2d1d7835f3974c3b5ff89df", + "path": "tools/standards_snapshots/standards_snapshots/__init__.py", "state": "present", "uses": [ { "check": "python-package-contract", "role": "package-contract-input", "suite": "a1c-public-cutover" + }, + { + "check": "current-structure", + "role": "registered-policy-impact", + "suite": "policy-semantic-impact" } ] }, { - "digest": "sha256:7d2a0b4d4c6529d403a943caf0bcd5c98e5b33ef1dc33f141679fe78b027a437", - "path": "tools/standards_engine/standards_engine/context_projection.py", + "digest": "sha256:c11328c1b3f7fb217cad2d4f68b7cbe80f6b001a62782ceeb8a2d0788cc42aeb", + "path": "tools/standards_snapshots/standards_snapshots/errors.py", "state": "present", "uses": [ { "check": "python-package-contract", "role": "package-contract-input", "suite": "a1c-public-cutover" + }, + { + "check": "current-structure", + "role": "registered-policy-impact", + "suite": "policy-semantic-impact" } ] }, { - "digest": "sha256:9b6b18cc2da3e1d3dd473322108a07cc0b0315bbfd1614dd7157c045397ceb3b", - "path": "tools/standards_engine/standards_engine/contract_discovery.py", + "digest": "sha256:b1ca65c06fa1313a5ee4656ac6b3304419d511aea5a4592cce58a802eb7a8ac9", + "path": "tools/standards_snapshots/standards_snapshots/model.py", "state": "present", "uses": [ { "check": "python-package-contract", "role": "package-contract-input", "suite": "a1c-public-cutover" + }, + { + "check": "current-structure", + "role": "registered-policy-impact", + "suite": "policy-semantic-impact" } ] }, { - "digest": "sha256:db3061fe87b423c7d9f58248d95df2fb5c9ecfdf1ec7343ea4396dd7d1a438d2", - "path": "tools/standards_engine/standards_engine/decision_batch.py", + "digest": "sha256:2491925afe9181f50226571d009f01b1618b315123c33cd2464753bd2e959a42", + "path": "tools/standards_snapshots/standards_snapshots/module.py", "state": "present", "uses": [ { "check": "python-package-contract", "role": "package-contract-input", "suite": "a1c-public-cutover" + }, + { + "check": "current-structure", + "role": "registered-policy-impact", + "suite": "policy-semantic-impact" } ] }, { - "digest": "sha256:ee994e8cb911405bcb1f97508d910f906af22ce0a3040200f844ff3e52de2e2b", - "path": "tools/standards_engine/standards_engine/engine.py", + "digest": "sha256:5c617b32e6eb103209a3a347d85b3e567f7e4caf8b2fabfa713612c1f96a16be", + "path": "tools/standards_snapshots/standards_snapshots/store.py", "state": "present", "uses": [ { @@ -7632,15 +7260,10 @@ ] }, { - "digest": "sha256:c9391ac17beb93cd11d0a4dccde3cb46f6f6842981536233e6d96de51948eee8", - "path": "tools/standards_engine/standards_engine/evidence_maintenance.py", + "digest": "sha256:e98ec19c3df6250196975026c460893c7844079f882629f3f0b991ff8aac60dc", + "path": "tools/standards_snapshots/tests/test_module.py", "state": "present", "uses": [ - { - "check": "python-package-contract", - "role": "package-contract-input", - "suite": "a1c-public-cutover" - }, { "check": "current-structure", "role": "registered-policy-impact", @@ -7649,80 +7272,100 @@ ] }, { - "digest": "sha256:faaedd424f81558a11724ab735f0631975ab15c1582e51cb33b28e3e46d5063b", - "path": "tools/standards_engine/standards_engine/input_feedback.py", + "digest": "sha256:7401b1ce117276e34c806870ec103d91a35c2d80ae413fd741a5f81547f81eb6", + "path": "tools/standards_snapshots/tests/test_store.py", "state": "present", "uses": [ { - "check": "python-package-contract", - "role": "package-contract-input", - "suite": "a1c-public-cutover" + "check": "current-structure", + "role": "registered-policy-impact", + "suite": "policy-semantic-impact" } ] }, { - "digest": "sha256:bc14652d3aa78ea400495d7f89fe9c4662c4de16acf759cac41d8279239a2a78", - "path": "tools/standards_engine/standards_engine/interaction_observer.py", + "digest": "sha256:e56834537ad6ee2ef8a243141ef554c1cb24cfdc6b5b0d543e998892920a766b", + "path": "tools/standards_verifier/README.md", "state": "present", "uses": [ { - "check": "python-package-contract", - "role": "package-contract-input", - "suite": "a1c-public-cutover" + "check": "root-links", + "role": "link-target", + "suite": "root-index-closure" } ] }, { - "digest": "sha256:bac3a3330851489f35542e775ecf61c2f04822b17d23806803b8da8d2fb4b506", - "path": "tools/standards_engine/standards_engine/logical_authoring.py", + "digest": "sha256:94009a1e1f42d9cb6d526e440c21c3e835cb0ffa2d42a8ba4fd83acff8281274", + "path": "tools/standards_verifier/pyproject.toml", "state": "present", "uses": [ { "check": "python-package-contract", "role": "package-contract-input", "suite": "a1c-public-cutover" + }, + { + "check": "current-structure", + "role": "registered-policy-impact", + "suite": "policy-semantic-impact" } ] }, { - "digest": "sha256:899c6bb6605a9b6e07bee7992c48120f3dd10fe2a8bf77fa9d20a35a3575ab22", - "path": "tools/standards_engine/standards_engine/mcp.py", + "digest": "sha256:df0fe1fded4e6acfa85c0342285064016cf70f7aeb6e351ae7cf4c26f81b2c0f", + "path": "tools/standards_verifier/standards_verifier/__init__.py", "state": "present", "uses": [ { "check": "python-package-contract", "role": "package-contract-input", "suite": "a1c-public-cutover" + }, + { + "check": "current-structure", + "role": "registered-policy-impact", + "suite": "policy-semantic-impact" } ] }, { - "digest": "sha256:c6527bf9f3338e21dfd1e5e9e30933cf98c28dc6c326906892717e7c434cb74d", - "path": "tools/standards_engine/standards_engine/mcp_catalog.py", + "digest": "sha256:4fd26bc3eba2945d3f9ca888a9a7eb02ac4e2dcca9527a578a4d934e25fcfab3", + "path": "tools/standards_verifier/standards_verifier/checks/__init__.py", "state": "present", "uses": [ { "check": "python-package-contract", "role": "package-contract-input", "suite": "a1c-public-cutover" + }, + { + "check": "current-structure", + "role": "registered-policy-impact", + "suite": "policy-semantic-impact" } ] }, { - "digest": "sha256:0c8b56d1a914306f954eaa9c24fb78d56415912f8668f486d9f88982d84e57c2", - "path": "tools/standards_engine/standards_engine/navigation_indexes.py", + "digest": "sha256:84eeaaaadec2526b56e1d17efac213ff4fd30dfc44bc3e4fb5776486a5c32b64", + "path": "tools/standards_verifier/standards_verifier/checks/contract_projection.py", "state": "present", "uses": [ { "check": "python-package-contract", "role": "package-contract-input", "suite": "a1c-public-cutover" + }, + { + "check": "current-structure", + "role": "registered-policy-impact", + "suite": "policy-semantic-impact" } ] }, { - "digest": "sha256:bcba59c19e69bcaf683c4266430933cb54c086d08c428ad0654c0f0db35c2881", - "path": "tools/standards_engine/standards_engine/operation_materials.py", + "digest": "sha256:0ebf225e5597c9df33c13ad3b52d6edb847bc0b3fa36a4df955c69f971825492", + "path": "tools/standards_verifier/standards_verifier/checks/literal_matching.py", "state": "present", "uses": [ { @@ -7733,8 +7376,8 @@ ] }, { - "digest": "sha256:2188fd6ca71176ae31db92cfbf4c1be0286b09c6025d5eed75a1dac4b3af3518", - "path": "tools/standards_engine/standards_engine/projection_continuation.py", + "digest": "sha256:fc1475e2653af9972776f32bb4c5c9098dd7b3de7d536db95af95800b76bc64f", + "path": "tools/standards_verifier/standards_verifier/checks/markdown.py", "state": "present", "uses": [ { @@ -7745,20 +7388,25 @@ ] }, { - "digest": "sha256:e1039af76be923d41362e81d35fb7025c59246aae8ea0f0a106cc2aa39ce9d0e", - "path": "tools/standards_engine/standards_engine/relationship_vocabulary.py", + "digest": "sha256:56caef06f81ab095f10a5a174022f9ea7c1a362cdb9c4b50fd45a4ee054cdf15", + "path": "tools/standards_verifier/standards_verifier/checks/markdown_link_coverage.py", "state": "present", "uses": [ { "check": "python-package-contract", "role": "package-contract-input", "suite": "a1c-public-cutover" + }, + { + "check": "current-structure", + "role": "registered-policy-impact", + "suite": "policy-semantic-impact" } ] }, { - "digest": "sha256:53f070736d679418213878dc7cd3e6849357d1351fd621cfb6bf8c018612d4fe", - "path": "tools/standards_engine/standards_engine/rendering.py", + "digest": "sha256:2a594dda5c4cb718a16e0cd09ed04df4b16f841004a170442c3bb4c36864ab3c", + "path": "tools/standards_verifier/standards_verifier/checks/markdown_links.py", "state": "present", "uses": [ { @@ -7774,8 +7422,8 @@ ] }, { - "digest": "sha256:48a61c2029c39f46e4bd533aba570cad4e481e35d8713d5d9365ade4d91bfc2a", - "path": "tools/standards_engine/standards_engine/request_evidence.py", + "digest": "sha256:4973ad8da5931d0905096ef51b420c8276a9171cc5c568ce3a003db4476ba136", + "path": "tools/standards_verifier/standards_verifier/checks/markdown_targets.py", "state": "present", "uses": [ { @@ -7786,32 +7434,42 @@ ] }, { - "digest": "sha256:2c5ca992b532a09b4bbd343e094e3686fefac2d3e76a9accbd911be966d2b46a", - "path": "tools/standards_engine/standards_engine/routing_edits.py", + "digest": "sha256:0f3420a7f0191460c2a918136948ef061e220536e709d8c4dc373603c5d1e870", + "path": "tools/standards_verifier/standards_verifier/checks/metadata.py", "state": "present", "uses": [ { "check": "python-package-contract", "role": "package-contract-input", "suite": "a1c-public-cutover" + }, + { + "check": "current-structure", + "role": "registered-policy-impact", + "suite": "policy-semantic-impact" } ] }, { - "digest": "sha256:24393890b46a4f56ba0a4f59e724f924e842eb0aa764b8c9f104672e9e995fdd", - "path": "tools/standards_engine/standards_engine/routing_inputs.py", + "digest": "sha256:cf0774afb622cb1f30d2377ab1c3a9a86017d8c98c382a18b8a3b6117a8507ea", + "path": "tools/standards_verifier/standards_verifier/checks/metadata_route.py", "state": "present", "uses": [ { "check": "python-package-contract", "role": "package-contract-input", "suite": "a1c-public-cutover" + }, + { + "check": "current-structure", + "role": "registered-policy-impact", + "suite": "policy-semantic-impact" } ] }, { - "digest": "sha256:5237dbc3ca5db69540b90c92e5f03279b2cfcad5e0cbf4fc8cf93e424f77ca1e", - "path": "tools/standards_engine/standards_engine/runtime_identity.py", + "digest": "sha256:c7266c0564b9ee02944fc4eb12d66cc20d604fd4ddb7f051ed77d01e9fe4466e", + "path": "tools/standards_verifier/standards_verifier/checks/plan_contract.py", "state": "present", "uses": [ { @@ -7822,20 +7480,25 @@ ] }, { - "digest": "sha256:9e16bf974c02ad5194a02a7836a9a8c8d4eca56b4ea5da821c1ab312e2832469", - "path": "tools/standards_engine/standards_engine/supporting.py", + "digest": "sha256:e28442711d42d69bdb9348ec01923daefd49cec2be8850239c9489fb6cb71dc9", + "path": "tools/standards_verifier/standards_verifier/checks/policy_impact.py", "state": "present", "uses": [ { "check": "python-package-contract", "role": "package-contract-input", "suite": "a1c-public-cutover" + }, + { + "check": "current-structure", + "role": "registered-policy-impact", + "suite": "policy-semantic-impact" } ] }, { - "digest": "sha256:2f11bf3e9c85c9a5ed073c884debf3010a36a0b4d6b60c5b38a52b9cb846afd7", - "path": "tools/standards_engine/standards_engine/supporting_authoring.py", + "digest": "sha256:d41f8ed712ee2bcf301d797168d172cb04907d85b7a75c9adffc2cfcfdc3454b", + "path": "tools/standards_verifier/standards_verifier/checks/predicates.py", "state": "present", "uses": [ { @@ -7846,8 +7509,8 @@ ] }, { - "digest": "sha256:52f6762cc0c94c40df466a632cec7612eec5fa6479b486b523835cd2c2f245b2", - "path": "tools/standards_engine/standards_engine/tools.py", + "digest": "sha256:a292b6d7aa44f3cbc2b1876ca46935aa7c1edf602b49fddf47308eba5ec7dca5", + "path": "tools/standards_verifier/standards_verifier/checks/python_package_contract.py", "state": "present", "uses": [ { @@ -7863,22 +7526,15 @@ ] }, { - "digest": "sha256:8ce8775aab3f3ff577d1c71a9d1b40d8dd4fef3650aa5cd0221155402a48e1b4", - "path": "tools/standards_engine/standards_engine/workflow_presentation.py", + "digest": "sha256:439b9ee8fe5cdd890cf8a7b3b43a6f19293c9e456579c68b5fab556543a65fe8", + "path": "tools/standards_verifier/standards_verifier/checks/table.py", "state": "present", "uses": [ { "check": "python-package-contract", "role": "package-contract-input", "suite": "a1c-public-cutover" - } - ] - }, - { - "digest": "sha256:7f51e403f03f5c57be8b1ca5736a79bcf139c87dd9eb4703ce3f7e59f1ba3d01", - "path": "tools/standards_engine/tests/test_analysis.py", - "state": "present", - "uses": [ + }, { "check": "current-structure", "role": "registered-policy-impact", @@ -7887,165 +7543,56 @@ ] }, { - "digest": "sha256:2a5e6761f159c63e3c79f8fed0d90e1edcf987ea78a86fc9878a2866c840ef03", - "path": "tools/standards_engine/tests/test_coverage_publication.py", + "digest": "sha256:6038575351f6700b2e54331d4a69506c9e7f43bb9adbd27880e92879576ab76c", + "path": "tools/standards_verifier/standards_verifier/cli.py", "state": "present", "uses": [ { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" + "check": "python-package-contract", + "role": "package-contract-input", + "suite": "a1c-public-cutover" } ] }, { - "digest": "sha256:09464a63f418e196c4e50bf86d83c85139f9f6035becbc22cf2bf44c02917d72", - "path": "tools/standards_engine/tests/test_evidence_maintenance.py", - "state": "present", - "uses": [ - { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" - } - ] - }, - { - "digest": "sha256:b14540a5826d5f2d490a7e5c4f5791b383ad11b9dd48e4fee460dc507ccb5474", - "path": "tools/standards_engine/tests/test_navigation.py", - "state": "present", - "uses": [ - { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" - } - ] - }, - { - "digest": "sha256:54d7e422c84555e6123c202d4fbc98ae7e32614b333c023b8a77dff4991fb16b", - "path": "tools/standards_graph/pyproject.toml", - "state": "present", - "uses": [ - { - "check": "python-package-contract", - "role": "package-contract-input", - "suite": "a1c-public-cutover" - }, - { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" - } - ] - }, - { - "digest": "sha256:bca9f62d323417605a3ad2e9dc77c44e95b4aa7106f59bbf53ec115153095c5f", - "path": "tools/standards_graph/standards_graph/__init__.py", - "state": "present", - "uses": [ - { - "check": "python-package-contract", - "role": "package-contract-input", - "suite": "a1c-public-cutover" - }, - { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" - } - ] - }, - { - "digest": "sha256:153921a40d785c6fc6facb8b090d5eefdde0123166a40ee85f8237f0c122b375", - "path": "tools/standards_graph/standards_graph/metadata.py", - "state": "present", - "uses": [ - { - "check": "python-package-contract", - "role": "package-contract-input", - "suite": "a1c-public-cutover" - } - ] - }, - { - "digest": "sha256:5f7320281ce1b2ae5884b41b9e65cb4c98bd1197e0468f19689f767301c66ba5", - "path": "tools/standards_graph/standards_graph/policy_units.py", - "state": "present", - "uses": [ - { - "check": "python-package-contract", - "role": "package-contract-input", - "suite": "a1c-public-cutover" - } - ] - }, - { - "digest": "sha256:89a711ce6e71e5508d5bd2e2f79fc3e2c9189ff90fbaca81a0134cd80f25f0b5", - "path": "tools/standards_graph/standards_graph/repository.py", + "digest": "sha256:45e5a3af333253b2a93d5c0f3802b803be3603b37a61c557a0794a2459b7c8f6", + "path": "tools/standards_verifier/standards_verifier/config.py", "state": "present", "uses": [ { "check": "python-package-contract", "role": "package-contract-input", "suite": "a1c-public-cutover" - }, - { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" - } - ] - }, - { - "digest": "sha256:1838ceb220964296fe1af9f0e25ea91b076972a8ee452c684da13e0f6db86709", - "path": "tools/standards_identity/README.md", - "state": "present", - "uses": [ - { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" } ] }, { - "digest": "sha256:d013e28962ada684dc0757541b935bd00686abf906e9d89718cc3248505af717", - "path": "tools/standards_identity/pyproject.toml", + "digest": "sha256:d4197095b0a6de9088a26ff9452452093cf5e7df637cd2f46c717db12d4f9289", + "path": "tools/standards_verifier/standards_verifier/diagnostics.py", "state": "present", "uses": [ { "check": "python-package-contract", "role": "package-contract-input", "suite": "a1c-public-cutover" - }, - { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" } ] }, { - "digest": "sha256:330770de68a1688aa5833d2ec01fb14684eeabd53b0a45fb6138709a98478fca", - "path": "tools/standards_identity/standards_identity/__init__.py", + "digest": "sha256:ba53599cdc5927b018daf020a55cb12c474fde1ae26d99e0caaaad5fca59f979", + "path": "tools/standards_verifier/standards_verifier/engine.py", "state": "present", "uses": [ { "check": "python-package-contract", "role": "package-contract-input", "suite": "a1c-public-cutover" - }, - { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" } ] }, { - "digest": "sha256:611655e641a65b8e7d0986f0af34a792b4b8a977523bee683553f8e0e48804f1", - "path": "tools/standards_identity/standards_identity/encoding.py", + "digest": "sha256:752db9aab7b47e4e6431bf2772d15550963c25034df773154c2507950b611269", + "path": "tools/standards_verifier/standards_verifier/entrypoints.py", "state": "present", "uses": [ { @@ -8061,8 +7608,8 @@ ] }, { - "digest": "sha256:2179f8bd7b9ff5e0499b711c4be6287c5e03d3530bd164904e196e33878be56e", - "path": "tools/standards_identity/standards_identity/errors.py", + "digest": "sha256:4423b8310e8760e9f85d4ab6df1a644f8ee8e8038236d3ee016d66def6b0d15a", + "path": "tools/standards_verifier/standards_verifier/git_reachability.py", "state": "present", "uses": [ { @@ -8078,42 +7625,32 @@ ] }, { - "digest": "sha256:596dc1dbc2778b1a3fac8cf4518c2cd4d2797252119cdc40774a8e1a2a396905", - "path": "tools/standards_metadata/pyproject.toml", + "digest": "sha256:a2daac9fcba96192e64bd0161c9af3f3878e6f833078415700eddc30698c2aec", + "path": "tools/standards_verifier/standards_verifier/graph_adapters.py", "state": "present", "uses": [ { "check": "python-package-contract", "role": "package-contract-input", "suite": "a1c-public-cutover" - }, - { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" } ] }, { - "digest": "sha256:c15dd073190a0d427a5d1e8879bd46112fe96343b38de1f7c20a823cbbb305bd", - "path": "tools/standards_metadata/standards_metadata/__init__.py", + "digest": "sha256:c54c8c8967dec15675b3a9dfc5c0bcca118a63edf0eec0f99038221cda134ca7", + "path": "tools/standards_verifier/standards_verifier/input_sources.py", "state": "present", "uses": [ { "check": "python-package-contract", "role": "package-contract-input", "suite": "a1c-public-cutover" - }, - { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" } ] }, { - "digest": "sha256:14719d8a568fbcf8850ee4dbd650e15808c7b07534aa9d434d647717775f7de9", - "path": "tools/standards_metadata/standards_metadata/corpus.py", + "digest": "sha256:5b5b87b7eee4dfa98776459ac50e02af29b62eb602842e0b547a190b74acbe02", + "path": "tools/standards_verifier/standards_verifier/model.py", "state": "present", "uses": [ { @@ -8129,8 +7666,8 @@ ] }, { - "digest": "sha256:88f919d535c28a27946bb64c7670043de5529fd4dd4e43b845e37338bed02266", - "path": "tools/standards_metadata/standards_metadata/errors.py", + "digest": "sha256:de45013a15b4989767b250ef5e3fa4fb54a41d52b8a1b480a67d8986f9ea65e3", + "path": "tools/standards_verifier/standards_verifier/paths.py", "state": "present", "uses": [ { @@ -8141,8 +7678,8 @@ ] }, { - "digest": "sha256:4f648ce836bc5a1976a1823581a3e7840743ab064fdc87056300dd547ef10e42", - "path": "tools/standards_metadata/standards_metadata/loader.py", + "digest": "sha256:d2505473e3c78783c7c3f50f4072e4830c80ae9d91cbb2b09ece8aa85b68612e", + "path": "tools/standards_verifier/standards_verifier/policy_impact.py", "state": "present", "uses": [ { @@ -8158,32 +7695,8 @@ ] }, { - "digest": "sha256:9090c26487afb5c476a660648c9a21e1934a709c437f109375efbf60f2c40a1f", - "path": "tools/standards_metadata/standards_metadata/model.py", - "state": "present", - "uses": [ - { - "check": "python-package-contract", - "role": "package-contract-input", - "suite": "a1c-public-cutover" - } - ] - }, - { - "digest": "sha256:8b071568245437eb2f495d651ce282145db6aed0f81f8b660ea04ccf7ef0db80", - "path": "tools/standards_metadata/standards_metadata/paths.py", - "state": "present", - "uses": [ - { - "check": "python-package-contract", - "role": "package-contract-input", - "suite": "a1c-public-cutover" - } - ] - }, - { - "digest": "sha256:90081a9ae3a3e6d0005c34f3ae4448225ae50087b9c02ee1150fb9f39a82f047", - "path": "tools/standards_metadata/standards_metadata/policy_units.py", + "digest": "sha256:717bc3fe807cd00a6da5b147a0a7923c009ac594157a76ed43e18feabb8413d7", + "path": "tools/standards_verifier/standards_verifier/python_packages.py", "state": "present", "uses": [ { @@ -8199,8 +7712,8 @@ ] }, { - "digest": "sha256:d203344970e92235a06c13a7ed0b307a4611ccbe5b0ca4e55f0cb5445a56b73b", - "path": "tools/standards_metadata/standards_metadata/source.py", + "digest": "sha256:38cf46ae2a908eeb5873096834a3ad727d2539404b9666cdb5c9319b51c6f8e3", + "path": "tools/standards_verifier/standards_verifier/repository_graph.py", "state": "present", "uses": [ { @@ -8216,8 +7729,8 @@ ] }, { - "digest": "sha256:ca59c9b44cc21fdca6bc92784581d3c40ddced5d80bae73772b7f146754e2d5c", - "path": "tools/standards_metadata/standards_metadata/suite_inputs.py", + "digest": "sha256:272c4c522ea65e726705c7da73224f16fe405c09630d8db22c5642d6ab718bae", + "path": "tools/standards_verifier/standards_verifier/suite_inputs.py", "state": "present", "uses": [ { @@ -8233,20 +7746,8 @@ ] }, { - "digest": "sha256:e3675974a343e699e30b561a0eb394982920f4805c7d9499993f0245313c2f89", - "path": "tools/standards_metadata/standards_metadata/supporting_content.py", - "state": "present", - "uses": [ - { - "check": "python-package-contract", - "role": "package-contract-input", - "suite": "a1c-public-cutover" - } - ] - }, - { - "digest": "sha256:9f0c7bdb2212a46fff2318d235563d65421318eea1703e587bb000e125fc4091", - "path": "tools/standards_policy_impact/contracts/policy-impact-authoring-v2.toml", + "digest": "sha256:ce9d010a24ec3074da9d9110b8d5f90f977559c22d2f6a175ae0a1acf73b87cb", + "path": "tools/standards_verifier/tests/test_policy_impact.py", "state": "present", "uses": [ { @@ -8257,15 +7758,10 @@ ] }, { - "digest": "sha256:28925b2b97f0c31fc0678fe2693cf30e78c01d7dd3b700cf83232b3bce28084b", - "path": "tools/standards_policy_impact/pyproject.toml", + "digest": "sha256:7f64e6b43152dfd51230daf2773ff7cba8113c27e708c7d6ca829a041ba6d7c3", + "path": "tools/standards_verifier/tests/test_python_package_contract.py", "state": "present", "uses": [ - { - "check": "python-package-contract", - "role": "package-contract-input", - "suite": "a1c-public-cutover" - }, { "check": "current-structure", "role": "registered-policy-impact", @@ -8274,8 +7770,8 @@ ] }, { - "digest": "sha256:ee4954dcfa56c051a85ad712dce52d85230cc5bdf4ff5882cf3beff1ee19af20", - "path": "tools/standards_policy_impact/standards_policy_impact/__init__.py", + "digest": "sha256:77ac6c2f233c2ac442230fe0a28e74131ab4a507b50c768dcfc108f8e75c573e", + "path": "tools/standards_verifier/verify.py", "state": "present", "uses": [ { @@ -8291,8 +7787,8 @@ ] }, { - "digest": "sha256:b43946dda744f25073c39a57e11f3cb3f3493ce79bc4ed83a85cf2424c2d56eb", - "path": "tools/standards_policy_impact/standards_policy_impact/compiler.py", + "digest": "sha256:92f32562c4b748c3a174faa8392966a928e865098a6d2c52ba008cc8b212bd9e", + "path": "tools/verify_git_reachability.py", "state": "present", "uses": [ { @@ -8300,2489 +7796,22 @@ "role": "package-contract-input", "suite": "a1c-public-cutover" }, - { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" - } - ] - }, - { - "digest": "sha256:3d0b1501c872ede7a78991305e6287db2d7952457769d3b5e5070af7ea5973c6", - "path": "tools/standards_policy_impact/standards_policy_impact/errors.py", - "state": "present", - "uses": [ - { - "check": "python-package-contract", - "role": "package-contract-input", - "suite": "a1c-public-cutover" - } - ] - }, - { - "digest": "sha256:d49cf43b7193b4c01a31b3dc4ae0dc1dbd26e72c78f32315fa9e3dd65817b793", - "path": "tools/standards_policy_impact/standards_policy_impact/model.py", - "state": "present", - "uses": [ - { - "check": "python-package-contract", - "role": "package-contract-input", - "suite": "a1c-public-cutover" - } - ] - }, - { - "digest": "sha256:55d4198beaf10ef36c2e86970e54f7bfc4960117db75b0710a27470f386e185b", - "path": "tools/standards_policy_impact/standards_policy_impact/provenance.py", - "state": "present", - "uses": [ - { - "check": "python-package-contract", - "role": "package-contract-input", - "suite": "a1c-public-cutover" - } - ] - }, - { - "digest": "sha256:828be47647e4332067893b79a508e85ed65ff1d524c41daf8f09fa41f6b7d2a2", - "path": "tools/standards_snapshots/README.md", - "state": "present", - "uses": [ - { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" - } - ] - }, - { - "digest": "sha256:bf7d9d341bb1c4e79016cac36e159369423605d8cc148d9211255dc85a5035fa", - "path": "tools/standards_snapshots/pyproject.toml", - "state": "present", - "uses": [ - { - "check": "python-package-contract", - "role": "package-contract-input", - "suite": "a1c-public-cutover" - }, - { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" - } - ] - }, - { - "digest": "sha256:bfb48d6fe1c8ffae55ad80a6e46e3a4ec5c78ffcc2d1d7835f3974c3b5ff89df", - "path": "tools/standards_snapshots/standards_snapshots/__init__.py", - "state": "present", - "uses": [ - { - "check": "python-package-contract", - "role": "package-contract-input", - "suite": "a1c-public-cutover" - }, - { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" - } - ] - }, - { - "digest": "sha256:c11328c1b3f7fb217cad2d4f68b7cbe80f6b001a62782ceeb8a2d0788cc42aeb", - "path": "tools/standards_snapshots/standards_snapshots/errors.py", - "state": "present", - "uses": [ - { - "check": "python-package-contract", - "role": "package-contract-input", - "suite": "a1c-public-cutover" - }, - { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" - } - ] - }, - { - "digest": "sha256:b1ca65c06fa1313a5ee4656ac6b3304419d511aea5a4592cce58a802eb7a8ac9", - "path": "tools/standards_snapshots/standards_snapshots/model.py", - "state": "present", - "uses": [ - { - "check": "python-package-contract", - "role": "package-contract-input", - "suite": "a1c-public-cutover" - }, - { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" - } - ] - }, - { - "digest": "sha256:0725a0c3a208d7e773f15feb3129aec241caec75cb758e45dfc2f7757216bff9", - "path": "tools/standards_snapshots/standards_snapshots/module.py", - "state": "present", - "uses": [ - { - "check": "python-package-contract", - "role": "package-contract-input", - "suite": "a1c-public-cutover" - }, - { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" - } - ] - }, - { - "digest": "sha256:bda178630b8226af0de5c42a7da6290ace2ed1745e3d2a99057deb0bae6ac617", - "path": "tools/standards_snapshots/standards_snapshots/store.py", - "state": "present", - "uses": [ - { - "check": "python-package-contract", - "role": "package-contract-input", - "suite": "a1c-public-cutover" - }, - { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" - } - ] - }, - { - "digest": "sha256:e98ec19c3df6250196975026c460893c7844079f882629f3f0b991ff8aac60dc", - "path": "tools/standards_snapshots/tests/test_module.py", - "state": "present", - "uses": [ - { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" - } - ] - }, - { - "digest": "sha256:7401b1ce117276e34c806870ec103d91a35c2d80ae413fd741a5f81547f81eb6", - "path": "tools/standards_snapshots/tests/test_store.py", - "state": "present", - "uses": [ - { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" - } - ] - }, - { - "digest": "sha256:32b8f1d3c681bcc9cbcb81fc68a57d668653a266b2abb7d8b8ac28a815f95ef1", - "path": "tools/standards_verifier/README.md", - "state": "present", - "uses": [ - { - "check": "root-links", - "role": "link-target", - "suite": "root-index-closure" - } - ] - }, - { - "digest": "sha256:94009a1e1f42d9cb6d526e440c21c3e835cb0ffa2d42a8ba4fd83acff8281274", - "path": "tools/standards_verifier/pyproject.toml", - "state": "present", - "uses": [ - { - "check": "python-package-contract", - "role": "package-contract-input", - "suite": "a1c-public-cutover" - }, - { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" - } - ] - }, - { - "digest": "sha256:df0fe1fded4e6acfa85c0342285064016cf70f7aeb6e351ae7cf4c26f81b2c0f", - "path": "tools/standards_verifier/standards_verifier/__init__.py", - "state": "present", - "uses": [ - { - "check": "python-package-contract", - "role": "package-contract-input", - "suite": "a1c-public-cutover" - }, - { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" - } - ] - }, - { - "digest": "sha256:4fd26bc3eba2945d3f9ca888a9a7eb02ac4e2dcca9527a578a4d934e25fcfab3", - "path": "tools/standards_verifier/standards_verifier/checks/__init__.py", - "state": "present", - "uses": [ - { - "check": "python-package-contract", - "role": "package-contract-input", - "suite": "a1c-public-cutover" - }, - { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" - } - ] - }, - { - "digest": "sha256:84eeaaaadec2526b56e1d17efac213ff4fd30dfc44bc3e4fb5776486a5c32b64", - "path": "tools/standards_verifier/standards_verifier/checks/contract_projection.py", - "state": "present", - "uses": [ - { - "check": "python-package-contract", - "role": "package-contract-input", - "suite": "a1c-public-cutover" - }, - { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" - } - ] - }, - { - "digest": "sha256:0ebf225e5597c9df33c13ad3b52d6edb847bc0b3fa36a4df955c69f971825492", - "path": "tools/standards_verifier/standards_verifier/checks/literal_matching.py", - "state": "present", - "uses": [ - { - "check": "python-package-contract", - "role": "package-contract-input", - "suite": "a1c-public-cutover" - } - ] - }, - { - "digest": "sha256:fc1475e2653af9972776f32bb4c5c9098dd7b3de7d536db95af95800b76bc64f", - "path": "tools/standards_verifier/standards_verifier/checks/markdown.py", - "state": "present", - "uses": [ - { - "check": "python-package-contract", - "role": "package-contract-input", - "suite": "a1c-public-cutover" - } - ] - }, - { - "digest": "sha256:56caef06f81ab095f10a5a174022f9ea7c1a362cdb9c4b50fd45a4ee054cdf15", - "path": "tools/standards_verifier/standards_verifier/checks/markdown_link_coverage.py", - "state": "present", - "uses": [ - { - "check": "python-package-contract", - "role": "package-contract-input", - "suite": "a1c-public-cutover" - }, - { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" - } - ] - }, - { - "digest": "sha256:2a594dda5c4cb718a16e0cd09ed04df4b16f841004a170442c3bb4c36864ab3c", - "path": "tools/standards_verifier/standards_verifier/checks/markdown_links.py", - "state": "present", - "uses": [ - { - "check": "python-package-contract", - "role": "package-contract-input", - "suite": "a1c-public-cutover" - }, - { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" - } - ] - }, - { - "digest": "sha256:4973ad8da5931d0905096ef51b420c8276a9171cc5c568ce3a003db4476ba136", - "path": "tools/standards_verifier/standards_verifier/checks/markdown_targets.py", - "state": "present", - "uses": [ - { - "check": "python-package-contract", - "role": "package-contract-input", - "suite": "a1c-public-cutover" - } - ] - }, - { - "digest": "sha256:dea89749eea74df0b1194907d5507d6dc74cf1e74c18e1861e4a5e3c99613dcd", - "path": "tools/standards_verifier/standards_verifier/checks/metadata.py", - "state": "present", - "uses": [ - { - "check": "python-package-contract", - "role": "package-contract-input", - "suite": "a1c-public-cutover" - }, - { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" - } - ] - }, - { - "digest": "sha256:42a7223e6aad21bf6bf4239c0e37751b6c0f5499db78e2b3725d0cec95525812", - "path": "tools/standards_verifier/standards_verifier/checks/metadata_route.py", - "state": "present", - "uses": [ - { - "check": "python-package-contract", - "role": "package-contract-input", - "suite": "a1c-public-cutover" - }, - { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" - } - ] - }, - { - "digest": "sha256:c7266c0564b9ee02944fc4eb12d66cc20d604fd4ddb7f051ed77d01e9fe4466e", - "path": "tools/standards_verifier/standards_verifier/checks/plan_contract.py", - "state": "present", - "uses": [ - { - "check": "python-package-contract", - "role": "package-contract-input", - "suite": "a1c-public-cutover" - } - ] - }, - { - "digest": "sha256:e28442711d42d69bdb9348ec01923daefd49cec2be8850239c9489fb6cb71dc9", - "path": "tools/standards_verifier/standards_verifier/checks/policy_impact.py", - "state": "present", - "uses": [ - { - "check": "python-package-contract", - "role": "package-contract-input", - "suite": "a1c-public-cutover" - }, - { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" - } - ] - }, - { - "digest": "sha256:d41f8ed712ee2bcf301d797168d172cb04907d85b7a75c9adffc2cfcfdc3454b", - "path": "tools/standards_verifier/standards_verifier/checks/predicates.py", - "state": "present", - "uses": [ - { - "check": "python-package-contract", - "role": "package-contract-input", - "suite": "a1c-public-cutover" - } - ] - }, - { - "digest": "sha256:a292b6d7aa44f3cbc2b1876ca46935aa7c1edf602b49fddf47308eba5ec7dca5", - "path": "tools/standards_verifier/standards_verifier/checks/python_package_contract.py", - "state": "present", - "uses": [ - { - "check": "python-package-contract", - "role": "package-contract-input", - "suite": "a1c-public-cutover" - }, - { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" - } - ] - }, - { - "digest": "sha256:439b9ee8fe5cdd890cf8a7b3b43a6f19293c9e456579c68b5fab556543a65fe8", - "path": "tools/standards_verifier/standards_verifier/checks/table.py", - "state": "present", - "uses": [ - { - "check": "python-package-contract", - "role": "package-contract-input", - "suite": "a1c-public-cutover" - }, - { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" - } - ] - }, - { - "digest": "sha256:9bd69963a333f0590c47c86f23425412ab9358ffe2c94d676c23ba40c5b68c34", - "path": "tools/standards_verifier/standards_verifier/cli.py", - "state": "present", - "uses": [ - { - "check": "python-package-contract", - "role": "package-contract-input", - "suite": "a1c-public-cutover" - } - ] - }, - { - "digest": "sha256:45e5a3af333253b2a93d5c0f3802b803be3603b37a61c557a0794a2459b7c8f6", - "path": "tools/standards_verifier/standards_verifier/config.py", - "state": "present", - "uses": [ - { - "check": "python-package-contract", - "role": "package-contract-input", - "suite": "a1c-public-cutover" - } - ] - }, - { - "digest": "sha256:d4197095b0a6de9088a26ff9452452093cf5e7df637cd2f46c717db12d4f9289", - "path": "tools/standards_verifier/standards_verifier/diagnostics.py", - "state": "present", - "uses": [ - { - "check": "python-package-contract", - "role": "package-contract-input", - "suite": "a1c-public-cutover" - } - ] - }, - { - "digest": "sha256:ba53599cdc5927b018daf020a55cb12c474fde1ae26d99e0caaaad5fca59f979", - "path": "tools/standards_verifier/standards_verifier/engine.py", - "state": "present", - "uses": [ - { - "check": "python-package-contract", - "role": "package-contract-input", - "suite": "a1c-public-cutover" - } - ] - }, - { - "digest": "sha256:752db9aab7b47e4e6431bf2772d15550963c25034df773154c2507950b611269", - "path": "tools/standards_verifier/standards_verifier/entrypoints.py", - "state": "present", - "uses": [ - { - "check": "python-package-contract", - "role": "package-contract-input", - "suite": "a1c-public-cutover" - }, - { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" - } - ] - }, - { - "digest": "sha256:4423b8310e8760e9f85d4ab6df1a644f8ee8e8038236d3ee016d66def6b0d15a", - "path": "tools/standards_verifier/standards_verifier/git_reachability.py", - "state": "present", - "uses": [ - { - "check": "python-package-contract", - "role": "package-contract-input", - "suite": "a1c-public-cutover" - }, - { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" - } - ] - }, - { - "digest": "sha256:a2daac9fcba96192e64bd0161c9af3f3878e6f833078415700eddc30698c2aec", - "path": "tools/standards_verifier/standards_verifier/graph_adapters.py", - "state": "present", - "uses": [ - { - "check": "python-package-contract", - "role": "package-contract-input", - "suite": "a1c-public-cutover" - } - ] - }, - { - "digest": "sha256:c54c8c8967dec15675b3a9dfc5c0bcca118a63edf0eec0f99038221cda134ca7", - "path": "tools/standards_verifier/standards_verifier/input_sources.py", - "state": "present", - "uses": [ - { - "check": "python-package-contract", - "role": "package-contract-input", - "suite": "a1c-public-cutover" - } - ] - }, - { - "digest": "sha256:5b5b87b7eee4dfa98776459ac50e02af29b62eb602842e0b547a190b74acbe02", - "path": "tools/standards_verifier/standards_verifier/model.py", - "state": "present", - "uses": [ - { - "check": "python-package-contract", - "role": "package-contract-input", - "suite": "a1c-public-cutover" - }, - { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" - } - ] - }, - { - "digest": "sha256:de45013a15b4989767b250ef5e3fa4fb54a41d52b8a1b480a67d8986f9ea65e3", - "path": "tools/standards_verifier/standards_verifier/paths.py", - "state": "present", - "uses": [ - { - "check": "python-package-contract", - "role": "package-contract-input", - "suite": "a1c-public-cutover" - } - ] - }, - { - "digest": "sha256:d2505473e3c78783c7c3f50f4072e4830c80ae9d91cbb2b09ece8aa85b68612e", - "path": "tools/standards_verifier/standards_verifier/policy_impact.py", - "state": "present", - "uses": [ - { - "check": "python-package-contract", - "role": "package-contract-input", - "suite": "a1c-public-cutover" - }, - { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" - } - ] - }, - { - "digest": "sha256:717bc3fe807cd00a6da5b147a0a7923c009ac594157a76ed43e18feabb8413d7", - "path": "tools/standards_verifier/standards_verifier/python_packages.py", - "state": "present", - "uses": [ - { - "check": "python-package-contract", - "role": "package-contract-input", - "suite": "a1c-public-cutover" - }, - { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" - } - ] - }, - { - "digest": "sha256:38cf46ae2a908eeb5873096834a3ad727d2539404b9666cdb5c9319b51c6f8e3", - "path": "tools/standards_verifier/standards_verifier/repository_graph.py", - "state": "present", - "uses": [ - { - "check": "python-package-contract", - "role": "package-contract-input", - "suite": "a1c-public-cutover" - }, - { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" - } - ] - }, - { - "digest": "sha256:9c2e21a210ce0ad4ca076e9ed73645ca34b929abbdfae4a822dc31bd0b266cae", - "path": "tools/standards_verifier/standards_verifier/suite_inputs.py", - "state": "present", - "uses": [ - { - "check": "python-package-contract", - "role": "package-contract-input", - "suite": "a1c-public-cutover" - }, - { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" - } - ] - }, - { - "digest": "sha256:ce9d010a24ec3074da9d9110b8d5f90f977559c22d2f6a175ae0a1acf73b87cb", - "path": "tools/standards_verifier/tests/test_policy_impact.py", - "state": "present", - "uses": [ - { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" - } - ] - }, - { - "digest": "sha256:7f64e6b43152dfd51230daf2773ff7cba8113c27e708c7d6ca829a041ba6d7c3", - "path": "tools/standards_verifier/tests/test_python_package_contract.py", - "state": "present", - "uses": [ - { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" - } - ] - }, - { - "digest": "sha256:77ac6c2f233c2ac442230fe0a28e74131ab4a507b50c768dcfc108f8e75c573e", - "path": "tools/standards_verifier/verify.py", - "state": "present", - "uses": [ - { - "check": "python-package-contract", - "role": "package-contract-input", - "suite": "a1c-public-cutover" - }, - { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" - } - ] - }, - { - "digest": "sha256:92f32562c4b748c3a174faa8392966a928e865098a6d2c52ba008cc8b212bd9e", - "path": "tools/verify_git_reachability.py", - "state": "present", - "uses": [ - { - "check": "python-package-contract", - "role": "package-contract-input", - "suite": "a1c-public-cutover" - }, - { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" - } - ] - }, - { - "digest": "sha256:e1dac1dc41f883418d3b753db8ffa53d485b4f3afec2e48b1c0fee371771f6d6", - "path": "topics/accessibility.md", - "state": "present", - "uses": [ - { - "check": "local-links", - "role": "link-target", - "suite": "development-proportionality" - }, - { - "check": "routing-closure", - "role": "canonical-module", - "suite": "development-proportionality" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "frontend-rendering-synchronization" - }, - { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" - }, - { - "check": "negative-fixtures", - "role": "canonical-policy-impact", - "suite": "policy-semantic-impact" - }, - { - "check": "root-router-routes", - "role": "link-target", - "suite": "root-index-closure" - }, - { - "check": "root-router-routes", - "role": "member-content", - "suite": "root-index-closure" - }, - { - "check": "router-links", - "role": "link-target", - "suite": "router-legacy-route-closure" - }, - { - "check": "local-links", - "role": "link-target", - "suite": "s1-routing" - }, - { - "check": "verifier-change-route-closure", - "role": "canonical-module", - "suite": "s1-routing" - }, - { - "check": "frontend-routes", - "role": "link-target", - "suite": "source-index-closures" - }, - { - "check": "frontend-routes", - "role": "member-content", - "suite": "source-index-closures" - }, - { - "check": "source-links", - "role": "link-target", - "suite": "source-index-closures" - }, - { - "check": "requires-closure", - "role": "canonical-module", - "suite": "standards-recovery-routing" - } - ] - }, - { - "digest": "sha256:d35471532ba216056a4a88474fac15f2aada1de866ada136efb31ce26dc06036", - "path": "topics/architecture.md", - "state": "present", - "uses": [ - { - "check": "metadata", - "role": "metadata", - "suite": "architecture-pattern-reference-owner" - }, - { - "check": "architecture-contract-authority-destinations", - "role": "target", - "suite": "contract-ownership" - }, - { - "check": "coding-route-destinations", - "role": "target", - "suite": "contract-ownership" - }, - { - "check": "local-links", - "role": "link-target", - "suite": "development-proportionality" - }, - { - "check": "routing-closure", - "role": "canonical-module", - "suite": "development-proportionality" - }, - { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" - }, - { - "check": "negative-fixtures", - "role": "canonical-policy-impact", - "suite": "policy-semantic-impact" - }, - { - "check": "root-router-routes", - "role": "link-target", - "suite": "root-index-closure" - }, - { - "check": "router-links", - "role": "link-target", - "suite": "router-legacy-route-closure" - }, - { - "check": "metadata", - "role": "metadata", - "suite": "rust-api-owner-contract" - }, - { - "check": "source-index-destinations", - "role": "target", - "suite": "rust-api-rustdoc" - }, - { - "check": "local-links", - "role": "link-target", - "suite": "s1-routing" - }, - { - "check": "verifier-change-route-closure", - "role": "canonical-module", - "suite": "s1-routing" - }, - { - "check": "coding-routes", - "role": "link-target", - "suite": "source-index-closures" - }, - { - "check": "coding-routes", - "role": "member-content", - "suite": "source-index-closures" - }, - { - "check": "source-links", - "role": "link-target", - "suite": "source-index-closures" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "standards-recovery-routing" - }, - { - "check": "requires-closure", - "role": "canonical-module", - "suite": "standards-recovery-routing" - } - ] - }, - { - "digest": "sha256:678edd13bdaf6db9604c8dd4e98cc68e358d6e39eba8089d4f0ab69b52a085c5", - "path": "topics/architecture/replay.md", - "state": "present", - "uses": [ - { - "check": "local-links", - "role": "link-target", - "suite": "development-proportionality" - }, - { - "check": "routing-closure", - "role": "canonical-module", - "suite": "development-proportionality" - }, - { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" - }, - { - "check": "negative-fixtures", - "role": "canonical-policy-impact", - "suite": "policy-semantic-impact" - }, - { - "check": "root-router-routes", - "role": "link-target", - "suite": "root-index-closure" - }, - { - "check": "router-links", - "role": "link-target", - "suite": "router-legacy-route-closure" - }, - { - "check": "metadata", - "role": "metadata", - "suite": "rust-api-owner-contract" - }, - { - "check": "local-links", - "role": "link-target", - "suite": "s1-routing" - }, - { - "check": "verifier-change-route-closure", - "role": "canonical-module", - "suite": "s1-routing" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "standards-recovery-routing" - }, - { - "check": "requires-closure", - "role": "canonical-module", - "suite": "standards-recovery-routing" - } - ] - }, - { - "digest": "sha256:659f47b7d53abc05627cb3672aab33265062f92001b4d212d4c52ffd8c2de8e0", - "path": "topics/code-design.md", - "state": "present", - "uses": [ - { - "check": "metadata-closure", - "role": "metadata", - "suite": "concurrency-policy" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "contract-http-outcome-projection" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "cross-language-contract" - }, - { - "check": "local-links", - "role": "link-target", - "suite": "development-proportionality" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "development-proportionality" - }, - { - "check": "routing-closure", - "role": "canonical-module", - "suite": "development-proportionality" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "documentation-changelog-closure" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "documentation-policy-consolidation" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "documentation-reference" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "filesystem-containment-policy" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "frontend-rendering-synchronization" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "input-validation-authority" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "interop-boundary-policy" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "interop-event-registration" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "ipc-payload-validation" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "language-binding-boundary" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "language-binding-wire-representation" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "network-transport-policy" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "persistence-owner-contract" - }, - { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" - }, - { - "check": "negative-fixtures", - "role": "canonical-policy-impact", - "suite": "policy-semantic-impact" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-artifact-policy" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-maintenance-policy" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-pipeline-policy" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-procedure-policy" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-publication-policy" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-recovery-policy" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-reference-closure" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-workflow-foundation" - }, - { - "check": "root-router-routes", - "role": "link-target", - "suite": "root-index-closure" - }, - { - "check": "router-links", - "role": "link-target", - "suite": "router-legacy-route-closure" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "runtime-decoding-policy" - }, - { - "check": "metadata", - "role": "metadata", - "suite": "rust-api-owner-contract" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-async-blocking-mutex" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-async-boundary" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-async-cancellation-observability" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-async-lifecycle" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-architecture" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-callback-task" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-conversions" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-enum-representation" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-error-mapping" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-event-delivery" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-executor-delegation" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-runtime" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-boundary-arithmetic" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-dependency-candidate-inspection" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-dependency-owner-contract" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-external-input-queue" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-filesystem-authority" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-interop-memory" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-listener-lifecycle" - }, - { - "check": "rust-profile-metadata", - "role": "metadata", - "suite": "rust-profile-authority-closure" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-release-owner-contract" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-security-panic-boundary" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-tooling-owner-contract" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-unsafe-contracts" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-wire-representation" - }, - { - "check": "local-links", - "role": "link-target", - "suite": "s1-routing" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "s1-routing" - }, - { - "check": "verifier-change-route-closure", - "role": "canonical-module", - "suite": "s1-routing" - }, - { - "check": "coding-routes", - "role": "link-target", - "suite": "source-index-closures" - }, - { - "check": "source-links", - "role": "link-target", - "suite": "source-index-closures" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "standards-recovery-routing" - }, - { - "check": "requires-closure", - "role": "canonical-module", - "suite": "standards-recovery-routing" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "validation-proof-lifetime" - } - ] - }, - { - "digest": "sha256:e0cd8f80f95c0acc8d6c246e871f1d674861d8019a906137127aa51ad4065e0c", - "path": "topics/concurrency.md", - "state": "present", - "uses": [ - { - "check": "metadata-closure", - "role": "metadata", - "suite": "concurrency-policy" - }, - { - "check": "architecture-contract-authority-destinations", - "role": "target", - "suite": "contract-ownership" - }, - { - "check": "local-links", - "role": "link-target", - "suite": "development-proportionality" - }, - { - "check": "routing-closure", - "role": "canonical-module", - "suite": "development-proportionality" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "frontend-rendering-synchronization" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "network-transport-policy" - }, - { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" - }, - { - "check": "negative-fixtures", - "role": "canonical-policy-impact", - "suite": "policy-semantic-impact" - }, - { - "check": "root-router-routes", - "role": "link-target", - "suite": "root-index-closure" - }, - { - "check": "root-router-routes", - "role": "member-content", - "suite": "root-index-closure" - }, - { - "check": "router-links", - "role": "link-target", - "suite": "router-legacy-route-closure" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-async-blocking-mutex" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-async-boundary" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-async-cancellation-observability" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-async-lifecycle" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-callback-task" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-event-delivery" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-executor-delegation" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-runtime" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-listener-lifecycle" - }, - { - "check": "local-links", - "role": "link-target", - "suite": "s1-routing" - }, - { - "check": "verifier-change-route-closure", - "role": "canonical-module", - "suite": "s1-routing" - }, - { - "check": "concurrency-routes", - "role": "link-target", - "suite": "source-index-closures" - }, - { - "check": "concurrency-routes", - "role": "member-content", - "suite": "source-index-closures" - }, - { - "check": "frontend-routes", - "role": "link-target", - "suite": "source-index-closures" - }, - { - "check": "frontend-routes", - "role": "member-content", - "suite": "source-index-closures" - }, - { - "check": "security-routes", - "role": "link-target", - "suite": "source-index-closures" - }, - { - "check": "security-routes", - "role": "member-content", - "suite": "source-index-closures" - }, - { - "check": "source-links", - "role": "link-target", - "suite": "source-index-closures" - }, - { - "check": "requires-closure", - "role": "canonical-module", - "suite": "standards-recovery-routing" - }, - { - "check": "testing-route-and-legacy-removal-destinations", - "role": "target", - "suite": "verification-ownership" - } - ] - }, - { - "digest": "sha256:3190700189e589d7baec3551ff6330ca7afd64d8f425566cb621db9dd1399532", - "path": "topics/contracts.md", - "state": "present", - "uses": [ - { - "check": "metadata", - "role": "metadata", - "suite": "architecture-pattern-reference-owner" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "contract-http-outcome-projection" - }, - { - "check": "architecture-contract-authority-destinations", - "role": "target", - "suite": "contract-ownership" - }, - { - "check": "binding-route-destinations", - "role": "target", - "suite": "contract-ownership" - }, - { - "check": "coding-route-destinations", - "role": "target", - "suite": "contract-ownership" - }, - { - "check": "interop-route-destinations", - "role": "target", - "suite": "contract-ownership" - }, - { - "check": "release-workflow-route-destinations", - "role": "target", - "suite": "contract-ownership" - }, - { - "check": "rust-binding-contract-authority-destinations", - "role": "target", - "suite": "contract-ownership" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "cross-language-contract" - }, - { - "check": "local-links", - "role": "link-target", - "suite": "development-proportionality" - }, - { - "check": "routing-closure", - "role": "canonical-module", - "suite": "development-proportionality" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "documentation-changelog-closure" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "frontend-rendering-synchronization" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "input-validation-authority" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "interop-boundary-policy" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "interop-event-registration" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "ipc-payload-validation" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "language-binding-boundary" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "language-binding-wire-representation" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "network-transport-policy" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "persistence-owner-contract" - }, - { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" - }, - { - "check": "negative-fixtures", - "role": "canonical-policy-impact", - "suite": "policy-semantic-impact" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-artifact-policy" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-maintenance-policy" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-pipeline-policy" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-procedure-policy" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-publication-policy" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-recovery-policy" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-reference-closure" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-workflow-foundation" - }, - { - "check": "root-router-routes", - "role": "link-target", - "suite": "root-index-closure" - }, - { - "check": "root-router-routes", - "role": "member-content", - "suite": "root-index-closure" - }, - { - "check": "router-links", - "role": "link-target", - "suite": "router-legacy-route-closure" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "runtime-decoding-policy" - }, - { - "check": "metadata", - "role": "metadata", - "suite": "rust-api-owner-contract" - }, - { - "check": "source-index-destinations", - "role": "target", - "suite": "rust-api-rustdoc" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-architecture" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-callback-task" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-conversions" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-enum-representation" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-error-mapping" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-event-delivery" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-executor-delegation" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-runtime" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-dependency-candidate-inspection" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-dependency-owner-contract" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-interop-memory" - }, - { - "check": "source-index-destinations", - "role": "target", - "suite": "rust-release-evidence" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-release-owner-contract" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-wire-representation" - }, - { - "check": "local-links", - "role": "link-target", - "suite": "s1-routing" - }, - { - "check": "verifier-change-route-closure", - "role": "canonical-module", - "suite": "s1-routing" - }, - { - "check": "coding-routes", - "role": "link-target", - "suite": "source-index-closures" - }, - { - "check": "coding-routes", - "role": "member-content", - "suite": "source-index-closures" - }, - { - "check": "security-routes", - "role": "link-target", - "suite": "source-index-closures" - }, - { - "check": "security-routes", - "role": "member-content", - "suite": "source-index-closures" - }, - { - "check": "source-links", - "role": "link-target", - "suite": "source-index-closures" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "standards-recovery-routing" - }, - { - "check": "requires-closure", - "role": "canonical-module", - "suite": "standards-recovery-routing" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "validation-proof-lifetime" - }, - { - "check": "release-workflow-boundary-destinations", - "role": "target", - "suite": "verification-ownership" - }, - { - "check": "testing-route-and-legacy-removal-destinations", - "role": "target", - "suite": "verification-ownership" - } - ] - }, - { - "digest": "sha256:9789fccbc295188ec264a50d0e4183021e6bc136807d49eb7417b1159f0e86b8", - "path": "topics/contracts/evolution.md", - "state": "present", - "uses": [ - { - "check": "metadata-closure", - "role": "metadata", - "suite": "contract-http-outcome-projection" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "cross-language-contract" - }, - { - "check": "local-links", - "role": "link-target", - "suite": "development-proportionality" - }, - { - "check": "routing-closure", - "role": "canonical-module", - "suite": "development-proportionality" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "documentation-changelog-closure" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "frontend-rendering-synchronization" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "input-validation-authority" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "interop-boundary-policy" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "interop-event-registration" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "ipc-payload-validation" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "language-binding-boundary" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "language-binding-wire-representation" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "network-transport-policy" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "persistence-owner-contract" - }, - { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" - }, - { - "check": "negative-fixtures", - "role": "canonical-policy-impact", - "suite": "policy-semantic-impact" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-artifact-policy" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-maintenance-policy" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-pipeline-policy" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-procedure-policy" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-publication-policy" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-recovery-policy" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-reference-closure" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-workflow-foundation" - }, - { - "check": "root-router-routes", - "role": "link-target", - "suite": "root-index-closure" - }, - { - "check": "router-links", - "role": "link-target", - "suite": "router-legacy-route-closure" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "runtime-decoding-policy" - }, - { - "check": "metadata", - "role": "metadata", - "suite": "rust-api-owner-contract" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-architecture" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-callback-task" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-conversions" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-enum-representation" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-error-mapping" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-event-delivery" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-executor-delegation" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-runtime" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-dependency-candidate-inspection" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-dependency-owner-contract" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-interop-memory" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-release-owner-contract" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-wire-representation" - }, - { - "check": "local-links", - "role": "link-target", - "suite": "s1-routing" - }, - { - "check": "verifier-change-route-closure", - "role": "canonical-module", - "suite": "s1-routing" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "standards-recovery-routing" - }, - { - "check": "requires-closure", - "role": "canonical-module", - "suite": "standards-recovery-routing" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "validation-proof-lifetime" - } - ] - }, - { - "digest": "sha256:a49bb7b346c3fcacc39cc4402d8338b211df98299185aa0b6a5549d52e520194", - "path": "topics/contracts/protocols.md", - "state": "present", - "uses": [ - { - "check": "metadata-closure", - "role": "metadata", - "suite": "contract-http-outcome-projection" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "cross-language-contract" - }, - { - "check": "local-links", - "role": "link-target", - "suite": "development-proportionality" - }, - { - "check": "routing-closure", - "role": "canonical-module", - "suite": "development-proportionality" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "documentation-changelog-closure" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "frontend-rendering-synchronization" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "input-validation-authority" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "interop-boundary-policy" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "interop-event-registration" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "ipc-payload-validation" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "language-binding-boundary" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "language-binding-wire-representation" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "network-transport-policy" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "persistence-owner-contract" - }, - { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" - }, - { - "check": "negative-fixtures", - "role": "canonical-policy-impact", - "suite": "policy-semantic-impact" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-artifact-policy" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-maintenance-policy" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-pipeline-policy" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-procedure-policy" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-publication-policy" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-recovery-policy" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-reference-closure" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-workflow-foundation" - }, - { - "check": "root-router-routes", - "role": "link-target", - "suite": "root-index-closure" - }, - { - "check": "router-links", - "role": "link-target", - "suite": "router-legacy-route-closure" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "runtime-decoding-policy" - }, - { - "check": "metadata", - "role": "metadata", - "suite": "rust-api-owner-contract" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-architecture" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-callback-task" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-conversions" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-enum-representation" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-error-mapping" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-event-delivery" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-executor-delegation" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-runtime" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-dependency-candidate-inspection" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-dependency-owner-contract" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-interop-memory" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-release-owner-contract" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-wire-representation" - }, - { - "check": "local-links", - "role": "link-target", - "suite": "s1-routing" - }, - { - "check": "verifier-change-route-closure", - "role": "canonical-module", - "suite": "s1-routing" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "standards-recovery-routing" - }, - { - "check": "requires-closure", - "role": "canonical-module", - "suite": "standards-recovery-routing" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "validation-proof-lifetime" - } - ] - }, - { - "digest": "sha256:428bd940c6d843d8b2a0fe53ef8f473c753863b31c94ada006997c72eb2dfc72", - "path": "topics/contracts/schemas.md", - "state": "present", - "uses": [ - { - "check": "metadata-closure", - "role": "metadata", - "suite": "contract-http-outcome-projection" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "cross-language-contract" - }, - { - "check": "local-links", - "role": "link-target", - "suite": "development-proportionality" - }, - { - "check": "routing-closure", - "role": "canonical-module", - "suite": "development-proportionality" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "documentation-changelog-closure" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "frontend-rendering-synchronization" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "input-validation-authority" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "interop-boundary-policy" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "interop-event-registration" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "ipc-payload-validation" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "language-binding-boundary" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "language-binding-wire-representation" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "network-transport-policy" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "persistence-owner-contract" - }, - { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" - }, - { - "check": "negative-fixtures", - "role": "canonical-policy-impact", - "suite": "policy-semantic-impact" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-artifact-policy" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-maintenance-policy" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-pipeline-policy" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-procedure-policy" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-publication-policy" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-recovery-policy" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-reference-closure" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-workflow-foundation" - }, - { - "check": "root-router-routes", - "role": "link-target", - "suite": "root-index-closure" - }, - { - "check": "router-links", - "role": "link-target", - "suite": "router-legacy-route-closure" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "runtime-decoding-policy" - }, - { - "check": "metadata", - "role": "metadata", - "suite": "rust-api-owner-contract" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-architecture" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-callback-task" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-conversions" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-enum-representation" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-error-mapping" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-event-delivery" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-executor-delegation" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-runtime" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-dependency-candidate-inspection" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-dependency-owner-contract" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-interop-memory" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-release-owner-contract" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-wire-representation" - }, - { - "check": "local-links", - "role": "link-target", - "suite": "s1-routing" - }, - { - "check": "verifier-change-route-closure", - "role": "canonical-module", - "suite": "s1-routing" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "standards-recovery-routing" - }, - { - "check": "requires-closure", - "role": "canonical-module", - "suite": "standards-recovery-routing" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "validation-proof-lifetime" + { + "check": "current-structure", + "role": "registered-policy-impact", + "suite": "policy-semantic-impact" } ] }, { - "digest": "sha256:c987d41ddd217575811a520df61f5dd87ae660c55cfa3ce39ba0bcfaced1281a", - "path": "topics/cross-platform.md", + "digest": "sha256:e1dac1dc41f883418d3b753db8ffa53d485b4f3afec2e48b1c0fee371771f6d6", + "path": "topics/accessibility.md", "state": "present", "uses": [ { - "check": "architecture-contract-authority-destinations", - "role": "target", - "suite": "contract-ownership" - }, - { - "check": "release-workflow-route-destinations", - "role": "target", - "suite": "contract-ownership" + "check": "canonical-corpus", + "role": "metadata", + "suite": "canonical-corpus-metadata" }, { "check": "local-links", @@ -10794,11 +7823,6 @@ "role": "canonical-module", "suite": "development-proportionality" }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "filesystem-containment-policy" - }, { "check": "current-structure", "role": "registered-policy-impact", @@ -10824,16 +7848,6 @@ "role": "link-target", "suite": "router-legacy-route-closure" }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-filesystem-authority" - }, - { - "check": "exact-migration-index-destinations", - "role": "target", - "suite": "rust-target-configuration" - }, { "check": "local-links", "role": "link-target", @@ -10845,12 +7859,12 @@ "suite": "s1-routing" }, { - "check": "cross-platform-routes", + "check": "frontend-routes", "role": "link-target", "suite": "source-index-closures" }, { - "check": "cross-platform-routes", + "check": "frontend-routes", "role": "member-content", "suite": "source-index-closures" }, @@ -10863,19 +7877,24 @@ "check": "requires-closure", "role": "canonical-module", "suite": "standards-recovery-routing" - }, - { - "check": "release-workflow-boundary-destinations", - "role": "target", - "suite": "verification-ownership" } ] }, { - "digest": "sha256:b9698a1985aec38491f2d66d141978952fa691bef99ee7222f67e992d552b07f", - "path": "topics/dependencies.md", + "digest": "sha256:d35471532ba216056a4a88474fac15f2aada1de866ada136efb31ce26dc06036", + "path": "topics/architecture.md", "state": "present", "uses": [ + { + "check": "canonical-corpus", + "role": "metadata", + "suite": "canonical-corpus-metadata" + }, + { + "check": "architecture-contract-authority-destinations", + "role": "target", + "suite": "contract-ownership" + }, { "check": "coding-route-destinations", "role": "target", @@ -10906,51 +7925,16 @@ "role": "link-target", "suite": "root-index-closure" }, - { - "check": "root-router-routes", - "role": "member-content", - "suite": "root-index-closure" - }, { "check": "router-links", "role": "link-target", "suite": "router-legacy-route-closure" }, - { - "check": "metadata", - "role": "metadata", - "suite": "rust-api-owner-contract" - }, { "check": "source-index-destinations", "role": "target", "suite": "rust-api-rustdoc" }, - { - "check": "source-index-destinations", - "role": "target", - "suite": "rust-dependency-build-cost" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-dependency-candidate-inspection" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-dependency-owner-contract" - }, - { - "check": "source-index-destinations", - "role": "target", - "suite": "rust-release-evidence" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-release-owner-contract" - }, { "check": "local-links", "role": "link-target", @@ -10976,57 +7960,22 @@ "role": "link-target", "suite": "source-index-closures" }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "standards-recovery-routing" - }, { "check": "requires-closure", "role": "canonical-module", "suite": "standards-recovery-routing" - }, - { - "check": "former-source-destinations", - "role": "target", - "suite": "tooling-ci-workflow-reference" - }, - { - "check": "reference-destinations", - "role": "target", - "suite": "tooling-ci-workflow-reference" - }, - { - "check": "former-source-destinations", - "role": "target", - "suite": "tooling-reference-recipes" - }, - { - "check": "reference-destinations", - "role": "target", - "suite": "tooling-reference-recipes" - }, - { - "check": "launcher-route-destinations", - "role": "target", - "suite": "verification-ownership" - }, - { - "check": "tooling-route-and-legacy-removal-destinations", - "role": "target", - "suite": "verification-ownership" } ] }, { - "digest": "sha256:5e8e057397835fe09d9b02f74f080b39ed11d7062625c76cf8161b048f81bf7a", - "path": "topics/diagnostics.md", + "digest": "sha256:678edd13bdaf6db9604c8dd4e98cc68e358d6e39eba8089d4f0ab69b52a085c5", + "path": "topics/architecture/replay.md", "state": "present", "uses": [ { - "check": "architecture-contract-authority-destinations", - "role": "target", - "suite": "contract-ownership" + "check": "canonical-corpus", + "role": "metadata", + "suite": "canonical-corpus-metadata" }, { "check": "local-links", @@ -11053,11 +8002,6 @@ "role": "link-target", "suite": "root-index-closure" }, - { - "check": "root-router-routes", - "role": "member-content", - "suite": "root-index-closure" - }, { "check": "router-links", "role": "link-target", @@ -11081,14 +8025,14 @@ ] }, { - "digest": "sha256:80e8558198346fd6f5f57d5756fcf81d0929ebcbc4ca18288e22aba946bd4cb7", - "path": "topics/licensing.md", + "digest": "sha256:659f47b7d53abc05627cb3672aab33265062f92001b4d212d4c52ffd8c2de8e0", + "path": "topics/code-design.md", "state": "present", "uses": [ { - "check": "coding-route-destinations", - "role": "target", - "suite": "contract-ownership" + "check": "canonical-corpus", + "role": "metadata", + "suite": "canonical-corpus-metadata" }, { "check": "local-links", @@ -11111,13 +8055,13 @@ "suite": "policy-semantic-impact" }, { - "check": "root-router-routes", - "role": "link-target", - "suite": "root-index-closure" + "check": "metadata-closure", + "role": "metadata", + "suite": "release-maintenance-policy" }, { "check": "root-router-routes", - "role": "member-content", + "role": "link-target", "suite": "root-index-closure" }, { @@ -11125,16 +8069,6 @@ "role": "link-target", "suite": "router-legacy-route-closure" }, - { - "check": "source-index-destinations", - "role": "target", - "suite": "rust-dependency-build-cost" - }, - { - "check": "source-index-destinations", - "role": "target", - "suite": "rust-release-evidence" - }, { "check": "local-links", "role": "link-target", @@ -11150,11 +8084,6 @@ "role": "link-target", "suite": "source-index-closures" }, - { - "check": "coding-routes", - "role": "member-content", - "suite": "source-index-closures" - }, { "check": "source-links", "role": "link-target", @@ -11168,12 +8097,17 @@ ] }, { - "digest": "sha256:ff1ce8f1e7592c14bbb8f84fd2d6fef2434e861c29ddf517fe5f9ba9d983ae40", - "path": "topics/performance.md", + "digest": "sha256:e0cd8f80f95c0acc8d6c246e871f1d674861d8019a906137127aa51ad4065e0c", + "path": "topics/concurrency.md", "state": "present", "uses": [ { - "check": "coding-route-destinations", + "check": "canonical-corpus", + "role": "metadata", + "suite": "canonical-corpus-metadata" + }, + { + "check": "architecture-contract-authority-destinations", "role": "target", "suite": "contract-ownership" }, @@ -11204,94 +8138,7 @@ }, { "check": "root-router-routes", - "role": "member-content", - "suite": "root-index-closure" - }, - { - "check": "router-links", - "role": "link-target", - "suite": "router-legacy-route-closure" - }, - { - "check": "source-index-destinations", - "role": "target", - "suite": "rust-dependency-build-cost" - }, - { - "check": "local-links", - "role": "link-target", - "suite": "s1-routing" - }, - { - "check": "verifier-change-route-closure", - "role": "canonical-module", - "suite": "s1-routing" - }, - { - "check": "coding-routes", - "role": "link-target", - "suite": "source-index-closures" - }, - { - "check": "coding-routes", - "role": "member-content", - "suite": "source-index-closures" - }, - { - "check": "source-links", - "role": "link-target", - "suite": "source-index-closures" - }, - { - "check": "requires-closure", - "role": "canonical-module", - "suite": "standards-recovery-routing" - }, - { - "check": "testing-route-and-legacy-removal-destinations", - "role": "target", - "suite": "verification-ownership" - } - ] - }, - { - "digest": "sha256:573d59e334455d8f35c4e9213ce7f68a6edb23c36a36abdf72104af3f27685e8", - "path": "topics/resilience.md", - "state": "present", - "uses": [ - { - "check": "architecture-contract-authority-destinations", - "role": "target", - "suite": "contract-ownership" - }, - { - "check": "coding-route-destinations", - "role": "target", - "suite": "contract-ownership" - }, - { - "check": "local-links", - "role": "link-target", - "suite": "development-proportionality" - }, - { - "check": "routing-closure", - "role": "canonical-module", - "suite": "development-proportionality" - }, - { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" - }, - { - "check": "negative-fixtures", - "role": "canonical-policy-impact", - "suite": "policy-semantic-impact" - }, - { - "check": "root-router-routes", - "role": "link-target", + "role": "member-content", "suite": "root-index-closure" }, { @@ -11299,16 +8146,6 @@ "role": "link-target", "suite": "router-legacy-route-closure" }, - { - "check": "metadata", - "role": "metadata", - "suite": "rust-api-owner-contract" - }, - { - "check": "source-index-destinations", - "role": "target", - "suite": "rust-api-rustdoc" - }, { "check": "local-links", "role": "link-target", @@ -11320,12 +8157,32 @@ "suite": "s1-routing" }, { - "check": "coding-routes", + "check": "concurrency-routes", "role": "link-target", "suite": "source-index-closures" }, { - "check": "coding-routes", + "check": "concurrency-routes", + "role": "member-content", + "suite": "source-index-closures" + }, + { + "check": "frontend-routes", + "role": "link-target", + "suite": "source-index-closures" + }, + { + "check": "frontend-routes", + "role": "member-content", + "suite": "source-index-closures" + }, + { + "check": "security-routes", + "role": "link-target", + "suite": "source-index-closures" + }, + { + "check": "security-routes", "role": "member-content", "suite": "source-index-closures" }, @@ -11347,14 +8204,14 @@ ] }, { - "digest": "sha256:1ae23154bf405dd3722819189ae4bd1859b7777aecbf0b5951b532c6aece16e7", - "path": "topics/security.md", + "digest": "sha256:3190700189e589d7baec3551ff6330ca7afd64d8f425566cb621db9dd1399532", + "path": "topics/contracts.md", "state": "present", "uses": [ { - "check": "metadata-closure", + "check": "canonical-corpus", "role": "metadata", - "suite": "contract-http-outcome-projection" + "suite": "canonical-corpus-metadata" }, { "check": "architecture-contract-authority-destinations", @@ -11362,59 +8219,39 @@ "suite": "contract-ownership" }, { - "check": "interop-route-destinations", + "check": "binding-route-destinations", "role": "target", "suite": "contract-ownership" }, { - "check": "local-links", - "role": "link-target", - "suite": "development-proportionality" - }, - { - "check": "routing-closure", - "role": "canonical-module", - "suite": "development-proportionality" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "filesystem-containment-policy" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "input-validation-authority" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "interop-boundary-policy" + "check": "coding-route-destinations", + "role": "target", + "suite": "contract-ownership" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "interop-event-registration" + "check": "interop-route-destinations", + "role": "target", + "suite": "contract-ownership" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "ipc-payload-validation" + "check": "release-workflow-route-destinations", + "role": "target", + "suite": "contract-ownership" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "language-binding-boundary" + "check": "rust-binding-contract-authority-destinations", + "role": "target", + "suite": "contract-ownership" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "language-binding-wire-representation" + "check": "local-links", + "role": "link-target", + "suite": "development-proportionality" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "network-transport-policy" + "check": "routing-closure", + "role": "canonical-module", + "suite": "development-proportionality" }, { "check": "current-structure", @@ -11426,6 +8263,11 @@ "role": "canonical-policy-impact", "suite": "policy-semantic-impact" }, + { + "check": "metadata-closure", + "role": "metadata", + "suite": "release-maintenance-policy" + }, { "check": "root-router-routes", "role": "link-target", @@ -11446,85 +8288,10 @@ "role": "target", "suite": "rust-api-rustdoc" }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-architecture" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-callback-task" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-conversions" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-enum-representation" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-error-mapping" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-event-delivery" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-executor-delegation" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-runtime" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-boundary-arithmetic" - }, { "check": "source-index-destinations", "role": "target", - "suite": "rust-dependency-build-cost" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-external-input-queue" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-filesystem-authority" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-interop-memory" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-listener-lifecycle" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-security-panic-boundary" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-wire-representation" + "suite": "rust-release-evidence" }, { "check": "local-links", @@ -11537,12 +8304,12 @@ "suite": "s1-routing" }, { - "check": "cross-platform-routes", + "check": "coding-routes", "role": "link-target", "suite": "source-index-closures" }, { - "check": "cross-platform-routes", + "check": "coding-routes", "role": "member-content", "suite": "source-index-closures" }, @@ -11567,73 +8334,26 @@ "suite": "standards-recovery-routing" }, { - "check": "launcher-route-destinations", + "check": "release-workflow-boundary-destinations", "role": "target", "suite": "verification-ownership" - } - ] - }, - { - "digest": "sha256:c743d6232b20a22e19f1a34cb834a6fd48c3de483289893f42cec5580feb0c4b", - "path": "topics/security/untrusted-execution.md", - "state": "present", - "uses": [ - { - "check": "local-links", - "role": "link-target", - "suite": "development-proportionality" - }, - { - "check": "routing-closure", - "role": "canonical-module", - "suite": "development-proportionality" - }, - { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" - }, - { - "check": "negative-fixtures", - "role": "canonical-policy-impact", - "suite": "policy-semantic-impact" - }, - { - "check": "root-router-routes", - "role": "link-target", - "suite": "root-index-closure" - }, - { - "check": "router-links", - "role": "link-target", - "suite": "router-legacy-route-closure" - }, - { - "check": "local-links", - "role": "link-target", - "suite": "s1-routing" - }, - { - "check": "verifier-change-route-closure", - "role": "canonical-module", - "suite": "s1-routing" }, { - "check": "requires-closure", - "role": "canonical-module", - "suite": "standards-recovery-routing" + "check": "testing-route-and-legacy-removal-destinations", + "role": "target", + "suite": "verification-ownership" } ] }, { - "digest": "sha256:85aaf15fab1bc4695a48bb95135c93d7526ddc269c114b6d1952be93c6a47ecb", - "path": "workflows/build.md", + "digest": "sha256:9789fccbc295188ec264a50d0e4183021e6bc136807d49eb7417b1159f0e86b8", + "path": "topics/contracts/evolution.md", "state": "present", "uses": [ { - "check": "coding-route-destinations", - "role": "target", - "suite": "contract-ownership" + "check": "canonical-corpus", + "role": "metadata", + "suite": "canonical-corpus-metadata" }, { "check": "local-links", @@ -11656,13 +8376,13 @@ "suite": "policy-semantic-impact" }, { - "check": "root-router-routes", - "role": "link-target", - "suite": "root-index-closure" + "check": "metadata-closure", + "role": "metadata", + "suite": "release-maintenance-policy" }, { "check": "root-router-routes", - "role": "member-content", + "role": "link-target", "suite": "root-index-closure" }, { @@ -11676,31 +8396,11 @@ "suite": "s1-routing" }, { - "check": "verifier-change-route-closure", - "role": "canonical-module", - "suite": "s1-routing" - }, - { - "check": "coding-routes", - "role": "link-target", - "suite": "source-index-closures" - }, - { - "check": "coding-routes", - "role": "member-content", - "suite": "source-index-closures" - }, - { - "check": "source-links", - "role": "link-target", - "suite": "source-index-closures" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "standards-recovery-routing" - }, - { + "check": "verifier-change-route-closure", + "role": "canonical-module", + "suite": "s1-routing" + }, + { "check": "requires-closure", "role": "canonical-module", "suite": "standards-recovery-routing" @@ -11708,10 +8408,15 @@ ] }, { - "digest": "sha256:4ad5bbad2c9d9871d804baeb7dbe5491c406dda8d224a3566a3605a238b15d69", - "path": "workflows/commit.md", + "digest": "sha256:a49bb7b346c3fcacc39cc4402d8338b211df98299185aa0b6a5549d52e520194", + "path": "topics/contracts/protocols.md", "state": "present", "uses": [ + { + "check": "canonical-corpus", + "role": "metadata", + "suite": "canonical-corpus-metadata" + }, { "check": "local-links", "role": "link-target", @@ -11733,13 +8438,13 @@ "suite": "policy-semantic-impact" }, { - "check": "root-router-routes", - "role": "link-target", - "suite": "root-index-closure" + "check": "metadata-closure", + "role": "metadata", + "suite": "release-maintenance-policy" }, { "check": "root-router-routes", - "role": "member-content", + "role": "link-target", "suite": "root-index-closure" }, { @@ -11747,11 +8452,6 @@ "role": "link-target", "suite": "router-legacy-route-closure" }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-tooling-owner-contract" - }, { "check": "local-links", "role": "link-target", @@ -11762,66 +8462,26 @@ "role": "canonical-module", "suite": "s1-routing" }, - { - "check": "commit-routes", - "role": "link-target", - "suite": "source-index-closures" - }, - { - "check": "commit-routes", - "role": "member-content", - "suite": "source-index-closures" - }, - { - "check": "source-links", - "role": "link-target", - "suite": "source-index-closures" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "standards-recovery-routing" - }, { "check": "requires-closure", "role": "canonical-module", "suite": "standards-recovery-routing" - }, - { - "check": "former-source-destinations", - "role": "target", - "suite": "tooling-ci-workflow-reference" - }, - { - "check": "former-source-destinations", - "role": "target", - "suite": "tooling-reference-recipes" - }, - { - "check": "tooling-route-and-legacy-removal-destinations", - "role": "target", - "suite": "verification-ownership" } ] }, { - "digest": "sha256:558bf9e5d7715eb0256ceed076ce06db4bcd28bc4b9f7de2aaa20ed698d882fb", - "path": "workflows/development-proportionality.md", + "digest": "sha256:428bd940c6d843d8b2a0fe53ef8f473c753863b31c94ada006997c72eb2dfc72", + "path": "topics/contracts/schemas.md", "state": "present", "uses": [ { - "check": "local-links", - "role": "link-target", - "suite": "development-proportionality" + "check": "canonical-corpus", + "role": "metadata", + "suite": "canonical-corpus-metadata" }, { "check": "local-links", - "role": "markdown", - "suite": "development-proportionality" - }, - { - "check": "metadata-closure", - "role": "metadata", + "role": "link-target", "suite": "development-proportionality" }, { @@ -11839,6 +8499,11 @@ "role": "canonical-policy-impact", "suite": "policy-semantic-impact" }, + { + "check": "metadata-closure", + "role": "metadata", + "suite": "release-maintenance-policy" + }, { "check": "root-router-routes", "role": "link-target", @@ -11859,11 +8524,6 @@ "role": "canonical-module", "suite": "s1-routing" }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "standards-recovery-routing" - }, { "check": "requires-closure", "role": "canonical-module", @@ -11872,15 +8532,25 @@ ] }, { - "digest": "sha256:90d2d712bcc686d1d84d2de5b1a325c98353d8e7e820779b7c55ca121b32ad3d", - "path": "workflows/documentation.md", + "digest": "sha256:c987d41ddd217575811a520df61f5dd87ae660c55cfa3ce39ba0bcfaced1281a", + "path": "topics/cross-platform.md", "state": "present", "uses": [ + { + "check": "canonical-corpus", + "role": "metadata", + "suite": "canonical-corpus-metadata" + }, { "check": "architecture-contract-authority-destinations", "role": "target", "suite": "contract-ownership" }, + { + "check": "release-workflow-route-destinations", + "role": "target", + "suite": "contract-ownership" + }, { "check": "local-links", "role": "link-target", @@ -11891,16 +8561,6 @@ "role": "canonical-module", "suite": "development-proportionality" }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "documentation-policy-consolidation" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "documentation-reference" - }, { "check": "current-structure", "role": "registered-policy-impact", @@ -11916,25 +8576,20 @@ "role": "link-target", "suite": "root-index-closure" }, + { + "check": "root-router-routes", + "role": "member-content", + "suite": "root-index-closure" + }, { "check": "router-links", "role": "link-target", "suite": "router-legacy-route-closure" }, { - "check": "metadata", - "role": "metadata", - "suite": "rust-api-owner-contract" - }, - { - "check": "source-index-destinations", - "role": "target", - "suite": "rust-api-rustdoc" - }, - { - "check": "source-index-destinations", + "check": "exact-migration-index-destinations", "role": "target", - "suite": "rust-release-evidence" + "suite": "rust-target-configuration" }, { "check": "local-links", @@ -11947,12 +8602,12 @@ "suite": "s1-routing" }, { - "check": "documentation-routes", + "check": "cross-platform-routes", "role": "link-target", "suite": "source-index-closures" }, { - "check": "documentation-routes", + "check": "cross-platform-routes", "role": "member-content", "suite": "source-index-closures" }, @@ -11961,38 +8616,28 @@ "role": "link-target", "suite": "source-index-closures" }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "standards-recovery-routing" - }, { "check": "requires-closure", "role": "canonical-module", "suite": "standards-recovery-routing" }, { - "check": "former-source-destinations", - "role": "target", - "suite": "tooling-ci-workflow-reference" - }, - { - "check": "former-source-destinations", - "role": "target", - "suite": "tooling-reference-recipes" - }, - { - "check": "tooling-route-and-legacy-removal-destinations", + "check": "release-workflow-boundary-destinations", "role": "target", "suite": "verification-ownership" } ] }, { - "digest": "sha256:02bc0feb1f411072b082236da5354ab44b1a4cdfe4a07afab70108631c80e532", - "path": "workflows/implementation.md", + "digest": "sha256:b9698a1985aec38491f2d66d141978952fa691bef99ee7222f67e992d552b07f", + "path": "topics/dependencies.md", "state": "present", "uses": [ + { + "check": "canonical-corpus", + "role": "metadata", + "suite": "canonical-corpus-metadata" + }, { "check": "coding-route-destinations", "role": "target", @@ -12003,11 +8648,6 @@ "role": "link-target", "suite": "development-proportionality" }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "development-proportionality" - }, { "check": "routing-closure", "role": "canonical-module", @@ -12028,29 +8668,34 @@ "role": "link-target", "suite": "root-index-closure" }, + { + "check": "root-router-routes", + "role": "member-content", + "suite": "root-index-closure" + }, { "check": "router-links", "role": "link-target", "suite": "router-legacy-route-closure" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-tooling-owner-contract" + "check": "source-index-destinations", + "role": "target", + "suite": "rust-api-rustdoc" }, { - "check": "local-links", - "role": "link-target", - "suite": "s1-routing" + "check": "source-index-destinations", + "role": "target", + "suite": "rust-dependency-build-cost" }, { - "check": "local-links", - "role": "markdown", - "suite": "s1-routing" + "check": "source-index-destinations", + "role": "target", + "suite": "rust-release-evidence" }, { - "check": "metadata-closure", - "role": "metadata", + "check": "local-links", + "role": "link-target", "suite": "s1-routing" }, { @@ -12073,11 +8718,6 @@ "role": "link-target", "suite": "source-index-closures" }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "standards-recovery-routing" - }, { "check": "requires-closure", "role": "canonical-module", @@ -12089,40 +8729,117 @@ "suite": "tooling-ci-workflow-reference" }, { - "check": "former-source-destinations", - "role": "target", - "suite": "tooling-reference-recipes" + "check": "reference-destinations", + "role": "target", + "suite": "tooling-ci-workflow-reference" + }, + { + "check": "former-source-destinations", + "role": "target", + "suite": "tooling-reference-recipes" + }, + { + "check": "reference-destinations", + "role": "target", + "suite": "tooling-reference-recipes" + }, + { + "check": "launcher-route-destinations", + "role": "target", + "suite": "verification-ownership" + }, + { + "check": "tooling-route-and-legacy-removal-destinations", + "role": "target", + "suite": "verification-ownership" + } + ] + }, + { + "digest": "sha256:5e8e057397835fe09d9b02f74f080b39ed11d7062625c76cf8161b048f81bf7a", + "path": "topics/diagnostics.md", + "state": "present", + "uses": [ + { + "check": "canonical-corpus", + "role": "metadata", + "suite": "canonical-corpus-metadata" + }, + { + "check": "architecture-contract-authority-destinations", + "role": "target", + "suite": "contract-ownership" + }, + { + "check": "local-links", + "role": "link-target", + "suite": "development-proportionality" + }, + { + "check": "routing-closure", + "role": "canonical-module", + "suite": "development-proportionality" + }, + { + "check": "current-structure", + "role": "registered-policy-impact", + "suite": "policy-semantic-impact" + }, + { + "check": "negative-fixtures", + "role": "canonical-policy-impact", + "suite": "policy-semantic-impact" + }, + { + "check": "root-router-routes", + "role": "link-target", + "suite": "root-index-closure" + }, + { + "check": "root-router-routes", + "role": "member-content", + "suite": "root-index-closure" + }, + { + "check": "router-links", + "role": "link-target", + "suite": "router-legacy-route-closure" + }, + { + "check": "local-links", + "role": "link-target", + "suite": "s1-routing" }, { - "check": "canonical-workflow-sections-destinations", - "role": "target", - "suite": "verification-ownership" + "check": "verifier-change-route-closure", + "role": "canonical-module", + "suite": "s1-routing" }, { - "check": "tooling-route-and-legacy-removal-destinations", - "role": "target", - "suite": "verification-ownership" + "check": "requires-closure", + "role": "canonical-module", + "suite": "standards-recovery-routing" } ] }, { - "digest": "sha256:59d2cbd6b7525e41b41761b0caf7471ddde9c4e33290ba4a16c812937abc4403", - "path": "workflows/planning.md", + "digest": "sha256:80e8558198346fd6f5f57d5756fcf81d0929ebcbc4ca18288e22aba946bd4cb7", + "path": "topics/licensing.md", "state": "present", "uses": [ { - "check": "local-links", - "role": "link-target", - "suite": "development-proportionality" + "check": "canonical-corpus", + "role": "metadata", + "suite": "canonical-corpus-metadata" }, { - "check": "local-links", - "role": "markdown", - "suite": "development-proportionality" + "check": "coding-route-destinations", + "role": "target", + "suite": "contract-ownership" }, { - "check": "metadata-closure", - "role": "metadata", + "check": "local-links", + "role": "link-target", "suite": "development-proportionality" }, { @@ -12145,11 +8862,26 @@ "role": "link-target", "suite": "root-index-closure" }, + { + "check": "root-router-routes", + "role": "member-content", + "suite": "root-index-closure" + }, { "check": "router-links", "role": "link-target", "suite": "router-legacy-route-closure" }, + { + "check": "source-index-destinations", + "role": "target", + "suite": "rust-dependency-build-cost" + }, + { + "check": "source-index-destinations", + "role": "target", + "suite": "rust-release-evidence" + }, { "check": "local-links", "role": "link-target", @@ -12161,12 +8893,12 @@ "suite": "s1-routing" }, { - "check": "planning-routes", + "check": "coding-routes", "role": "link-target", "suite": "source-index-closures" }, { - "check": "planning-routes", + "check": "coding-routes", "role": "member-content", "suite": "source-index-closures" }, @@ -12175,11 +8907,6 @@ "role": "link-target", "suite": "source-index-closures" }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "standards-recovery-routing" - }, { "check": "requires-closure", "role": "canonical-module", @@ -12188,10 +8915,20 @@ ] }, { - "digest": "sha256:3cec960a68530b7afec2df692329e6a31d3f3ec429d48ff51ea92272c917a239", - "path": "workflows/planning/discovery.md", + "digest": "sha256:ff1ce8f1e7592c14bbb8f84fd2d6fef2434e861c29ddf517fe5f9ba9d983ae40", + "path": "topics/performance.md", "state": "present", "uses": [ + { + "check": "canonical-corpus", + "role": "metadata", + "suite": "canonical-corpus-metadata" + }, + { + "check": "coding-route-destinations", + "role": "target", + "suite": "contract-ownership" + }, { "check": "local-links", "role": "link-target", @@ -12217,11 +8954,21 @@ "role": "link-target", "suite": "root-index-closure" }, + { + "check": "root-router-routes", + "role": "member-content", + "suite": "root-index-closure" + }, { "check": "router-links", "role": "link-target", "suite": "router-legacy-route-closure" }, + { + "check": "source-index-destinations", + "role": "target", + "suite": "rust-dependency-build-cost" + }, { "check": "local-links", "role": "link-target", @@ -12232,30 +8979,50 @@ "role": "canonical-module", "suite": "s1-routing" }, + { + "check": "coding-routes", + "role": "link-target", + "suite": "source-index-closures" + }, + { + "check": "coding-routes", + "role": "member-content", + "suite": "source-index-closures" + }, + { + "check": "source-links", + "role": "link-target", + "suite": "source-index-closures" + }, { "check": "requires-closure", "role": "canonical-module", "suite": "standards-recovery-routing" + }, + { + "check": "testing-route-and-legacy-removal-destinations", + "role": "target", + "suite": "verification-ownership" } ] }, { - "digest": "sha256:de8ee6dd4a4f05f7146e21033beea7a40d1ddd036a3e8eb55279fa7ca6ebb37d", - "path": "workflows/release.md", + "digest": "sha256:573d59e334455d8f35c4e9213ce7f68a6edb23c36a36abdf72104af3f27685e8", + "path": "topics/resilience.md", "state": "present", "uses": [ { - "check": "release-entrypoint-destinations", - "role": "target", - "suite": "contract-ownership" + "check": "canonical-corpus", + "role": "metadata", + "suite": "canonical-corpus-metadata" }, { - "check": "release-workflow-route-destinations", - "role": "markdown", + "check": "architecture-contract-authority-destinations", + "role": "target", "suite": "contract-ownership" }, { - "check": "rust-binding-contract-authority-destinations", + "check": "coding-route-destinations", "role": "target", "suite": "contract-ownership" }, @@ -12269,11 +9036,6 @@ "role": "canonical-module", "suite": "development-proportionality" }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "documentation-changelog-closure" - }, { "check": "current-structure", "role": "registered-policy-impact", @@ -12284,90 +9046,20 @@ "role": "canonical-policy-impact", "suite": "policy-semantic-impact" }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-artifact-policy" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-maintenance-policy" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-pipeline-policy" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-procedure-policy" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-publication-policy" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-recovery-policy" - }, - { - "check": "legacy-index-destinations", - "role": "target", - "suite": "release-reference-closure" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-reference-closure" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-workflow-foundation" - }, { "check": "root-router-routes", "role": "link-target", "suite": "root-index-closure" }, - { - "check": "root-router-routes", - "role": "member-content", - "suite": "root-index-closure" - }, { "check": "router-links", "role": "link-target", "suite": "router-legacy-route-closure" }, - { - "check": "metadata", - "role": "metadata", - "suite": "rust-api-owner-contract" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-dependency-candidate-inspection" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-dependency-owner-contract" - }, { "check": "source-index-destinations", "role": "target", - "suite": "rust-release-evidence" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-release-owner-contract" + "suite": "rust-api-rustdoc" }, { "check": "local-links", @@ -12380,22 +9072,12 @@ "suite": "s1-routing" }, { - "check": "cross-platform-routes", - "role": "link-target", - "suite": "source-index-closures" - }, - { - "check": "cross-platform-routes", - "role": "member-content", - "suite": "source-index-closures" - }, - { - "check": "documentation-routes", + "check": "coding-routes", "role": "link-target", "suite": "source-index-closures" }, { - "check": "documentation-routes", + "check": "coding-routes", "role": "member-content", "suite": "source-index-closures" }, @@ -12404,111 +9086,66 @@ "role": "link-target", "suite": "source-index-closures" }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "standards-recovery-routing" - }, { "check": "requires-closure", "role": "canonical-module", "suite": "standards-recovery-routing" }, { - "check": "launcher-route-destinations", - "role": "target", - "suite": "verification-ownership" - }, - { - "check": "release-route-destinations", + "check": "testing-route-and-legacy-removal-destinations", "role": "target", "suite": "verification-ownership" - }, - { - "check": "release-workflow-boundary-destinations", - "role": "markdown", - "suite": "verification-ownership" } ] }, { - "digest": "sha256:580416b544b345e82cd0b422dd65be4a51b932fc55ee69c9260027f7d6310424", - "path": "workflows/release/operations.md", + "digest": "sha256:1ae23154bf405dd3722819189ae4bd1859b7777aecbf0b5951b532c6aece16e7", + "path": "topics/security.md", "state": "present", "uses": [ { - "check": "release-workflow-route-destinations", - "role": "target", - "suite": "contract-ownership" - }, - { - "check": "local-links", - "role": "link-target", - "suite": "development-proportionality" - }, - { - "check": "routing-closure", - "role": "canonical-module", - "suite": "development-proportionality" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "documentation-changelog-closure" - }, - { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" - }, - { - "check": "negative-fixtures", - "role": "canonical-policy-impact", - "suite": "policy-semantic-impact" - }, - { - "check": "metadata-closure", + "check": "canonical-corpus", "role": "metadata", - "suite": "release-artifact-policy" + "suite": "canonical-corpus-metadata" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-maintenance-policy" + "check": "architecture-contract-authority-destinations", + "role": "target", + "suite": "contract-ownership" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-pipeline-policy" + "check": "interop-route-destinations", + "role": "target", + "suite": "contract-ownership" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-procedure-policy" + "check": "local-links", + "role": "link-target", + "suite": "development-proportionality" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-publication-policy" + "check": "routing-closure", + "role": "canonical-module", + "suite": "development-proportionality" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-recovery-policy" + "check": "current-structure", + "role": "registered-policy-impact", + "suite": "policy-semantic-impact" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-reference-closure" + "check": "negative-fixtures", + "role": "canonical-policy-impact", + "suite": "policy-semantic-impact" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-workflow-foundation" + "check": "root-router-routes", + "role": "link-target", + "suite": "root-index-closure" }, { "check": "root-router-routes", - "role": "link-target", + "role": "member-content", "suite": "root-index-closure" }, { @@ -12517,24 +9154,14 @@ "suite": "router-legacy-route-closure" }, { - "check": "metadata", - "role": "metadata", - "suite": "rust-api-owner-contract" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-dependency-candidate-inspection" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-dependency-owner-contract" + "check": "source-index-destinations", + "role": "target", + "suite": "rust-api-rustdoc" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-release-owner-contract" + "check": "source-index-destinations", + "role": "target", + "suite": "rust-dependency-build-cost" }, { "check": "local-links", @@ -12547,9 +9174,29 @@ "suite": "s1-routing" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "standards-recovery-routing" + "check": "cross-platform-routes", + "role": "link-target", + "suite": "source-index-closures" + }, + { + "check": "cross-platform-routes", + "role": "member-content", + "suite": "source-index-closures" + }, + { + "check": "security-routes", + "role": "link-target", + "suite": "source-index-closures" + }, + { + "check": "security-routes", + "role": "member-content", + "suite": "source-index-closures" + }, + { + "check": "source-links", + "role": "link-target", + "suite": "source-index-closures" }, { "check": "requires-closure", @@ -12557,17 +9204,22 @@ "suite": "standards-recovery-routing" }, { - "check": "release-workflow-boundary-destinations", + "check": "launcher-route-destinations", "role": "target", "suite": "verification-ownership" } ] }, { - "digest": "sha256:e14ac61063820e13a3b2f90cf680b5349a0e3c1064e5fdaa3177b1c3e42d5567", - "path": "workflows/standards-authoring.md", + "digest": "sha256:c743d6232b20a22e19f1a34cb834a6fd48c3de483289893f42cec5580feb0c4b", + "path": "topics/security/untrusted-execution.md", "state": "present", "uses": [ + { + "check": "canonical-corpus", + "role": "metadata", + "suite": "canonical-corpus-metadata" + }, { "check": "local-links", "role": "link-target", @@ -12616,10 +9268,20 @@ ] }, { - "digest": "sha256:34f81c9653d1c66203ac2f77968070b82c267e2646254b12482ee1263246a427", - "path": "workflows/tooling.md", + "digest": "sha256:85aaf15fab1bc4695a48bb95135c93d7526ddc269c114b6d1952be93c6a47ecb", + "path": "workflows/build.md", "state": "present", "uses": [ + { + "check": "canonical-corpus", + "role": "metadata", + "suite": "canonical-corpus-metadata" + }, + { + "check": "coding-route-destinations", + "role": "target", + "suite": "contract-ownership" + }, { "check": "local-links", "role": "link-target", @@ -12655,21 +9317,6 @@ "role": "link-target", "suite": "router-legacy-route-closure" }, - { - "check": "source-index-destinations", - "role": "target", - "suite": "rust-dependency-build-cost" - }, - { - "check": "source-index-destinations", - "role": "target", - "suite": "rust-release-evidence" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-tooling-owner-contract" - }, { "check": "local-links", "role": "link-target", @@ -12681,12 +9328,12 @@ "suite": "s1-routing" }, { - "check": "frontend-routes", + "check": "coding-routes", "role": "link-target", "suite": "source-index-closures" }, { - "check": "frontend-routes", + "check": "coding-routes", "role": "member-content", "suite": "source-index-closures" }, @@ -12695,207 +9342,139 @@ "role": "link-target", "suite": "source-index-closures" }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "standards-recovery-routing" - }, { "check": "requires-closure", "role": "canonical-module", "suite": "standards-recovery-routing" - }, - { - "check": "former-source-destinations", - "role": "target", - "suite": "tooling-ci-workflow-reference" - }, - { - "check": "reference-destinations", - "role": "target", - "suite": "tooling-ci-workflow-reference" - }, - { - "check": "former-source-destinations", - "role": "target", - "suite": "tooling-reference-recipes" - }, - { - "check": "reference-destinations", - "role": "target", - "suite": "tooling-reference-recipes" - }, - { - "check": "tooling-route-and-legacy-removal-destinations", - "role": "target", - "suite": "verification-ownership" } ] }, { - "digest": "sha256:e5782006f8e871e75475490be34ffae3a1df4d97eae2947c4f4c3e6100a63b6a", - "path": "workflows/verification.md", + "digest": "sha256:4ad5bbad2c9d9871d804baeb7dbe5491c406dda8d224a3566a3605a238b15d69", + "path": "workflows/commit.md", "state": "present", "uses": [ { - "check": "metadata", - "role": "metadata", - "suite": "architecture-pattern-reference-owner" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "concurrency-policy" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "contract-http-outcome-projection" - }, - { - "check": "architecture-contract-authority-destinations", - "role": "target", - "suite": "contract-ownership" - }, - { - "check": "coding-route-destinations", - "role": "target", - "suite": "contract-ownership" - }, - { - "check": "release-workflow-route-destinations", - "role": "target", - "suite": "contract-ownership" - }, - { - "check": "rust-binding-contract-authority-destinations", - "role": "target", - "suite": "contract-ownership" - }, - { - "check": "metadata-closure", + "check": "canonical-corpus", "role": "metadata", - "suite": "cross-language-contract" + "suite": "canonical-corpus-metadata" }, { "check": "local-links", "role": "link-target", "suite": "development-proportionality" }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "development-proportionality" - }, { "check": "routing-closure", "role": "canonical-module", "suite": "development-proportionality" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "documentation-changelog-closure" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "filesystem-containment-policy" + "check": "current-structure", + "role": "registered-policy-impact", + "suite": "policy-semantic-impact" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "frontend-rendering-synchronization" + "check": "negative-fixtures", + "role": "canonical-policy-impact", + "suite": "policy-semantic-impact" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "input-validation-authority" + "check": "root-router-routes", + "role": "link-target", + "suite": "root-index-closure" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "interop-boundary-policy" + "check": "root-router-routes", + "role": "member-content", + "suite": "root-index-closure" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "interop-event-registration" + "check": "router-links", + "role": "link-target", + "suite": "router-legacy-route-closure" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "ipc-payload-validation" + "check": "local-links", + "role": "link-target", + "suite": "s1-routing" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "language-binding-boundary" + "check": "verifier-change-route-closure", + "role": "canonical-module", + "suite": "s1-routing" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "language-binding-wire-representation" + "check": "commit-routes", + "role": "link-target", + "suite": "source-index-closures" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "network-transport-policy" + "check": "commit-routes", + "role": "member-content", + "suite": "source-index-closures" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "persistence-owner-contract" + "check": "source-links", + "role": "link-target", + "suite": "source-index-closures" }, { - "check": "current-structure", - "role": "registered-policy-impact", - "suite": "policy-semantic-impact" + "check": "requires-closure", + "role": "canonical-module", + "suite": "standards-recovery-routing" }, { - "check": "negative-fixtures", - "role": "canonical-policy-impact", - "suite": "policy-semantic-impact" + "check": "former-source-destinations", + "role": "target", + "suite": "tooling-ci-workflow-reference" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-artifact-policy" + "check": "former-source-destinations", + "role": "target", + "suite": "tooling-reference-recipes" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-maintenance-policy" - }, + "check": "tooling-route-and-legacy-removal-destinations", + "role": "target", + "suite": "verification-ownership" + } + ] + }, + { + "digest": "sha256:558bf9e5d7715eb0256ceed076ce06db4bcd28bc4b9f7de2aaa20ed698d882fb", + "path": "workflows/development-proportionality.md", + "state": "present", + "uses": [ { - "check": "metadata-closure", + "check": "canonical-corpus", "role": "metadata", - "suite": "release-pipeline-policy" + "suite": "canonical-corpus-metadata" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-procedure-policy" + "check": "local-links", + "role": "link-target", + "suite": "development-proportionality" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-publication-policy" + "check": "local-links", + "role": "markdown", + "suite": "development-proportionality" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-recovery-policy" + "check": "routing-closure", + "role": "canonical-module", + "suite": "development-proportionality" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-reference-closure" + "check": "current-structure", + "role": "registered-policy-impact", + "suite": "policy-semantic-impact" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-workflow-foundation" + "check": "negative-fixtures", + "role": "canonical-policy-impact", + "suite": "policy-semantic-impact" }, { "check": "root-router-routes", @@ -12908,163 +9487,177 @@ "suite": "router-legacy-route-closure" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "runtime-decoding-policy" + "check": "local-links", + "role": "link-target", + "suite": "s1-routing" }, { - "check": "metadata", - "role": "metadata", - "suite": "rust-api-owner-contract" + "check": "verifier-change-route-closure", + "role": "canonical-module", + "suite": "s1-routing" }, { - "check": "source-index-destinations", - "role": "target", - "suite": "rust-api-rustdoc" - }, + "check": "requires-closure", + "role": "canonical-module", + "suite": "standards-recovery-routing" + } + ] + }, + { + "digest": "sha256:90d2d712bcc686d1d84d2de5b1a325c98353d8e7e820779b7c55ca121b32ad3d", + "path": "workflows/documentation.md", + "state": "present", + "uses": [ { - "check": "metadata-closure", + "check": "canonical-corpus", "role": "metadata", - "suite": "rust-async-blocking-mutex" + "suite": "canonical-corpus-metadata" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-async-boundary" + "check": "architecture-contract-authority-destinations", + "role": "target", + "suite": "contract-ownership" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-async-cancellation-observability" + "check": "local-links", + "role": "link-target", + "suite": "development-proportionality" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-async-lifecycle" + "check": "routing-closure", + "role": "canonical-module", + "suite": "development-proportionality" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-architecture" + "check": "current-structure", + "role": "registered-policy-impact", + "suite": "policy-semantic-impact" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-callback-task" + "check": "negative-fixtures", + "role": "canonical-policy-impact", + "suite": "policy-semantic-impact" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-conversions" + "check": "root-router-routes", + "role": "link-target", + "suite": "root-index-closure" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-enum-representation" + "check": "router-links", + "role": "link-target", + "suite": "router-legacy-route-closure" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-error-mapping" + "check": "source-index-destinations", + "role": "target", + "suite": "rust-api-rustdoc" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-event-delivery" + "check": "source-index-destinations", + "role": "target", + "suite": "rust-release-evidence" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-executor-delegation" + "check": "local-links", + "role": "link-target", + "suite": "s1-routing" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-runtime" + "check": "verifier-change-route-closure", + "role": "canonical-module", + "suite": "s1-routing" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-boundary-arithmetic" + "check": "documentation-routes", + "role": "link-target", + "suite": "source-index-closures" }, { - "check": "source-index-destinations", - "role": "target", - "suite": "rust-dependency-build-cost" + "check": "documentation-routes", + "role": "member-content", + "suite": "source-index-closures" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-dependency-candidate-inspection" + "check": "source-links", + "role": "link-target", + "suite": "source-index-closures" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-dependency-owner-contract" + "check": "requires-closure", + "role": "canonical-module", + "suite": "standards-recovery-routing" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-external-input-queue" + "check": "former-source-destinations", + "role": "target", + "suite": "tooling-ci-workflow-reference" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-filesystem-authority" + "check": "former-source-destinations", + "role": "target", + "suite": "tooling-reference-recipes" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-interop-memory" - }, + "check": "tooling-route-and-legacy-removal-destinations", + "role": "target", + "suite": "verification-ownership" + } + ] + }, + { + "digest": "sha256:02bc0feb1f411072b082236da5354ab44b1a4cdfe4a07afab70108631c80e532", + "path": "workflows/implementation.md", + "state": "present", + "uses": [ { - "check": "metadata-closure", + "check": "canonical-corpus", "role": "metadata", - "suite": "rust-listener-lifecycle" + "suite": "canonical-corpus-metadata" }, { - "check": "source-index-destinations", + "check": "coding-route-destinations", "role": "target", - "suite": "rust-release-evidence" + "suite": "contract-ownership" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-release-owner-contract" + "check": "local-links", + "role": "link-target", + "suite": "development-proportionality" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-security-panic-boundary" + "check": "routing-closure", + "role": "canonical-module", + "suite": "development-proportionality" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-tooling-owner-contract" + "check": "current-structure", + "role": "registered-policy-impact", + "suite": "policy-semantic-impact" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-unsafe-contracts" + "check": "negative-fixtures", + "role": "canonical-policy-impact", + "suite": "policy-semantic-impact" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-wire-representation" + "check": "root-router-routes", + "role": "link-target", + "suite": "root-index-closure" }, { - "check": "local-links", + "check": "router-links", "role": "link-target", - "suite": "s1-routing" + "suite": "router-legacy-route-closure" }, { "check": "local-links", - "role": "markdown", + "role": "link-target", "suite": "s1-routing" }, { - "check": "metadata-closure", - "role": "metadata", + "check": "local-links", + "role": "markdown", "suite": "s1-routing" }, { @@ -13082,73 +9675,28 @@ "role": "member-content", "suite": "source-index-closures" }, - { - "check": "cross-platform-routes", - "role": "link-target", - "suite": "source-index-closures" - }, - { - "check": "cross-platform-routes", - "role": "member-content", - "suite": "source-index-closures" - }, - { - "check": "frontend-routes", - "role": "link-target", - "suite": "source-index-closures" - }, - { - "check": "frontend-routes", - "role": "member-content", - "suite": "source-index-closures" - }, { "check": "source-links", "role": "link-target", "suite": "source-index-closures" }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "standards-recovery-routing" - }, - { - "check": "requires-closure", - "role": "canonical-module", - "suite": "standards-recovery-routing" - }, - { - "check": "former-source-destinations", - "role": "target", - "suite": "tooling-ci-workflow-reference" - }, - { - "check": "former-source-destinations", - "role": "target", - "suite": "tooling-reference-recipes" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "validation-proof-lifetime" - }, - { - "check": "canonical-workflow-sections-destinations", - "role": "markdown", - "suite": "verification-ownership" + { + "check": "requires-closure", + "role": "canonical-module", + "suite": "standards-recovery-routing" }, { - "check": "launcher-route-destinations", + "check": "former-source-destinations", "role": "target", - "suite": "verification-ownership" + "suite": "tooling-ci-workflow-reference" }, { - "check": "release-workflow-boundary-destinations", + "check": "former-source-destinations", "role": "target", - "suite": "verification-ownership" + "suite": "tooling-reference-recipes" }, { - "check": "testing-route-and-legacy-removal-destinations", + "check": "canonical-workflow-sections-destinations", "role": "target", "suite": "verification-ownership" }, @@ -13160,24 +9708,14 @@ ] }, { - "digest": "sha256:042d4fb92f880a07d1f025ace5c02aa211fadf921dd4a98701755f2e2edcbe8a", - "path": "workflows/verification/gui.md", + "digest": "sha256:59d2cbd6b7525e41b41761b0caf7471ddde9c4e33290ba4a16c812937abc4403", + "path": "workflows/planning.md", "state": "present", "uses": [ { - "check": "metadata-closure", - "role": "metadata", - "suite": "concurrency-policy" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "contract-http-outcome-projection" - }, - { - "check": "metadata-closure", + "check": "canonical-corpus", "role": "metadata", - "suite": "cross-language-contract" + "suite": "canonical-corpus-metadata" }, { "check": "local-links", @@ -13185,8 +9723,8 @@ "suite": "development-proportionality" }, { - "check": "metadata-closure", - "role": "metadata", + "check": "local-links", + "role": "markdown", "suite": "development-proportionality" }, { @@ -13195,59 +9733,76 @@ "suite": "development-proportionality" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "documentation-changelog-closure" + "check": "current-structure", + "role": "registered-policy-impact", + "suite": "policy-semantic-impact" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "filesystem-containment-policy" + "check": "negative-fixtures", + "role": "canonical-policy-impact", + "suite": "policy-semantic-impact" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "frontend-rendering-synchronization" + "check": "root-router-routes", + "role": "link-target", + "suite": "root-index-closure" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "input-validation-authority" + "check": "router-links", + "role": "link-target", + "suite": "router-legacy-route-closure" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "interop-boundary-policy" + "check": "local-links", + "role": "link-target", + "suite": "s1-routing" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "interop-event-registration" + "check": "verifier-change-route-closure", + "role": "canonical-module", + "suite": "s1-routing" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "ipc-payload-validation" + "check": "planning-routes", + "role": "link-target", + "suite": "source-index-closures" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "language-binding-boundary" + "check": "planning-routes", + "role": "member-content", + "suite": "source-index-closures" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "language-binding-wire-representation" + "check": "source-links", + "role": "link-target", + "suite": "source-index-closures" }, { - "check": "metadata-closure", + "check": "requires-closure", + "role": "canonical-module", + "suite": "standards-recovery-routing" + } + ] + }, + { + "digest": "sha256:3cec960a68530b7afec2df692329e6a31d3f3ec429d48ff51ea92272c917a239", + "path": "workflows/planning/discovery.md", + "state": "present", + "uses": [ + { + "check": "canonical-corpus", "role": "metadata", - "suite": "network-transport-policy" + "suite": "canonical-corpus-metadata" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "persistence-owner-contract" + "check": "local-links", + "role": "link-target", + "suite": "development-proportionality" + }, + { + "check": "routing-closure", + "role": "canonical-module", + "suite": "development-proportionality" }, { "check": "current-structure", @@ -13259,46 +9814,6 @@ "role": "canonical-policy-impact", "suite": "policy-semantic-impact" }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-artifact-policy" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-maintenance-policy" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-pipeline-policy" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-procedure-policy" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-publication-policy" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-recovery-policy" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-reference-closure" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-workflow-foundation" - }, { "check": "root-router-routes", "role": "link-target", @@ -13310,154 +9825,131 @@ "suite": "router-legacy-route-closure" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "runtime-decoding-policy" - }, - { - "check": "metadata", - "role": "metadata", - "suite": "rust-api-owner-contract" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-async-blocking-mutex" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-async-boundary" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-async-cancellation-observability" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-async-lifecycle" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-architecture" + "check": "local-links", + "role": "link-target", + "suite": "s1-routing" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-callback-task" + "check": "verifier-change-route-closure", + "role": "canonical-module", + "suite": "s1-routing" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-conversions" - }, + "check": "requires-closure", + "role": "canonical-module", + "suite": "standards-recovery-routing" + } + ] + }, + { + "digest": "sha256:de8ee6dd4a4f05f7146e21033beea7a40d1ddd036a3e8eb55279fa7ca6ebb37d", + "path": "workflows/release.md", + "state": "present", + "uses": [ { - "check": "metadata-closure", + "check": "canonical-corpus", "role": "metadata", - "suite": "rust-binding-enum-representation" + "suite": "canonical-corpus-metadata" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-error-mapping" + "check": "release-entrypoint-destinations", + "role": "target", + "suite": "contract-ownership" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-event-delivery" + "check": "release-workflow-route-destinations", + "role": "markdown", + "suite": "contract-ownership" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-executor-delegation" + "check": "rust-binding-contract-authority-destinations", + "role": "target", + "suite": "contract-ownership" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-runtime" + "check": "local-links", + "role": "link-target", + "suite": "development-proportionality" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-boundary-arithmetic" + "check": "routing-closure", + "role": "canonical-module", + "suite": "development-proportionality" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-dependency-candidate-inspection" + "check": "current-structure", + "role": "registered-policy-impact", + "suite": "policy-semantic-impact" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-dependency-owner-contract" + "check": "negative-fixtures", + "role": "canonical-policy-impact", + "suite": "policy-semantic-impact" }, { "check": "metadata-closure", "role": "metadata", - "suite": "rust-external-input-queue" + "suite": "release-maintenance-policy" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-filesystem-authority" + "check": "legacy-index-destinations", + "role": "target", + "suite": "release-reference-closure" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-interop-memory" + "check": "root-router-routes", + "role": "link-target", + "suite": "root-index-closure" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-listener-lifecycle" + "check": "root-router-routes", + "role": "member-content", + "suite": "root-index-closure" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-release-owner-contract" + "check": "router-links", + "role": "link-target", + "suite": "router-legacy-route-closure" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-security-panic-boundary" + "check": "source-index-destinations", + "role": "target", + "suite": "rust-release-evidence" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-tooling-owner-contract" + "check": "local-links", + "role": "link-target", + "suite": "s1-routing" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-unsafe-contracts" + "check": "verifier-change-route-closure", + "role": "canonical-module", + "suite": "s1-routing" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-wire-representation" + "check": "cross-platform-routes", + "role": "link-target", + "suite": "source-index-closures" }, { - "check": "local-links", - "role": "link-target", - "suite": "s1-routing" + "check": "cross-platform-routes", + "role": "member-content", + "suite": "source-index-closures" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "s1-routing" + "check": "documentation-routes", + "role": "link-target", + "suite": "source-index-closures" }, { - "check": "verifier-change-route-closure", - "role": "canonical-module", - "suite": "s1-routing" + "check": "documentation-routes", + "role": "member-content", + "suite": "source-index-closures" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "standards-recovery-routing" + "check": "source-links", + "role": "link-target", + "suite": "source-index-closures" }, { "check": "requires-closure", @@ -13465,106 +9957,113 @@ "suite": "standards-recovery-routing" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "validation-proof-lifetime" + "check": "launcher-route-destinations", + "role": "target", + "suite": "verification-ownership" }, { - "check": "canonical-workflow-sections-destinations", + "check": "release-route-destinations", "role": "target", "suite": "verification-ownership" + }, + { + "check": "release-workflow-boundary-destinations", + "role": "markdown", + "suite": "verification-ownership" } ] }, { - "digest": "sha256:f5cfd7d06a894f8f63ed14ebefafb6c861015bcd9746862e23d3918d1397f191", - "path": "workflows/verification/oracles.md", + "digest": "sha256:580416b544b345e82cd0b422dd65be4a51b932fc55ee69c9260027f7d6310424", + "path": "workflows/release/operations.md", "state": "present", "uses": [ { - "check": "metadata-closure", - "role": "metadata", - "suite": "concurrency-policy" - }, - { - "check": "metadata-closure", + "check": "canonical-corpus", "role": "metadata", - "suite": "contract-http-outcome-projection" + "suite": "canonical-corpus-metadata" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "cross-language-contract" + "check": "release-workflow-route-destinations", + "role": "target", + "suite": "contract-ownership" }, { "check": "local-links", "role": "link-target", "suite": "development-proportionality" }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "development-proportionality" - }, { "check": "routing-closure", "role": "canonical-module", "suite": "development-proportionality" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "documentation-changelog-closure" + "check": "current-structure", + "role": "registered-policy-impact", + "suite": "policy-semantic-impact" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "filesystem-containment-policy" + "check": "negative-fixtures", + "role": "canonical-policy-impact", + "suite": "policy-semantic-impact" }, { "check": "metadata-closure", "role": "metadata", - "suite": "frontend-rendering-synchronization" + "suite": "release-maintenance-policy" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "input-validation-authority" + "check": "root-router-routes", + "role": "link-target", + "suite": "root-index-closure" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "interop-boundary-policy" + "check": "router-links", + "role": "link-target", + "suite": "router-legacy-route-closure" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "interop-event-registration" + "check": "local-links", + "role": "link-target", + "suite": "s1-routing" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "ipc-payload-validation" + "check": "verifier-change-route-closure", + "role": "canonical-module", + "suite": "s1-routing" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "language-binding-boundary" + "check": "requires-closure", + "role": "canonical-module", + "suite": "standards-recovery-routing" }, { - "check": "metadata-closure", + "check": "release-workflow-boundary-destinations", + "role": "target", + "suite": "verification-ownership" + } + ] + }, + { + "digest": "sha256:e14ac61063820e13a3b2f90cf680b5349a0e3c1064e5fdaa3177b1c3e42d5567", + "path": "workflows/standards-authoring.md", + "state": "present", + "uses": [ + { + "check": "canonical-corpus", "role": "metadata", - "suite": "language-binding-wire-representation" + "suite": "canonical-corpus-metadata" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "network-transport-policy" + "check": "local-links", + "role": "link-target", + "suite": "development-proportionality" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "persistence-owner-contract" + "check": "routing-closure", + "role": "canonical-module", + "suite": "development-proportionality" }, { "check": "current-structure", @@ -13577,184 +10076,223 @@ "suite": "policy-semantic-impact" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-artifact-policy" + "check": "root-router-routes", + "role": "link-target", + "suite": "root-index-closure" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-maintenance-policy" + "check": "router-links", + "role": "link-target", + "suite": "router-legacy-route-closure" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-pipeline-policy" + "check": "local-links", + "role": "link-target", + "suite": "s1-routing" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-procedure-policy" + "check": "verifier-change-route-closure", + "role": "canonical-module", + "suite": "s1-routing" }, { - "check": "metadata-closure", + "check": "requires-closure", + "role": "canonical-module", + "suite": "standards-recovery-routing" + } + ] + }, + { + "digest": "sha256:34f81c9653d1c66203ac2f77968070b82c267e2646254b12482ee1263246a427", + "path": "workflows/tooling.md", + "state": "present", + "uses": [ + { + "check": "canonical-corpus", "role": "metadata", - "suite": "release-publication-policy" + "suite": "canonical-corpus-metadata" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-recovery-policy" + "check": "local-links", + "role": "link-target", + "suite": "development-proportionality" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-reference-closure" + "check": "routing-closure", + "role": "canonical-module", + "suite": "development-proportionality" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-workflow-foundation" + "check": "current-structure", + "role": "registered-policy-impact", + "suite": "policy-semantic-impact" + }, + { + "check": "negative-fixtures", + "role": "canonical-policy-impact", + "suite": "policy-semantic-impact" }, { "check": "root-router-routes", "role": "link-target", "suite": "root-index-closure" }, + { + "check": "root-router-routes", + "role": "member-content", + "suite": "root-index-closure" + }, { "check": "router-links", "role": "link-target", "suite": "router-legacy-route-closure" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "runtime-decoding-policy" + "check": "source-index-destinations", + "role": "target", + "suite": "rust-dependency-build-cost" }, { - "check": "metadata", - "role": "metadata", - "suite": "rust-api-owner-contract" + "check": "source-index-destinations", + "role": "target", + "suite": "rust-release-evidence" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-async-blocking-mutex" + "check": "local-links", + "role": "link-target", + "suite": "s1-routing" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-async-boundary" + "check": "verifier-change-route-closure", + "role": "canonical-module", + "suite": "s1-routing" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-async-cancellation-observability" + "check": "frontend-routes", + "role": "link-target", + "suite": "source-index-closures" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-async-lifecycle" + "check": "frontend-routes", + "role": "member-content", + "suite": "source-index-closures" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-architecture" + "check": "source-links", + "role": "link-target", + "suite": "source-index-closures" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-callback-task" + "check": "requires-closure", + "role": "canonical-module", + "suite": "standards-recovery-routing" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-conversions" + "check": "former-source-destinations", + "role": "target", + "suite": "tooling-ci-workflow-reference" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-enum-representation" + "check": "reference-destinations", + "role": "target", + "suite": "tooling-ci-workflow-reference" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-error-mapping" + "check": "former-source-destinations", + "role": "target", + "suite": "tooling-reference-recipes" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-event-delivery" + "check": "reference-destinations", + "role": "target", + "suite": "tooling-reference-recipes" }, { - "check": "metadata-closure", + "check": "tooling-route-and-legacy-removal-destinations", + "role": "target", + "suite": "verification-ownership" + } + ] + }, + { + "digest": "sha256:e5782006f8e871e75475490be34ffae3a1df4d97eae2947c4f4c3e6100a63b6a", + "path": "workflows/verification.md", + "state": "present", + "uses": [ + { + "check": "canonical-corpus", "role": "metadata", - "suite": "rust-binding-executor-delegation" + "suite": "canonical-corpus-metadata" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-runtime" + "check": "architecture-contract-authority-destinations", + "role": "target", + "suite": "contract-ownership" + }, + { + "check": "coding-route-destinations", + "role": "target", + "suite": "contract-ownership" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-boundary-arithmetic" + "check": "release-workflow-route-destinations", + "role": "target", + "suite": "contract-ownership" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-dependency-candidate-inspection" + "check": "rust-binding-contract-authority-destinations", + "role": "target", + "suite": "contract-ownership" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-dependency-owner-contract" + "check": "local-links", + "role": "link-target", + "suite": "development-proportionality" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-external-input-queue" + "check": "routing-closure", + "role": "canonical-module", + "suite": "development-proportionality" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-filesystem-authority" + "check": "current-structure", + "role": "registered-policy-impact", + "suite": "policy-semantic-impact" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-interop-memory" + "check": "negative-fixtures", + "role": "canonical-policy-impact", + "suite": "policy-semantic-impact" }, { "check": "metadata-closure", "role": "metadata", - "suite": "rust-listener-lifecycle" + "suite": "release-maintenance-policy" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-release-owner-contract" + "check": "root-router-routes", + "role": "link-target", + "suite": "root-index-closure" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-security-panic-boundary" + "check": "router-links", + "role": "link-target", + "suite": "router-legacy-route-closure" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-tooling-owner-contract" + "check": "source-index-destinations", + "role": "target", + "suite": "rust-api-rustdoc" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-unsafe-contracts" + "check": "source-index-destinations", + "role": "target", + "suite": "rust-dependency-build-cost" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-wire-representation" + "check": "source-index-destinations", + "role": "target", + "suite": "rust-release-evidence" }, { "check": "local-links", @@ -13762,8 +10300,8 @@ "suite": "s1-routing" }, { - "check": "metadata-closure", - "role": "metadata", + "check": "local-links", + "role": "markdown", "suite": "s1-routing" }, { @@ -13772,116 +10310,101 @@ "suite": "s1-routing" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "standards-recovery-routing" + "check": "coding-routes", + "role": "link-target", + "suite": "source-index-closures" }, { - "check": "requires-closure", - "role": "canonical-module", - "suite": "standards-recovery-routing" + "check": "coding-routes", + "role": "member-content", + "suite": "source-index-closures" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "validation-proof-lifetime" + "check": "cross-platform-routes", + "role": "link-target", + "suite": "source-index-closures" }, { - "check": "canonical-workflow-sections-destinations", - "role": "target", - "suite": "verification-ownership" - } - ] - }, - { - "digest": "sha256:a27afd0d5e11f8e4bd5f3319b1a2da55593ac59a9f4b8eb82e7e8641c32f9a7d", - "path": "workflows/verification/platforms.md", - "state": "present", - "uses": [ - { - "check": "metadata-closure", - "role": "metadata", - "suite": "concurrency-policy" + "check": "cross-platform-routes", + "role": "member-content", + "suite": "source-index-closures" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "contract-http-outcome-projection" + "check": "frontend-routes", + "role": "link-target", + "suite": "source-index-closures" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "cross-language-contract" + "check": "frontend-routes", + "role": "member-content", + "suite": "source-index-closures" }, { - "check": "local-links", + "check": "source-links", "role": "link-target", - "suite": "development-proportionality" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "development-proportionality" + "suite": "source-index-closures" }, { - "check": "routing-closure", + "check": "requires-closure", "role": "canonical-module", - "suite": "development-proportionality" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "documentation-changelog-closure" + "suite": "standards-recovery-routing" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "filesystem-containment-policy" + "check": "former-source-destinations", + "role": "target", + "suite": "tooling-ci-workflow-reference" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "frontend-rendering-synchronization" + "check": "former-source-destinations", + "role": "target", + "suite": "tooling-reference-recipes" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "input-validation-authority" + "check": "canonical-workflow-sections-destinations", + "role": "markdown", + "suite": "verification-ownership" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "interop-boundary-policy" + "check": "launcher-route-destinations", + "role": "target", + "suite": "verification-ownership" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "interop-event-registration" + "check": "release-workflow-boundary-destinations", + "role": "target", + "suite": "verification-ownership" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "ipc-payload-validation" + "check": "testing-route-and-legacy-removal-destinations", + "role": "target", + "suite": "verification-ownership" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "language-binding-boundary" - }, + "check": "tooling-route-and-legacy-removal-destinations", + "role": "target", + "suite": "verification-ownership" + } + ] + }, + { + "digest": "sha256:042d4fb92f880a07d1f025ace5c02aa211fadf921dd4a98701755f2e2edcbe8a", + "path": "workflows/verification/gui.md", + "state": "present", + "uses": [ { - "check": "metadata-closure", + "check": "canonical-corpus", "role": "metadata", - "suite": "language-binding-wire-representation" + "suite": "canonical-corpus-metadata" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "network-transport-policy" + "check": "local-links", + "role": "link-target", + "suite": "development-proportionality" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "persistence-owner-contract" + "check": "routing-closure", + "role": "canonical-module", + "suite": "development-proportionality" }, { "check": "current-structure", @@ -13893,46 +10416,11 @@ "role": "canonical-policy-impact", "suite": "policy-semantic-impact" }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-artifact-policy" - }, { "check": "metadata-closure", "role": "metadata", "suite": "release-maintenance-policy" }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-pipeline-policy" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-procedure-policy" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-publication-policy" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-recovery-policy" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-reference-closure" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "release-workflow-foundation" - }, { "check": "root-router-routes", "role": "link-target", @@ -13944,143 +10432,142 @@ "suite": "router-legacy-route-closure" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "runtime-decoding-policy" - }, - { - "check": "metadata", - "role": "metadata", - "suite": "rust-api-owner-contract" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-async-blocking-mutex" - }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-async-boundary" + "check": "local-links", + "role": "link-target", + "suite": "s1-routing" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-async-cancellation-observability" + "check": "verifier-change-route-closure", + "role": "canonical-module", + "suite": "s1-routing" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-async-lifecycle" + "check": "requires-closure", + "role": "canonical-module", + "suite": "standards-recovery-routing" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-architecture" - }, + "check": "canonical-workflow-sections-destinations", + "role": "target", + "suite": "verification-ownership" + } + ] + }, + { + "digest": "sha256:f5cfd7d06a894f8f63ed14ebefafb6c861015bcd9746862e23d3918d1397f191", + "path": "workflows/verification/oracles.md", + "state": "present", + "uses": [ { - "check": "metadata-closure", + "check": "canonical-corpus", "role": "metadata", - "suite": "rust-binding-callback-task" + "suite": "canonical-corpus-metadata" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-conversions" + "check": "local-links", + "role": "link-target", + "suite": "development-proportionality" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-enum-representation" + "check": "routing-closure", + "role": "canonical-module", + "suite": "development-proportionality" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-error-mapping" + "check": "current-structure", + "role": "registered-policy-impact", + "suite": "policy-semantic-impact" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-event-delivery" + "check": "negative-fixtures", + "role": "canonical-policy-impact", + "suite": "policy-semantic-impact" }, { "check": "metadata-closure", "role": "metadata", - "suite": "rust-binding-executor-delegation" + "suite": "release-maintenance-policy" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-binding-runtime" + "check": "root-router-routes", + "role": "link-target", + "suite": "root-index-closure" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-boundary-arithmetic" + "check": "router-links", + "role": "link-target", + "suite": "router-legacy-route-closure" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-dependency-candidate-inspection" + "check": "local-links", + "role": "link-target", + "suite": "s1-routing" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-dependency-owner-contract" + "check": "verifier-change-route-closure", + "role": "canonical-module", + "suite": "s1-routing" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-external-input-queue" + "check": "requires-closure", + "role": "canonical-module", + "suite": "standards-recovery-routing" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-filesystem-authority" - }, + "check": "canonical-workflow-sections-destinations", + "role": "target", + "suite": "verification-ownership" + } + ] + }, + { + "digest": "sha256:a27afd0d5e11f8e4bd5f3319b1a2da55593ac59a9f4b8eb82e7e8641c32f9a7d", + "path": "workflows/verification/platforms.md", + "state": "present", + "uses": [ { - "check": "metadata-closure", + "check": "canonical-corpus", "role": "metadata", - "suite": "rust-interop-memory" + "suite": "canonical-corpus-metadata" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-listener-lifecycle" + "check": "local-links", + "role": "link-target", + "suite": "development-proportionality" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-release-owner-contract" + "check": "routing-closure", + "role": "canonical-module", + "suite": "development-proportionality" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-security-panic-boundary" + "check": "current-structure", + "role": "registered-policy-impact", + "suite": "policy-semantic-impact" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-tooling-owner-contract" + "check": "negative-fixtures", + "role": "canonical-policy-impact", + "suite": "policy-semantic-impact" }, { "check": "metadata-closure", "role": "metadata", - "suite": "rust-unsafe-contracts" + "suite": "release-maintenance-policy" }, { - "check": "metadata-closure", - "role": "metadata", - "suite": "rust-wire-representation" + "check": "root-router-routes", + "role": "link-target", + "suite": "root-index-closure" }, { - "check": "local-links", + "check": "router-links", "role": "link-target", - "suite": "s1-routing" + "suite": "router-legacy-route-closure" }, { - "check": "metadata-closure", - "role": "metadata", + "check": "local-links", + "role": "link-target", "suite": "s1-routing" }, { @@ -14088,21 +10575,11 @@ "role": "canonical-module", "suite": "s1-routing" }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "standards-recovery-routing" - }, { "check": "requires-closure", "role": "canonical-module", "suite": "standards-recovery-routing" }, - { - "check": "metadata-closure", - "role": "metadata", - "suite": "validation-proof-lifetime" - }, { "check": "canonical-workflow-sections-destinations", "role": "target", @@ -14112,11 +10589,11 @@ } ], "registry": { - "digest": "sha256:8c0b2f96659a45ed04e42a22501395a6ac62f522093cb9b18985e8c5d5a1794c", + "digest": "sha256:af8f30134a34385b211429c7d325b9f0c233839ec8d49aee03f882f67aa69ca5", "path": "evaluation/standards-effectiveness/suite-registry.toml" }, "repository_index": { - "digest": "sha256:25f5d13e9650e10c5bcc198f50ea81aa00f90799ca3f9ba2a5a433a658262229", + "digest": "sha256:ae3843ae7d58b01dbbd6efb662286d52e4fc9c70f9c5e14bde04c0544d9b7d17", "uses": [ { "check": "python-package-contract", @@ -14176,18 +10653,16 @@ "requires": [] }, { - "digest": "sha256:b672f405b9cb72f567bd5d79d1a936422c4b80a39283bef4ca6c33a4211b2196", - "id": "release-reference-closure", - "path": "evaluation/standards-effectiveness/suites/release-reference-closure.toml", + "digest": "sha256:8f57462615fe61d89cc6d1c5e59d7754ab7ceb8302572888e122f558049b5c9b", + "id": "canonical-corpus-metadata", + "path": "evaluation/standards-effectiveness/suites/canonical-corpus-metadata.toml", "requires": [] }, { - "digest": "sha256:c2cb117c3b841b7ae035616b71fa425b4d7b0807071d6942e38069c117d2bd8e", - "id": "release-recovery-policy", - "path": "evaluation/standards-effectiveness/suites/release-recovery-policy.toml", - "requires": [ - "release-reference-closure" - ] + "digest": "sha256:7fea2ba620f744cee21fbd96edfff1fe2f88f43ce5d277a2edf4e0a3e979e9f7", + "id": "release-reference-closure", + "path": "evaluation/standards-effectiveness/suites/release-reference-closure.toml", + "requires": [] }, { "digest": "sha256:61760956e55a27d2333794a36514cdabf23ca2d73722a6f71c00fb7ffda53ea8", @@ -14198,109 +10673,13 @@ ] }, { - "digest": "sha256:db00c577bea185cc27d9d0285beeb4c2ae869ca51621227a9f93129c5b86d03e", - "id": "release-pipeline-policy", - "path": "evaluation/standards-effectiveness/suites/release-pipeline-policy.toml", - "requires": [ - "release-reference-closure" - ] - }, - { - "digest": "sha256:e98fd44783399a6fbeb5deb5a26d2d530c03d42ecb3a70baf159b63c3718e21b", - "id": "release-artifact-policy", - "path": "evaluation/standards-effectiveness/suites/release-artifact-policy.toml", - "requires": [ - "release-reference-closure" - ] - }, - { - "digest": "sha256:d3e9f3866322d3239362c02e9f3dd8cd35ed2facf3dd06e0f5c73f897abd8774", - "id": "release-publication-policy", - "path": "evaluation/standards-effectiveness/suites/release-publication-policy.toml", - "requires": [ - "release-reference-closure" - ] - }, - { - "digest": "sha256:a57d965e86ce3ddb1b840f49833d95ab1ff8a66afb16f58f1b7fe8b160494320", - "id": "documentation-changelog-closure", - "path": "evaluation/standards-effectiveness/suites/documentation-changelog-closure.toml", - "requires": [] - }, - { - "digest": "sha256:7e6c4dfda782068c7ffe8d3af35fca6e2f7e36ec865993d9d1be98c67576b7e0", - "id": "documentation-reference", - "path": "evaluation/standards-effectiveness/suites/documentation-reference.toml", - "requires": [] - }, - { - "digest": "sha256:ddd9d0f582873114775fdf1d23cf5505ebe0d47f06e7850ec61a15d8eb3f4fbb", - "id": "release-workflow-foundation", - "path": "evaluation/standards-effectiveness/suites/release-workflow-foundation.toml", - "requires": [] - }, - { - "digest": "sha256:406b90e3ea1e2bd5e7cdfa22603b53fb8f3099419a77fccfe1b9c051c4674ed2", - "id": "rust-dependency-owner-contract", - "path": "evaluation/standards-effectiveness/suites/rust-dependency-owner-contract.toml", - "requires": [] - }, - { - "digest": "sha256:6bf9eb6f99cfab91e5faa7ac9236f961bca5d7796b682be482064b2a4e41326e", - "id": "rust-release-owner-contract", - "path": "evaluation/standards-effectiveness/suites/rust-release-owner-contract.toml", - "requires": [] - }, - { - "digest": "sha256:7561c909672665d201d0c221a59077cce9ff86b3f67c16fa6dfb34f12e560133", - "id": "rust-tooling-owner-contract", - "path": "evaluation/standards-effectiveness/suites/rust-tooling-owner-contract.toml", - "requires": [] - }, - { - "digest": "sha256:c39b918d6e48f0fe627f38ea3c4b7683bad94032cafa5999b4af1b4f63e8da02", - "id": "rust-dependency-candidate-inspection", - "path": "evaluation/standards-effectiveness/suites/rust-dependency-candidate-inspection.toml", - "requires": [] - }, - { - "digest": "sha256:93bc3acf6122f977034961bba5d8cae43453c45052ea0d8935f794d561bc78d3", - "id": "rust-async-blocking-mutex", - "path": "evaluation/standards-effectiveness/suites/rust-async-blocking-mutex.toml", - "requires": [] - }, - { - "digest": "sha256:8679e434eca610c36d8b78117cec74c394a780cfdbacc80fb0908957810e8107", - "id": "rust-async-cancellation-observability", - "path": "evaluation/standards-effectiveness/suites/rust-async-cancellation-observability.toml", - "requires": [] - }, - { - "digest": "sha256:f9ea6220d9523f654146694a74b71db3a1dccad6781ab5f4c045fe46d0ab3882", - "id": "rust-interop-memory", - "path": "evaluation/standards-effectiveness/suites/rust-interop-memory.toml", - "requires": [] - }, - { - "digest": "sha256:4908cffe925ed6f64c5bade4efda3aee71bd9f1416ef3bd95ed8cf449141fe7d", - "id": "contract-http-outcome-projection", - "path": "evaluation/standards-effectiveness/suites/contract-http-outcome-projection.toml", - "requires": [] - }, - { - "digest": "sha256:bb25b83b069e31d1a15c9ea2d0d3ba0bc53c30e9f581da0fdf110e01646cdf97", - "id": "persistence-owner-contract", - "path": "evaluation/standards-effectiveness/suites/persistence-owner-contract.toml", - "requires": [] - }, - { - "digest": "sha256:0d38d373f07548a92f37c2ecd2a8f7d5b907de3b134664726a23a787b4266678", + "digest": "sha256:63cca2ceac227aacccf33a964801a645bb4083719e5011a46a313308f2628026", "id": "s1-routing", "path": "evaluation/standards-effectiveness/suites/s1-routing.toml", "requires": [] }, { - "digest": "sha256:9ba7154751917ef53bfa6d4596847f4cda3004947b3086af2ac15875462065a4", + "digest": "sha256:08dab633d8a18eb6a503658c62473e962f7794fe1c077ca8171edc3c7d18e978", "id": "development-proportionality", "path": "evaluation/standards-effectiveness/suites/development-proportionality.toml", "requires": [] @@ -14318,7 +10697,7 @@ "requires": [] }, { - "digest": "sha256:ef26cc7f741c03651849af77d29d53635e060cbbae39fea530c903ab8f56deb9", + "digest": "sha256:6304c413733928e233dbc69b8cfdafcc6be120a7070d3e0948cd7d3a55f90ae3", "id": "rust-profile-authority-closure", "path": "evaluation/standards-effectiveness/suites/rust-profile-authority-closure.toml", "requires": [] @@ -14341,12 +10720,6 @@ "path": "evaluation/standards-effectiveness/suites/planning-consolidation.toml", "requires": [] }, - { - "digest": "sha256:a465e91f30c5803dbd6c829e68d03b466a634a830dd87094db960334386a2f3b", - "id": "rust-api-owner-contract", - "path": "evaluation/standards-effectiveness/suites/rust-api-owner-contract.toml", - "requires": [] - }, { "digest": "sha256:823c0b11b169e39ed02db8f64e70c8887932fa08143c7312ff270e4209518039", "id": "source-index-closures", @@ -14354,169 +10727,7 @@ "requires": [] }, { - "digest": "sha256:9654c91342b49eacf415eb6477d87642df284b74982bd00b859c4d462802d720", - "id": "frontend-rendering-synchronization", - "path": "evaluation/standards-effectiveness/suites/frontend-rendering-synchronization.toml", - "requires": [] - }, - { - "digest": "sha256:fe33581eec327e25acb81b76aa6cabaca87029cdd0346223afc978f91b210ca6", - "id": "architecture-pattern-reference-owner", - "path": "evaluation/standards-effectiveness/suites/architecture-pattern-reference-owner.toml", - "requires": [] - }, - { - "digest": "sha256:7bb1602aa91eac60b8e12df55daa54f95b2730b4be39e46ea267a16b95795a57", - "id": "rust-async-boundary", - "path": "evaluation/standards-effectiveness/suites/rust-async-boundary.toml", - "requires": [] - }, - { - "digest": "sha256:3668679df83d85d2004e28a1f5a4826f9b4d2d93e0f502292273d9036f4a3b64", - "id": "rust-binding-error-mapping", - "path": "evaluation/standards-effectiveness/suites/rust-binding-error-mapping.toml", - "requires": [] - }, - { - "digest": "sha256:8810692f6a1da8adcb912ff9c7f28a12499cc5bdc3fee4186b40f9fd407af71f", - "id": "rust-unsafe-contracts", - "path": "evaluation/standards-effectiveness/suites/rust-unsafe-contracts.toml", - "requires": [] - }, - { - "digest": "sha256:e5093b5f7b1f966c794d602e7fa9e73de261f5aa8bd3408e3352aec23cc21642", - "id": "documentation-policy-consolidation", - "path": "evaluation/standards-effectiveness/suites/documentation-policy-consolidation.toml", - "requires": [] - }, - { - "digest": "sha256:c41ae05a24d41550a79f28c86bafe3a439422e6a06ccb4e6d55ac1f5d48933ac", - "id": "release-procedure-policy", - "path": "evaluation/standards-effectiveness/suites/release-procedure-policy.toml", - "requires": [] - }, - { - "digest": "sha256:d7109e373cdf655e3f76409019967537e9d988529c27ce958655c20a44843724", - "id": "language-binding-wire-representation", - "path": "evaluation/standards-effectiveness/suites/language-binding-wire-representation.toml", - "requires": [] - }, - { - "digest": "sha256:6d4dfa2eb18c32b51cb642c6b48ab7e3d3d6c941923c8302e871743970c985c4", - "id": "rust-binding-enum-representation", - "path": "evaluation/standards-effectiveness/suites/rust-binding-enum-representation.toml", - "requires": [] - }, - { - "digest": "sha256:809fb407d3a0f40fa6f3d49772d399463709f8f511b4dad846f23463bfb1dfa5", - "id": "rust-wire-representation", - "path": "evaluation/standards-effectiveness/suites/rust-wire-representation.toml", - "requires": [] - }, - { - "digest": "sha256:d1c30ddaed6e789c75a43a720890f66e0e41dadf1624f24a9be63a0e4c332188", - "id": "rust-binding-callback-task", - "path": "evaluation/standards-effectiveness/suites/rust-binding-callback-task.toml", - "requires": [] - }, - { - "digest": "sha256:74c3b83e09afb7f14c6645dfcf8eadb8c280130b790f8dca8f59e5b208251452", - "id": "rust-binding-executor-delegation", - "path": "evaluation/standards-effectiveness/suites/rust-binding-executor-delegation.toml", - "requires": [] - }, - { - "digest": "sha256:4ead7e6e2be6488b661a1cdbf73255b3c96537ceeea5daffe4f40b08b83e0874", - "id": "rust-binding-event-delivery", - "path": "evaluation/standards-effectiveness/suites/rust-binding-event-delivery.toml", - "requires": [] - }, - { - "digest": "sha256:b7caccafeeac8442df5e38ab2069c9f39f9cea1c421a49276b2d9d9adfb13b8f", - "id": "rust-security-panic-boundary", - "path": "evaluation/standards-effectiveness/suites/rust-security-panic-boundary.toml", - "requires": [] - }, - { - "digest": "sha256:402e1f8118071a3faf4a4d6109593664a2028a872f3d046ac16ac2ccfc1d95a8", - "id": "rust-external-input-queue", - "path": "evaluation/standards-effectiveness/suites/rust-external-input-queue.toml", - "requires": [] - }, - { - "digest": "sha256:aaa28d7f83777bbb60336b0b5157597a7b425b39ba0a72bd425350cdfea78925", - "id": "validation-proof-lifetime", - "path": "evaluation/standards-effectiveness/suites/validation-proof-lifetime.toml", - "requires": [] - }, - { - "digest": "sha256:4da1e26abcb7245be74ce24e928f36233234e19153652aadae99571d3e1de4f4", - "id": "input-validation-authority", - "path": "evaluation/standards-effectiveness/suites/input-validation-authority.toml", - "requires": [] - }, - { - "digest": "sha256:a9928475098c48bb93451d9c5eccef6e6962bdbe8edce8ca6a40f87ef2f924b4", - "id": "network-transport-policy", - "path": "evaluation/standards-effectiveness/suites/network-transport-policy.toml", - "requires": [] - }, - { - "digest": "sha256:ebe0845f6b7a3cc776349ad54c0d0796715c5a1f8df5a8157eceafeb0c83825b", - "id": "rust-filesystem-authority", - "path": "evaluation/standards-effectiveness/suites/rust-filesystem-authority.toml", - "requires": [] - }, - { - "digest": "sha256:5db963df29645eec64741ed16d64e81e9acde5aafa1cb7a4af0f6d0ad637e900", - "id": "rust-listener-lifecycle", - "path": "evaluation/standards-effectiveness/suites/rust-listener-lifecycle.toml", - "requires": [] - }, - { - "digest": "sha256:7507ae9af0da2d3bcbd27a3708485953a19e9b0bfdfb12dada1d32135b3f65eb", - "id": "rust-async-lifecycle", - "path": "evaluation/standards-effectiveness/suites/rust-async-lifecycle.toml", - "requires": [] - }, - { - "digest": "sha256:a248cac0db36d6555405a14a56e95809412bb5fdf8958f5a618a385626c6cf2c", - "id": "rust-boundary-arithmetic", - "path": "evaluation/standards-effectiveness/suites/rust-boundary-arithmetic.toml", - "requires": [] - }, - { - "digest": "sha256:852b43dbb3eb73a2dba287f88d988abba41540319072123cd662c7e871865e09", - "id": "filesystem-containment-policy", - "path": "evaluation/standards-effectiveness/suites/filesystem-containment-policy.toml", - "requires": [] - }, - { - "digest": "sha256:7d9da77f7e7f3508b379534697e41e1bc6a1895f575dd3bdc57e9aa86853b9cf", - "id": "ipc-payload-validation", - "path": "evaluation/standards-effectiveness/suites/ipc-payload-validation.toml", - "requires": [] - }, - { - "digest": "sha256:049224f8dc9d0b6245a710ab827e1558d595810d63425b738eceb58f08ed2550", - "id": "rust-binding-runtime", - "path": "evaluation/standards-effectiveness/suites/rust-binding-runtime.toml", - "requires": [] - }, - { - "digest": "sha256:a250180c069e73edca8d283d609254022cbffd4c55308cad8b95dcfd1f52e054", - "id": "rust-binding-architecture", - "path": "evaluation/standards-effectiveness/suites/rust-binding-architecture.toml", - "requires": [] - }, - { - "digest": "sha256:5e46fb2e608fe6860e5b5c03117b72a80c2807057ccfd37b4e59d5dccf8804cc", - "id": "cross-language-contract", - "path": "evaluation/standards-effectiveness/suites/cross-language-contract.toml", - "requires": [] - }, - { - "digest": "sha256:d8f87d528b0340c1676aa0bbcaea20df03b4da856580b645986c1825768f0006", + "digest": "sha256:3d9838e58ca4728da7bda9c3a670fd5070e0b2e795e45302624efa90622b5a9f", "id": "standards-recovery-routing", "path": "evaluation/standards-effectiveness/suites/standards-recovery-routing.toml", "requires": [] @@ -14535,47 +10746,11 @@ "generated-contract-semantic-conformance" ] }, - { - "digest": "sha256:fdb7aeededde0c448a6877ef0eefac3996c76e4c28f16e2310061594acad7826", - "id": "language-binding-boundary", - "path": "evaluation/standards-effectiveness/suites/language-binding-boundary.toml", - "requires": [] - }, - { - "digest": "sha256:89bfa1ca30bedf2bc372fdbdb06eee71cbf635f86a13674492501648b5fb5da5", - "id": "rust-binding-conversions", - "path": "evaluation/standards-effectiveness/suites/rust-binding-conversions.toml", - "requires": [] - }, - { - "digest": "sha256:c0fdf0dc5d9f4a41cd3944181a87c7377e0844acb8baf7c071e0ac7d91b91afa", - "id": "runtime-decoding-policy", - "path": "evaluation/standards-effectiveness/suites/runtime-decoding-policy.toml", - "requires": [] - }, - { - "digest": "sha256:47edd12aca4ef13810043ead4a25541ba4903d5f8c635b692f4d4d2df7be3ca0", - "id": "interop-event-registration", - "path": "evaluation/standards-effectiveness/suites/interop-event-registration.toml", - "requires": [] - }, - { - "digest": "sha256:87b3601ecb7352ccba001878233666c5981f56eb3339b35daa6fe939e92be8f6", - "id": "concurrency-policy", - "path": "evaluation/standards-effectiveness/suites/concurrency-policy.toml", - "requires": [] - }, { "digest": "sha256:8152e0dd7fc5b3997f9c1f7be58a29ec19cac0e92337d55757b62768f3319f3e", "id": "contract-ownership", "path": "evaluation/standards-effectiveness/suites/contract-ownership.toml", "requires": [] - }, - { - "digest": "sha256:1b06478d82d260ad8effc46bddf89fb6b9a0f01b60d1dc3adeb43345c4baaa1d", - "id": "interop-boundary-policy", - "path": "evaluation/standards-effectiveness/suites/interop-boundary-policy.toml", - "requires": [] } ] } diff --git a/evaluation/standards-effectiveness/suite-registry.toml b/evaluation/standards-effectiveness/suite-registry.toml index 0a506996..80c2ec3d 100644 --- a/evaluation/standards-effectiveness/suite-registry.toml +++ b/evaluation/standards-effectiveness/suite-registry.toml @@ -41,95 +41,20 @@ path = "evaluation/standards-effectiveness/suites/metadata-fixtures.toml" requires = [] [[suites]] -id = "release-reference-closure" -path = "evaluation/standards-effectiveness/suites/release-reference-closure.toml" +id = "canonical-corpus-metadata" +path = "evaluation/standards-effectiveness/suites/canonical-corpus-metadata.toml" requires = [] [[suites]] -id = "release-recovery-policy" -path = "evaluation/standards-effectiveness/suites/release-recovery-policy.toml" -requires = ["release-reference-closure"] +id = "release-reference-closure" +path = "evaluation/standards-effectiveness/suites/release-reference-closure.toml" +requires = [] [[suites]] id = "release-maintenance-policy" path = "evaluation/standards-effectiveness/suites/release-maintenance-policy.toml" requires = ["release-reference-closure"] -[[suites]] -id = "release-pipeline-policy" -path = "evaluation/standards-effectiveness/suites/release-pipeline-policy.toml" -requires = ["release-reference-closure"] - -[[suites]] -id = "release-artifact-policy" -path = "evaluation/standards-effectiveness/suites/release-artifact-policy.toml" -requires = ["release-reference-closure"] - -[[suites]] -id = "release-publication-policy" -path = "evaluation/standards-effectiveness/suites/release-publication-policy.toml" -requires = ["release-reference-closure"] - -[[suites]] -id = "documentation-changelog-closure" -path = "evaluation/standards-effectiveness/suites/documentation-changelog-closure.toml" -requires = [] - -[[suites]] -id = "documentation-reference" -path = "evaluation/standards-effectiveness/suites/documentation-reference.toml" -requires = [] - -[[suites]] -id = "release-workflow-foundation" -path = "evaluation/standards-effectiveness/suites/release-workflow-foundation.toml" -requires = [] - -[[suites]] -id = "rust-dependency-owner-contract" -path = "evaluation/standards-effectiveness/suites/rust-dependency-owner-contract.toml" -requires = [] - -[[suites]] -id = "rust-release-owner-contract" -path = "evaluation/standards-effectiveness/suites/rust-release-owner-contract.toml" -requires = [] - -[[suites]] -id = "rust-tooling-owner-contract" -path = "evaluation/standards-effectiveness/suites/rust-tooling-owner-contract.toml" -requires = [] - -[[suites]] -id = "rust-dependency-candidate-inspection" -path = "evaluation/standards-effectiveness/suites/rust-dependency-candidate-inspection.toml" -requires = [] - -[[suites]] -id = "rust-async-blocking-mutex" -path = "evaluation/standards-effectiveness/suites/rust-async-blocking-mutex.toml" -requires = [] - -[[suites]] -id = "rust-async-cancellation-observability" -path = "evaluation/standards-effectiveness/suites/rust-async-cancellation-observability.toml" -requires = [] - -[[suites]] -id = "rust-interop-memory" -path = "evaluation/standards-effectiveness/suites/rust-interop-memory.toml" -requires = [] - -[[suites]] -id = "contract-http-outcome-projection" -path = "evaluation/standards-effectiveness/suites/contract-http-outcome-projection.toml" -requires = [] - -[[suites]] -id = "persistence-owner-contract" -path = "evaluation/standards-effectiveness/suites/persistence-owner-contract.toml" -requires = [] - [[suites]] id = "s1-routing" path = "evaluation/standards-effectiveness/suites/s1-routing.toml" @@ -170,151 +95,11 @@ id = "planning-consolidation" path = "evaluation/standards-effectiveness/suites/planning-consolidation.toml" requires = [] -[[suites]] -id = "rust-api-owner-contract" -path = "evaluation/standards-effectiveness/suites/rust-api-owner-contract.toml" -requires = [] - [[suites]] id = "source-index-closures" path = "evaluation/standards-effectiveness/suites/source-index-closures.toml" requires = [] -[[suites]] -id = "frontend-rendering-synchronization" -path = "evaluation/standards-effectiveness/suites/frontend-rendering-synchronization.toml" -requires = [] - -[[suites]] -id = "architecture-pattern-reference-owner" -path = "evaluation/standards-effectiveness/suites/architecture-pattern-reference-owner.toml" -requires = [] - -[[suites]] -id = "rust-async-boundary" -path = "evaluation/standards-effectiveness/suites/rust-async-boundary.toml" -requires = [] - -[[suites]] -id = "rust-binding-error-mapping" -path = "evaluation/standards-effectiveness/suites/rust-binding-error-mapping.toml" -requires = [] - -[[suites]] -id = "rust-unsafe-contracts" -path = "evaluation/standards-effectiveness/suites/rust-unsafe-contracts.toml" -requires = [] - -[[suites]] -id = "documentation-policy-consolidation" -path = "evaluation/standards-effectiveness/suites/documentation-policy-consolidation.toml" -requires = [] - -[[suites]] -id = "release-procedure-policy" -path = "evaluation/standards-effectiveness/suites/release-procedure-policy.toml" -requires = [] - -[[suites]] -id = "language-binding-wire-representation" -path = "evaluation/standards-effectiveness/suites/language-binding-wire-representation.toml" -requires = [] - -[[suites]] -id = "rust-binding-enum-representation" -path = "evaluation/standards-effectiveness/suites/rust-binding-enum-representation.toml" -requires = [] - -[[suites]] -id = "rust-wire-representation" -path = "evaluation/standards-effectiveness/suites/rust-wire-representation.toml" -requires = [] - -[[suites]] -id = "rust-binding-callback-task" -path = "evaluation/standards-effectiveness/suites/rust-binding-callback-task.toml" -requires = [] - -[[suites]] -id = "rust-binding-executor-delegation" -path = "evaluation/standards-effectiveness/suites/rust-binding-executor-delegation.toml" -requires = [] - -[[suites]] -id = "rust-binding-event-delivery" -path = "evaluation/standards-effectiveness/suites/rust-binding-event-delivery.toml" -requires = [] - -[[suites]] -id = "rust-security-panic-boundary" -path = "evaluation/standards-effectiveness/suites/rust-security-panic-boundary.toml" -requires = [] - -[[suites]] -id = "rust-external-input-queue" -path = "evaluation/standards-effectiveness/suites/rust-external-input-queue.toml" -requires = [] - -[[suites]] -id = "validation-proof-lifetime" -path = "evaluation/standards-effectiveness/suites/validation-proof-lifetime.toml" -requires = [] - -[[suites]] -id = "input-validation-authority" -path = "evaluation/standards-effectiveness/suites/input-validation-authority.toml" -requires = [] - -[[suites]] -id = "network-transport-policy" -path = "evaluation/standards-effectiveness/suites/network-transport-policy.toml" -requires = [] - -[[suites]] -id = "rust-filesystem-authority" -path = "evaluation/standards-effectiveness/suites/rust-filesystem-authority.toml" -requires = [] - -[[suites]] -id = "rust-listener-lifecycle" -path = "evaluation/standards-effectiveness/suites/rust-listener-lifecycle.toml" -requires = [] - -[[suites]] -id = "rust-async-lifecycle" -path = "evaluation/standards-effectiveness/suites/rust-async-lifecycle.toml" -requires = [] - -[[suites]] -id = "rust-boundary-arithmetic" -path = "evaluation/standards-effectiveness/suites/rust-boundary-arithmetic.toml" -requires = [] - -[[suites]] -id = "filesystem-containment-policy" -path = "evaluation/standards-effectiveness/suites/filesystem-containment-policy.toml" -requires = [] - -[[suites]] -id = "ipc-payload-validation" -path = "evaluation/standards-effectiveness/suites/ipc-payload-validation.toml" -requires = [] - -[[suites]] -id = "rust-binding-runtime" -path = "evaluation/standards-effectiveness/suites/rust-binding-runtime.toml" -requires = [] - -[[suites]] -id = "rust-binding-architecture" -path = "evaluation/standards-effectiveness/suites/rust-binding-architecture.toml" -requires = [] - -[[suites]] -id = "cross-language-contract" -path = "evaluation/standards-effectiveness/suites/cross-language-contract.toml" -requires = [] - [[suites]] id = "standards-recovery-routing" path = "evaluation/standards-effectiveness/suites/standards-recovery-routing.toml" @@ -330,37 +115,7 @@ id = "a1c-public-cutover" path = "evaluation/standards-effectiveness/suites/a1c-public-cutover.toml" requires = ["generated-contract-semantic-conformance"] -[[suites]] -id = "language-binding-boundary" -path = "evaluation/standards-effectiveness/suites/language-binding-boundary.toml" -requires = [] - -[[suites]] -id = "rust-binding-conversions" -path = "evaluation/standards-effectiveness/suites/rust-binding-conversions.toml" -requires = [] - -[[suites]] -id = "runtime-decoding-policy" -path = "evaluation/standards-effectiveness/suites/runtime-decoding-policy.toml" -requires = [] - -[[suites]] -id = "interop-event-registration" -path = "evaluation/standards-effectiveness/suites/interop-event-registration.toml" -requires = [] - -[[suites]] -id = "concurrency-policy" -path = "evaluation/standards-effectiveness/suites/concurrency-policy.toml" -requires = [] - [[suites]] id = "contract-ownership" path = "evaluation/standards-effectiveness/suites/contract-ownership.toml" requires = [] - -[[suites]] -id = "interop-boundary-policy" -path = "evaluation/standards-effectiveness/suites/interop-boundary-policy.toml" -requires = [] diff --git a/evaluation/standards-effectiveness/suites/architecture-pattern-reference-owner.toml b/evaluation/standards-effectiveness/suites/architecture-pattern-reference-owner.toml deleted file mode 100644 index 41428a59..00000000 --- a/evaluation/standards-effectiveness/suites/architecture-pattern-reference-owner.toml +++ /dev/null @@ -1,9 +0,0 @@ -schema_version = 1 -id = "architecture-pattern-reference-owner" -owner = "reference.patterns.architecture" -description = "Checks current metadata graph constraints. Does not certify prose quality, consumer compliance, or unexecuted runtime behavior." - -[[checks]] -id = "metadata" -type = "metadata_graph" -cases = [{ expected = [], id = "reference-owner-closure", paths = ["CORE-STANDARDS.md", "workflows/verification.md", "topics/contracts.md", "topics/architecture.md", "reference/patterns/architecture.md"] }] diff --git a/evaluation/standards-effectiveness/suites/canonical-corpus-metadata.toml b/evaluation/standards-effectiveness/suites/canonical-corpus-metadata.toml new file mode 100644 index 00000000..9a74c0b8 --- /dev/null +++ b/evaluation/standards-effectiveness/suites/canonical-corpus-metadata.toml @@ -0,0 +1,9 @@ +schema_version = 1 +id = "canonical-corpus-metadata" +owner = "evaluation.metadata-schema" +description = "Checks the metadata header and the Requires and Specializes relations of every module in the canonical corpus. Does not certify prose quality, consumer compliance, or unexecuted runtime behavior." + +[[checks]] +id = "canonical-corpus" +type = "metadata_graph" +corpus = "evaluation/standards-effectiveness/canonical-module-corpus.toml" diff --git a/evaluation/standards-effectiveness/suites/concurrency-policy.toml b/evaluation/standards-effectiveness/suites/concurrency-policy.toml deleted file mode 100644 index 01b60c31..00000000 --- a/evaluation/standards-effectiveness/suites/concurrency-policy.toml +++ /dev/null @@ -1,9 +0,0 @@ -schema_version = 1 -id = "concurrency-policy" -owner = "topic.concurrency" -description = "Checks current metadata graph constraints. Does not certify prose quality, consumer compliance, or unexecuted runtime behavior." - -[[checks]] -id = "metadata-closure" -type = "metadata_graph" -paths = ["CORE-STANDARDS.md", "workflows/verification.md", "topics/concurrency.md", "workflows/verification/oracles.md", "workflows/verification/platforms.md", "workflows/verification/gui.md", "topics/code-design.md"] diff --git a/evaluation/standards-effectiveness/suites/contract-http-outcome-projection.toml b/evaluation/standards-effectiveness/suites/contract-http-outcome-projection.toml deleted file mode 100644 index b19fb8ae..00000000 --- a/evaluation/standards-effectiveness/suites/contract-http-outcome-projection.toml +++ /dev/null @@ -1,9 +0,0 @@ -schema_version = 1 -id = "contract-http-outcome-projection" -owner = "topic.contracts" -description = "Checks current metadata graph constraints. Does not certify prose quality, consumer compliance, or unexecuted runtime behavior." - -[[checks]] -id = "metadata-closure" -type = "metadata_graph" -paths = ["CORE-STANDARDS.md", "workflows/verification.md", "topics/security.md", "topics/contracts.md", "reference/recipes/http.md", "topics/contracts/schemas.md", "topics/contracts/protocols.md", "topics/contracts/evolution.md", "workflows/verification/oracles.md", "workflows/verification/platforms.md", "workflows/verification/gui.md", "topics/code-design.md"] diff --git a/evaluation/standards-effectiveness/suites/cross-language-contract.toml b/evaluation/standards-effectiveness/suites/cross-language-contract.toml deleted file mode 100644 index 1193beaa..00000000 --- a/evaluation/standards-effectiveness/suites/cross-language-contract.toml +++ /dev/null @@ -1,9 +0,0 @@ -schema_version = 1 -id = "cross-language-contract" -owner = "topic.contracts" -description = "Checks current metadata graph constraints. Does not certify prose quality, consumer compliance, or unexecuted runtime behavior." - -[[checks]] -id = "metadata-closure" -type = "metadata_graph" -paths = ["CORE-STANDARDS.md", "workflows/verification.md", "topics/contracts.md", "topics/contracts/schemas.md", "topics/contracts/protocols.md", "topics/contracts/evolution.md", "workflows/verification/oracles.md", "workflows/verification/platforms.md", "workflows/verification/gui.md", "topics/code-design.md"] diff --git a/evaluation/standards-effectiveness/suites/development-proportionality.toml b/evaluation/standards-effectiveness/suites/development-proportionality.toml index 8d3c55b0..25a9098a 100644 --- a/evaluation/standards-effectiveness/suites/development-proportionality.toml +++ b/evaluation/standards-effectiveness/suites/development-proportionality.toml @@ -1,25 +1,20 @@ schema_version = 1 id = "development-proportionality" owner = "workflow.development-proportionality" -description = "Checks resolvable Markdown links, current metadata graph constraints, fact-driven routing outcomes. Does not certify prose quality, consumer compliance, or unexecuted runtime behavior." +description = "Checks resolvable Markdown links, fact-driven routing outcomes. Does not certify prose quality, consumer compliance, or unexecuted runtime behavior." [[checks]] id = "routing-closure" type = "metadata_route" path = "evaluation/standards-effectiveness/fixtures/development/routing-decisions.tsv" -header = ["case", "uncertainty_reduction", "planning", "facts", "expected_development", "expected_planning", "expected_route"] +header = ["case", "routing.activities", "expected_development", "expected_planning", "expected_route"] +facts = ["routing.activities"] expectations_path = "evaluation/standards-effectiveness/fixtures/development/routing-routes.tsv" route_column = "expected_route" resolved = "route" unresolved = "unresolved" -base_modules = ["router"] selections = [{ column = "expected_development", excluded = "exclude", module = "workflow.development-proportionality", selected = "select" }, { column = "expected_planning", excluded = "exclude", module = "workflow.planning", selected = "select" }] -[[checks]] -id = "metadata-closure" -type = "metadata_graph" -paths = ["CORE-STANDARDS.md", "STANDARDS-ROUTER.md", "workflows/development-proportionality.md", "workflows/implementation.md", "workflows/planning.md", "workflows/verification.md", "workflows/verification/oracles.md", "workflows/verification/platforms.md", "workflows/verification/gui.md", "topics/code-design.md"] - [[checks]] id = "local-links" type = "markdown_links" diff --git a/evaluation/standards-effectiveness/suites/documentation-changelog-closure.toml b/evaluation/standards-effectiveness/suites/documentation-changelog-closure.toml deleted file mode 100644 index db615a7f..00000000 --- a/evaluation/standards-effectiveness/suites/documentation-changelog-closure.toml +++ /dev/null @@ -1,9 +0,0 @@ -schema_version = 1 -id = "documentation-changelog-closure" -owner = "workflow.release" -description = "Checks current metadata graph constraints. Does not certify prose quality, consumer compliance, or unexecuted runtime behavior." - -[[checks]] -id = "metadata-closure" -type = "metadata_graph" -paths = ["CORE-STANDARDS.md", "workflows/verification.md", "topics/contracts.md", "workflows/release.md", "topics/contracts/schemas.md", "topics/contracts/protocols.md", "topics/contracts/evolution.md", "workflows/verification/oracles.md", "workflows/verification/platforms.md", "workflows/release/operations.md", "workflows/verification/gui.md", "topics/code-design.md"] diff --git a/evaluation/standards-effectiveness/suites/documentation-policy-consolidation.toml b/evaluation/standards-effectiveness/suites/documentation-policy-consolidation.toml deleted file mode 100644 index a8fc6563..00000000 --- a/evaluation/standards-effectiveness/suites/documentation-policy-consolidation.toml +++ /dev/null @@ -1,9 +0,0 @@ -schema_version = 1 -id = "documentation-policy-consolidation" -owner = "workflow.documentation" -description = "Checks current metadata graph constraints. Does not certify prose quality, consumer compliance, or unexecuted runtime behavior." - -[[checks]] -id = "metadata-closure" -type = "metadata_graph" -paths = ["CORE-STANDARDS.md", "workflows/documentation.md", "topics/code-design.md"] diff --git a/evaluation/standards-effectiveness/suites/documentation-reference.toml b/evaluation/standards-effectiveness/suites/documentation-reference.toml deleted file mode 100644 index 7d102015..00000000 --- a/evaluation/standards-effectiveness/suites/documentation-reference.toml +++ /dev/null @@ -1,9 +0,0 @@ -schema_version = 1 -id = "documentation-reference" -owner = "reference.recipes.documentation" -description = "Checks current metadata graph constraints. Does not certify prose quality, consumer compliance, or unexecuted runtime behavior." - -[[checks]] -id = "metadata-closure" -type = "metadata_graph" -paths = ["CORE-STANDARDS.md", "workflows/documentation.md", "reference/recipes/documentation.md", "topics/code-design.md"] diff --git a/evaluation/standards-effectiveness/suites/filesystem-containment-policy.toml b/evaluation/standards-effectiveness/suites/filesystem-containment-policy.toml deleted file mode 100644 index 1505f9da..00000000 --- a/evaluation/standards-effectiveness/suites/filesystem-containment-policy.toml +++ /dev/null @@ -1,9 +0,0 @@ -schema_version = 1 -id = "filesystem-containment-policy" -owner = "topic.security" -description = "Checks current metadata graph constraints. Does not certify prose quality, consumer compliance, or unexecuted runtime behavior." - -[[checks]] -id = "metadata-closure" -type = "metadata_graph" -paths = ["CORE-STANDARDS.md", "workflows/verification.md", "topics/security.md", "topics/cross-platform.md", "workflows/verification/oracles.md", "workflows/verification/platforms.md", "workflows/verification/gui.md", "topics/code-design.md"] diff --git a/evaluation/standards-effectiveness/suites/frontend-rendering-synchronization.toml b/evaluation/standards-effectiveness/suites/frontend-rendering-synchronization.toml deleted file mode 100644 index 5e325c62..00000000 --- a/evaluation/standards-effectiveness/suites/frontend-rendering-synchronization.toml +++ /dev/null @@ -1,9 +0,0 @@ -schema_version = 1 -id = "frontend-rendering-synchronization" -owner = "profile.application.frontend" -description = "Checks current metadata graph constraints. Does not certify prose quality, consumer compliance, or unexecuted runtime behavior." - -[[checks]] -id = "metadata-closure" -type = "metadata_graph" -paths = ["CORE-STANDARDS.md", "workflows/verification.md", "topics/contracts.md", "topics/accessibility.md", "topics/concurrency.md", "profiles/languages/typescript.md", "profiles/languages/typescript/async.md", "profiles/applications/frontend.md", "reference/recipes/frontend.md", "topics/contracts/schemas.md", "topics/contracts/protocols.md", "topics/contracts/evolution.md", "workflows/verification/oracles.md", "workflows/verification/platforms.md", "workflows/verification/gui.md", "topics/code-design.md"] diff --git a/evaluation/standards-effectiveness/suites/input-validation-authority.toml b/evaluation/standards-effectiveness/suites/input-validation-authority.toml deleted file mode 100644 index 6d260ce7..00000000 --- a/evaluation/standards-effectiveness/suites/input-validation-authority.toml +++ /dev/null @@ -1,9 +0,0 @@ -schema_version = 1 -id = "input-validation-authority" -owner = "topic.security" -description = "Checks current metadata graph constraints. Does not certify prose quality, consumer compliance, or unexecuted runtime behavior." - -[[checks]] -id = "metadata-closure" -type = "metadata_graph" -paths = ["CORE-STANDARDS.md", "workflows/verification.md", "topics/contracts.md", "topics/security.md", "topics/contracts/schemas.md", "topics/contracts/protocols.md", "topics/contracts/evolution.md", "workflows/verification/oracles.md", "workflows/verification/platforms.md", "workflows/verification/gui.md", "topics/code-design.md"] diff --git a/evaluation/standards-effectiveness/suites/interop-boundary-policy.toml b/evaluation/standards-effectiveness/suites/interop-boundary-policy.toml deleted file mode 100644 index 50fbead2..00000000 --- a/evaluation/standards-effectiveness/suites/interop-boundary-policy.toml +++ /dev/null @@ -1,9 +0,0 @@ -schema_version = 1 -id = "interop-boundary-policy" -owner = "profile.boundary.interop" -description = "Checks current metadata graph constraints. Does not certify prose quality, consumer compliance, or unexecuted runtime behavior." - -[[checks]] -id = "metadata-closure" -type = "metadata_graph" -paths = ["CORE-STANDARDS.md", "workflows/verification.md", "topics/contracts.md", "topics/security.md", "profiles/boundaries/interop.md", "topics/contracts/schemas.md", "topics/contracts/protocols.md", "topics/contracts/evolution.md", "workflows/verification/oracles.md", "workflows/verification/platforms.md", "workflows/verification/gui.md", "topics/code-design.md"] diff --git a/evaluation/standards-effectiveness/suites/interop-event-registration.toml b/evaluation/standards-effectiveness/suites/interop-event-registration.toml deleted file mode 100644 index b31d99a8..00000000 --- a/evaluation/standards-effectiveness/suites/interop-event-registration.toml +++ /dev/null @@ -1,9 +0,0 @@ -schema_version = 1 -id = "interop-event-registration" -owner = "profile.boundary.interop" -description = "Checks current metadata graph constraints. Does not certify prose quality, consumer compliance, or unexecuted runtime behavior." - -[[checks]] -id = "metadata-closure" -type = "metadata_graph" -paths = ["CORE-STANDARDS.md", "workflows/verification.md", "topics/contracts.md", "topics/security.md", "profiles/boundaries/interop.md", "topics/contracts/schemas.md", "topics/contracts/protocols.md", "topics/contracts/evolution.md", "workflows/verification/oracles.md", "workflows/verification/platforms.md", "workflows/verification/gui.md", "topics/code-design.md"] diff --git a/evaluation/standards-effectiveness/suites/ipc-payload-validation.toml b/evaluation/standards-effectiveness/suites/ipc-payload-validation.toml deleted file mode 100644 index 16150e79..00000000 --- a/evaluation/standards-effectiveness/suites/ipc-payload-validation.toml +++ /dev/null @@ -1,9 +0,0 @@ -schema_version = 1 -id = "ipc-payload-validation" -owner = "profile.boundary.ipc" -description = "Checks current metadata graph constraints. Does not certify prose quality, consumer compliance, or unexecuted runtime behavior." - -[[checks]] -id = "metadata-closure" -type = "metadata_graph" -paths = ["CORE-STANDARDS.md", "workflows/verification.md", "topics/contracts.md", "topics/security.md", "profiles/boundaries/ipc.md", "topics/contracts/schemas.md", "topics/contracts/protocols.md", "topics/contracts/evolution.md", "workflows/verification/oracles.md", "workflows/verification/platforms.md", "workflows/verification/gui.md", "topics/code-design.md"] diff --git a/evaluation/standards-effectiveness/suites/language-binding-boundary.toml b/evaluation/standards-effectiveness/suites/language-binding-boundary.toml deleted file mode 100644 index 87a2dc40..00000000 --- a/evaluation/standards-effectiveness/suites/language-binding-boundary.toml +++ /dev/null @@ -1,9 +0,0 @@ -schema_version = 1 -id = "language-binding-boundary" -owner = "profile.boundary.language-bindings" -description = "Checks current metadata graph constraints. Does not certify prose quality, consumer compliance, or unexecuted runtime behavior." - -[[checks]] -id = "metadata-closure" -type = "metadata_graph" -paths = ["CORE-STANDARDS.md", "workflows/verification.md", "topics/contracts.md", "topics/security.md", "profiles/boundaries/interop.md", "profiles/boundaries/language-bindings.md", "topics/contracts/schemas.md", "topics/contracts/protocols.md", "topics/contracts/evolution.md", "workflows/verification/oracles.md", "workflows/verification/platforms.md", "workflows/verification/gui.md", "topics/code-design.md"] diff --git a/evaluation/standards-effectiveness/suites/language-binding-wire-representation.toml b/evaluation/standards-effectiveness/suites/language-binding-wire-representation.toml deleted file mode 100644 index b33dad8a..00000000 --- a/evaluation/standards-effectiveness/suites/language-binding-wire-representation.toml +++ /dev/null @@ -1,9 +0,0 @@ -schema_version = 1 -id = "language-binding-wire-representation" -owner = "profile.boundary.language-bindings" -description = "Checks current metadata graph constraints. Does not certify prose quality, consumer compliance, or unexecuted runtime behavior." - -[[checks]] -id = "metadata-closure" -type = "metadata_graph" -paths = ["CORE-STANDARDS.md", "workflows/verification.md", "topics/contracts.md", "topics/security.md", "profiles/boundaries/interop.md", "profiles/boundaries/language-bindings.md", "topics/contracts/schemas.md", "topics/contracts/protocols.md", "topics/contracts/evolution.md", "workflows/verification/oracles.md", "workflows/verification/platforms.md", "workflows/verification/gui.md", "topics/code-design.md"] diff --git a/evaluation/standards-effectiveness/suites/network-transport-policy.toml b/evaluation/standards-effectiveness/suites/network-transport-policy.toml deleted file mode 100644 index 9b9c41f7..00000000 --- a/evaluation/standards-effectiveness/suites/network-transport-policy.toml +++ /dev/null @@ -1,9 +0,0 @@ -schema_version = 1 -id = "network-transport-policy" -owner = "topic.security" -description = "Checks current metadata graph constraints. Does not certify prose quality, consumer compliance, or unexecuted runtime behavior." - -[[checks]] -id = "metadata-closure" -type = "metadata_graph" -paths = ["CORE-STANDARDS.md", "workflows/verification.md", "topics/contracts.md", "topics/concurrency.md", "profiles/boundaries/ipc.md", "topics/security.md", "topics/contracts/schemas.md", "topics/contracts/protocols.md", "topics/contracts/evolution.md", "workflows/verification/oracles.md", "workflows/verification/platforms.md", "workflows/verification/gui.md", "topics/code-design.md"] diff --git a/evaluation/standards-effectiveness/suites/persistence-owner-contract.toml b/evaluation/standards-effectiveness/suites/persistence-owner-contract.toml deleted file mode 100644 index 0de8d356..00000000 --- a/evaluation/standards-effectiveness/suites/persistence-owner-contract.toml +++ /dev/null @@ -1,9 +0,0 @@ -schema_version = 1 -id = "persistence-owner-contract" -owner = "profile.boundary.persistence" -description = "Checks current metadata graph constraints. Does not certify prose quality, consumer compliance, or unexecuted runtime behavior." - -[[checks]] -id = "metadata-closure" -type = "metadata_graph" -paths = ["CORE-STANDARDS.md", "workflows/verification.md", "topics/contracts.md", "profiles/boundaries/persistence.md", "reference/recipes/persistence.md", "topics/contracts/schemas.md", "topics/contracts/protocols.md", "topics/contracts/evolution.md", "workflows/verification/oracles.md", "workflows/verification/platforms.md", "workflows/verification/gui.md", "topics/code-design.md"] diff --git a/evaluation/standards-effectiveness/suites/release-artifact-policy.toml b/evaluation/standards-effectiveness/suites/release-artifact-policy.toml deleted file mode 100644 index 05dffb6f..00000000 --- a/evaluation/standards-effectiveness/suites/release-artifact-policy.toml +++ /dev/null @@ -1,9 +0,0 @@ -schema_version = 1 -id = "release-artifact-policy" -owner = "workflow.release" -description = "Checks current metadata graph constraints. Does not certify prose quality, consumer compliance, or unexecuted runtime behavior." - -[[checks]] -id = "metadata-closure" -type = "metadata_graph" -paths = ["CORE-STANDARDS.md", "workflows/verification.md", "topics/contracts.md", "workflows/release.md", "topics/contracts/schemas.md", "topics/contracts/protocols.md", "topics/contracts/evolution.md", "workflows/verification/oracles.md", "workflows/verification/platforms.md", "workflows/release/operations.md", "workflows/verification/gui.md", "topics/code-design.md"] diff --git a/evaluation/standards-effectiveness/suites/release-pipeline-policy.toml b/evaluation/standards-effectiveness/suites/release-pipeline-policy.toml deleted file mode 100644 index ffa5e492..00000000 --- a/evaluation/standards-effectiveness/suites/release-pipeline-policy.toml +++ /dev/null @@ -1,9 +0,0 @@ -schema_version = 1 -id = "release-pipeline-policy" -owner = "workflow.release" -description = "Checks current metadata graph constraints. Does not certify prose quality, consumer compliance, or unexecuted runtime behavior." - -[[checks]] -id = "metadata-closure" -type = "metadata_graph" -paths = ["CORE-STANDARDS.md", "workflows/verification.md", "topics/contracts.md", "workflows/release.md", "topics/contracts/schemas.md", "topics/contracts/protocols.md", "topics/contracts/evolution.md", "workflows/verification/oracles.md", "workflows/verification/platforms.md", "workflows/release/operations.md", "workflows/verification/gui.md", "topics/code-design.md"] diff --git a/evaluation/standards-effectiveness/suites/release-procedure-policy.toml b/evaluation/standards-effectiveness/suites/release-procedure-policy.toml deleted file mode 100644 index 425cdfa9..00000000 --- a/evaluation/standards-effectiveness/suites/release-procedure-policy.toml +++ /dev/null @@ -1,9 +0,0 @@ -schema_version = 1 -id = "release-procedure-policy" -owner = "workflow.release" -description = "Checks current metadata graph constraints. Does not certify prose quality, consumer compliance, or unexecuted runtime behavior." - -[[checks]] -id = "metadata-closure" -type = "metadata_graph" -paths = ["CORE-STANDARDS.md", "workflows/verification.md", "topics/contracts.md", "workflows/release.md", "profiles/languages/rust/README.md", "topics/contracts/schemas.md", "topics/contracts/protocols.md", "topics/contracts/evolution.md", "workflows/verification/oracles.md", "workflows/verification/platforms.md", "workflows/release/operations.md", "workflows/verification/gui.md", "topics/code-design.md"] diff --git a/evaluation/standards-effectiveness/suites/release-publication-policy.toml b/evaluation/standards-effectiveness/suites/release-publication-policy.toml deleted file mode 100644 index 4b7bec62..00000000 --- a/evaluation/standards-effectiveness/suites/release-publication-policy.toml +++ /dev/null @@ -1,9 +0,0 @@ -schema_version = 1 -id = "release-publication-policy" -owner = "workflow.release" -description = "Checks current metadata graph constraints. Does not certify prose quality, consumer compliance, or unexecuted runtime behavior." - -[[checks]] -id = "metadata-closure" -type = "metadata_graph" -paths = ["CORE-STANDARDS.md", "workflows/verification.md", "topics/contracts.md", "workflows/release.md", "topics/contracts/schemas.md", "topics/contracts/protocols.md", "topics/contracts/evolution.md", "workflows/verification/oracles.md", "workflows/verification/platforms.md", "workflows/release/operations.md", "workflows/verification/gui.md", "topics/code-design.md"] diff --git a/evaluation/standards-effectiveness/suites/release-recovery-policy.toml b/evaluation/standards-effectiveness/suites/release-recovery-policy.toml deleted file mode 100644 index c6877b92..00000000 --- a/evaluation/standards-effectiveness/suites/release-recovery-policy.toml +++ /dev/null @@ -1,9 +0,0 @@ -schema_version = 1 -id = "release-recovery-policy" -owner = "workflow.release" -description = "Checks current metadata graph constraints. Does not certify prose quality, consumer compliance, or unexecuted runtime behavior." - -[[checks]] -id = "metadata-closure" -type = "metadata_graph" -paths = ["CORE-STANDARDS.md", "workflows/verification.md", "topics/contracts.md", "workflows/release.md", "topics/contracts/schemas.md", "topics/contracts/protocols.md", "topics/contracts/evolution.md", "workflows/verification/oracles.md", "workflows/verification/platforms.md", "workflows/release/operations.md", "workflows/verification/gui.md", "topics/code-design.md"] diff --git a/evaluation/standards-effectiveness/suites/release-reference-closure.toml b/evaluation/standards-effectiveness/suites/release-reference-closure.toml index f7840cdd..02eb47af 100644 --- a/evaluation/standards-effectiveness/suites/release-reference-closure.toml +++ b/evaluation/standards-effectiveness/suites/release-reference-closure.toml @@ -1,12 +1,7 @@ schema_version = 1 id = "release-reference-closure" owner = "reference.recipes.releases" -description = "Checks declared Markdown destinations, current metadata graph constraints. Does not certify prose quality, consumer compliance, or unexecuted runtime behavior." - -[[checks]] -id = "metadata-closure" -type = "metadata_graph" -paths = ["CORE-STANDARDS.md", "workflows/verification.md", "topics/contracts.md", "workflows/release.md", "reference/recipes/releases.md", "topics/contracts/schemas.md", "topics/contracts/protocols.md", "topics/contracts/evolution.md", "workflows/verification/oracles.md", "workflows/verification/platforms.md", "workflows/release/operations.md", "workflows/verification/gui.md", "topics/code-design.md"] +description = "Checks declared Markdown destinations. Does not certify prose quality, consumer compliance, or unexecuted runtime behavior." [[checks]] id = "legacy-index-destinations" diff --git a/evaluation/standards-effectiveness/suites/release-workflow-foundation.toml b/evaluation/standards-effectiveness/suites/release-workflow-foundation.toml deleted file mode 100644 index ca13b5ff..00000000 --- a/evaluation/standards-effectiveness/suites/release-workflow-foundation.toml +++ /dev/null @@ -1,9 +0,0 @@ -schema_version = 1 -id = "release-workflow-foundation" -owner = "workflow.release" -description = "Checks current metadata graph constraints. Does not certify prose quality, consumer compliance, or unexecuted runtime behavior." - -[[checks]] -id = "metadata-closure" -type = "metadata_graph" -paths = ["CORE-STANDARDS.md", "workflows/verification.md", "topics/contracts.md", "workflows/release.md", "topics/contracts/schemas.md", "topics/contracts/protocols.md", "topics/contracts/evolution.md", "workflows/verification/oracles.md", "workflows/verification/platforms.md", "workflows/release/operations.md", "workflows/verification/gui.md", "topics/code-design.md"] diff --git a/evaluation/standards-effectiveness/suites/runtime-decoding-policy.toml b/evaluation/standards-effectiveness/suites/runtime-decoding-policy.toml deleted file mode 100644 index 22db5094..00000000 --- a/evaluation/standards-effectiveness/suites/runtime-decoding-policy.toml +++ /dev/null @@ -1,9 +0,0 @@ -schema_version = 1 -id = "runtime-decoding-policy" -owner = "topic.contracts" -description = "Checks current metadata graph constraints. Does not certify prose quality, consumer compliance, or unexecuted runtime behavior." - -[[checks]] -id = "metadata-closure" -type = "metadata_graph" -paths = ["CORE-STANDARDS.md", "workflows/verification.md", "topics/contracts.md", "topics/contracts/schemas.md", "topics/contracts/protocols.md", "topics/contracts/evolution.md", "workflows/verification/oracles.md", "workflows/verification/platforms.md", "workflows/verification/gui.md", "topics/code-design.md"] diff --git a/evaluation/standards-effectiveness/suites/rust-api-owner-contract.toml b/evaluation/standards-effectiveness/suites/rust-api-owner-contract.toml deleted file mode 100644 index 6ad429e8..00000000 --- a/evaluation/standards-effectiveness/suites/rust-api-owner-contract.toml +++ /dev/null @@ -1,9 +0,0 @@ -schema_version = 1 -id = "rust-api-owner-contract" -owner = "profile.language.rust.api" -description = "Checks current metadata graph constraints. Does not certify prose quality, consumer compliance, or unexecuted runtime behavior." - -[[checks]] -id = "metadata" -type = "metadata_graph" -paths = ["CORE-STANDARDS.md", "workflows/verification.md", "workflows/release.md", "topics/contracts.md", "topics/architecture.md", "topics/resilience.md", "topics/dependencies.md", "workflows/documentation.md", "profiles/applications/library.md", "profiles/languages/rust/README.md", "profiles/languages/rust/api.md", "topics/architecture/replay.md", "topics/contracts/schemas.md", "topics/contracts/protocols.md", "topics/contracts/evolution.md", "workflows/verification/oracles.md", "workflows/verification/platforms.md", "workflows/release/operations.md", "workflows/verification/gui.md", "topics/code-design.md"] diff --git a/evaluation/standards-effectiveness/suites/rust-async-blocking-mutex.toml b/evaluation/standards-effectiveness/suites/rust-async-blocking-mutex.toml deleted file mode 100644 index 5455ff09..00000000 --- a/evaluation/standards-effectiveness/suites/rust-async-blocking-mutex.toml +++ /dev/null @@ -1,9 +0,0 @@ -schema_version = 1 -id = "rust-async-blocking-mutex" -owner = "profile.language.rust.async" -description = "Checks current metadata graph constraints. Does not certify prose quality, consumer compliance, or unexecuted runtime behavior." - -[[checks]] -id = "metadata-closure" -type = "metadata_graph" -paths = ["CORE-STANDARDS.md", "workflows/verification.md", "topics/concurrency.md", "profiles/languages/rust/README.md", "profiles/languages/rust/async.md", "workflows/verification/oracles.md", "workflows/verification/platforms.md", "workflows/verification/gui.md", "topics/code-design.md"] diff --git a/evaluation/standards-effectiveness/suites/rust-async-boundary.toml b/evaluation/standards-effectiveness/suites/rust-async-boundary.toml deleted file mode 100644 index ec4e65ff..00000000 --- a/evaluation/standards-effectiveness/suites/rust-async-boundary.toml +++ /dev/null @@ -1,9 +0,0 @@ -schema_version = 1 -id = "rust-async-boundary" -owner = "profile.language.rust.async" -description = "Checks current metadata graph constraints. Does not certify prose quality, consumer compliance, or unexecuted runtime behavior." - -[[checks]] -id = "metadata-closure" -type = "metadata_graph" -paths = ["CORE-STANDARDS.md", "workflows/verification.md", "topics/concurrency.md", "profiles/languages/rust/README.md", "profiles/languages/rust/async.md", "workflows/verification/oracles.md", "workflows/verification/platforms.md", "workflows/verification/gui.md", "topics/code-design.md"] diff --git a/evaluation/standards-effectiveness/suites/rust-async-cancellation-observability.toml b/evaluation/standards-effectiveness/suites/rust-async-cancellation-observability.toml deleted file mode 100644 index 5fe8ecdb..00000000 --- a/evaluation/standards-effectiveness/suites/rust-async-cancellation-observability.toml +++ /dev/null @@ -1,9 +0,0 @@ -schema_version = 1 -id = "rust-async-cancellation-observability" -owner = "profile.language.rust.async" -description = "Checks current metadata graph constraints. Does not certify prose quality, consumer compliance, or unexecuted runtime behavior." - -[[checks]] -id = "metadata-closure" -type = "metadata_graph" -paths = ["CORE-STANDARDS.md", "workflows/verification.md", "topics/concurrency.md", "profiles/languages/rust/README.md", "profiles/languages/rust/async.md", "workflows/verification/oracles.md", "workflows/verification/platforms.md", "workflows/verification/gui.md", "topics/code-design.md"] diff --git a/evaluation/standards-effectiveness/suites/rust-async-lifecycle.toml b/evaluation/standards-effectiveness/suites/rust-async-lifecycle.toml deleted file mode 100644 index f891e490..00000000 --- a/evaluation/standards-effectiveness/suites/rust-async-lifecycle.toml +++ /dev/null @@ -1,9 +0,0 @@ -schema_version = 1 -id = "rust-async-lifecycle" -owner = "profile.language.rust.async" -description = "Checks current metadata graph constraints. Does not certify prose quality, consumer compliance, or unexecuted runtime behavior." - -[[checks]] -id = "metadata-closure" -type = "metadata_graph" -paths = ["CORE-STANDARDS.md", "workflows/verification.md", "topics/concurrency.md", "profiles/languages/rust/README.md", "profiles/languages/rust/async.md", "workflows/verification/oracles.md", "workflows/verification/platforms.md", "workflows/verification/gui.md", "topics/code-design.md"] diff --git a/evaluation/standards-effectiveness/suites/rust-binding-architecture.toml b/evaluation/standards-effectiveness/suites/rust-binding-architecture.toml deleted file mode 100644 index 1180a1e8..00000000 --- a/evaluation/standards-effectiveness/suites/rust-binding-architecture.toml +++ /dev/null @@ -1,9 +0,0 @@ -schema_version = 1 -id = "rust-binding-architecture" -owner = "profile.language.rust.language-bindings" -description = "Checks current metadata graph constraints. Does not certify prose quality, consumer compliance, or unexecuted runtime behavior." - -[[checks]] -id = "metadata-closure" -type = "metadata_graph" -paths = ["CORE-STANDARDS.md", "workflows/verification.md", "topics/contracts.md", "topics/security.md", "profiles/boundaries/interop.md", "profiles/boundaries/language-bindings.md", "profiles/languages/rust/README.md", "profiles/languages/rust/language-bindings.md", "topics/contracts/schemas.md", "topics/contracts/protocols.md", "topics/contracts/evolution.md", "workflows/verification/oracles.md", "workflows/verification/platforms.md", "profiles/languages/rust/binding-lifecycle.md", "workflows/verification/gui.md", "topics/code-design.md"] diff --git a/evaluation/standards-effectiveness/suites/rust-binding-callback-task.toml b/evaluation/standards-effectiveness/suites/rust-binding-callback-task.toml deleted file mode 100644 index b3fabd10..00000000 --- a/evaluation/standards-effectiveness/suites/rust-binding-callback-task.toml +++ /dev/null @@ -1,9 +0,0 @@ -schema_version = 1 -id = "rust-binding-callback-task" -owner = "profile.language.rust.language-bindings" -description = "Checks current metadata graph constraints. Does not certify prose quality, consumer compliance, or unexecuted runtime behavior." - -[[checks]] -id = "metadata-closure" -type = "metadata_graph" -paths = ["CORE-STANDARDS.md", "workflows/verification.md", "topics/concurrency.md", "topics/contracts.md", "topics/security.md", "profiles/boundaries/interop.md", "profiles/boundaries/language-bindings.md", "profiles/languages/rust/README.md", "profiles/languages/rust/async.md", "profiles/languages/rust/language-bindings.md", "topics/contracts/schemas.md", "topics/contracts/protocols.md", "topics/contracts/evolution.md", "workflows/verification/oracles.md", "workflows/verification/platforms.md", "profiles/languages/rust/binding-lifecycle.md", "workflows/verification/gui.md", "topics/code-design.md"] diff --git a/evaluation/standards-effectiveness/suites/rust-binding-conversions.toml b/evaluation/standards-effectiveness/suites/rust-binding-conversions.toml deleted file mode 100644 index 515a2cf5..00000000 --- a/evaluation/standards-effectiveness/suites/rust-binding-conversions.toml +++ /dev/null @@ -1,9 +0,0 @@ -schema_version = 1 -id = "rust-binding-conversions" -owner = "profile.language.rust.language-bindings" -description = "Checks current metadata graph constraints. Does not certify prose quality, consumer compliance, or unexecuted runtime behavior." - -[[checks]] -id = "metadata-closure" -type = "metadata_graph" -paths = ["CORE-STANDARDS.md", "workflows/verification.md", "topics/contracts.md", "topics/security.md", "profiles/boundaries/interop.md", "profiles/boundaries/language-bindings.md", "profiles/languages/rust/README.md", "profiles/languages/rust/language-bindings.md", "topics/contracts/schemas.md", "topics/contracts/protocols.md", "topics/contracts/evolution.md", "workflows/verification/oracles.md", "workflows/verification/platforms.md", "profiles/languages/rust/binding-lifecycle.md", "workflows/verification/gui.md", "topics/code-design.md"] diff --git a/evaluation/standards-effectiveness/suites/rust-binding-enum-representation.toml b/evaluation/standards-effectiveness/suites/rust-binding-enum-representation.toml deleted file mode 100644 index 7a3e1100..00000000 --- a/evaluation/standards-effectiveness/suites/rust-binding-enum-representation.toml +++ /dev/null @@ -1,9 +0,0 @@ -schema_version = 1 -id = "rust-binding-enum-representation" -owner = "profile.language.rust.language-bindings" -description = "Checks current metadata graph constraints. Does not certify prose quality, consumer compliance, or unexecuted runtime behavior." - -[[checks]] -id = "metadata-closure" -type = "metadata_graph" -paths = ["CORE-STANDARDS.md", "workflows/verification.md", "topics/contracts.md", "topics/security.md", "profiles/boundaries/interop.md", "profiles/boundaries/language-bindings.md", "profiles/languages/rust/README.md", "profiles/languages/rust/language-bindings.md", "topics/contracts/schemas.md", "topics/contracts/protocols.md", "topics/contracts/evolution.md", "workflows/verification/oracles.md", "workflows/verification/platforms.md", "profiles/languages/rust/binding-lifecycle.md", "workflows/verification/gui.md", "topics/code-design.md"] diff --git a/evaluation/standards-effectiveness/suites/rust-binding-error-mapping.toml b/evaluation/standards-effectiveness/suites/rust-binding-error-mapping.toml deleted file mode 100644 index 5d6c29f7..00000000 --- a/evaluation/standards-effectiveness/suites/rust-binding-error-mapping.toml +++ /dev/null @@ -1,9 +0,0 @@ -schema_version = 1 -id = "rust-binding-error-mapping" -owner = "profile.language.rust.language-bindings" -description = "Checks current metadata graph constraints. Does not certify prose quality, consumer compliance, or unexecuted runtime behavior." - -[[checks]] -id = "metadata-closure" -type = "metadata_graph" -paths = ["CORE-STANDARDS.md", "workflows/verification.md", "topics/contracts.md", "topics/security.md", "profiles/boundaries/interop.md", "profiles/boundaries/language-bindings.md", "profiles/languages/rust/README.md", "profiles/languages/rust/language-bindings.md", "topics/contracts/schemas.md", "topics/contracts/protocols.md", "topics/contracts/evolution.md", "workflows/verification/oracles.md", "workflows/verification/platforms.md", "profiles/languages/rust/binding-lifecycle.md", "workflows/verification/gui.md", "topics/code-design.md"] diff --git a/evaluation/standards-effectiveness/suites/rust-binding-event-delivery.toml b/evaluation/standards-effectiveness/suites/rust-binding-event-delivery.toml deleted file mode 100644 index c4d22c20..00000000 --- a/evaluation/standards-effectiveness/suites/rust-binding-event-delivery.toml +++ /dev/null @@ -1,9 +0,0 @@ -schema_version = 1 -id = "rust-binding-event-delivery" -owner = "profile.language.rust.language-bindings" -description = "Checks current metadata graph constraints. Does not certify prose quality, consumer compliance, or unexecuted runtime behavior." - -[[checks]] -id = "metadata-closure" -type = "metadata_graph" -paths = ["CORE-STANDARDS.md", "workflows/verification.md", "topics/concurrency.md", "topics/contracts.md", "topics/security.md", "profiles/boundaries/interop.md", "profiles/boundaries/language-bindings.md", "profiles/languages/rust/README.md", "profiles/languages/rust/language-bindings.md", "topics/contracts/schemas.md", "topics/contracts/protocols.md", "topics/contracts/evolution.md", "workflows/verification/oracles.md", "workflows/verification/platforms.md", "profiles/languages/rust/binding-lifecycle.md", "workflows/verification/gui.md", "topics/code-design.md"] diff --git a/evaluation/standards-effectiveness/suites/rust-binding-executor-delegation.toml b/evaluation/standards-effectiveness/suites/rust-binding-executor-delegation.toml deleted file mode 100644 index 26e71055..00000000 --- a/evaluation/standards-effectiveness/suites/rust-binding-executor-delegation.toml +++ /dev/null @@ -1,9 +0,0 @@ -schema_version = 1 -id = "rust-binding-executor-delegation" -owner = "profile.language.rust.language-bindings" -description = "Checks current metadata graph constraints. Does not certify prose quality, consumer compliance, or unexecuted runtime behavior." - -[[checks]] -id = "metadata-closure" -type = "metadata_graph" -paths = ["CORE-STANDARDS.md", "workflows/verification.md", "topics/contracts.md", "topics/security.md", "topics/concurrency.md", "profiles/boundaries/interop.md", "profiles/boundaries/language-bindings.md", "profiles/languages/rust/README.md", "profiles/languages/rust/async.md", "profiles/languages/rust/language-bindings.md", "topics/contracts/schemas.md", "topics/contracts/protocols.md", "topics/contracts/evolution.md", "workflows/verification/oracles.md", "workflows/verification/platforms.md", "profiles/languages/rust/binding-lifecycle.md", "workflows/verification/gui.md", "topics/code-design.md"] diff --git a/evaluation/standards-effectiveness/suites/rust-binding-runtime.toml b/evaluation/standards-effectiveness/suites/rust-binding-runtime.toml deleted file mode 100644 index f823e9f7..00000000 --- a/evaluation/standards-effectiveness/suites/rust-binding-runtime.toml +++ /dev/null @@ -1,9 +0,0 @@ -schema_version = 1 -id = "rust-binding-runtime" -owner = "profile.language.rust.language-bindings" -description = "Checks current metadata graph constraints. Does not certify prose quality, consumer compliance, or unexecuted runtime behavior." - -[[checks]] -id = "metadata-closure" -type = "metadata_graph" -paths = ["CORE-STANDARDS.md", "workflows/verification.md", "topics/contracts.md", "topics/security.md", "topics/concurrency.md", "profiles/boundaries/interop.md", "profiles/boundaries/language-bindings.md", "profiles/languages/rust/README.md", "profiles/languages/rust/async.md", "profiles/languages/rust/language-bindings.md", "topics/contracts/schemas.md", "topics/contracts/protocols.md", "topics/contracts/evolution.md", "workflows/verification/oracles.md", "workflows/verification/platforms.md", "profiles/languages/rust/binding-lifecycle.md", "workflows/verification/gui.md", "topics/code-design.md"] diff --git a/evaluation/standards-effectiveness/suites/rust-boundary-arithmetic.toml b/evaluation/standards-effectiveness/suites/rust-boundary-arithmetic.toml deleted file mode 100644 index fac3d6a0..00000000 --- a/evaluation/standards-effectiveness/suites/rust-boundary-arithmetic.toml +++ /dev/null @@ -1,9 +0,0 @@ -schema_version = 1 -id = "rust-boundary-arithmetic" -owner = "profile.language.rust.security" -description = "Checks current metadata graph constraints. Does not certify prose quality, consumer compliance, or unexecuted runtime behavior." - -[[checks]] -id = "metadata-closure" -type = "metadata_graph" -paths = ["CORE-STANDARDS.md", "workflows/verification.md", "topics/security.md", "profiles/languages/rust/README.md", "profiles/languages/rust/security.md", "workflows/verification/oracles.md", "workflows/verification/platforms.md", "workflows/verification/gui.md", "topics/code-design.md"] diff --git a/evaluation/standards-effectiveness/suites/rust-dependency-candidate-inspection.toml b/evaluation/standards-effectiveness/suites/rust-dependency-candidate-inspection.toml deleted file mode 100644 index 0df7bf80..00000000 --- a/evaluation/standards-effectiveness/suites/rust-dependency-candidate-inspection.toml +++ /dev/null @@ -1,9 +0,0 @@ -schema_version = 1 -id = "rust-dependency-candidate-inspection" -owner = "profile.language.rust.dependencies" -description = "Checks current metadata graph constraints. Does not certify prose quality, consumer compliance, or unexecuted runtime behavior." - -[[checks]] -id = "metadata-closure" -type = "metadata_graph" -paths = ["CORE-STANDARDS.md", "workflows/verification.md", "workflows/release.md", "topics/contracts.md", "topics/dependencies.md", "profiles/languages/rust/README.md", "profiles/languages/rust/dependencies.md", "reference/recipes/rust-dependencies.md", "topics/contracts/schemas.md", "topics/contracts/protocols.md", "topics/contracts/evolution.md", "workflows/verification/oracles.md", "workflows/verification/platforms.md", "workflows/release/operations.md", "workflows/verification/gui.md", "topics/code-design.md"] diff --git a/evaluation/standards-effectiveness/suites/rust-dependency-owner-contract.toml b/evaluation/standards-effectiveness/suites/rust-dependency-owner-contract.toml deleted file mode 100644 index 8e7c78f1..00000000 --- a/evaluation/standards-effectiveness/suites/rust-dependency-owner-contract.toml +++ /dev/null @@ -1,9 +0,0 @@ -schema_version = 1 -id = "rust-dependency-owner-contract" -owner = "profile.language.rust.dependencies" -description = "Checks current metadata graph constraints. Does not certify prose quality, consumer compliance, or unexecuted runtime behavior." - -[[checks]] -id = "metadata-closure" -type = "metadata_graph" -paths = ["CORE-STANDARDS.md", "workflows/verification.md", "workflows/release.md", "topics/contracts.md", "topics/dependencies.md", "profiles/languages/rust/README.md", "profiles/languages/rust/dependencies.md", "topics/contracts/schemas.md", "topics/contracts/protocols.md", "topics/contracts/evolution.md", "workflows/verification/oracles.md", "workflows/verification/platforms.md", "workflows/release/operations.md", "workflows/verification/gui.md", "topics/code-design.md"] diff --git a/evaluation/standards-effectiveness/suites/rust-external-input-queue.toml b/evaluation/standards-effectiveness/suites/rust-external-input-queue.toml deleted file mode 100644 index 8664a3de..00000000 --- a/evaluation/standards-effectiveness/suites/rust-external-input-queue.toml +++ /dev/null @@ -1,9 +0,0 @@ -schema_version = 1 -id = "rust-external-input-queue" -owner = "profile.language.rust.security" -description = "Checks current metadata graph constraints. Does not certify prose quality, consumer compliance, or unexecuted runtime behavior." - -[[checks]] -id = "metadata-closure" -type = "metadata_graph" -paths = ["CORE-STANDARDS.md", "workflows/verification.md", "topics/security.md", "profiles/languages/rust/README.md", "profiles/languages/rust/security.md", "workflows/verification/oracles.md", "workflows/verification/platforms.md", "workflows/verification/gui.md", "topics/code-design.md"] diff --git a/evaluation/standards-effectiveness/suites/rust-filesystem-authority.toml b/evaluation/standards-effectiveness/suites/rust-filesystem-authority.toml deleted file mode 100644 index 01492cae..00000000 --- a/evaluation/standards-effectiveness/suites/rust-filesystem-authority.toml +++ /dev/null @@ -1,9 +0,0 @@ -schema_version = 1 -id = "rust-filesystem-authority" -owner = "profile.language.rust.security" -description = "Checks current metadata graph constraints. Does not certify prose quality, consumer compliance, or unexecuted runtime behavior." - -[[checks]] -id = "metadata-closure" -type = "metadata_graph" -paths = ["CORE-STANDARDS.md", "workflows/verification.md", "topics/security.md", "topics/cross-platform.md", "profiles/languages/rust/README.md", "profiles/languages/rust/security.md", "workflows/verification/oracles.md", "workflows/verification/platforms.md", "workflows/verification/gui.md", "topics/code-design.md"] diff --git a/evaluation/standards-effectiveness/suites/rust-interop-memory.toml b/evaluation/standards-effectiveness/suites/rust-interop-memory.toml deleted file mode 100644 index 6185617e..00000000 --- a/evaluation/standards-effectiveness/suites/rust-interop-memory.toml +++ /dev/null @@ -1,9 +0,0 @@ -schema_version = 1 -id = "rust-interop-memory" -owner = "profile.language.rust.interop" -description = "Checks current metadata graph constraints. Does not certify prose quality, consumer compliance, or unexecuted runtime behavior." - -[[checks]] -id = "metadata-closure" -type = "metadata_graph" -paths = ["CORE-STANDARDS.md", "workflows/verification.md", "topics/contracts.md", "topics/security.md", "profiles/boundaries/interop.md", "profiles/languages/rust/README.md", "profiles/languages/rust/interop.md", "topics/contracts/schemas.md", "topics/contracts/protocols.md", "topics/contracts/evolution.md", "workflows/verification/oracles.md", "workflows/verification/platforms.md", "workflows/verification/gui.md", "topics/code-design.md"] diff --git a/evaluation/standards-effectiveness/suites/rust-listener-lifecycle.toml b/evaluation/standards-effectiveness/suites/rust-listener-lifecycle.toml deleted file mode 100644 index 81425aa8..00000000 --- a/evaluation/standards-effectiveness/suites/rust-listener-lifecycle.toml +++ /dev/null @@ -1,9 +0,0 @@ -schema_version = 1 -id = "rust-listener-lifecycle" -owner = "profile.language.rust.security" -description = "Checks current metadata graph constraints. Does not certify prose quality, consumer compliance, or unexecuted runtime behavior." - -[[checks]] -id = "metadata-closure" -type = "metadata_graph" -paths = ["CORE-STANDARDS.md", "workflows/verification.md", "topics/security.md", "topics/concurrency.md", "profiles/languages/rust/README.md", "profiles/languages/rust/async.md", "profiles/languages/rust/security.md", "workflows/verification/oracles.md", "workflows/verification/platforms.md", "workflows/verification/gui.md", "topics/code-design.md"] diff --git a/evaluation/standards-effectiveness/suites/rust-profile-authority-closure.toml b/evaluation/standards-effectiveness/suites/rust-profile-authority-closure.toml index a07f00bf..896190f1 100644 --- a/evaluation/standards-effectiveness/suites/rust-profile-authority-closure.toml +++ b/evaluation/standards-effectiveness/suites/rust-profile-authority-closure.toml @@ -1,12 +1,7 @@ schema_version = 1 id = "rust-profile-authority-closure" owner = "profiles/languages/rust/README.md" -description = "Checks resolvable Markdown links, current metadata graph constraints. Does not certify prose quality, consumer compliance, or unexecuted runtime behavior." - -[[checks]] -id = "rust-profile-metadata" -type = "metadata_graph" -paths = ["CORE-STANDARDS.md", "profiles/languages/rust/README.md", "topics/code-design.md"] +description = "Checks resolvable Markdown links. Does not certify prose quality, consumer compliance, or unexecuted runtime behavior." [[checks]] id = "rust-profile-links" diff --git a/evaluation/standards-effectiveness/suites/rust-release-owner-contract.toml b/evaluation/standards-effectiveness/suites/rust-release-owner-contract.toml deleted file mode 100644 index 3f82e8a9..00000000 --- a/evaluation/standards-effectiveness/suites/rust-release-owner-contract.toml +++ /dev/null @@ -1,9 +0,0 @@ -schema_version = 1 -id = "rust-release-owner-contract" -owner = "profile.language.rust.release" -description = "Checks current metadata graph constraints. Does not certify prose quality, consumer compliance, or unexecuted runtime behavior." - -[[checks]] -id = "metadata-closure" -type = "metadata_graph" -paths = ["CORE-STANDARDS.md", "workflows/verification.md", "workflows/release.md", "topics/contracts.md", "topics/dependencies.md", "profiles/languages/rust/README.md", "profiles/languages/rust/dependencies.md", "profiles/languages/rust/release.md", "reference/recipes/rust-release.md", "topics/contracts/schemas.md", "topics/contracts/protocols.md", "topics/contracts/evolution.md", "workflows/verification/oracles.md", "workflows/verification/platforms.md", "workflows/release/operations.md", "workflows/verification/gui.md", "topics/code-design.md"] diff --git a/evaluation/standards-effectiveness/suites/rust-security-panic-boundary.toml b/evaluation/standards-effectiveness/suites/rust-security-panic-boundary.toml deleted file mode 100644 index 71abb548..00000000 --- a/evaluation/standards-effectiveness/suites/rust-security-panic-boundary.toml +++ /dev/null @@ -1,9 +0,0 @@ -schema_version = 1 -id = "rust-security-panic-boundary" -owner = "profile.language.rust.security" -description = "Checks current metadata graph constraints. Does not certify prose quality, consumer compliance, or unexecuted runtime behavior." - -[[checks]] -id = "metadata-closure" -type = "metadata_graph" -paths = ["CORE-STANDARDS.md", "workflows/verification.md", "topics/security.md", "profiles/languages/rust/README.md", "profiles/languages/rust/security.md", "workflows/verification/oracles.md", "workflows/verification/platforms.md", "workflows/verification/gui.md", "topics/code-design.md"] diff --git a/evaluation/standards-effectiveness/suites/rust-tooling-owner-contract.toml b/evaluation/standards-effectiveness/suites/rust-tooling-owner-contract.toml deleted file mode 100644 index 75ff9685..00000000 --- a/evaluation/standards-effectiveness/suites/rust-tooling-owner-contract.toml +++ /dev/null @@ -1,9 +0,0 @@ -schema_version = 1 -id = "rust-tooling-owner-contract" -owner = "profile.language.rust.tooling" -description = "Checks current metadata graph constraints. Does not certify prose quality, consumer compliance, or unexecuted runtime behavior." - -[[checks]] -id = "metadata-closure" -type = "metadata_graph" -paths = ["CORE-STANDARDS.md", "workflows/implementation.md", "workflows/commit.md", "workflows/verification.md", "workflows/tooling.md", "profiles/languages/rust/README.md", "profiles/languages/rust/tooling.md", "reference/recipes/rust-tooling.md", "workflows/verification/oracles.md", "workflows/verification/platforms.md", "workflows/verification/gui.md", "topics/code-design.md"] diff --git a/evaluation/standards-effectiveness/suites/rust-unsafe-contracts.toml b/evaluation/standards-effectiveness/suites/rust-unsafe-contracts.toml deleted file mode 100644 index 13fce730..00000000 --- a/evaluation/standards-effectiveness/suites/rust-unsafe-contracts.toml +++ /dev/null @@ -1,9 +0,0 @@ -schema_version = 1 -id = "rust-unsafe-contracts" -owner = "profile.language.rust.unsafe" -description = "Checks current metadata graph constraints. Does not certify prose quality, consumer compliance, or unexecuted runtime behavior." - -[[checks]] -id = "metadata-closure" -type = "metadata_graph" -paths = ["CORE-STANDARDS.md", "workflows/verification.md", "profiles/languages/rust/README.md", "profiles/languages/rust/unsafe.md", "workflows/verification/oracles.md", "workflows/verification/platforms.md", "workflows/verification/gui.md", "topics/code-design.md"] diff --git a/evaluation/standards-effectiveness/suites/rust-wire-representation.toml b/evaluation/standards-effectiveness/suites/rust-wire-representation.toml deleted file mode 100644 index f488eae0..00000000 --- a/evaluation/standards-effectiveness/suites/rust-wire-representation.toml +++ /dev/null @@ -1,9 +0,0 @@ -schema_version = 1 -id = "rust-wire-representation" -owner = "profile.language.rust.language-bindings" -description = "Checks current metadata graph constraints. Does not certify prose quality, consumer compliance, or unexecuted runtime behavior." - -[[checks]] -id = "metadata-closure" -type = "metadata_graph" -paths = ["CORE-STANDARDS.md", "workflows/verification.md", "topics/contracts.md", "topics/security.md", "profiles/boundaries/interop.md", "profiles/boundaries/language-bindings.md", "profiles/languages/rust/README.md", "profiles/languages/rust/language-bindings.md", "topics/contracts/schemas.md", "topics/contracts/protocols.md", "topics/contracts/evolution.md", "workflows/verification/oracles.md", "workflows/verification/platforms.md", "profiles/languages/rust/binding-lifecycle.md", "workflows/verification/gui.md", "topics/code-design.md"] diff --git a/evaluation/standards-effectiveness/suites/s1-routing.toml b/evaluation/standards-effectiveness/suites/s1-routing.toml index 61dda00c..c9338cbd 100644 --- a/evaluation/standards-effectiveness/suites/s1-routing.toml +++ b/evaluation/standards-effectiveness/suites/s1-routing.toml @@ -1,25 +1,20 @@ schema_version = 1 id = "s1-routing" owner = "migration.parent-plan" -description = "Checks resolvable Markdown links, current metadata graph constraints, fact-driven routing outcomes. Does not certify prose quality, consumer compliance, or unexecuted runtime behavior." +description = "Checks resolvable Markdown links, fact-driven routing outcomes. Does not certify prose quality, consumer compliance, or unexecuted runtime behavior." [[checks]] id = "verifier-change-route-closure" type = "metadata_route" path = "evaluation/standards-effectiveness/fixtures/routing/verifier-change-decisions.tsv" -header = ["case", "module_boundary", "dependency_direction", "performance_concern", "migration_lifecycle", "planning_scope", "facts", "expected_architecture", "expected_performance", "expected_planning", "expected_route"] +header = ["case", "routing.activities", "routing.topics", "expected_architecture", "expected_performance", "expected_planning", "expected_route"] +facts = ["routing.activities", "routing.topics"] expectations_path = "evaluation/standards-effectiveness/fixtures/routing/verifier-change-routes.tsv" route_column = "expected_route" resolved = "route" unresolved = "unresolved" -base_modules = ["workflow.implementation", "workflow.verification"] selections = [{ column = "expected_architecture", excluded = "exclude", module = "topic.architecture", selected = "select" }, { column = "expected_performance", excluded = "exclude", module = "topic.performance", selected = "select" }, { column = "expected_planning", excluded = "exclude", module = "workflow.planning", selected = "select" }] -[[checks]] -id = "metadata-closure" -type = "metadata_graph" -paths = ["CORE-STANDARDS.md", "STANDARDS-ROUTER.md", "workflows/implementation.md", "workflows/verification.md", "profiles/applications/library.md", "profiles/languages/rust/README.md", "workflows/verification/oracles.md", "workflows/verification/platforms.md", "workflows/verification/gui.md", "topics/code-design.md"] - [[checks]] id = "local-links" type = "markdown_links" diff --git a/evaluation/standards-effectiveness/suites/standards-recovery-routing.toml b/evaluation/standards-effectiveness/suites/standards-recovery-routing.toml index d78f1693..dd1747f6 100644 --- a/evaluation/standards-effectiveness/suites/standards-recovery-routing.toml +++ b/evaluation/standards-effectiveness/suites/standards-recovery-routing.toml @@ -1,21 +1,16 @@ schema_version = 1 id = "standards-recovery-routing" owner = "router" -description = "Checks current metadata graph constraints, fact-driven routing outcomes. Does not certify prose quality, consumer compliance, or unexecuted runtime behavior." +description = "Checks fact-driven routing outcomes. Does not certify prose quality, consumer compliance, or unexecuted runtime behavior." [[checks]] id = "requires-closure" type = "metadata_route" path = "evaluation/standards-effectiveness/fixtures/routing/generated-contract-decisions.tsv" -header = ["case", "program_consumer", "generated_source", "cross_language", "process_boundary", "durable_state", "diagnostics", "security", "facts", "expected_generated_contract", "expected_language_binding", "expected_ipc", "expected_persistence", "expected_diagnostics", "expected_security", "expected_route"] +header = ["case", "routing.activities", "routing.applications", "routing.boundaries", "routing.topics", "expected_generated_contract", "expected_language_binding", "expected_ipc", "expected_persistence", "expected_diagnostics", "expected_security", "expected_route"] +facts = ["routing.activities", "routing.applications", "routing.boundaries", "routing.topics"] expectations_path = "evaluation/standards-effectiveness/fixtures/routing/generated-contract-routes.tsv" route_column = "expected_route" resolved = "route" unresolved = "unresolved" -base_modules = ["router", "workflow.planning", "workflow.implementation", "workflow.verification", "workflow.documentation", "workflow.build", "workflow.tooling", "topic.architecture", "topic.contracts", "topic.dependencies", "profile.application.library"] selections = [{ column = "expected_generated_contract", excluded = "exclude", module = "profile.boundary.generated-contract", selected = "select" }, { column = "expected_language_binding", excluded = "exclude", module = "profile.boundary.language-bindings", selected = "select" }, { column = "expected_ipc", excluded = "exclude", module = "profile.boundary.ipc", selected = "select" }, { column = "expected_persistence", excluded = "exclude", module = "profile.boundary.persistence", selected = "select" }, { column = "expected_diagnostics", excluded = "exclude", module = "topic.diagnostics", selected = "select" }, { column = "expected_security", excluded = "exclude", module = "topic.security", selected = "select" }] - -[[checks]] -id = "metadata-closure" -type = "metadata_graph" -paths = ["CORE-STANDARDS.md", "STANDARDS-ROUTER.md", "profiles/boundaries/generated-contract.md", "topics/architecture.md", "topics/contracts.md", "topics/dependencies.md", "workflows/build.md", "workflows/commit.md", "workflows/development-proportionality.md", "workflows/documentation.md", "workflows/implementation.md", "workflows/planning.md", "workflows/release.md", "workflows/tooling.md", "workflows/verification.md", "topics/architecture/replay.md", "topics/contracts/schemas.md", "topics/contracts/protocols.md", "topics/contracts/evolution.md", "workflows/verification/oracles.md", "workflows/verification/platforms.md", "workflows/release/operations.md", "workflows/verification/gui.md", "topics/code-design.md"] diff --git a/evaluation/standards-effectiveness/suites/validation-proof-lifetime.toml b/evaluation/standards-effectiveness/suites/validation-proof-lifetime.toml deleted file mode 100644 index dce3ae78..00000000 --- a/evaluation/standards-effectiveness/suites/validation-proof-lifetime.toml +++ /dev/null @@ -1,9 +0,0 @@ -schema_version = 1 -id = "validation-proof-lifetime" -owner = "topic.contracts" -description = "Checks current metadata graph constraints. Does not certify prose quality, consumer compliance, or unexecuted runtime behavior." - -[[checks]] -id = "metadata-closure" -type = "metadata_graph" -paths = ["CORE-STANDARDS.md", "workflows/verification.md", "topics/contracts.md", "topics/contracts/schemas.md", "topics/contracts/protocols.md", "topics/contracts/evolution.md", "workflows/verification/oracles.md", "workflows/verification/platforms.md", "workflows/verification/gui.md", "topics/code-design.md"] diff --git a/tools/standards_analysis/standards_analysis/__init__.py b/tools/standards_analysis/standards_analysis/__init__.py index b55531dc..6b5dbac1 100644 --- a/tools/standards_analysis/standards_analysis/__init__.py +++ b/tools/standards_analysis/standards_analysis/__init__.py @@ -73,6 +73,7 @@ ) from .routing import ( ROUTER_PROJECTION, + RouteDecision, RouteRule, RouterProjection, load_router_projection, @@ -193,6 +194,7 @@ "ResolvedEvidence", "ReviewScope", "RouteRule", + "RouteDecision", "RouterProjection", "RoutingBaseCause", "RoutingRuleCause", diff --git a/tools/standards_analysis/standards_analysis/routing.py b/tools/standards_analysis/standards_analysis/routing.py index a64405e1..293fa35c 100644 --- a/tools/standards_analysis/standards_analysis/routing.py +++ b/tools/standards_analysis/standards_analysis/routing.py @@ -8,6 +8,8 @@ ApplicabilityProgram, FactContract, FactSchema, + FactSet, + Truth, compile_fact_schema, ) from tools.standards_metadata.standards_metadata import ( @@ -32,6 +34,26 @@ class RouteRule: program: ApplicabilityProgram +@dataclass(frozen=True, slots=True) +class RouteDecision: + """The Router's direct decision for one bound fact set, before `Requires`. + + ``rule_states`` holds each rule whose condition is true ("selected") or + cannot be decided from the supplied facts ("unresolved"), in rule order. + A rule whose condition is false is absent. + """ + + selected: tuple[str, ...] + unresolved_facts: tuple[str, ...] + rule_states: tuple[tuple[RouteRule, str], ...] + + @property + def unresolved_targets(self) -> tuple[str, ...]: + return tuple( + rule.target for rule, state in self.rule_states if state == "unresolved" + ) + + @dataclass(frozen=True, slots=True) class RouterProjection: id: str @@ -42,6 +64,24 @@ class RouterProjection: rules: tuple[RouteRule, ...] fact_schema: FactSchema + def decide(self, facts: FactSet) -> RouteDecision: + """Evaluate every rule; this is the only place routes are decided.""" + selected = list(self.base_modules) + unresolved: set[str] = set() + rule_states: list[tuple[RouteRule, str]] = [] + for rule in self.rules: + result = rule.program.evaluate(facts) + if result.truth is Truth.TRUE: + if rule.target not in selected: + selected.append(rule.target) + rule_states.append((rule, "selected")) + elif result.truth is Truth.UNKNOWN: + rule_states.append((rule, "unresolved")) + unresolved.update(result.unresolved_facts) + return RouteDecision( + tuple(selected), tuple(sorted(unresolved)), tuple(rule_states) + ) + def fact_definitions(self) -> list[dict[str, object]]: """Canonical routing vocabulary used by material binding and navigation. diff --git a/tools/standards_analysis/tests/test_route_decision.py b/tools/standards_analysis/tests/test_route_decision.py new file mode 100644 index 00000000..e4d03e85 --- /dev/null +++ b/tools/standards_analysis/tests/test_route_decision.py @@ -0,0 +1,75 @@ +from __future__ import annotations + +import unittest +from pathlib import Path + +from tools.standards_analysis.standards_analysis import ( + RouteDecision, + load_router_projection, +) +from tools.standards_metadata.standards_metadata import load_canonical_module_corpus + + +REPO_ROOT = Path(__file__).resolve().parents[3] + + +class RouteDecisionTest(unittest.TestCase): + """The repository Router decides a route in one place for every caller.""" + + @classmethod + def setUpClass(cls) -> None: + modules = load_canonical_module_corpus(REPO_ROOT) + cls.router = load_router_projection(REPO_ROOT, modules) + + def decide(self, **facts: object) -> RouteDecision: + values: dict[str, object] = {} + for definition in self.router.facts: + value = facts.get(definition.id.removeprefix("routing."), []) + values[definition.id] = ( + {"type": definition.type, "state": "unknown"} + if value is None + else {"type": definition.type, "state": "known", "value": value} + ) + return self.router.decide(self.router.fact_schema.bind(values)) + + def test_base_modules_come_first_and_true_rules_follow_in_rule_order(self) -> None: + decision = self.decide( + activities=["verification", "implementation"], boundaries=["generated-contract"] + ) + + self.assertEqual(decision.selected[:1], self.router.base_modules) + self.assertEqual( + sorted(decision.selected[1:]), + [ + "profile.boundary.generated-contract", + "topic.contracts.schemas", + "workflow.implementation", + "workflow.verification", + ], + ) + self.assertEqual(decision.unresolved_facts, ()) + self.assertEqual(decision.unresolved_targets, ()) + self.assertEqual( + [(rule.target, state) for rule, state in decision.rule_states], + [(target, "selected") for target in decision.selected[1:]], + ) + + def test_no_known_fact_selects_only_the_base(self) -> None: + decision = self.decide() + + self.assertEqual(decision.selected, self.router.base_modules) + self.assertEqual(decision.rule_states, ()) + + def test_an_unknown_fact_leaves_its_rules_unresolved(self) -> None: + decision = self.decide(activities=["implementation"], topics=None) + + self.assertEqual(decision.selected, ("router", "workflow.implementation")) + self.assertEqual(decision.unresolved_facts, ("routing.topics",)) + self.assertIn("topic.architecture", decision.unresolved_targets) + self.assertIn("topic.code-design", decision.unresolved_targets) + self.assertNotIn("workflow.verification", decision.unresolved_targets) + self.assertFalse(set(decision.selected) & set(decision.unresolved_targets)) + + +if __name__ == "__main__": + unittest.main() diff --git a/tools/standards_contracts/README.md b/tools/standards_contracts/README.md index 3c1bab8d..0f2e0f19 100644 --- a/tools/standards_contracts/README.md +++ b/tools/standards_contracts/README.md @@ -128,3 +128,31 @@ unchanged. the existing Draft 2020-12 validator. Interface 44's canonical Digest uses it with the lowercase SHA-256 pattern to exclude trailing data, including a final newline. Generated tools/models preserve this constraint without a local keyword evaluator. + +## Metaschema validation and the recorded schema digest + +`compile_contracts(schema, interface)` validates the schema against the Draft +2020-12 metaschema on every call. That validation is the slowest step of +compilation, and a server start otherwise repeats it for a schema that has not +changed since the generator validated it. + +The generated Python projection therefore records `VALIDATED_SCHEMA_DIGEST`, the +digest of the schema the generator compiled. A caller that holds that projection +may pass the value as `validated_schema_digest`. `compile_contracts` computes the +digest of the schema it was given and omits metaschema validation only when the +two are equal. A schema with any other digest is validated exactly as a call +without the argument. The dialect, projection-profile, reference, reachability, +root-closure and interface checks run on every call. + +The digest is the SHA-256 of the schema's JSON value serialized with sorted keys. +Key order and file formatting do not change it; `1`, `1.0` and `true` are +different values. A Python value that is not plain JSON, such as one holding a +tuple or a non-string key, has no digest and is always validated. The argument is +the caller's statement that a generator validated the schema with that digest, so +pass only a digest read from a generated projection. + +The repository generator, its `--check` mode and the `contract_projection` +verifier check never pass a digest: they always validate, and they report a +generated projection whose recorded digest is not the canonical schema's as stale. +The Engine passes the digest when it prepares its installed interface. A schema +edited without regenerating has another digest and is validated at startup. diff --git a/tools/standards_contracts/standards_contracts/compiler.py b/tools/standards_contracts/standards_contracts/compiler.py index 18ca64e6..c0bf1559 100644 --- a/tools/standards_contracts/standards_contracts/compiler.py +++ b/tools/standards_contracts/standards_contracts/compiler.py @@ -1,6 +1,7 @@ from __future__ import annotations import copy +import hashlib import json import keyword import re @@ -117,9 +118,33 @@ def project(self) -> ProjectionArtifacts: ) +def schema_digest(schema: Mapping[str, object]) -> str | None: + """Identify a schema by its JSON value; a value that is not plain JSON has none. + + Key order is ignored; 1, 1.0 and true are different values. json.dumps writes + a tuple as an array and a scalar key as a string, so the document must also + read back equal before its digest names this value. + """ + try: + document = json.dumps(schema, sort_keys=True, separators=(",", ":")) + except (TypeError, ValueError): + return None + if json.loads(document) != schema: + return None + return "sha256:" + hashlib.sha256(document.encode("ascii")).hexdigest() + + def compile_contracts( - schema: Mapping[str, object], interface: Mapping[str, object] + schema: Mapping[str, object], interface: Mapping[str, object], + *, validated_schema_digest: str | None = None, ) -> CompiledContracts: + """Compile the schema and interface together. + + ``validated_schema_digest`` is the digest that a generated projection records + for the schema its generator validated. A schema with that digest is not + validated against the Draft 2020-12 metaschema again; any other schema is. + Every other check here always runs. + """ selected_schema = copy.deepcopy(dict(schema)) if selected_schema.get("$schema") != _DIALECT: raise failure( @@ -128,18 +153,20 @@ def compile_contracts( outcome="unsupported", schema_pointer="/$schema", ) - try: - Draft202012Validator.check_schema(selected_schema) - except SchemaError as error: - raise ContractError( - ContractFailure( - outcome="invalid", - code="CONTRACT.INVALID_SCHEMA", - message="the canonical schema is not valid Draft 2020-12", - schema_pointer=_pointer(error.absolute_schema_path), - keyword=str(error.validator) if error.validator is not None else None, - ) - ) from None + if (validated_schema_digest is None + or schema_digest(selected_schema) != validated_schema_digest): + try: + Draft202012Validator.check_schema(selected_schema) + except SchemaError as error: + raise ContractError( + ContractFailure( + outcome="invalid", + code="CONTRACT.INVALID_SCHEMA", + message="the canonical schema is not valid Draft 2020-12", + schema_pointer=_pointer(error.absolute_schema_path), + keyword=str(error.validator) if error.validator is not None else None, + ) + ) from None _check_projection_profile(selected_schema) definitions = selected_schema.get("$defs") @@ -587,6 +614,7 @@ def _python_source( ")", "", f"_SCHEMA = json.loads({json.dumps(schema, ensure_ascii=False, separators=(',', ':'))!r})", + f"VALIDATED_SCHEMA_DIGEST = {schema_digest(schema)!r}", f"DEFINITION_METADATA = freeze_json({_definition_metadata(definitions)!r})", "", ] diff --git a/tools/standards_contracts/tests/support.py b/tools/standards_contracts/tests/support.py index a0acd315..01130590 100644 --- a/tools/standards_contracts/tests/support.py +++ b/tools/standards_contracts/tests/support.py @@ -4,6 +4,9 @@ import json import tomllib from pathlib import Path +from unittest import mock + +from jsonschema import Draft202012Validator ROOT = Path(__file__).resolve().parents[3] @@ -17,6 +20,13 @@ def canonical_inputs() -> tuple[dict[str, object], dict[str, object]]: return schema, interface +def metaschema_checks(): + """Count Draft 2020-12 metaschema validations while still performing them.""" + return mock.patch.object( + Draft202012Validator, "check_schema", wraps=Draft202012Validator.check_schema + ) + + def mutated_definition( name: str, replacement: dict[str, object] ) -> tuple[dict[str, object], dict[str, object]]: diff --git a/tools/standards_contracts/tests/test_compiler.py b/tools/standards_contracts/tests/test_compiler.py index 44e92c17..80a74d54 100644 --- a/tools/standards_contracts/tests/test_compiler.py +++ b/tools/standards_contracts/tests/test_compiler.py @@ -7,8 +7,9 @@ ContractError, compile_contracts, ) +from tools.standards_contracts.standards_contracts.compiler import schema_digest -from support import canonical_inputs +from support import canonical_inputs, metaschema_checks class ContractCompilerTest(unittest.TestCase): @@ -238,3 +239,111 @@ def test_variant_rejects_unknown_definitions_fields_and_duplicate_results(self): with self.subTest(replacement=replacement), self.assertRaises(ContractError) as caught: compile_contracts(schema, interface) self.assertEqual(caught.exception.failure.code, "CONTRACT.INVALID_INTERFACE") + + +class ValidatedSchemaDigestTest(unittest.TestCase): + """Only the schema named by a recorded digest skips the metaschema check.""" + + def test_schema_with_the_recorded_digest_is_not_validated_again(self) -> None: + schema, interface = canonical_inputs() + with metaschema_checks() as checked: + validated = compile_contracts(schema, interface) + self.assertEqual(checked.call_count, 1) + reused = compile_contracts( + schema, interface, validated_schema_digest=schema_digest(schema) + ) + self.assertEqual(checked.call_count, 1) + + self.assertEqual(reused.schema, validated.schema) + self.assertEqual(reused.interface, validated.interface) + self.assertEqual(reused.reachable_definitions, validated.reachable_definitions) + self.assertEqual(reused.project(), validated.project()) + + def test_schema_that_differs_from_the_digest_is_fully_validated(self) -> None: + schema, interface = canonical_inputs() + recorded = schema_digest(schema) + schema["$defs"]["NonEmptyString"]["minLength"] = 2 + with metaschema_checks() as checked: + compiled = compile_contracts(schema, interface, validated_schema_digest=recorded) + self.assertEqual(checked.call_count, 1) + with self.assertRaises(ContractError): + compiled.validate("NonEmptyString", "a") + + def test_invalid_schema_is_rejected_with_and_without_a_recorded_digest(self) -> None: + canonical, _ = canonical_inputs() + # -1 fails the metaschema only. true equals the canonical 1 in Python, + # so comparing parsed schemas instead of digests would accept it. + for value, keyword in ((-1, "minimum"), (True, "type")): + for recorded in (None, schema_digest(canonical)): + schema, interface = canonical_inputs() + schema["$defs"]["NonEmptyString"]["minLength"] = value + self.assertEqual(schema == canonical, value is True) + with self.subTest(value=value, recorded=recorded): + with self.assertRaises(ContractError) as caught: + compile_contracts(schema, interface, validated_schema_digest=recorded) + self.assertEqual(caught.exception.failure.code, "CONTRACT.INVALID_SCHEMA") + self.assertEqual(caught.exception.failure.outcome, "invalid") + self.assertEqual(caught.exception.failure.keyword, keyword) + + def test_every_other_check_still_runs_for_a_matching_digest(self) -> None: + def another_dialect(schema: dict[str, object]) -> None: + schema["$schema"] = "https://json-schema.org/draft/2019-09/schema" + + def unsupported_keyword(schema: dict[str, object]) -> None: + schema["$defs"]["NonEmptyString"]["format"] = "email" + + def unreachable_definition(schema: dict[str, object]) -> None: + schema["$defs"]["Unused"] = {"type": "string"} + + def missing_root(schema: dict[str, object]) -> None: + schema["oneOf"].pop() + + for change, code in ( + (another_dialect, "CONTRACT.UNSUPPORTED_DIALECT"), + (unsupported_keyword, "CONTRACT.UNSUPPORTED_PROJECTION"), + (unreachable_definition, "CONTRACT.UNREACHABLE_DEFINITION"), + (missing_root, "CONTRACT.ROOT_CLOSURE_MISMATCH"), + ): + schema, interface = canonical_inputs() + change(schema) + with self.subTest(code=code): + with self.assertRaises(ContractError) as caught: + compile_contracts( + schema, interface, validated_schema_digest=schema_digest(schema) + ) + self.assertEqual(caught.exception.failure.code, code) + + schema, interface = canonical_inputs() + interface["operations"][0]["extra"] = True + with self.assertRaises(ContractError) as caught: + compile_contracts(schema, interface, validated_schema_digest=schema_digest(schema)) + self.assertEqual(caught.exception.failure.code, "CONTRACT.INVALID_INTERFACE") + + def test_digest_names_the_json_value_not_its_key_order(self) -> None: + schema, _ = canonical_inputs() + reordered = dict(reversed(schema.items())) + self.assertNotEqual(list(reordered), list(schema)) + self.assertEqual(schema_digest(reordered), schema_digest(schema)) + self.assertRegex(schema_digest(schema), r"\Asha256:[0-9a-f]{64}\Z") + digests = { + schema_digest({"minLength": value}) for value in (1, 1.0, True, "1", [1], None) + } + self.assertEqual(len(digests), 6) + + def test_python_value_that_only_serializes_like_the_schema_is_validated(self) -> None: + canonical, interface = canonical_inputs() + recorded = schema_digest(canonical) + # json.dumps writes this tuple as the same array, but it is not a JSON array + # and the metaschema rejects it. + schema, _ = canonical_inputs() + required = schema["$defs"]["QueryCall"]["required"] + schema["$defs"]["QueryCall"]["required"] = tuple(required) + self.assertIsNone(schema_digest(schema)) + with self.assertRaises(ContractError) as caught: + compile_contracts(schema, interface, validated_schema_digest=recorded) + self.assertEqual(caught.exception.failure.code, "CONTRACT.INVALID_SCHEMA") + + # An integer key reads back as a string; mixed keys and a set cannot be written. + for not_json in ({1: "key"}, {1: "key", "a": "key"}, {"const": {1, 2}}): + with self.subTest(not_json=not_json): + self.assertIsNone(schema_digest(not_json)) diff --git a/tools/standards_contracts/tests/test_projection.py b/tools/standards_contracts/tests/test_projection.py index bd57a1f2..184d4a65 100644 --- a/tools/standards_contracts/tests/test_projection.py +++ b/tools/standards_contracts/tests/test_projection.py @@ -4,16 +4,21 @@ import copy import json import sys +import tempfile import types import unittest +from pathlib import Path +from unittest import mock from tools.standards_contracts.standards_contracts import ( ContractError, MISSING, compile_contracts, ) +from tools.standards_contracts.standards_contracts import projection +from tools.standards_contracts.standards_contracts.compiler import schema_digest -from support import canonical_inputs +from support import canonical_inputs, metaschema_checks def load_generated(source: str) -> types.ModuleType: @@ -330,5 +335,39 @@ def test_agent_tools_derive_every_operation_and_reachable_definition(self) -> No json.dumps(tools) +class RepositoryGeneratorValidationTest(unittest.TestCase): + """The generator owns the validation that a recorded digest stands for.""" + + def test_generator_validates_the_schema_whose_digest_it_records(self) -> None: + schema, _ = canonical_inputs() + with metaschema_checks() as checked: + projections = projection.render_repository_projections() + self.assertEqual(checked.call_count, 1) + generated = load_generated(projections[projection.PYTHON_PATH]) + self.assertEqual(generated.VALIDATED_SCHEMA_DIGEST, schema_digest(schema)) + self.assertNotIn("VALIDATED_SCHEMA_DIGEST", generated.__all__) + + def test_generator_and_drift_check_reject_an_invalid_schema(self) -> None: + schema, _ = canonical_inputs() + schema["$defs"]["NonEmptyString"]["minLength"] = -1 + with tempfile.TemporaryDirectory(prefix="invalid-contract-") as directory: + invalid = Path(directory) / "a1-contract.schema.json" + invalid.write_text(json.dumps(schema), encoding="utf-8") + outputs = (Path(directory) / "generated.py", Path(directory) / "agent-tools.json") + with mock.patch.multiple( + projection, SCHEMA_PATH=invalid, PYTHON_PATH=outputs[0], TOOLS_PATH=outputs[1] + ): + for name, run in ( + ("render", projection.render_repository_projections), + ("check", lambda: projection.projection_main(["--check"])), + ("write", lambda: projection.projection_main([])), + ): + with self.subTest(run=name): + with self.assertRaises(ContractError) as caught: + run() + self.assertEqual(caught.exception.failure.code, "CONTRACT.INVALID_SCHEMA") + self.assertFalse(any(path.exists() for path in outputs)) + + if __name__ == "__main__": unittest.main() diff --git a/tools/standards_engine/MCP-OBSERVABILITY.md b/tools/standards_engine/MCP-OBSERVABILITY.md index 44acb8e4..d344509b 100644 --- a/tools/standards_engine/MCP-OBSERVABILITY.md +++ b/tools/standards_engine/MCP-OBSERVABILITY.md @@ -1,193 +1,293 @@ -# Operator MCP interaction observations +# MCP interaction recording -This optional local recorder observes the existing MCP boundary. It does not add -agent tools, modify domain outcomes or workflow authority, make model calls, retry -operations, or change the installed agent catalog. The qualification observer remains -**observer v3**, with its existing raw-event acquisition, assessment and exact-source -replay. The production recorder does not import the harness or rewrite verdicts. +Every Standards Engine MCP server process records how its tools are used, so the +interface can be improved from what agents actually send and receive. Recording is +always on, keeps about seven days, and is invisible to the agent. -The sanitized recorder selected by `--observe-database` and -`--observe-deployment` is the sole supported recording mode. The earlier raw -recorder and its `--observation-db` option are retired. Historical raw databases -retain their original schema and remain separate evidence; configure a new -dedicated database for sanitized observations. +- **Always on.** No flag is needed, in either purpose, for any client. +- **Invisible.** Recording adds no tool, catalog entry or instruction text and + changes no result. It never raises into a request. A recording problem is + reported only on the server's stderr. +- **No dropped records.** A call that cannot be written at once waits in memory + and is written by a later call or when the process closes. +- **Seven days.** Older calls are removed automatically. -## Configuration and authority +This is the only MCP recorder. The qualification observer remains **observer v3** +with its own raw-event evidence and exact-source replay; the recorder neither +imports that harness nor rewrites its verdicts. -Recording is off unless the operator explicitly supplies **both** options below. -The commands illustrate a new operator-owned installation, not instructions to -enable an existing one without its operator's approval. Replace paths and the -nonsensitive deployment label with operator-selected values: +## Where the file is + +```text +${XDG_DATA_HOME:-~/.local/share}/standards-engine/observations/interactions-v2.sqlite3 +``` + +The server creates that directory with mode 0700 if it is missing and the file with +mode 0600. Existing directories and permissions are never changed. + +| Launch option | Default | Meaning | +| --- | --- | --- | +| `--observe-database PATH` | the file above | Record somewhere else. The directory must already exist; it is not created. | +| `--observe-deployment LABEL` | `local` | A nonsensitive label stored with each server process. | +| `--observe-max-calls N` | 10000 | 16–100000 calls kept, across all processes. | +| `--observe-max-age-seconds N` | 604800 (7 days) | 60–31536000 seconds since a call began. | +| `--observe-max-bytes N` | 33554432 (32 MiB) | 1048576–1073741824 bytes of database file. | +| `--no-observe` | recording on | Do not record this process. | + +## Turning it off + +Either of these stops recording for a server process. Nothing is created or opened. ```sh -python3 -m tools.standards_engine.standards_engine.mcp \ - --repo-root /operator/standards --purpose authoring \ - --observe-database /operator/private-diagnostics/interactions.sqlite \ - --observe-deployment qualification-fixture +python3 -m tools.standards_engine.standards_engine.mcp --purpose application --no-observe +STANDARDS_ENGINE_OBSERVE=off python3 -m tools.standards_engine.standards_engine.mcp --purpose application ``` -The database directory must already exist, be operator controlled and exclude -concurrent untrusted replacement of the directory or its ancestors. This initial -recorder supports POSIX regular local files and SQLite rollback journals only. -It refuses final-component symlinks, hardlinked files, existing group/world-readable -files, unsupported journal modes and unsupported or unrelated database schemas. -New files use mode 0600. It does not chmod existing files, create directories or -use an Engine domain database. Do not place it in a repository, tracked directory, -network share or an agent-visible artifact directory. The operator must select -appropriate disk access, encrypted storage/backup and disposal arrangements. - -**Same-user filesystem access is not a security boundary.** A process with the -same OS authority can read, modify or remove the recorder database and stderr. -Tool-catalog invisibility does not create confidentiality or tamper evidence. -The recorder therefore excludes payload values regardless of filesystem modes. -The deployment label must not contain account identities, credentials or secrets. -No network exporter is included. Export/sharing requires separate operator review. - -Policy defaults and valid ranges: - -| Option | Default | Range / meaning | +The environment variable wins over every `--observe-*` option. Tests and harnesses +that start a server pass `--no-observe`, set the variable, or name a temporary +`--observe-database`, so they never write to a developer's own file; a test +enforces this. Constructing +`MCPServer` directly in Python records only when it is given a `RecorderConfig`. + +## What is recorded + +One row per server process (`sessions`), one per request (`interactions`) and one +per response (`events`). Notifications are not recorded. + +**Per server process** + +- A random process id, start time, purpose, interface version and the catalog, + schema and implementation digests the process actually loaded. +- The deployment label, and the client name and version from `initialize` + `clientInfo` (for example `codex-mcp-client 0.163.0`). +- Per-tool input and output schema digests, stored once per distinct catalog. +- How many calls this process pruned, and how many rows it lost (see below). + +**Per request** + +- Time, order within the process, method, installed operation name, and whether the + response was written to stdio or only constructed. +- `input_shape`: the argument structure with every value replaced by its type. +- `arguments`: the values listed in the next section, and nothing else. +- `request_bytes` (the whole JSON-RPC line, client metadata included) and + `arguments_bytes` (the `arguments` object alone). +- `expected_catalog` as `matches`, `differs` or `unspecified`; the operation a + `describe_input`/`describe_output` call asked about. +- `thread`: a 16-hex-digit keyed hash of the client's thread or session id, when + the request metadata carries one, and `origin`: `main`, `subagent` or `unknown`. + Codex supplies both. A client that sends neither is recorded with no thread and + `unknown`; reports then treat the server process as the thread. + +**Per response** + +- Time, duration, `response_bytes` (the whole line) and `result_bytes` (one + serialization of `structuredContent`; the line carries that payload twice). +- An outcome word: the result's own `outcome` or `status` (`complete`, + `needs-facts`, `needs-action`, `requires-change`, `ready`, `draft`, `applied`, + `stale`, `rejected`, `recovery-required`, `invalid`, `unavailable`, `unsupported`, + `unauthorized`), or `input-invalid`, `tool-exception`, a protocol error class, + `response`, or `unknown` for an interrupted call. +- Where input validation failed: schema field names and the constraint keyword. +- `result`: `kind`, `status`, `code` and `outcome`; for a route, the selected + target IDs, the IDs of facts still unresolved, and the content page's offset, + total, item count and item IDs; for reads, the target IDs returned. + +### Argument values that are kept + +Values are kept only for names on an explicit list per operation. Any other +argument appears only as a type in `input_shape`. Strings are cut at 200 +characters, and lists and fact maps at 32 entries, with a `[truncated]` marker. A +whole `arguments` object over 8 KB keeps only its top-level scalars and +`truncated`. + +| Operation | Kept as sent | +| --- | --- | +| `read` | `target`, `detail`, `include_coverage`, `include_routing` | +| `read_many` | the same four names for each item | +| `route` | `detail`; `content.limit` and `content.offset`; every fact name and value | +| `related` | `target`, `direction`, `transitive`, `groups` | +| `relationship_groups` | `limit`, `offset` | +| `describe_input`, `describe_output` | `operation`, `selector`, `limit`, `offset` | +| `inspect` | the handle's `kind` and `child_kind` | +| `query`, `query_proposal`, `preview_application` | the nested request's `kind`, the `read`/`related` names above, and route facts; the revision handle's `kind` | +| `routing_facts`, `runtime_info` | nothing beyond the snapshot note below | + +A supplied `snapshot` is recorded as a 12-hex-digit hash of its id, so reuse of +one snapshot is visible without keeping the handle. + +**Route facts are kept exactly as the agent sent them**, including names and +values the routing vocabulary does not contain. An agent that invents a fact such +as `python`, or passes a sentence as a `task` fact, is the most useful signal this +recording has, so up to 200 characters of that text are stored. + +Every other operation is an authoring operation (`propose`, `revise`, +`resolve_workflow`, `resolve_many`, `review`, `apply`, `recover`, `analyze`, +`workflow_status`, `workflow_details`, `resume`, `maintain_evidence` and the +advanced native operations). For these, a value is kept only when all of the +following hold: + +- its name is declared by the installed input schema at that position; +- it is not inside `body`, `content`, `text`, `prompt`, `message`, `rationale`, + `reason`, `evidence`, `explicit_exclusions`, `details`, `metadata` or a + credential-like field; +- its name is one of: `kind`, `child_kind`, `detail`, `action`, `section`, + `result`, `decision`, `owner`, `disposition`, `relation`, `artifact_kind`, + `authority`, `level`, `role`, `origin`, `lifecycle`, `direction`, `id`, `policy`, + `standard`, `consumer`, `target`, `source_policy`, `subject`, `evidence_owner`, + `after_policy`, `rule`, `fact`, `requires`, `specializes`, `successors`, + `predecessors`, `groups`, `limit`, `offset`, `apply`, `transitive`; +- it is a boolean, a small number, or a string shaped like a canonical identifier + (letters, digits and `._:/-`, no spaces) that contains no digest, UUID or other + long hexadecimal run. + +So an edit is recorded as, for example, +`{"kind":"revise-policy-unit","policy":"workflow.planning.written-plan-applicability"}` +and a handle as `{"kind":"analysis-handle"}`. + +### What is never recorded + +- Standards text, bodies, titles, summaries, rationales, intents, headings, + conditions, evidence text, file paths, or any other prose in an authoring call. +- Result content: no standard text, messages, details or summaries. +- Handle ids, digests, request ids and progress tokens. +- Raw thread, session or turn ids, model names, workspace paths, repository URLs, + or anything else in request `_meta`. +- Argument names the installed schema does not declare (they are counted), other + than route fact names. +- Tool names the server does not install, exception messages and tracebacks. +- Credentials or tokens, under any name. + +## The seven-day window + +Each new call first removes calls that began more than seven days ago, then the +oldest calls beyond the count limit. When the file is within one sixteenth of its +byte limit the oldest sixteenth of calls is removed as well, so a full file never +stops new recording. A call and its response are removed together, and a server +process row goes when its last call does (one that carries a loss count stays +until it is seven days old). + +Removal happens only while something is recording: an idle file keeps its last +contents until the next call. Deleted rows are overwritten in the file +(`secure_delete`), but backups, filesystem snapshots and storage remnants are +outside the recorder's reach. The file does not shrink; freed space is reused. + +## No dropped records, and what can still be lost + +Each request is written before it is dispatched and each response after it has +been delivered. If the database is busy or unavailable, the row stays in an +in-memory backlog of at most 1,000 rows and the call proceeds: + +- A busy database is waited for at most 20 ms per attempt, and 250 ms once at + process start. The backlog is written by the next request or response, and at + orderly close with a wait of up to 5 seconds. +- Recording is never switched off. After any other storage error the connection + is reopened on a later call. +- Several processes creating the file at the same instant all succeed: the first + publishes the whole schema in one commit and the others find it complete. + +What cannot be recovered, and how it shows: + +| Situation | Effect | Visible as | | --- | --- | --- | -| `--observe-max-calls` | 10000 | 16–100000 retained interaction starts, across all processes | -| `--observe-max-age-seconds` | 604800 | 60–31536000 seconds since begin | -| `--observe-max-bytes` | 33554432 | 1048576–1073741824 bytes, SQLite main-file page quota | - -All processes sharing a database must use the same privacy/retention policy. -Each connection enforces its configured page quota; mixed policies do not establish -a shared minimum. Rollback journals may temporarily add up to roughly another -main database's size, plus SQLite bookkeeping and bounded report/sort working space. -The directory's filesystem quota remains the final bound on all files. No WAL, -background thread, queue or telemetry write retry is introduced. Main files do not -shrink on deletion: SQLite reuses freed pages. No automatic VACUUM/rebuild occurs. - -## Persisted contract and lifecycle - -Schema v1 has three owners within one recorder database: - -- `sessions`: exact startup runtime metadata (process instance UUID, interface, - purpose, catalog/schema/implementation digests), deployment label and per-tool - input/output schema digests. These bind the actually loaded source and effective - eager/on-demand catalog. They do not prove a client refreshed its catalog. -- `interactions`: immutable begin evidence, recorder UUID, session-local ordinal, - wall-clock begin instant, method/installed operation, sanitized input shape and - its shape-only digest, safe discovery target, expected-catalog match state, - request byte measurement and delivery scope. This row is the begin event. -- `events`: at most one independent end/error/incomplete observation per begin, - with monotonic elapsed milliseconds, wall-clock finish instant, response bytes, - fixed outcome class and sanitized validation locations/constraint keywords. - -Each mutation owns `BEGIN IMMEDIATE`/commit/rollback. Schema admission is checked -under the same lock, including exact owned DDL and application ID. Zero-length new version-0 -SQLite files migrate transactionally once to v1; v1 reopens without rewriting -observations. Future versions, unrelated/partial schemas and corruption are -unavailable, never deleted or replaced. Migration interruption rolls back under -SQLite recovery. Backup a stopped database before any future supported migration; -no downgrade migration or automatic restoration is currently provided. - -Stdio begins are committed before dispatch. End/error evidence is committed only -after the ordinary response write and flush return. `stdio-flushed` does not prove -the client received/processed the response. The direct Python `dispatch` path uses -`constructed` scope, which proves only that a response was produced. Parsing errors -and malformed requests with responses are observed; valid notifications have no -request/response pair and are excluded. Client IDs and clientInfo are not retained. - -A caught tool exception has a fixed `tool-exception` category; domain outcome may -be unknown. Typed validation rejections retain `input-invalid` plus safe field -locations. Other protocol/domain classes use fixed vocabularies, never exception -messages, tracebacks or arbitrary result codes. Transport/interruption errors -append `incomplete/unknown` if storage remains available. A killed process or a -failed terminal write leaves an unmatched begin. Reports label it unknown; startup -does not complete old calls or presume other live recorders died. Telemetry cannot -prove a domain effect did or did not commit and cannot authorize a mutation retry. - -Age and count retention run transactionally on each new observed request. Expiry -is event-driven: an idle/stopped database retains expired records until recording -resumes or the operator disposes of it. Starts and their terminal evidence are -removed together; unreferenced session manifests are removed in the same -transaction. Retention can evict an in-flight call from another process. Its late -terminal is counted as dropped and recording continues; no start is recreated. -Retention can remove evidence before a later success, so history/repair denominators -are limited to retained observations. Per-session prune counters themselves expire -with their session; they are not installation-lifetime loss totals. Secure deletion -is enabled for recorder deletes; it does not erase backups, filesystem snapshots, -SQLite journal history or storage-device remnants. - -## Privacy projection - -No credentials/tokens, scalar input values, raw request IDs, complete prompts, -model transcripts, standards/repository bodies, domain handles or arbitrary tool -outputs are stored or hashed. Every scalar input becomes only its type. - -At each structural location, only property names declared by the installed input -schema can appear. Recursive references/unions supply possible property names; -this is a disclosure projection, not another input validator. Dynamic map keys -and unknown names are removed and counted. Sensitive subtrees (`body`, `content`, -`text`, `prompt`, `message`, `rationale`, `reason`, `evidence`, `details`, `metadata`, -credentials/password/token/secret/authorization/api_key/environment/env) are replaced -by a redacted marker. Other input fields still retain no scalar values. Shapes -have at most 64 visited nodes, depth 5, four sampled array items and 8192 serialized -ASCII bytes. Truncation is explicit. Validation feedback is limited to eight -issues, depth-five schema-owned pointer components, wildcard indices/dynamic keys -and fixed constraint keywords; messages and offending values are omitted. - -An input-shape digest groups structural samples, not raw values or exact semantic -variants. Two scalar variants can deliberately have the same shape. Discovery -operation values are retained only on exact installed-operation membership. -Expected catalogs become only unspecified/matches/differs. Selector values are -not retained. There is no legitimate cross-process session/task ID in the current -MCP server: reports do not infer continuation from prompts or domain handles. - -## Health and recovery - -Operator stderr receives fixed JSON health at recorder startup, first degradation, -retention-dropped terminal observations, and orderly close. It carries state, -fixed reason, starts/terminals recorded, observations dropped and interactions -pruned in that process. Stderr failure itself is guarded. Health is not advertised -in the agent catalog or appended to an Engine result. - -Unavailable, locked (20 ms busy budget), full, unsafe, unsupported or corrupt -storage disables recording for that process and reports degraded health. Existing -begin evidence remains independent; no completion is invented. No further writes -or retries occur. The MCP operation still returns its original outcome and runs -once, including a domain result committed before the telemetry failure. A failed -start means that interaction may have no retained evidence at all. Health counters -cover attempted observations, not an exact census of lost interactions. - -The operator must monitor stderr/process supervision independently of SQLite, -fix the owned storage condition and restart the MCP process to recover recording. -Preserve a corrupt/unrecognized database for diagnosis; select a separately -approved fresh path rather than silently rebuilding it. A report cannot recover -health messages that were unavailable/lost with stderr or process termination. - -## Read-only inspection +| Process killed during a call | The request has no response row. | "without an outcome" in the report | +| Backlog over 1,000 rows | The oldest waiting rows are dropped. | `lost` on the process row and in the report | +| A response whose request row was already pruned or dropped | The response is not stored. | counted in the same `lost` | +| Database unreachable until the process ends | Its rows are never written. | stderr only: nothing can be stored | +| Process killed while rows are waiting | The waiting rows are gone. | not visible | + +In ordinary use the write takes well under a millisecond, so the last two cases +need a database that stays locked or broken for the life of a process. + +## Storage + +The database uses SQLite write-ahead logging. That is what keeps recording out of +the way: a commit holds the write lock for microseconds instead of the several +milliseconds a synced rollback journal needs, and reading a report never blocks a +server. For the person reading the data it means: + +- While any server is running there are three files: the database, `-wal` and + `-shm`. Recent calls may exist only in `-wal`. Read through SQLite (the report + does) or copy all three; do not copy the database file alone. +- The file must be on a local filesystem. Network shares are not supported. +- After an operating-system crash or power loss the last few commits may be + missing. A killed or crashed server process loses nothing that was committed. +- `-wal` is usually a few megabytes on top of the byte limit and is removed when + the last server closes. + +The recorder accepts only a new empty file or its own schema v2. It refuses +symlinks, hardlinked files, files readable by group or others, unrelated SQLite +files, files larger than the byte limit, and other schema versions, and leaves +them untouched. That includes schema v1 files written by earlier releases: they +are historical evidence, are never migrated or deleted, and are no longer written +because the default file name is new. + +**Same-user file access is not a security boundary.** Any process running as the +same user can read or change the recording. The thread hash key is stored in the +same database: it keeps raw client ids out of the file and out of shared reports, +but it does not hide a thread from someone who holds both the file and the id. Do +not put the file in a repository or an agent-visible directory, and review a +report before sharing it: route facts can contain agent-written text. + +## Health messages + +A healthy recorder writes nothing. When recording changes state, one line goes to +the server's stderr: + +```text +standards-engine observer {"backlog":6,"lost":0,"pruned_interactions":0,"reason":"storage-locked","recorded_starts":2,"recorded_terminals":2,"state":"degraded"} +``` + +`degraded` means rows are waiting in memory for the stated reason; it does not mean +recording stopped. A line with `healthy` follows when they have been written, and a +final line is written at close if anything was reported or lost. Reasons are fixed +words: `storage-locked`, `storage-unavailable`, `storage-full`, `storage-corrupt`, +`storage-error`, `unsafe-database-file`, `unsupported-database-schema`, +`invalid-database-schema`, `nonpristine-database`, `database-over-budget`, +`unsupported-journal-mode`, `unsupported-filesystem` and `recorder-error`. Paths, +SQL and payloads never appear. + +## Reading the recording ```sh -python3 -m tools.standards_engine.standards_engine.interaction_observer \ - --database /operator/private-diagnostics/interactions.sqlite --limit 100 +python3 -m tools.standards_engine.standards_engine.interaction_observer +python3 -m tools.standards_engine.standards_engine.interaction_observer --since-days 2 +python3 -m tools.standards_engine.standards_engine.interaction_observer --format json --limit 100 ``` -This operator CLI opens an existing v1 database in SQLite read-only/query-only -mode and uses one read snapshot. It never creates, migrates, prunes or modifies -observations. JSON goes only to the operator's stdout; no output file is created. -Each group/session/histogram section is bounded by `--limit` (1–1000), with explicit -truncation flags. Sequence analysis scans at most the latest 10000 retained starts; -its scan count and truncation are reported. Aggregate queries scan the bounded -retained database (at most the configured 100000 starts). Sessions show the latest -bounded set in chronological order; catalog comparisons cover those shown manifests. - -The report provides operation usage, error distribution by structural input shape, -sanitized field/constraint failures, observed latency and serialized bytes with -measurement counts, sanitized shapes for successful and failed calls, session -identity and catalog additions/removals/schema changes. Totals include all retained -starts/terminals; operation/failure/shape rows identify their delivery scope and -have their own counts. An end is a non-error MCP response, not evidence the domain -workflow completed. Missing measurements are null and have separate denominators. - -Sequence histograms count preceding observed errors/discoveries before a non-error -tool response, by session, delivery scope and operation. Their denominator is the -reported number of non-error responses in the bounded scan. This is a diagnostic -candidate for investigating repair loops, not proof that errors caused discovery, -that a schema was acquired before use, or that separate tasks share agent intent. -No raw trace or redacted request can be reconstructed. Bytes are JSON/stdio bytes, -not model tokens or provider billing. Preserve independent qualification evidence -for observer-v3 replay and exact behavioral assessment; do not export actual logs -with code or automatically rewrite contracts from these summaries. +`--database PATH` reads another file. The command opens the database read-only, +uses one consistent snapshot and never creates, changes or prunes a recording. +SQLite may leave an empty `-wal` and a `-shm` file beside a database it has read. + +The default output is about one screen of text: + +- calls by client, purpose and interface version; +- per operation: calls, share rejected, p50/p90/max duration and p50/max result + size; +- the most frequent rejections with their code, the field that failed and the + value that was sent; +- route fact names and values the server refused and never accepted in the window; +- the most-read targets, counting `read`, `read_many` and route content pages; +- how often a thread read a target it had already read; +- routes sent without a snapshot; +- threads, tool calls and repeated reads for main agents, subagents and clients + that identify neither; +- calls without an outcome, rows lost and calls pruned. + +`--format json` gives every section in full, plus the structural input shapes, +the latest server processes, catalog differences between them and the +error-then-success sequences. `--limit` (1–1000) bounds the rows per section and +truncation is flagged. + +How to read it: + +- "Refused and never accepted" is inferred from the recording, not checked against + a vocabulary: a fact name counts when its route was rejected for a fact and the + server neither accepted that name nor listed it as an unresolved fact in the + window. A value counts when the rejection points at its fact and that value was + never accepted. +- A thread is the hashed client thread, or the server process when the client sent + none. Repeat reads are counted within a thread. +- An unmatched call has an unknown outcome. The recording cannot show whether a + mutation committed and must not be used to decide a retry. +- Bytes are serialized JSON, not model tokens or billing. +- Recorded requests cannot be replayed. Keep qualification evidence for that. diff --git a/tools/standards_engine/PURPOSE-SEPARATION.md b/tools/standards_engine/PURPOSE-SEPARATION.md index b112edf0..38f5a14a 100644 --- a/tools/standards_engine/PURPOSE-SEPARATION.md +++ b/tools/standards_engine/PURPOSE-SEPARATION.md @@ -1,5 +1,76 @@ # Purpose-separated Engine contract +## Labelled application delivery (interface 49) + +Application approval is a review label, not a delivery gate. Every registered +standard and registered operational aid (prompt, template or documentation) that +an application call selects or names is delivered. `route`, `read`, `read_many`, +`related`, `relationship_groups`, `routing_facts`, `inspect`, native `query` and +authoring `preview_application` no longer depend on the approval state of the +Router, Core, the target or its prerequisites. Editing Core or the Router changes +their labels; it does not take the application interface offline. + +Each application read result (single, grouped, routed content item or candidate +preview) and each application `reading_plan` entry carries `review_state`: + +| `review_state` | Authoring `application_exposure` | Meaning | +| --- | --- | --- | +| `current` | `current` | This exact material was approved for application use. | +| `changed-since-review` | `needs-review` | The material changed after its approval. | +| `not-reviewed` | `unreviewed` | The material has never been approved. | + +A scoped policy read carries the label of its containing module. A label reports +the item's own state; prerequisites carry their own labels where they are +delivered. Labels describe editorial review of the wording, not whether guidance +applies. The approval manifest, its Engine-derived bindings, +`approve-application-content`, `withdraw-application-content`, the authoring +`application_exposure` values and the review workflow are unchanged. + +The application relationship graph contains every registered material and its +registered policy units, restricted to the `standards-requires`, +`standards-specializes`, `standards-dependencies`, `policy-impact` and `semantic` +groups. Decision provenance, the `decision-provenance` group and unregistered +consumers such as fixtures and implementation artifacts stay outside it; they can +neither be read nor connect a traversal. + +`APPLICATION.CONTENT_UNAVAILABLE` is removed; no path reports that guidance awaits +publication. Rejections name what the caller can correct: + +| Code | Outcome | Cause | +| --- | --- | --- | +| `APPLICATION.UNKNOWN_TARGET` | `invalid` | The identity or handle is not registered application material. Use an ID exactly as a route, read or related result gave it. | +| `APPLICATION.UNKNOWN_GROUP` | `invalid` | Unchanged for `related`; candidate previews now return it too. | +| `APPLICATION.TRAVERSAL_NOT_PERMITTED` | `invalid` | The selected group does not permit that direction or transitive traversal. | + +Misspelt, unknown, provenance and unregistered-consumer identities receive the +same `APPLICATION.UNKNOWN_TARGET` result, so the code does not reveal whether a +private record exists. Any other graph failure is +`APPLICATION.INTERNAL_UNAVAILABLE`. Candidate previews return the same codes and +messages bound to their revision. + +### Client-sized route content pages + +Application route content pages are sized for inline display by the client. The +page budget defaults to 40 KiB (40,960 bytes) of the result's one default JSON +serialization, which is the MCP text copy; the duplicate structured copy and +protocol framing are outside it. An application server accepts +`--route-page-bytes N` from 8,192 to 2,097,152; the option is a launch error for +authoring. Byte pressure ends a page before the next whole read, and a page always +keeps its first whole read: a module larger than the budget is returned alone, +never clipped or rejected. Only a result above the 2 MiB transport bound returns +`APPLICATION.RESULT_LIMIT`. Follow `content.next` unchanged. Authoring route +content, `read_many` in both purposes and selection-only routes keep their +existing bounds. + +Application `initialize` instructions and tool descriptions state the normal +sequence in plain language. Application agents learn the same sequence from the +[`coding-standards` skill](../../.agents/skills/coding-standards/SKILL.md). + +Interface 49 and result projection 9 version these result shapes. Request contract +6 and snapshot, Analysis, handle and store versions are unchanged, and no stored +state is migrated. Restart the MCP process and refresh the client catalog. +Sections below that describe an approval gate record earlier editions. + ## Explicit certificate retirement (interface 48) Authoring `maintain_evidence` accepts optional @@ -42,7 +113,7 @@ workflow. Canonical interface operation variants own each purpose's input and result definitions; MCP and CLI project only their reachable schema closure. The public application boundary constructs dedicated result values from -qualified domain material. Full detail remains within that boundary. Both +registered domain material. Full detail remains within that boundary. Both MCP result encodings carry the same value. Unknown/private identities and malformed requests receive bounded application outcomes. Detailed operational failures stay in host-private diagnostics, which the host must keep outside an @@ -62,9 +133,9 @@ The two support manifests are mandatory captured inputs: Both are empty in this code delivery. Existing normative and reference bytes remain unchanged and authoring-readable after the code candidate is integrated -into accepted `main`. Application reads initially report that the requested -guidance awaits application publication. This is intentional bootstrap behavior, -not an inference that legacy prose was reviewed. +into accepted `main`. Material without an approval is delivered with the +`not-reviewed` label (before interface 49 it was withheld). An empty manifest is +intentional bootstrap state, not an inference that legacy prose was reviewed. A supported snapshot contains its exact support records, exposure decisions, Router inputs and material. Reopening uses those captured bytes. Later exposure @@ -104,8 +175,11 @@ re-entry constructs its own scope, and public request shapes remain unchanged. Each subsequent operation loads and verifies its own captured bytes. Publication verification, target compare-and-swap and recovery obtain fresh observations; no operation-local material crosses those barriers as permission or readiness. -Each facade/Engine/SQLite lifetime remains per call. MCP now owns the installed -interface and a bounded cache of pure snapshot compilation as described below. +One MCP server process has one facade and Engine, opened by its first +store-backed call and described under +[One Engine per server process](#one-engine-per-server-process); the SQLite +lifetime remains per call. The Engine keeps +a bounded cache of pure snapshot compilation as described below. Operation-local workflow state, evaluations and permissions remain per-call. Exact draft projection retention is described separately below. @@ -119,14 +193,30 @@ code or its API schema requires a controlled process restart. Ordinary standards publication keeps the installed interface valid. Standalone facades prepare their own interface unless their trusted owner supplies an already prepared one. -One MCP process also owns a repository/purpose-scoped compilation cache with a +Preparing the interface does not repeat Draft 2020-12 metaschema validation for +the schema the contract generator already validated. The generated contract records +that schema's digest; a schema file with another digest is validated in full, as +described under +[Metaschema validation](../standards_contracts/README.md#metaschema-validation-and-the-recorded-schema-digest). +Every other interface check runs at each start. + +Every Engine has a repository/purpose-scoped compilation cache with a two-entry and 32 MiB accounted-retention limit shared by snapshot and draft -projection entries. Snapshot keys contain the exact verified +projection entries. An Engine keeps its own until it closes, unless its owner +lends one that outlives it; the one Engine of an MCP process keeps its own for +that process, and a CLI invocation's Engine for that invocation. Snapshot keys +contain the exact verified captured paths, bytes and source revision, plus the installed compiler function. -Python dictionary equality distinguishes hash collisions. Each new operation -opens and validates its store, checks snapshot lifecycle and verifies complete -content identity before lookup. Missing, quarantined, purged, replaced or corrupt -storage therefore remains observable. Equal verified inputs may share pure +Python dictionary equality distinguishes hash collisions. Each new MCP call +opens its store, checking its application, version and exact schema, and +each operation checks snapshot +lifecycle and verifies complete content identity before lookup. Missing, +quarantined, purged or replaced storage, and content that no longer matches its +identity, therefore remain observable. The store's complete SQLite +integrity/foreign-key audit is not repeated by every operation: a process runs it +on its first open of a store file, as described under +[Snapshot admission](../standards_snapshots/README.md#admission-and-maintenance-work). +Equal verified inputs may share pure compilation even when obtained from distinct store roots; store-specific handles, access checks and result envelopes remain fresh. No store facts enter the cache. @@ -148,14 +238,68 @@ Advancing main affects new captures; historical snapshots preserve their capture material. Publication candidate verification and recovery keep their existing fresh observations. Each new process starts empty and reconstructs correctly. -The transport retains serial dispatch and opens/closes a fresh facade and SQLite -connection for each call. Pure cached structures are read-only through their -owned interfaces; each response and continuation is newly constructed. The cache +The transport retains serial dispatch and opens and closes a SQLite connection +for each call. Pure cached structures are read-only +through their owned interfaces; each response and continuation is newly +constructed. The cache is not a thread-safety guarantee for concurrent use of one Engine. Independent server processes retain separate fixed-purpose resources. Stream EOF or failure -releases the server-owned interface, catalog and cache; closing a borrowing Engine +releases the server-owned interface and catalog and closes the Engine with its +store and cache; closing an Engine that borrowed a cache closes its store without releasing the owner's cache. +## One Engine per server process + +An MCP server process opens its facade and Engine with the first tool call that +needs a store, uses them for every later call, and closes them when the server +closes. `runtime_info`, `describe_input` and `describe_output` need no Engine +and open none. A CLI invocation is one process with one Engine for its single +operation, as before. + +The store connection is not part of that lifetime. Each call opens one and +closes it when the call ends, so between calls the process holds no store +connection, no SQLite lock and no open store file, journal or write-ahead log, +and a call may come from any thread. What a call observes is what it observed +when every call opened its own Engine: + +- **The store is opened for every call.** Before a call the server asks the + Engine to readmit, which opens a new connection and runs the statements a new + open of that existing file runs: application, version and exact schema, the + required SQLite profile, a version 1 migration with all of its audits, and the + maintenance probe with any due purge. A failure there is the same private + failure as a failed open: `isError` with the generic text, the diagnostic on + stderr, and no structured result. Only the complete integrity audit that the + process already ran for that file is not repeated, as before. +- **Another process's work is visible to the next call.** A new connection has + read nothing, so committed snapshots, proposals, quarantine and purge by + another server or a CLI call, a store migrated or altered in place, and a + store file overwritten in place are all read as they are on disk. +- **A replaced or missing store file opens a new Engine.** Before opening the + connection the Engine compares the repository root and store path it was + opened with against what they resolve to now, and the store path against the + file it opened. When either resolves elsewhere, or the store path names + another file or none, the server closes the Engine and opens a new one: that + open audits a file the process has not audited, creates a missing store, and + refuses a path that is not a regular file, exactly as an open always has. The + process also forgets its audit record of the file that was replaced. The + compilation cache belongs to the Engine, so nothing compiled from the old + store's content is carried to the new one except by verifying the new + store's bytes again. +- **No operation state is kept.** Operation material (`ProposalMaterials`, its + decoded revision, base and projection) and Git read sessions and candidates + are created inside one operation and released when it ends, on success or + failure. Nothing an operation computes is attached to the facade, the Engine + or the snapshot module; what stays is the pure compilation cache. A store + transaction is committed or rolled back by the store method that began it, + and closing the call's connection rolls back one that was not ended. +- **An Engine is not used after a failure nobody classified.** A typed + rejection is an ordinary outcome and keeps the Engine. An exception that + reaches the transport, an interruption, and an unclassified failure that an + application operation reports as its bounded `APPLICATION.INTERNAL_UNAVAILABLE` + rejection all close the Engine and its cache before the result is returned. + The next call opens a new Engine. Results and diagnostics of the failed call + are unchanged, and nothing is retried. + ## Exact draft projection reuse Draft reads, analysis, status, creation/revision preparation and focused resolution @@ -185,8 +329,9 @@ Review, candidate verification, application and recovery retain their existing fresh replay paths. New snapshot capture retains both independent compiler passes. Main advancement affects new captures, never the base of an existing draft. Old explicit revisions retain historical meaning and can have live stale status. -Corruption, quarantine, purge or missing/replaced stores reject before projection -reuse. Server restart reconstructs cold, and close releases both entry kinds. +Stored content that fails validation, quarantine, purge or missing/replaced stores +reject before projection reuse. Server restart reconstructs cold and repeats the +store's complete SQLite audit; close releases both entry kinds. ### Incremental successor construction @@ -233,7 +378,7 @@ returned by routing or a single read, and select only the needed guidance. The result contains the original snapshot and ordered single-read results. One complete durable content/identity validation supplies the whole operation; current snapshot lifecycle is checked before every item and before return. -Purpose, exposure, prerequisite and item-option checks use the ordinary read +Purpose, review-label and item-option handling use the ordinary read projection. Any failed item or lifecycle observation rejects the entire set. No item content is returned on failure. A new independent call verifies durable content again. This is a new explicit operation, not a change to single reads. @@ -259,19 +404,21 @@ Operational aids bind their source content and registered policy-owner facts. The derived states are `unreviewed`, `current` and `needs-review`. Content changes preserve the old declaration as stale until explicit renewed approval or -withdrawal. An application read requires its selected unit and actual mandatory -prerequisites to be current. Unknown applicability remains a request for facts; -a missing required qualification is an explicit unavailable observation. +withdrawal. The application view delivers material in every state and reports the +state as its `review_state` label; see +[labelled application delivery](#labelled-application-delivery-interface-49). +Unknown applicability remains a request for facts. Supplementary relationships remain selective. A prompt's policy-impact association does not acquire `Requires` semantics. The application graph view -contains permitted endpoints before traversal, so hidden intermediary nodes -cannot connect otherwise disconnected visible material. Whole-module discovery +contains its permitted endpoints (registered materials and their policy units) +before traversal, so hidden intermediary nodes cannot connect otherwise +disconnected visible material. Whole-module discovery includes relationships declared by its registered policy units. -Eligibility is an editorial decision. The runtime checks the declaration, -binding and required closure; it does not classify sentiment or prove prose -quality. No positivity model or lexical prohibition list is part of the runtime. +Approval is an editorial decision. The runtime checks the declaration and +binding and reports the result as a label; it does not classify sentiment or +prove prose quality. No positivity model or lexical prohibition list is part of the runtime. ## Decision provenance @@ -408,10 +555,10 @@ identities and prior proposal records remain intact. An authoring caller uses `preview_application` with the exact draft revision and one application read, route or related request. Candidate results carry that revision, without published-snapshot or snapshot-child handles. Their -continuations remain candidate previews. The same application view enforces -qualification, prerequisite closure and graph filtering. A missing qualification -is a candidate-application rejection, not partial acceptance. Normal application -sessions retain their published-only operation set. +continuations remain candidate previews. The same application view supplies +delivery, review labels and graph filtering. An unregistered target is a +candidate-application rejection. Normal application sessions retain their +published-only operation set. `maintain_evidence` remains accepted-repository maintenance, not draft mutation. Use logical registration for draft-only scopes. After installing this change, @@ -686,17 +833,19 @@ Focused `route` optionally accepts `content` with `offset` (default 0) and `limi (default 8, 1–32). Both purposes use one captured snapshot, one compiled input and the ordinary purpose-qualified single-read owner. Content contains whole compact reads for selected unique targets, in reading-plan order. The complete composed -JSON result is limited to 2 MiB. Byte pressure ends a page before the next whole +JSON result is limited to 2 MiB; application pages additionally use the +[interface-49 page budget](#client-sized-route-content-pages). Byte pressure ends +a page before the next whole read; `content.next` is a complete route request with identical facts, snapshot, limit and the next offset. Missing applicability facts remain missing. Reading plan and unresolved questions are not paged or suppressed. Nonzero offsets require explicit snapshot authority before capture. An offset past -the selected count rejects; equality returns a final empty page. A single oversized -record or oversized route envelope yields a bounded limit rejection. The caller -may explicitly route without content, then read a target with an adequate client. -Selected dependency qualification is checked for the whole route, not only the -current page. Failed reads or lifecycle checks expose no successful partial prefix. +the selected count rejects; equality returns a final empty page. In authoring, a +single oversized record or oversized route envelope yields a bounded limit rejection; +the caller may explicitly route without content, then read a target with an adequate +client. Application routes deliver every selected target with its review label. +Failed reads or lifecycle checks expose no successful partial prefix. The existing selection-only route, native query and candidate preview contracts retain their previous behavior. This is paging over a request, not an authorization cursor: changing facts explicitly requests another route. @@ -729,7 +878,7 @@ usable after process replacement. Restart/reconnect and preserve retained state. There is no remote publication, auto-review, retry or migration in this increment. The focused suites and `agent_efficiency_trace.py` qualify schema semantics, -selected text, explicit evidence decisions, cold stdio and serialized byte/call +selected text, explicit evidence decisions, real stdio and serialized byte/call counts. These are not claims about model tokens, billed usage or client rendering. The plan records supported-runtime, configured-client and independent-review gates separately from local structural and unit evidence. @@ -813,7 +962,7 @@ closure. `unresolved_policy_count` counts reading-plan entries not selected; it not evidence those policies do not apply. `explanation` is a complete full-route request anchored to the same snapshot and facts. Full focused route retains `agent-route-result`; native queries and candidate previews keep prior contracts. -Application results remain qualified and never disclose private rule explanations. +Application results keep their own projection and never disclose private rule explanations. Content paging retains detail, facts and snapshot. Rule evaluation and missing vs known-empty semantics are unchanged; compact presentation does not build full rule expression output merely to discard it. @@ -822,12 +971,12 @@ expression output merely to discard it. selected graph. Its result records purpose, snapshot, total, offset, whole group items and next arguments. Each item contains id, registered meaning and traversal policy, not source locators, validator implementation or extension metadata. The -application view supplies only permitted groups after Router qualification. A group +application view supplies only permitted groups. A group can be registered with no relationships for a target. Default 8/max 32 records and 16 KiB page JSON bound the result; oversized records return unsupported without truncation. Nonzero offsets require the exact snapshot, and final lifecycle failure discards the complete page. Unknown focused `related` queries return the same first -page as optional rejection feedback (qualified targets are checked first). Native +page as optional rejection feedback (registered targets are checked first). Native application queries share that behavior; native authoring and candidate queries keep existing authority-specific failures. No guessed alias or alternate graph is used. @@ -965,10 +1114,10 @@ The bound selection helper reuses the existing algorithm and program schema-dige checks. Native query/preview callers still bind canonical typed inputs before selecting; they are not a fallback for old focused requests. -Application dispatch first qualifies Router and its required content. It then binds -focused input and qualifies the complete selected content closure before returning -a route or page. The new invalid-input adaptation is confined to that known binding -boundary, not a general change to lifecycle/qualification errors. Authoring returns +Application dispatch binds focused input and returns the complete selected content +closure with review labels (interface 49 removed the earlier Router and closure +qualification step). The invalid-input adaptation is confined to that known binding +boundary, not a general change to lifecycle errors. Authoring returns `ROUTE.INPUT_INVALID`; application returns `APPLICATION.INPUT_INVALID`. Both include bounded existing input_feedback with a route describe_input hint. Known fields may be named; unrecognized input keys/values are not echoed. This is one fixed-prose diff --git a/tools/standards_engine/README.md b/tools/standards_engine/README.md index 3e0b3fd7..642a6229 100644 --- a/tools/standards_engine/README.md +++ b/tools/standards_engine/README.md @@ -1,10 +1,24 @@ # Standards Engine -The current interface is **48**. Input contracts are native-only; `--schema-mode` +The current interface is **49**. Input contracts are native-only; `--schema-mode` is no longer accepted. Exact input/output contracts remain available through `describe_input` and `describe_output`. Select `--output-schemas on-demand` for the smaller catalog; eager output delivery remains the default. +Interface 49 makes application approval a review label instead of a delivery gate. +An application agent receives every registered module its facts select or its call +names; each read result and reading-plan entry carries `review_state` (`current`, +`changed-since-review` or `not-reviewed`). Editing Core or the Router changes their +labels and no longer takes the application interface offline. An unregistered +identity returns `APPLICATION.UNKNOWN_TARGET`; `APPLICATION.CONTENT_UNAVAILABLE` is +removed. Application route content pages default to 40 KiB of result JSON so a +client can show them inline; `--route-page-bytes` selects 8,192–2,097,152 for an +application server, and a page always holds at least one whole module. The +approval manifest and authoring exposure workflow are unchanged. Application +agents use the [`coding-standards` skill](../../.agents/skills/coding-standards/SKILL.md). +Restart the MCP process and refresh the client catalog. See +[labelled application delivery](PURPOSE-SEPARATION.md#labelled-application-delivery-interface-49). + Interface 44 aligns logical graph, store-path, integer and evidence-digest boundaries. The Digest scalar now excludes trailing data explicitly. Operation shapes and stored workflow identities are unchanged. Restart the MCP process and refresh the client @@ -38,16 +52,19 @@ normative text, policy subjects, consumer relationships and other certificates remain intact. It supplies no replacement coverage claim. Restart/reconnect after installing the coordinated source and generated contracts; preserve stores. -Optional sanitized operator measurements use `--observe-database` with -`--observe-deployment`; see [MCP observability](MCP-OBSERVABILITY.md). Recording is -disabled by default and preserves the existing qualification observer v3 and -agent-visible interface. This is the sole supported MCP recorder. +Every MCP server process records how its tools are used in an operator-only local +SQLite file and keeps about seven days. See +[MCP interaction recording](MCP-OBSERVABILITY.md) for exactly what is and is not +recorded, where the file is, and how to turn it off (`--no-observe` or +`STANDARDS_ENGINE_OBSERVE=off`). Recording changes nothing an agent can see and +preserves the existing qualification observer v3. This is the sole supported MCP +recorder. ## Purpose separation (interface 31) Version 0.2.0 / interface 31 requires host-selected `application` or `authoring` -purpose. Application views use exact reviewed content declarations; the real -corpus intentionally starts unqualified in this code release. Authoring retains +purpose. Application views label material against exact reviewed content +declarations (since interface 49 the label no longer withholds it). Authoring retains the complete workflow and adds provenance, registered operational-aid editing and explicit application exposure decisions. Analysis request 6 / state 7 bind explicit preservation or change to the actual candidate semantic revision. @@ -78,7 +95,9 @@ rows. Native `query` remains available. `read_many` reads a selected set using one explicit snapshot. It accepts 1–32 ordered unique items, applies the existing purpose-qualified single-read behavior, and returns all results or one bounded rejection. Its complete JSON domain -payload is limited to 2 MiB. See [the grouped-read contract](PURPOSE-SEPARATION.md#bounded-grouped-reads). +payload is limited to 2 MiB; application agents should request two or three +modules per call so the client can show the whole result. See +[the grouped-read contract](PURPOSE-SEPARATION.md#bounded-grouped-reads). Navigation reads immutable snapshots; proposal analysis, review, verification, and application operate on exact revision handles. Proposal creation and @@ -253,7 +272,8 @@ PYTHONPATH=. python3 -m unittest tools.standards_engine.tests.test_schema_presen PYTHONPATH=. python3 -m tools.standards_engine.tests.agent_efficiency_trace ``` -The trace uses disposable repositories, real cold MCP stdio calls and explicit +The trace uses disposable repositories, real MCP stdio calls through one server +process per trace (replaced where a cold read is the claim) and explicit fixture-owned decisions. It compares selection-plus-read to composed routing and inline to shared evidence, verifies exact outcomes and stops before publication. Use the supported locked environment for release qualification. @@ -264,7 +284,10 @@ Use the supported locked environment for release qualification. `mcp_catalog.tool_catalog` builds tool definitions from an already compiled interface plus explicit purpose, focused/advanced selection and output delivery. It performs no installation loading, store access or connection management. MCP -and CLI composition load the interface; `mcp.py` owns protocol and stdio lifetime. +and CLI composition load the interface; `mcp.py` owns protocol and stdio lifetime +and the server process's one Engine, which it opens with the first store-backed +call and closes with the server. The store connection is opened for each call +and closed when the call ends. Schema locations and reference closure belong to the contracts package. Input schemas are the exact reference-preserving closure of the selected declaration; there is no recursive inliner, size-based representation selector, input-mode enum, @@ -332,10 +355,19 @@ smaller catalog. Preserve stores and handles across restart/reconnect. ## Immutable-work reuse (interface unchanged: 44) -The process-owned compilation cache also retains exact captured-content identity +Every Engine has a compilation cache: its own for its lifetime, or one its owner +lends. An MCP server process has one Engine, opened by its first store-backed call +and closed with the server, so its cache lasts for the process, while its store +connection lasts for one call; see +[One Engine per server process](PURPOSE-SEPARATION.md#one-engine-per-server-process). +The cache also retains exact captured-content identity proofs. Identity and compilation for one capture share one LRU entry and the existing byte budget. The Snapshot codec still defines identity, and every read reloads actual bytes, verifies file integrity and checks the stored identity and current lifecycle. +These per-read checks are separate from the store's complete SQLite +integrity/foreign-key audit, which a process runs on its first open of a store file +and not on each store-backed call; see +[Snapshot admission](../standards_snapshots/README.md#admission-and-maintenance-work). Focused authoring operations reuse canonical revision decoding through `ProposalMaterials`; the single record is released on success or exceptional exit. @@ -371,7 +403,7 @@ reconstructed and disabled/undersized caches preserve results. See the Successful capture still compiles the live recorded source and the frozen replay independently and checks both path closure and semantic signature before durable snapshot publication. After admission it offers that proved frozen compilation -to the existing bounded process cache, without retaining the recording wrapper. +to the Engine's bounded cache, without retaining the recording wrapper. The first snapshot operation can reuse the result instead of compiling it again. This is computation reuse, not a stored proof or lifecycle decision. Every later @@ -420,8 +452,15 @@ after installation without changing launch arguments or deleting stores. The earlier raw invocation recorder was retired on 2026-10-22. Its `--observation-db` launch option is no longer accepted. Historical raw databases remain operator-owned evidence and are not converted, reused or deleted. -Select a new dedicated database with `--observe-database` and a nonsensitive -`--observe-deployment` label. Follow the [sanitized recorder's operating contract](MCP-OBSERVABILITY.md) + +The opt-in sanitized recorder that replaced it (schema v1, selected with +`--observe-database` and `--observe-deployment`) is in turn replaced by always-on +recording in a new default file (schema v2). Its v1 databases are also left +untouched. A registration that still names a v1 file with `--observe-database` +is refused that file and records nothing until the option is removed; remove both +options to use the default location. `--observe-database` now only overrides the +location and `--observe-deployment` defaults to `local`. Follow the +[recording contract](MCP-OBSERVABILITY.md) for permissions, retained data, retention and reports. The [original observation plan](../../docs/plans/agent-interaction-observation/plan.md) retains its historical acceptance and qualification records. diff --git a/tools/standards_engine/contracts/README.md b/tools/standards_engine/contracts/README.md index 4bb13f27..76c37865 100644 --- a/tools/standards_engine/contracts/README.md +++ b/tools/standards_engine/contracts/README.md @@ -1,5 +1,14 @@ # Standards Engine Contracts +Interface 49 adds a required `review_state` (`current`, `changed-since-review` or +`not-reviewed`) to application and candidate-application read results and to +application reading-plan entries. Application approval labels delivered material +and no longer withholds it. `APPLICATION.CONTENT_UNAVAILABLE` is removed; +`APPLICATION.UNKNOWN_TARGET` and `APPLICATION.TRAVERSAL_NOT_PERMITTED` are added, +and candidate previews also return `APPLICATION.UNKNOWN_GROUP`. Result projection +advances to 9; request contract 6 and persisted state versions remain unchanged. +See [the interface-49 contract](../PURPOSE-SEPARATION.md#labelled-application-delivery-interface-49). + Interface 46 adds a durable application publication receipt and a fresh, read-only observation of the selected Git checkout to apply/recover results and workflow status. Observation failures return bounded unavailable fields without @@ -83,8 +92,8 @@ accepts a canonical registered ID or returned exact target. Fixture and source consumers do not acquire an editing capability. `preview_application` accepts an exact proposal revision and one application -read/route/related request. It applies normal exposure and prerequisite checks, -returns explicitly candidate-bound results, and provides preview-only +read/route/related request. It applies normal application delivery and review +labels, returns explicitly candidate-bound results, and provides preview-only continuations. It is absent from ordinary application catalogs. Preflight still checks structure rather than returning an application view. Preview does not certify coverage, accept review, issue exposure approval or publish the draft. diff --git a/tools/standards_engine/contracts/a1-contract.schema.json b/tools/standards_engine/contracts/a1-contract.schema.json index 16142b1c..aa75fab8 100644 --- a/tools/standards_engine/contracts/a1-contract.schema.json +++ b/tools/standards_engine/contracts/a1-contract.schema.json @@ -6948,13 +6948,14 @@ }, "code": { "enum": [ - "APPLICATION.CONTENT_UNAVAILABLE", + "APPLICATION.UNKNOWN_TARGET", "APPLICATION.INPUT_INVALID", "APPLICATION.OPERATION_UNAVAILABLE", "APPLICATION.INTERNAL_UNAVAILABLE", "APPLICATION.UNSUPPORTED_CAPTURE", "APPLICATION.RESULT_LIMIT", - "APPLICATION.UNKNOWN_GROUP" + "APPLICATION.UNKNOWN_GROUP", + "APPLICATION.TRAVERSAL_NOT_PERMITTED" ] }, "outcome": { @@ -7066,6 +7067,7 @@ "purpose", "snapshot", "policy", + "review_state", "content", "scope", "requires", @@ -7085,6 +7087,9 @@ "policy": { "$ref": "#/$defs/ApplicationPolicy" }, + "review_state": { + "$ref": "#/$defs/ApplicationReviewState" + }, "content": { "type": "string" }, @@ -7162,7 +7167,8 @@ "target", "scope", "authority", - "state" + "state", + "review_state" ], "properties": { "target": { @@ -7179,6 +7185,9 @@ }, "state": { "const": "selected" + }, + "review_state": { + "$ref": "#/$defs/ApplicationReviewState" } } }, @@ -7515,6 +7524,14 @@ "needs-review" ] }, + "ApplicationReviewState": { + "enum": [ + "current", + "changed-since-review", + "not-reviewed" + ], + "description": "Review label of delivered application material. current: this exact text was approved for application use. changed-since-review: the text was edited after its approval. not-reviewed: the text has never been approved. The label never withholds material; a scoped policy read carries the label of its containing module." + }, "ProvenanceReadResult": { "type": "object", "additionalProperties": false, @@ -7961,7 +7978,7 @@ "$ref": "#/$defs/ApplicationQueryRequest" } }, - "description": "Authoring-only inspection of an exact draft through application qualification and filtering; this observation neither publishes nor grants ordinary application access." + "description": "Authoring-only inspection of an exact draft as an application agent would receive it, including each item's review label; this observation neither publishes nor grants ordinary application access." }, "CandidateApplicationNextOperation": { "type": "object", @@ -8059,6 +8076,7 @@ "kind", "purpose", "policy", + "review_state", "content", "scope", "requires", @@ -8076,6 +8094,9 @@ "policy": { "$ref": "#/$defs/CandidateApplicationPolicy" }, + "review_state": { + "$ref": "#/$defs/ApplicationReviewState" + }, "content": { "type": "string" }, @@ -8218,12 +8239,14 @@ }, "code": { "enum": [ - "APPLICATION.CONTENT_UNAVAILABLE", + "APPLICATION.UNKNOWN_TARGET", "APPLICATION.INPUT_INVALID", "APPLICATION.OPERATION_UNAVAILABLE", "APPLICATION.INTERNAL_UNAVAILABLE", "APPLICATION.UNSUPPORTED_CAPTURE", - "APPLICATION.RESULT_LIMIT" + "APPLICATION.RESULT_LIMIT", + "APPLICATION.UNKNOWN_GROUP", + "APPLICATION.TRAVERSAL_NOT_PERMITTED" ] }, "outcome": { @@ -9520,7 +9543,7 @@ } }, "additionalProperties": false, - "description": "Exact compact reads of selected targets in Router order. Total counts selected targets, not unresolved applicability. Follow next unchanged for the remaining page." + "description": "Exact compact reads of selected targets in Router order, each with its review label. Total counts selected targets, not unresolved applicability. A page ends early at the host's page byte budget but holds at least one whole item while targets remain. Follow next unchanged for the remaining page." }, "DescribeInputCall": { "type": "object", diff --git a/tools/standards_engine/contracts/a1-interface.toml b/tools/standards_engine/contracts/a1-interface.toml index a7be0562..b2df6186 100644 --- a/tools/standards_engine/contracts/a1-interface.toml +++ b/tools/standards_engine/contracts/a1-interface.toml @@ -1,7 +1,7 @@ schema_version = 1 -interface_schema_version = 48 +interface_schema_version = 49 request_contract_version = 6 -result_projection_version = 8 +result_projection_version = 9 [[operations]] id = "create_snapshot" diff --git a/tools/standards_engine/contracts/examples/a1-examples.json b/tools/standards_engine/contracts/examples/a1-examples.json index a697ac1f..b1bcc4e9 100644 --- a/tools/standards_engine/contracts/examples/a1-examples.json +++ b/tools/standards_engine/contracts/examples/a1-examples.json @@ -1,6 +1,6 @@ { "schema_version": 2, - "interface_schema_version": 48, + "interface_schema_version": 49, "examples": [ { "name": "create-snapshot", @@ -1274,7 +1274,7 @@ "value": { "kind": "input-contract-result", "purpose": "application", - "interface_version": 47, + "interface_version": 49, "catalog_digest": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "operation": "runtime_info", "root": "RuntimeInfoCall", @@ -1420,7 +1420,7 @@ "value": { "kind": "output-contract-result", "purpose": "authoring", - "interface_version": 47, + "interface_version": 49, "catalog_digest": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "operation": "review", "dialect": "https://json-schema.org/draft/2020-12/schema", diff --git a/tools/standards_engine/contracts/generated/agent-tools.json b/tools/standards_engine/contracts/generated/agent-tools.json index 9afcb2c1..858e16d3 100644 --- a/tools/standards_engine/contracts/generated/agent-tools.json +++ b/tools/standards_engine/contracts/generated/agent-tools.json @@ -1558,6 +1558,9 @@ }, "type": "array" }, + "review_state": { + "$ref": "#/$defs/ApplicationReviewState" + }, "scope": { "$ref": "#/$defs/ReviewScope" }, @@ -1576,6 +1579,7 @@ "purpose", "snapshot", "policy", + "review_state", "content", "scope", "requires", @@ -1593,6 +1597,9 @@ "contextual" ] }, + "review_state": { + "$ref": "#/$defs/ApplicationReviewState" + }, "scope": { "$ref": "#/$defs/ReviewScope" }, @@ -1607,7 +1614,8 @@ "target", "scope", "authority", - "state" + "state", + "review_state" ], "type": "object" }, @@ -1670,13 +1678,14 @@ "properties": { "code": { "enum": [ - "APPLICATION.CONTENT_UNAVAILABLE", + "APPLICATION.UNKNOWN_TARGET", "APPLICATION.INPUT_INVALID", "APPLICATION.OPERATION_UNAVAILABLE", "APPLICATION.INTERNAL_UNAVAILABLE", "APPLICATION.UNSUPPORTED_CAPTURE", "APPLICATION.RESULT_LIMIT", - "APPLICATION.UNKNOWN_GROUP" + "APPLICATION.UNKNOWN_GROUP", + "APPLICATION.TRAVERSAL_NOT_PERMITTED" ] }, "input_feedback": { @@ -1794,6 +1803,14 @@ ], "type": "object" }, + "ApplicationReviewState": { + "description": "Review label of delivered application material. current: this exact text was approved for application use. changed-since-review: the text was edited after its approval. not-reviewed: the text has never been approved. The label never withholds material; a scoped policy read carries the label of its containing module.", + "enum": [ + "current", + "changed-since-review", + "not-reviewed" + ] + }, "ApplicationRouteResult": { "additionalProperties": false, "properties": { @@ -1847,7 +1864,7 @@ }, "ApplicationRoutedContentPage": { "additionalProperties": false, - "description": "Exact compact reads of selected targets in Router order. Total counts selected targets, not unresolved applicability. Follow next unchanged for the remaining page.", + "description": "Exact compact reads of selected targets in Router order, each with its review label. Total counts selected targets, not unresolved applicability. A page ends early at the host's page byte budget but holds at least one whole item while targets remain. Follow next unchanged for the remaining page.", "properties": { "items": { "items": { @@ -2361,6 +2378,9 @@ }, "type": "array" }, + "review_state": { + "$ref": "#/$defs/ApplicationReviewState" + }, "revision": { "$ref": "#/$defs/ProposalRevisionHandle" }, @@ -2378,6 +2398,7 @@ "kind", "purpose", "policy", + "review_state", "content", "scope", "requires", @@ -2392,12 +2413,14 @@ "properties": { "code": { "enum": [ - "APPLICATION.CONTENT_UNAVAILABLE", + "APPLICATION.UNKNOWN_TARGET", "APPLICATION.INPUT_INVALID", "APPLICATION.OPERATION_UNAVAILABLE", "APPLICATION.INTERNAL_UNAVAILABLE", "APPLICATION.UNSUPPORTED_CAPTURE", - "APPLICATION.RESULT_LIMIT" + "APPLICATION.RESULT_LIMIT", + "APPLICATION.UNKNOWN_GROUP", + "APPLICATION.TRAVERSAL_NOT_PERMITTED" ] }, "kind": { @@ -6040,7 +6063,7 @@ }, "PreviewApplicationCall": { "additionalProperties": false, - "description": "Authoring-only inspection of an exact draft through application qualification and filtering; this observation neither publishes nor grants ordinary application access.", + "description": "Authoring-only inspection of an exact draft as an application agent would receive it, including each item's review label; this observation neither publishes nor grants ordinary application access.", "properties": { "request": { "$ref": "#/$defs/ApplicationQueryRequest" @@ -9966,7 +9989,7 @@ "type": "object" } }, - "interface_schema_version": 48, + "interface_schema_version": 49, "operations": [ { "capability": "standards.snapshot.create", @@ -10670,6 +10693,6 @@ } ], "request_contract_version": 6, - "result_projection_version": 8, + "result_projection_version": 9, "schema_version": 1 } diff --git a/tools/standards_engine/standards_engine/_generated_contract.py b/tools/standards_engine/standards_engine/_generated_contract.py index d35d0480..b4e716c7 100644 --- a/tools/standards_engine/standards_engine/_generated_contract.py +++ b/tools/standards_engine/standards_engine/_generated_contract.py @@ -14,8 +14,9 @@ model_as_contract, ) -_SCHEMA = json.loads('{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://coding-standards.local/contracts/standards-engine/a2-v40","title":"Standards Engine A2 contract","description":"Canonical typed contract for snapshot lifecycle, controlled authoring, navigation, inspection, and immutable standards-change analysis.","oneOf":[{"$ref":"#/$defs/AgentProposeCall"},{"$ref":"#/$defs/AgentResolveManyCall"},{"$ref":"#/$defs/AgentResolveWorkflowCall"},{"$ref":"#/$defs/AgentReviewCall"},{"$ref":"#/$defs/AgentReviseCall"},{"$ref":"#/$defs/AgentRouteResult"},{"$ref":"#/$defs/AnalyzeCall"},{"$ref":"#/$defs/AnalyzeProposalCall"},{"$ref":"#/$defs/ApplicationInspectCall"},{"$ref":"#/$defs/ApplicationQueryCall"},{"$ref":"#/$defs/ApplicationReadCall"},{"$ref":"#/$defs/ApplicationReadManyCall"},{"$ref":"#/$defs/ApplicationReadManyResult"},{"$ref":"#/$defs/ApplicationReadResult"},{"$ref":"#/$defs/ApplicationRecoveryRequiredResult"},{"$ref":"#/$defs/ApplicationRejectedResult"},{"$ref":"#/$defs/ApplicationRelatedResult"},{"$ref":"#/$defs/ApplicationRouteResult"},{"$ref":"#/$defs/ApplicationRoutingFactsResult"},{"$ref":"#/$defs/ApplyCall"},{"$ref":"#/$defs/ApplyProposalCall"},{"$ref":"#/$defs/ApplyProposalResult"},{"$ref":"#/$defs/CompactReadResult"},{"$ref":"#/$defs/CompactRouteResult"},{"$ref":"#/$defs/CompleteResult"},{"$ref":"#/$defs/CreateProposalCall"},{"$ref":"#/$defs/CreateProposalResult"},{"$ref":"#/$defs/CreateSnapshotCall"},{"$ref":"#/$defs/CreateSnapshotResult"},{"$ref":"#/$defs/DeleteSnapshotCall"},{"$ref":"#/$defs/DeleteSnapshotResult"},{"$ref":"#/$defs/DescribeInputCall"},{"$ref":"#/$defs/DescribeOutputCall"},{"$ref":"#/$defs/FindProposalsCall"},{"$ref":"#/$defs/FindProposalsResult"},{"$ref":"#/$defs/FindSnapshotsCall"},{"$ref":"#/$defs/FindSnapshotsResult"},{"$ref":"#/$defs/InputContractRejectedResult"},{"$ref":"#/$defs/InputContractResult"},{"$ref":"#/$defs/InspectCall"},{"$ref":"#/$defs/InspectionResult"},{"$ref":"#/$defs/MaintainEvidenceCall"},{"$ref":"#/$defs/MaintainEvidenceResult"},{"$ref":"#/$defs/NavigationIndexesResult"},{"$ref":"#/$defs/OperationalReadResult"},{"$ref":"#/$defs/OutputContractRejectedResult"},{"$ref":"#/$defs/OutputContractResult"},{"$ref":"#/$defs/PendingResult"},{"$ref":"#/$defs/PrepareCall"},{"$ref":"#/$defs/PreviewApplicationCall"},{"$ref":"#/$defs/PreviewApplicationResult"},{"$ref":"#/$defs/ProposeCall"},{"$ref":"#/$defs/ProvenanceReadResult"},{"$ref":"#/$defs/QueryCall"},{"$ref":"#/$defs/QueryProposalCall"},{"$ref":"#/$defs/QueryProposalResult"},{"$ref":"#/$defs/QueryResult"},{"$ref":"#/$defs/ReadCall"},{"$ref":"#/$defs/ReadManyCall"},{"$ref":"#/$defs/ReadManyResult"},{"$ref":"#/$defs/ReadResult"},{"$ref":"#/$defs/RecoverApplicationCall"},{"$ref":"#/$defs/RecoverApplicationResult"},{"$ref":"#/$defs/RecoverCall"},{"$ref":"#/$defs/RejectedResult"},{"$ref":"#/$defs/RelatedCall"},{"$ref":"#/$defs/RelatedResult"},{"$ref":"#/$defs/RelationshipGroupsCall"},{"$ref":"#/$defs/RelationshipGroupsResult"},{"$ref":"#/$defs/ResolveCall"},{"$ref":"#/$defs/ResolveManyCall"},{"$ref":"#/$defs/ResolveWorkflowCall"},{"$ref":"#/$defs/ResumeCall"},{"$ref":"#/$defs/ReviewCall"},{"$ref":"#/$defs/ReviewProposalCall"},{"$ref":"#/$defs/ReviewProposalResult"},{"$ref":"#/$defs/ReviseCall"},{"$ref":"#/$defs/ReviseProposalCall"},{"$ref":"#/$defs/ReviseProposalResult"},{"$ref":"#/$defs/RouteCall"},{"$ref":"#/$defs/RoutingFactsCall"},{"$ref":"#/$defs/RoutingFactsResult"},{"$ref":"#/$defs/RuntimeInfoCall"},{"$ref":"#/$defs/RuntimeInfoResult"},{"$ref":"#/$defs/UndeleteSnapshotCall"},{"$ref":"#/$defs/UndeleteSnapshotResult"},{"$ref":"#/$defs/VerifyProposalCall"},{"$ref":"#/$defs/VerifyProposalResult"},{"$ref":"#/$defs/VerifyRepositoryCall"},{"$ref":"#/$defs/VerifyRepositoryResult"},{"$ref":"#/$defs/WorkflowDetailsCall"},{"$ref":"#/$defs/WorkflowDetailsResult"},{"$ref":"#/$defs/WorkflowResult"},{"$ref":"#/$defs/WorkflowStatusCall"}],"$defs":{"NonEmptyString":{"type":"string","minLength":1},"CanonicalId":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9._:/-]*$"},"EdgeId":{"type":"string","minLength":1},"Digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$","maxLength":71},"GitObjectId":{"oneOf":[{"type":"string","pattern":"^[0-9a-f]{40}$"},{"type":"string","pattern":"^[0-9a-f]{64}$"}]},"ObligationId":{"type":"string","pattern":"^obligation:sha256:[0-9a-f]{64}$"},"ImpactTraceId":{"type":"string","pattern":"^impact-trace:sha256:[0-9a-f]{64}$"},"FactRequirementId":{"type":"string","pattern":"^fact-requirement:sha256:[0-9a-f]{64}$"},"ScalarValue":{"oneOf":[{"type":"boolean"},{"type":"integer"},{"type":"string"},{"type":"null"}]},"FactValue":{"oneOf":[{"type":"object","required":["type","state","value"],"properties":{"type":{"const":"boolean"},"state":{"const":"known"},"value":{"type":"boolean"}},"additionalProperties":false},{"type":"object","required":["type","state","value"],"properties":{"type":{"enum":["boolean","enum","string","string-set","enum-set","canonical-id"]},"state":{"const":"known"},"value":{"type":"null"}},"additionalProperties":false},{"type":"object","required":["type","state","value"],"properties":{"type":{"enum":["enum","string","canonical-id"]},"state":{"const":"known"},"value":{"type":"string"}},"additionalProperties":false},{"type":"object","required":["type","state","value"],"properties":{"type":{"enum":["string-set","enum-set"]},"state":{"const":"known"},"value":{"type":"array","items":{"type":"string"},"uniqueItems":true}},"additionalProperties":false},{"type":"object","required":["type","state"],"properties":{"type":{"enum":["boolean","enum","string","string-set","enum-set","canonical-id"]},"state":{"enum":["known-absent","unknown"]}},"additionalProperties":false}]},"FactSet":{"type":"object","additionalProperties":{"$ref":"#/$defs/FactValue"}},"StructuredScope":{"type":"object","required":["kind","heading_path"],"properties":{"kind":{"const":"structured"},"heading_path":{"type":"array","minItems":1,"items":{"$ref":"#/$defs/NonEmptyString"}}},"additionalProperties":false},"WholeArtifactScope":{"type":"object","required":["kind"],"properties":{"kind":{"const":"whole-artifact"}},"additionalProperties":false},"ReviewScope":{"oneOf":[{"$ref":"#/$defs/StructuredScope"},{"$ref":"#/$defs/WholeArtifactScope"}]},"AllExpression":{"type":"object","required":["operator","expressions"],"properties":{"operator":{"const":"all"},"expressions":{"type":"array","minItems":1,"items":{"$ref":"#/$defs/ApplicabilityExpression"}}},"additionalProperties":false},"AnyExpression":{"type":"object","required":["operator","expressions"],"properties":{"operator":{"const":"any"},"expressions":{"type":"array","minItems":1,"items":{"$ref":"#/$defs/ApplicabilityExpression"}}},"additionalProperties":false},"NotExpression":{"type":"object","required":["operator","expression"],"properties":{"operator":{"const":"not"},"expression":{"$ref":"#/$defs/ApplicabilityExpression"}},"additionalProperties":false},"EqualsExpression":{"type":"object","required":["operator","fact","value"],"properties":{"operator":{"const":"equals"},"fact":{"$ref":"#/$defs/CanonicalId"},"value":{"$ref":"#/$defs/ScalarValue"}},"additionalProperties":false},"InExpression":{"type":"object","required":["operator","fact","values"],"properties":{"operator":{"const":"in"},"fact":{"$ref":"#/$defs/CanonicalId"},"values":{"type":"array","minItems":1,"uniqueItems":true,"items":{"$ref":"#/$defs/ScalarValue"}}},"additionalProperties":false},"ContainsExpression":{"type":"object","required":["operator","fact","value"],"properties":{"operator":{"const":"contains"},"fact":{"$ref":"#/$defs/CanonicalId"},"value":{"$ref":"#/$defs/ScalarValue"}},"additionalProperties":false},"ExistsExpression":{"type":"object","required":["operator","fact"],"properties":{"operator":{"const":"exists"},"fact":{"$ref":"#/$defs/CanonicalId"}},"additionalProperties":false},"AlwaysExpression":{"type":"object","required":["operator"],"properties":{"operator":{"const":"always"}},"additionalProperties":false},"ApplicabilityExpression":{"oneOf":[{"$ref":"#/$defs/AlwaysExpression"},{"$ref":"#/$defs/AllExpression"},{"$ref":"#/$defs/AnyExpression"},{"$ref":"#/$defs/NotExpression"},{"$ref":"#/$defs/EqualsExpression"},{"$ref":"#/$defs/InExpression"},{"$ref":"#/$defs/ContainsExpression"},{"$ref":"#/$defs/ExistsExpression"}]},"GeneralSelectionReason":{"type":"object","required":["kind"],"properties":{"kind":{"enum":["routing-fact","requires","specializes","changed-policy","question","audit-coverage","unmapped-normative-change","structured-scope-analysis-unsupported","navigation-index-change","supporting-content-change"]},"source":{"$ref":"#/$defs/CanonicalId"},"fact":{"$ref":"#/$defs/CanonicalId"},"edge":{"$ref":"#/$defs/EdgeId"},"question":{"$ref":"#/$defs/CanonicalId"}},"additionalProperties":false},"PolicyImpactSelectionReason":{"type":"object","required":["kind","source","edge","relation","evidence_owner","traces"],"properties":{"kind":{"const":"policy-impact-edge"},"source":{"$ref":"#/$defs/CanonicalId"},"edge":{"$ref":"#/$defs/EdgeId"},"relation":{"$ref":"#/$defs/CanonicalId"},"evidence_owner":{"$ref":"#/$defs/CanonicalId"},"traces":{"type":"array","minItems":1,"uniqueItems":true,"items":{"$ref":"#/$defs/ImpactTraceReference"}}},"additionalProperties":false},"SelectionReason":{"oneOf":[{"$ref":"#/$defs/GeneralSelectionReason"},{"$ref":"#/$defs/PolicyImpactSelectionReason"}]},"ImpactTraceReference":{"type":"object","required":["id","graph","applicability"],"properties":{"id":{"$ref":"#/$defs/ImpactTraceId"},"graph":{"enum":["accepted","proposed"]},"applicability":{"enum":["true","false","unknown"]}},"additionalProperties":false},"ConsumerReviewObligationReadingReason":{"type":"object","required":["kind","obligation"],"properties":{"kind":{"const":"consumer-review-obligation"},"obligation":{"$ref":"#/$defs/ObligationId"}},"additionalProperties":false},"RoutingBaseReadingReason":{"type":"object","required":["kind","projection"],"properties":{"kind":{"const":"routing-base"},"projection":{"$ref":"#/$defs/CanonicalId"}},"additionalProperties":false},"RoutingRuleReadingReason":{"type":"object","required":["kind","rule","facts"],"properties":{"kind":{"const":"routing-rule"},"rule":{"$ref":"#/$defs/CanonicalId"},"facts":{"type":"array","uniqueItems":true,"items":{"$ref":"#/$defs/CanonicalId"}}},"additionalProperties":false},"RequiresReadingReason":{"type":"object","required":["kind","edge","source"],"properties":{"kind":{"const":"requires"},"edge":{"$ref":"#/$defs/EdgeId"},"source":{"$ref":"#/$defs/CanonicalId"}},"additionalProperties":false},"SpecializesReadingReason":{"type":"object","required":["kind","edge","source"],"properties":{"kind":{"const":"specializes"},"edge":{"$ref":"#/$defs/EdgeId"},"source":{"$ref":"#/$defs/CanonicalId"}},"additionalProperties":false},"ReadingPlanReason":{"oneOf":[{"$ref":"#/$defs/ConsumerReviewObligationReadingReason"},{"$ref":"#/$defs/RoutingBaseReadingReason"},{"$ref":"#/$defs/RoutingRuleReadingReason"},{"$ref":"#/$defs/RequiresReadingReason"},{"$ref":"#/$defs/SpecializesReadingReason"}]},"ReadingPlanEntry":{"type":"object","required":["target","scope","authority","reasons","state"],"properties":{"target":{"$ref":"#/$defs/CanonicalId"},"scope":{"$ref":"#/$defs/ReviewScope"},"authority":{"enum":["normative","projection","contextual","evidence"]},"reasons":{"type":"array","minItems":1,"uniqueItems":true,"items":{"$ref":"#/$defs/ReadingPlanReason"}},"state":{"enum":["selected","conditional","unresolved"]}},"additionalProperties":false},"RouteRequest":{"type":"object","required":["kind","facts"],"properties":{"kind":{"const":"route"},"facts":{"$ref":"#/$defs/FactSet"}},"additionalProperties":false},"ReadRequest":{"type":"object","required":["kind","target"],"properties":{"kind":{"const":"read"},"target":{"$ref":"#/$defs/CanonicalId"},"include_routing":{"type":"boolean"},"include_coverage":{"type":"boolean","description":"Include current repository attestation status for registered policy units in this read scope."}},"additionalProperties":false},"RelatedRequest":{"type":"object","required":["kind","target","groups","direction","transitive"],"properties":{"kind":{"const":"related"},"target":{"$ref":"#/$defs/CanonicalId"},"groups":{"type":"array","minItems":1,"uniqueItems":true,"items":{"$ref":"#/$defs/CanonicalId"}},"direction":{"enum":["incoming","outgoing","both"]},"transitive":{"type":"boolean","default":false}},"additionalProperties":false},"QueryRequest":{"oneOf":[{"$ref":"#/$defs/RouteRequest"},{"$ref":"#/$defs/ReadRequest"},{"$ref":"#/$defs/RelatedRequest"}]},"PolicyUnitDeclaration":{"type":"object","required":["kind","id","module","heading_path","semantic_revision","lifecycle"],"properties":{"kind":{"const":"policy-unit"},"id":{"$ref":"#/$defs/CanonicalId"},"module":{"$ref":"#/$defs/CanonicalId"},"heading_path":{"type":"array","minItems":1,"items":{"$ref":"#/$defs/NonEmptyString"}},"semantic_revision":{"type":"integer","minimum":1},"lifecycle":{"const":"active"},"aliases":{"type":"array","uniqueItems":true,"items":{"$ref":"#/$defs/CanonicalId"}},"predecessors":{"type":"array","uniqueItems":true,"items":{"$ref":"#/$defs/CanonicalId"}},"successors":{"type":"array","uniqueItems":true,"items":{"$ref":"#/$defs/CanonicalId"}}},"additionalProperties":false},"CanonicalModuleDeclaration":{"type":"object","required":["kind","id","role","level","applies_when","does_not_apply_when","requires","specializes","verification"],"properties":{"kind":{"const":"canonical-module"},"id":{"$ref":"#/$defs/CanonicalId"},"role":{"enum":["core","router","workflow","profile","topic","reference"]},"level":{"enum":["MUST","SHOULD","PROFILE","REFERENCE"]},"applies_when":{"$ref":"#/$defs/NonEmptyString"},"does_not_apply_when":{"$ref":"#/$defs/NonEmptyString"},"requires":{"type":"array","uniqueItems":true,"items":{"$ref":"#/$defs/CanonicalId"}},"specializes":{"type":"array","uniqueItems":true,"items":{"$ref":"#/$defs/CanonicalId"}},"verification":{"$ref":"#/$defs/NonEmptyString"}},"additionalProperties":false},"PolicyRelationshipInspection":{"type":"object","required":["relationship_kind","applicability","source_scope","consumer_scope","propagation","evidence_owner","rationale"],"properties":{"relationship_kind":{"enum":["normative-consumer","router-projection","prompt-projection","template-projection","reference-projection","fixture-projection","enforcement-suite-projection","documentation-projection","implementation-projection"]},"applicability":{"$ref":"#/$defs/ApplicabilityExpression"},"source_scope":{"oneOf":[{"$ref":"#/$defs/ReviewScope"},{"type":"null"}]},"consumer_scope":{"oneOf":[{"$ref":"#/$defs/ReviewScope"},{"type":"null"}]},"propagation":{"const":"source-to-consumer"},"evidence_owner":{"$ref":"#/$defs/CanonicalId"},"rationale":{"$ref":"#/$defs/NonEmptyString"}},"additionalProperties":false},"SemanticProposal":{"type":"object","required":["policy","accepted_semantic_revision","proposed_semantic_revision","intent","structural_digest"],"properties":{"policy":{"$ref":"#/$defs/CanonicalId"},"accepted_semantic_revision":{"oneOf":[{"type":"integer","minimum":1},{"type":"null"}]},"proposed_semantic_revision":{"type":"integer","minimum":1},"intent":{"$ref":"#/$defs/NonEmptyString"},"structural_digest":{"$ref":"#/$defs/Digest"}},"additionalProperties":false},"ChangeDescriptor":{"type":"object","required":["kind","accepted_ids","proposed_ids","scope"],"properties":{"kind":{"enum":["module","modification","addition","removal","move","split","merge","navigation-index","supporting-content"]},"accepted_ids":{"type":"array","uniqueItems":true,"items":{"$ref":"#/$defs/CanonicalId"}},"proposed_ids":{"type":"array","uniqueItems":true,"items":{"$ref":"#/$defs/CanonicalId"}},"scope":{"$ref":"#/$defs/ReviewScope"},"accepted_module":{"$ref":"#/$defs/CanonicalId"},"proposed_module":{"$ref":"#/$defs/CanonicalId"}},"additionalProperties":false},"ChangedPolicyUnit":{"type":"object","required":["policy","change_kind","classification","accepted_representation_digest","proposed_representation_digest","accepted_structural_digest","proposed_structural_digest","accepted_semantic_revision","proposed_semantic_revision","semantic_state","scope"],"properties":{"policy":{"$ref":"#/$defs/CanonicalId"},"change_kind":{"enum":["modification","addition","removal","move","split-predecessor","split-successor","merge-predecessor","merge-successor"]},"classification":{"enum":["unchanged","representation-only-candidate","possibly-semantically-changed","semantically-changed","unresolved"]},"accepted_representation_digest":{"oneOf":[{"$ref":"#/$defs/Digest"},{"type":"null"}]},"proposed_representation_digest":{"oneOf":[{"$ref":"#/$defs/Digest"},{"type":"null"}]},"accepted_structural_digest":{"oneOf":[{"$ref":"#/$defs/Digest"},{"type":"null"}]},"proposed_structural_digest":{"oneOf":[{"$ref":"#/$defs/Digest"},{"type":"null"}]},"accepted_semantic_revision":{"oneOf":[{"type":"integer","minimum":1},{"type":"null"}]},"proposed_semantic_revision":{"oneOf":[{"type":"integer","minimum":1},{"type":"null"}]},"semantic_state":{"enum":["accepted-unchanged","proposed","removed","unresolved"]},"scope":{"$ref":"#/$defs/ReviewScope"}},"additionalProperties":false},"Question":{"type":"object","required":["id","kind","prompt","state","permitted_answers"],"properties":{"id":{"$ref":"#/$defs/CanonicalId"},"kind":{"enum":["applicability-fact","normative-classification","identity-resolution","scope-resolution"]},"prompt":{"$ref":"#/$defs/NonEmptyString"},"state":{"enum":["required","answered","blocked"]},"permitted_answers":{"type":"array","minItems":1,"uniqueItems":true,"items":{"$ref":"#/$defs/NonEmptyString"}}},"additionalProperties":false},"ConsumerReviewContract":{"type":"object","required":["kind","id","version","permitted_dispositions","evidence_contract","authorization_capability","semantics"],"properties":{"kind":{"const":"consumer-review-contract"},"id":{"$ref":"#/$defs/CanonicalId"},"version":{"type":"integer","minimum":1},"permitted_dispositions":{"type":"array","minItems":1,"uniqueItems":true,"items":{"enum":["updated","reviewed-no-change","not-applicable","blocked"]}},"evidence_contract":{"$ref":"#/$defs/CanonicalId"},"authorization_capability":{"$ref":"#/$defs/CanonicalId"},"semantics":{"$ref":"#/$defs/NonEmptyString"}},"additionalProperties":false},"DecisionDependency":{"type":"object","required":["class","identity","digest"],"properties":{"class":{"enum":["policy-unit","semantic-revision","structure","representation","module-locator","applicability-fact","relationship","audit","exception","evidence","provider-contract","applicability-contract","analysis-contract"]},"identity":{"$ref":"#/$defs/NonEmptyString"},"digest":{"$ref":"#/$defs/Digest"}},"additionalProperties":false},"DecisionFingerprint":{"type":"object","required":["decision_kind","decision_contract","schema_version","dependencies"],"properties":{"decision_kind":{"$ref":"#/$defs/CanonicalId"},"decision_contract":{"$ref":"#/$defs/CanonicalId"},"schema_version":{"const":1},"dependencies":{"type":"array","minItems":1,"items":{"$ref":"#/$defs/DecisionDependency"}}},"additionalProperties":false},"FactValueContract":{"type":"object","required":["type","states","nullable"],"properties":{"type":{"enum":["boolean","enum","string","string-set","enum-set","canonical-id"]},"states":{"const":["known","known-absent"]},"nullable":{"type":"boolean"},"values":{"type":"array","minItems":1,"uniqueItems":true,"items":{"type":"string"}}},"additionalProperties":false},"EvidenceReference":{"type":"object","required":["id","digest","provider_contract","provider_contract_version"],"properties":{"id":{"$ref":"#/$defs/CanonicalId"},"digest":{"$ref":"#/$defs/Digest"},"provider_contract":{"$ref":"#/$defs/CanonicalId"},"provider_contract_version":{"$ref":"#/$defs/NonEmptyString"}},"additionalProperties":false},"CompletionProof":{"type":"object","required":["required_coverage_subjects","certificate_subjects","reached_consumer_obligations","disposition_obligations","required_fact_requirements","observed_fact_requirements","non_consumer_obligations_resolved","applicability_resolved","authorization_valid","evidence_valid"],"properties":{"required_coverage_subjects":{"type":"array","uniqueItems":true,"items":{"$ref":"#/$defs/CanonicalId"}},"certificate_subjects":{"type":"array","uniqueItems":true,"items":{"$ref":"#/$defs/CanonicalId"}},"reached_consumer_obligations":{"type":"array","uniqueItems":true,"items":{"$ref":"#/$defs/ObligationId"}},"disposition_obligations":{"type":"array","uniqueItems":true,"items":{"$ref":"#/$defs/ObligationId"}},"required_fact_requirements":{"type":"array","uniqueItems":true,"items":{"$ref":"#/$defs/FactRequirementId"}},"observed_fact_requirements":{"type":"array","uniqueItems":true,"items":{"$ref":"#/$defs/FactRequirementId"}},"non_consumer_obligations_resolved":{"const":true},"applicability_resolved":{"const":true},"authorization_valid":{"const":true},"evidence_valid":{"const":true}},"additionalProperties":false},"Timestamp":{"type":"integer","minimum":0},"SnapshotId":{"type":"string","pattern":"^snapshot:v1:[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"},"AnalysisId":{"type":"string","pattern":"^analysis:sha256:[0-9a-f]{64}$"},"ProposalId":{"type":"string","pattern":"^proposal:v1:[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"},"ProposalRevisionId":{"type":"string","pattern":"^proposal-revision:sha256:[0-9a-f]{64}$"},"ReadinessId":{"type":"string","pattern":"^readiness:sha256:[0-9a-f]{64}$"},"ApplicationId":{"type":"string","pattern":"^application:sha256:[0-9a-f]{64}$"},"ChildId":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"AuthorizationId":{"type":"string","pattern":"^authorization:sha256:[0-9a-f]{64}$"},"SnapshotHandle":{"type":"object","required":["kind","id","schema_version"],"properties":{"kind":{"const":"snapshot-handle"},"id":{"$ref":"#/$defs/SnapshotId"},"schema_version":{"const":5}},"additionalProperties":false},"AnalysisHandle":{"type":"object","required":["kind","id","schema_version"],"properties":{"kind":{"const":"analysis-handle"},"id":{"$ref":"#/$defs/AnalysisId"},"schema_version":{"const":7}},"additionalProperties":false},"ProposalHandle":{"type":"object","required":["kind","id","schema_version"],"properties":{"kind":{"const":"proposal-handle"},"id":{"$ref":"#/$defs/ProposalId"},"schema_version":{"const":1}},"additionalProperties":false},"ProposalRevisionHandle":{"type":"object","required":["kind","id","schema_version"],"properties":{"kind":{"const":"proposal-revision-handle"},"id":{"$ref":"#/$defs/ProposalRevisionId"},"schema_version":{"const":1}},"additionalProperties":false},"ReadinessHandle":{"type":"object","required":["kind","id","schema_version"],"properties":{"kind":{"const":"readiness-handle"},"id":{"$ref":"#/$defs/ReadinessId"},"schema_version":{"const":1}},"additionalProperties":false},"ApplicationHandle":{"type":"object","required":["kind","id","schema_version"],"properties":{"kind":{"const":"application-handle"},"id":{"$ref":"#/$defs/ApplicationId"},"schema_version":{"const":1}},"additionalProperties":false},"SnapshotChildHandle":{"type":"object","required":["kind","snapshot","child_kind","child_id","schema_version"],"properties":{"kind":{"const":"snapshot-child-handle"},"snapshot":{"$ref":"#/$defs/SnapshotHandle"},"child_kind":{"enum":["policy","relationship"]},"child_id":{"$ref":"#/$defs/NonEmptyString"},"schema_version":{"const":5}},"additionalProperties":false},"AnalysisChildHandle":{"type":"object","required":["kind","analysis","child_kind","child_id","schema_version"],"properties":{"kind":{"const":"analysis-child-handle"},"analysis":{"$ref":"#/$defs/AnalysisHandle"},"child_kind":{"enum":["context","fact-requirement","fact-observation","obligation","coverage-requirement","coverage-certificate"]},"child_id":{"$ref":"#/$defs/ChildId"},"schema_version":{"const":7}},"additionalProperties":false},"AnalysisMaterialHandle":{"oneOf":[{"$ref":"#/$defs/SnapshotHandle"},{"$ref":"#/$defs/ProposalRevisionHandle"}]},"InspectableHandle":{"oneOf":[{"$ref":"#/$defs/SnapshotHandle"},{"$ref":"#/$defs/AnalysisHandle"},{"$ref":"#/$defs/SnapshotChildHandle"},{"$ref":"#/$defs/AnalysisChildHandle"}]},"ActiveSnapshotSummary":{"type":"object","required":["snapshot","lifecycle","source_revision","created_at"],"properties":{"snapshot":{"$ref":"#/$defs/SnapshotHandle"},"lifecycle":{"const":"active"},"source_revision":{"$ref":"#/$defs/NonEmptyString"},"created_at":{"$ref":"#/$defs/Timestamp"}},"additionalProperties":false},"QuarantinedSnapshotSummary":{"type":"object","required":["snapshot","lifecycle","source_revision","created_at","purge_deadline"],"properties":{"snapshot":{"$ref":"#/$defs/SnapshotHandle"},"lifecycle":{"const":"quarantined"},"source_revision":{"$ref":"#/$defs/NonEmptyString"},"created_at":{"$ref":"#/$defs/Timestamp"},"purge_deadline":{"$ref":"#/$defs/Timestamp"}},"additionalProperties":false},"SnapshotSummary":{"oneOf":[{"$ref":"#/$defs/ActiveSnapshotSummary"},{"$ref":"#/$defs/QuarantinedSnapshotSummary"}]},"CreateSnapshotCall":{"type":"object","required":["kind"],"properties":{"kind":{"const":"create-snapshot"}},"additionalProperties":false},"CreateSnapshotResult":{"type":"object","required":["kind","snapshot"],"properties":{"kind":{"const":"create-snapshot-result"},"snapshot":{"$ref":"#/$defs/ActiveSnapshotSummary"}},"additionalProperties":false},"FindSnapshotsCall":{"type":"object","required":["kind"],"properties":{"kind":{"const":"find-snapshots"},"lifecycle":{"enum":["active","quarantined"],"default":"active"},"after":{"$ref":"#/$defs/SnapshotHandle"},"limit":{"type":"integer","minimum":1,"default":50}},"additionalProperties":false},"FindSnapshotsResult":{"type":"object","required":["kind","snapshots"],"properties":{"kind":{"const":"find-snapshots-result"},"snapshots":{"type":"array","items":{"$ref":"#/$defs/SnapshotSummary"}},"continuation":{"$ref":"#/$defs/SnapshotHandle"}},"additionalProperties":false},"StandardsChangePurpose":{"type":"object","required":["summary","rationale","evidence"],"properties":{"summary":{"$ref":"#/$defs/NonEmptyString"},"rationale":{"$ref":"#/$defs/NonEmptyString"},"evidence":{"type":"array","minItems":1,"uniqueItems":true,"items":{"$ref":"#/$defs/EvidenceReference"}}},"additionalProperties":false},"StandardContent":{"type":"object","required":["id","title","role","level","applies_when","does_not_apply_when","verification","body"],"properties":{"id":{"$ref":"#/$defs/CanonicalId"},"title":{"$ref":"#/$defs/NonEmptyString"},"role":{"enum":["core","router","workflow","profile","topic","reference"]},"level":{"enum":["MUST","SHOULD","PROFILE","REFERENCE"]},"applies_when":{"$ref":"#/$defs/NonEmptyString"},"does_not_apply_when":{"$ref":"#/$defs/NonEmptyString"},"verification":{"$ref":"#/$defs/NonEmptyString"},"body":{"$ref":"#/$defs/NonEmptyString"}},"additionalProperties":false},"NewPolicyUnit":{"type":"object","required":["id","heading_chain","semantic_revision","intent","aliases","predecessors","successors"],"properties":{"id":{"$ref":"#/$defs/CanonicalId"},"heading_chain":{"type":"array","minItems":1,"items":{"$ref":"#/$defs/NonEmptyString"}},"semantic_revision":{"const":1},"intent":{"$ref":"#/$defs/NonEmptyString"},"aliases":{"type":"array","uniqueItems":true,"items":{"$ref":"#/$defs/CanonicalId"}},"predecessors":{"type":"array","uniqueItems":true,"items":{"$ref":"#/$defs/CanonicalId"}},"successors":{"type":"array","uniqueItems":true,"items":{"$ref":"#/$defs/CanonicalId"}}},"additionalProperties":false},"PreservePolicySemantics":{"type":"object","required":["kind","semantic_revision","intent"],"properties":{"kind":{"const":"preserve"},"semantic_revision":{"type":"integer","minimum":1},"intent":{"$ref":"#/$defs/NonEmptyString"}},"additionalProperties":false},"ChangePolicySemantics":{"type":"object","required":["kind","accepted_semantic_revision","proposed_semantic_revision","intent"],"properties":{"kind":{"const":"change"},"accepted_semantic_revision":{"type":"integer","minimum":1},"proposed_semantic_revision":{"type":"integer","minimum":1},"intent":{"$ref":"#/$defs/NonEmptyString"}},"additionalProperties":false},"PolicySemanticIntent":{"oneOf":[{"$ref":"#/$defs/PreservePolicySemantics"},{"$ref":"#/$defs/ChangePolicySemantics"}]},"CreateStandardEdit":{"type":"object","required":["kind","standard","requires","specializes","policy_units"],"properties":{"kind":{"const":"create-standard"},"standard":{"$ref":"#/$defs/StandardContent"},"requires":{"type":"array","uniqueItems":true,"items":{"$ref":"#/$defs/CanonicalId"}},"specializes":{"type":"array","uniqueItems":true,"items":{"$ref":"#/$defs/CanonicalId"}},"policy_units":{"type":"array","uniqueItems":true,"items":{"$ref":"#/$defs/NewPolicyUnit"}}},"additionalProperties":false},"RegisterPolicyUnitEdit":{"type":"object","description":"Register an explicitly selected policy scope in an existing standard. The Engine owns declaration placement and validates the final candidate.","required":["kind","standard","policy_unit"],"properties":{"kind":{"const":"register-policy-unit"},"standard":{"$ref":"#/$defs/CanonicalId"},"policy_unit":{"$ref":"#/$defs/NewPolicyUnit"}},"additionalProperties":false},"ReviseStandardEdit":{"type":"object","required":["kind","standard"],"properties":{"kind":{"const":"revise-standard"},"standard":{"$ref":"#/$defs/StandardContent"},"scope_updates":{"type":"array","items":{"$ref":"#/$defs/PolicyScopeUpdate"}}},"additionalProperties":false},"RevisePolicyUnitEdit":{"type":"object","required":["kind","policy","title","body","semantics"],"properties":{"kind":{"const":"revise-policy-unit"},"policy":{"$ref":"#/$defs/CanonicalId"},"title":{"$ref":"#/$defs/NonEmptyString"},"body":{"$ref":"#/$defs/NonEmptyString"},"semantics":{"$ref":"#/$defs/PolicySemanticIntent"}},"additionalProperties":false},"MovePolicyUnitEdit":{"type":"object","required":["kind","policy","standard","semantics"],"properties":{"kind":{"const":"move-policy-unit"},"policy":{"$ref":"#/$defs/CanonicalId"},"standard":{"$ref":"#/$defs/CanonicalId"},"after_policy":{"$ref":"#/$defs/CanonicalId"},"semantics":{"$ref":"#/$defs/PolicySemanticIntent"}},"additionalProperties":false},"RetirePolicyUnitEdit":{"type":"object","required":["kind","policy","retired_semantic_revision","successors","relationship_dispositions","evidence"],"properties":{"kind":{"const":"retire-policy-unit"},"policy":{"$ref":"#/$defs/CanonicalId"},"retired_semantic_revision":{"type":"integer","minimum":1},"successors":{"type":"array","uniqueItems":true,"items":{"$ref":"#/$defs/CanonicalId"}},"relationship_dispositions":{"type":"array","uniqueItems":true,"items":{"$ref":"#/$defs/RelationshipDisposition"}},"evidence":{"type":"array","minItems":1,"uniqueItems":true,"items":{"$ref":"#/$defs/EvidenceReference"}}},"additionalProperties":false},"RetireStandardEdit":{"type":"object","required":["kind","standard","successors","relationship_dispositions","evidence"],"properties":{"kind":{"const":"retire-standard"},"standard":{"$ref":"#/$defs/CanonicalId"},"successors":{"type":"array","uniqueItems":true,"items":{"$ref":"#/$defs/CanonicalId"}},"relationship_dispositions":{"type":"array","uniqueItems":true,"items":{"$ref":"#/$defs/RelationshipDisposition"}},"evidence":{"type":"array","minItems":1,"uniqueItems":true,"items":{"$ref":"#/$defs/EvidenceReference"}}},"additionalProperties":false},"ReplaceStandardRelationshipsEdit":{"type":"object","required":["kind","standard","requires","specializes","rationale"],"properties":{"kind":{"const":"replace-standard-relationships"},"standard":{"$ref":"#/$defs/CanonicalId"},"requires":{"type":"array","uniqueItems":true,"items":{"$ref":"#/$defs/CanonicalId"}},"specializes":{"type":"array","uniqueItems":true,"items":{"$ref":"#/$defs/CanonicalId"}},"rationale":{"$ref":"#/$defs/NonEmptyString"}},"additionalProperties":false},"AuthoringTargetHandle":{"type":"object","required":["kind","snapshot","id","schema_version"],"properties":{"kind":{"const":"authoring-target-handle"},"snapshot":{"$ref":"#/$defs/SnapshotHandle"},"id":{"$ref":"#/$defs/ChildId"},"schema_version":{"const":5}},"additionalProperties":false},"RelationshipConsumer":{"oneOf":[{"$ref":"#/$defs/CanonicalId"},{"$ref":"#/$defs/AuthoringTargetHandle"}]},"PolicyRelationship":{"type":"object","required":["source_policy","consumer","relation","applicability","source_scope","consumer_scope","evidence_owner","rationale"],"properties":{"source_policy":{"$ref":"#/$defs/CanonicalId"},"consumer":{"$ref":"#/$defs/RelationshipConsumer"},"relation":{"enum":["normative-consumer","router-projection","prompt-projection","template-projection","reference-projection","fixture-projection","enforcement-suite-projection","documentation-projection","implementation-projection"]},"applicability":{"$ref":"#/$defs/ApplicabilityExpression"},"source_scope":{"oneOf":[{"$ref":"#/$defs/ReviewScope"},{"type":"null"}]},"consumer_scope":{"oneOf":[{"$ref":"#/$defs/ReviewScope"},{"type":"null"}]},"evidence_owner":{"$ref":"#/$defs/CanonicalId"},"rationale":{"$ref":"#/$defs/NonEmptyString"}},"additionalProperties":false},"PutPolicyRelationshipEdit":{"type":"object","required":["kind","relationship"],"properties":{"kind":{"const":"put-policy-relationship"},"relationship":{"$ref":"#/$defs/PolicyRelationship"}},"additionalProperties":false},"RemovePolicyRelationshipEdit":{"type":"object","required":["kind","relationship"],"properties":{"kind":{"const":"remove-policy-relationship"},"relationship":{"$ref":"#/$defs/PolicyRelationship"}},"additionalProperties":false},"ModuleRelationshipKey":{"type":"object","required":["kind","relation","source","target"],"properties":{"kind":{"const":"module-relationship"},"relation":{"enum":["requires","specializes"]},"source":{"$ref":"#/$defs/CanonicalId"},"target":{"$ref":"#/$defs/CanonicalId"}},"additionalProperties":false},"PolicyRelationshipKey":{"type":"object","required":["kind","source_policy","consumer","relation"],"properties":{"kind":{"const":"policy-relationship"},"source_policy":{"$ref":"#/$defs/CanonicalId"},"consumer":{"$ref":"#/$defs/RelationshipConsumer"},"relation":{"$ref":"#/$defs/CanonicalId"}},"additionalProperties":false},"RelationshipKey":{"oneOf":[{"$ref":"#/$defs/ModuleRelationshipKey"},{"$ref":"#/$defs/PolicyRelationshipKey"}]},"RelationshipDisposition":{"type":"object","required":["relationship","disposition","rationale","evidence"],"properties":{"relationship":{"$ref":"#/$defs/RelationshipKey"},"disposition":{"enum":["remove","retarget"]},"replacement_consumer":{"$ref":"#/$defs/RelationshipConsumer"},"rationale":{"$ref":"#/$defs/NonEmptyString"},"evidence":{"type":"array","minItems":1,"uniqueItems":true,"items":{"$ref":"#/$defs/EvidenceReference"}}},"additionalProperties":false},"StandardEdit":{"oneOf":[{"$ref":"#/$defs/CreateStandardEdit"},{"$ref":"#/$defs/RegisterPolicyUnitEdit"},{"$ref":"#/$defs/ReviseStandardEdit"},{"$ref":"#/$defs/RevisePolicyUnitEdit"},{"$ref":"#/$defs/MovePolicyUnitEdit"},{"$ref":"#/$defs/RetirePolicyUnitEdit"},{"$ref":"#/$defs/RetireStandardEdit"},{"$ref":"#/$defs/ReplaceStandardRelationshipsEdit"},{"$ref":"#/$defs/PutPolicyRelationshipEdit"},{"$ref":"#/$defs/RemovePolicyRelationshipEdit"},{"$ref":"#/$defs/PutRoutingRuleEdit"},{"$ref":"#/$defs/RemoveRoutingRuleEdit"},{"$ref":"#/$defs/PutRoutingFactEdit"},{"$ref":"#/$defs/RemoveRoutingFactEdit"},{"$ref":"#/$defs/AuditPolicyUnitEdit"},{"$ref":"#/$defs/RewriteNavigationIndexEdit"},{"$ref":"#/$defs/PutDecisionProvenanceEdit"},{"$ref":"#/$defs/RetireDecisionProvenanceEdit"},{"$ref":"#/$defs/ApproveApplicationContentEdit"},{"$ref":"#/$defs/WithdrawApplicationContentEdit"},{"$ref":"#/$defs/ReviseOperationalArtifactEdit"},{"$ref":"#/$defs/RegisterConsumerEdit"}]},"StandardsChangeSet":{"type":"object","required":["purpose","edits"],"properties":{"purpose":{"$ref":"#/$defs/StandardsChangePurpose"},"edits":{"type":"array","minItems":1,"uniqueItems":true,"items":{"$ref":"#/$defs/StandardEdit"}}},"additionalProperties":false},"ProposalSummary":{"type":"object","required":["proposal","head_revision"],"properties":{"proposal":{"$ref":"#/$defs/ProposalHandle"},"head_revision":{"$ref":"#/$defs/ProposalRevisionHandle"}},"additionalProperties":false},"CreateProposalCall":{"type":"object","required":["kind","base_snapshot","change_set"],"properties":{"kind":{"const":"create-proposal"},"base_snapshot":{"$ref":"#/$defs/SnapshotHandle"},"change_set":{"$ref":"#/$defs/StandardsChangeSet"}},"additionalProperties":false},"CreateProposalResult":{"type":"object","required":["kind","proposal","revision"],"properties":{"kind":{"const":"create-proposal-result"},"proposal":{"$ref":"#/$defs/ProposalHandle"},"revision":{"$ref":"#/$defs/ProposalRevisionHandle"}},"additionalProperties":false},"FindProposalsCall":{"type":"object","required":["kind"],"properties":{"kind":{"const":"find-proposals"},"after":{"$ref":"#/$defs/ProposalHandle"},"limit":{"type":"integer","minimum":1,"default":50}},"additionalProperties":false},"FindProposalsResult":{"type":"object","required":["kind","proposals"],"properties":{"kind":{"const":"find-proposals-result"},"proposals":{"type":"array","items":{"$ref":"#/$defs/ProposalSummary"}},"continuation":{"$ref":"#/$defs/ProposalHandle"}},"additionalProperties":false},"ReviseProposalCall":{"type":"object","required":["kind","expected_revision","change_set"],"properties":{"kind":{"const":"revise-proposal"},"expected_revision":{"$ref":"#/$defs/ProposalRevisionHandle"},"change_set":{"$ref":"#/$defs/StandardsChangeSet"}},"additionalProperties":false},"ReviseProposalResult":{"type":"object","required":["kind","proposal","revision"],"properties":{"kind":{"const":"revise-proposal-result"},"proposal":{"$ref":"#/$defs/ProposalHandle"},"revision":{"$ref":"#/$defs/ProposalRevisionHandle"}},"additionalProperties":false},"DeleteSnapshotCall":{"type":"object","required":["kind","snapshot"],"properties":{"kind":{"const":"delete-snapshot"},"snapshot":{"$ref":"#/$defs/SnapshotHandle"}},"additionalProperties":false},"DeleteSnapshotResult":{"type":"object","required":["kind","snapshot","purge_deadline"],"properties":{"kind":{"const":"delete-snapshot-result"},"snapshot":{"$ref":"#/$defs/SnapshotHandle"},"purge_deadline":{"$ref":"#/$defs/Timestamp"}},"additionalProperties":false},"UndeleteSnapshotCall":{"type":"object","required":["kind","snapshot"],"properties":{"kind":{"const":"undelete-snapshot"},"snapshot":{"$ref":"#/$defs/SnapshotHandle"}},"additionalProperties":false},"UndeleteSnapshotResult":{"type":"object","required":["kind","snapshot"],"properties":{"kind":{"const":"undelete-snapshot-result"},"snapshot":{"$ref":"#/$defs/ActiveSnapshotSummary"}},"additionalProperties":false},"QueryNextOperation":{"type":"object","required":["operation","request_kind","snapshot"],"properties":{"operation":{"const":"query"},"request_kind":{"enum":["route","read","related"]},"target":{"$ref":"#/$defs/CanonicalId"},"snapshot":{"$ref":"#/$defs/SnapshotHandle"}},"additionalProperties":false},"QueryProposalNextOperation":{"type":"object","required":["operation","request_kind","revision"],"properties":{"operation":{"const":"query_proposal"},"request_kind":{"enum":["route","read","related"]},"target":{"$ref":"#/$defs/CanonicalId"},"revision":{"$ref":"#/$defs/ProposalRevisionHandle"}},"additionalProperties":false},"ResolveNextOperation":{"type":"object","required":["operation","request_kind","analysis"],"properties":{"operation":{"const":"resolve"},"request_kind":{"enum":["provide-fact","consumer-disposition","impact-disposition","coverage-attestation"]},"target":{"$ref":"#/$defs/CanonicalId"},"work":{"$ref":"#/$defs/AnalysisChildHandle"},"analysis":{"$ref":"#/$defs/AnalysisHandle"}},"additionalProperties":false},"InspectNextOperation":{"type":"object","required":["operation","request_kind","handle"],"properties":{"operation":{"const":"inspect"},"request_kind":{"const":"inspect"},"handle":{"$ref":"#/$defs/InspectableHandle"}},"additionalProperties":false},"NextOperation":{"oneOf":[{"$ref":"#/$defs/QueryNextOperation"},{"$ref":"#/$defs/ResolveNextOperation"},{"$ref":"#/$defs/InspectNextOperation"},{"$ref":"#/$defs/FocusedQueryNextOperation"},{"$ref":"#/$defs/WorkflowDetailsNextOperation"}]},"QueryCall":{"type":"object","required":["snapshot","request"],"properties":{"snapshot":{"$ref":"#/$defs/SnapshotHandle"},"request":{"$ref":"#/$defs/QueryRequest"}},"additionalProperties":false},"QueryProposalCall":{"type":"object","required":["revision","request"],"properties":{"revision":{"$ref":"#/$defs/ProposalRevisionHandle"},"request":{"$ref":"#/$defs/QueryRequest"}},"additionalProperties":false},"AnalyzeProposalCall":{"type":"object","required":["revision"],"properties":{"revision":{"$ref":"#/$defs/ProposalRevisionHandle"}},"additionalProperties":false},"ReviewDecision":{"type":"object","required":["owner","decision","rationale","evidence"],"properties":{"owner":{"enum":["consumer","impact","audit"]},"decision":{"const":"accept"},"rationale":{"$ref":"#/$defs/NonEmptyString"},"evidence":{"type":"array","minItems":1,"uniqueItems":true,"items":{"$ref":"#/$defs/EvidenceReference"}}},"additionalProperties":false},"ReviewProposalCall":{"type":"object","required":["kind","analysis","decisions"],"properties":{"kind":{"const":"review-proposal"},"analysis":{"$ref":"#/$defs/AnalysisHandle"},"decisions":{"type":"array","minItems":3,"maxItems":3,"uniqueItems":true,"items":{"$ref":"#/$defs/ReviewDecision"}},"prior_readiness":{"$ref":"#/$defs/ReadinessHandle"}},"additionalProperties":false},"ReviewProposalResult":{"type":"object","required":["kind","readiness","revision","status"],"properties":{"kind":{"const":"review-proposal-result"},"readiness":{"$ref":"#/$defs/ReadinessHandle"},"revision":{"$ref":"#/$defs/ProposalRevisionHandle"},"status":{"const":"ready"}},"additionalProperties":false},"ApplyProposalCall":{"type":"object","required":["kind","readiness"],"properties":{"kind":{"const":"apply-proposal"},"readiness":{"$ref":"#/$defs/ReadinessHandle"}},"additionalProperties":false},"ApplyProposalResult":{"type":"object","required":["kind","application","status","publication","checkout"],"properties":{"kind":{"const":"apply-proposal-result"},"application":{"$ref":"#/$defs/ApplicationHandle"},"status":{"const":"applied"},"publication":{"$ref":"#/$defs/ApplicationPublicationReceipt"},"checkout":{"$ref":"#/$defs/PublicationCheckoutObservation"}},"additionalProperties":false},"RecoverApplicationCall":{"type":"object","required":["kind","readiness"],"properties":{"kind":{"const":"recover-application"},"readiness":{"$ref":"#/$defs/ReadinessHandle"},"action":{"enum":["observe","complete-publication"],"description":"Omit or select observe to reconcile only. Explicit complete-publication revalidates and attempts the same admitted candidate against its original expected target; it requires current publication authorization."}},"additionalProperties":false,"description":"Recover an admitted application. Observation performs no Git writes. Explicit completion reconstructs and verifies the exact admitted candidate before one compare-and-swap attempt."},"RecoverApplicationResult":{"type":"object","required":["kind","application","status","publication","checkout"],"properties":{"kind":{"const":"recover-application-result"},"application":{"$ref":"#/$defs/ApplicationHandle"},"status":{"const":"applied"},"publication":{"$ref":"#/$defs/ApplicationPublicationReceipt"},"checkout":{"$ref":"#/$defs/PublicationCheckoutObservation"}},"additionalProperties":false},"ApplicationRecoveryRequiredResult":{"type":"object","required":["kind","application","status","code","outcome","message","publication","checkout"],"properties":{"kind":{"const":"application-recovery-required-result"},"application":{"$ref":"#/$defs/ApplicationHandle"},"status":{"const":"recovery-required"},"code":{"enum":["APPLICATION.PUBLICATION_UNAVAILABLE","APPLICATION.OBSERVATION_UNAVAILABLE","APPLICATION.OUTCOME_OBSERVATION_UNAVAILABLE","APPLICATION.OUTCOME_PERSISTENCE_UNAVAILABLE","APPLICATION.RECOVERY_TARGET_UNCERTAIN","APPLICATION.RECOVERY_TARGET_DIVERGED","APPLICATION.RECOVERY_BLOCKED"]},"outcome":{"const":"unavailable"},"message":{"$ref":"#/$defs/NonEmptyString"},"publication":{"$ref":"#/$defs/ApplicationPublicationReceipt"},"checkout":{"$ref":"#/$defs/PublicationCheckoutObservation"},"details":{"type":"object","additionalProperties":{"$ref":"#/$defs/ScalarValue"}}},"additionalProperties":false},"PublicationTargetObservation":{"description":"Fresh bounded observation of the configured target ref; an unavailable revision is null.","type":"object","required":["kind","status","revision"],"properties":{"kind":{"const":"publication-target-observation"},"status":{"enum":["candidate","expected","diverged","unavailable"]},"revision":{"oneOf":[{"$ref":"#/$defs/GitObjectId"},{"type":"null"}]}},"additionalProperties":false},"ApplicationPublicationReceipt":{"description":"Durable application identity and exact candidate facts, separate from the fresh target observation.","type":"object","required":["kind","application","candidate_commit","candidate_tree","target_ref","expected_predecessor","durable_state","target_observation"],"properties":{"kind":{"const":"application-publication-receipt"},"application":{"$ref":"#/$defs/ApplicationHandle"},"candidate_commit":{"$ref":"#/$defs/GitObjectId"},"candidate_tree":{"oneOf":[{"$ref":"#/$defs/GitObjectId"},{"type":"null"}]},"target_ref":{"const":"refs/heads/main"},"expected_predecessor":{"$ref":"#/$defs/GitObjectId"},"durable_state":{"enum":["applied","admitted","unknown"]},"target_observation":{"$ref":"#/$defs/PublicationTargetObservation"}},"additionalProperties":false},"PublicationPathCounts":{"type":"object","required":["predecessor","candidate","conflicted"],"properties":{"predecessor":{"type":["integer","null"],"minimum":0},"candidate":{"type":["integer","null"],"minimum":0},"conflicted":{"type":["integer","null"],"minimum":0}},"additionalProperties":false},"PublicationCheckoutObservation":{"description":"Fresh read-only observation of one selected checkout. Unavailable observations use null for every fact that could not be established.","type":"object","required":["kind","status","worktree_id","symbolic_branch","head","index_observation","publication_path_count","index_paths","worktree_paths"],"properties":{"kind":{"const":"publication-checkout-observation"},"status":{"enum":["not-observed","unavailable","not-target-checkout","current","needs-reconciliation","conflicted"]},"worktree_id":{"oneOf":[{"$ref":"#/$defs/Digest"},{"type":"null"}]},"symbolic_branch":{"oneOf":[{"$ref":"#/$defs/NonEmptyString"},{"type":"null"}]},"head":{"oneOf":[{"$ref":"#/$defs/GitObjectId"},{"type":"null"}]},"index_observation":{"oneOf":[{"$ref":"#/$defs/Digest"},{"type":"null"}]},"publication_path_count":{"type":["integer","null"],"minimum":0},"index_paths":{"$ref":"#/$defs/PublicationPathCounts"},"worktree_paths":{"$ref":"#/$defs/PublicationPathCounts"}},"additionalProperties":false},"PolicySummary":{"type":"object","required":["handle","authority","scope"],"properties":{"handle":{"$ref":"#/$defs/SnapshotChildHandle"},"authority":{"enum":["normative","projection","contextual","evidence"]},"scope":{"$ref":"#/$defs/ReviewScope"}},"additionalProperties":false},"RelationshipSummary":{"type":"object","required":["handle","source","target","relation","groups","direction","traversal_eligible","applicability"],"properties":{"handle":{"$ref":"#/$defs/SnapshotChildHandle"},"source":{"$ref":"#/$defs/CanonicalId"},"target":{"$ref":"#/$defs/CanonicalId"},"relation":{"$ref":"#/$defs/CanonicalId"},"groups":{"type":"array","items":{"$ref":"#/$defs/CanonicalId"},"minItems":1,"uniqueItems":true},"direction":{"enum":["incoming","outgoing"]},"traversal_eligible":{"type":"boolean"},"applicability":{"enum":["true","false","unknown","not-declared"]}},"additionalProperties":false},"ProposalPolicySummary":{"type":"object","required":["id","authority","scope"],"properties":{"id":{"$ref":"#/$defs/CanonicalId"},"authority":{"enum":["normative","projection","contextual","evidence"]},"scope":{"$ref":"#/$defs/ReviewScope"}},"additionalProperties":false},"ProposalRelationshipSummary":{"type":"object","required":["source","target","relation","groups","direction","traversal_eligible","applicability"],"properties":{"source":{"$ref":"#/$defs/CanonicalId"},"target":{"$ref":"#/$defs/CanonicalId"},"relation":{"$ref":"#/$defs/CanonicalId"},"groups":{"type":"array","items":{"$ref":"#/$defs/CanonicalId"},"minItems":1,"uniqueItems":true},"direction":{"enum":["incoming","outgoing"]},"traversal_eligible":{"type":"boolean"},"applicability":{"enum":["true","false","unknown","not-declared"]}},"additionalProperties":false},"RouteResult":{"type":"object","required":["kind","snapshot","reading_plan","unresolved_questions","next_operations"],"properties":{"kind":{"const":"route-result"},"snapshot":{"$ref":"#/$defs/SnapshotHandle"},"reading_plan":{"type":"array","items":{"$ref":"#/$defs/ReadingPlanEntry"}},"unresolved_questions":{"type":"array","items":{"$ref":"#/$defs/Question"}},"next_operations":{"type":"array","items":{"$ref":"#/$defs/NextOperation"}},"summary":{"type":"string"}},"additionalProperties":false},"ReadResult":{"type":"object","required":["kind","snapshot","policy","content","requires","specializes","related","next_operations"],"properties":{"kind":{"const":"read-result"},"snapshot":{"$ref":"#/$defs/SnapshotHandle"},"policy":{"$ref":"#/$defs/PolicySummary"},"content":{"type":"string"},"requires":{"type":"array","items":{"$ref":"#/$defs/CanonicalId"},"uniqueItems":true},"specializes":{"type":"array","items":{"$ref":"#/$defs/CanonicalId"},"uniqueItems":true},"related":{"type":"array","items":{"$ref":"#/$defs/RelationshipSummary"}},"next_operations":{"type":"array","items":{"$ref":"#/$defs/NextOperation"}},"summary":{"type":"string"},"routing":{"$ref":"#/$defs/RoutingConfiguration"},"coverage":{"$ref":"#/$defs/ReadCoverage"},"application_exposure":{"$ref":"#/$defs/ApplicationExposureState"},"provenance":{"type":"array","items":{"$ref":"#/$defs/CanonicalId"}}},"additionalProperties":false},"PolicyUnitMapping":{"type":"object","required":["state","policy_units"],"properties":{"state":{"enum":["exact-policy-unit","policy-units-present","incomplete"]},"reason":{"const":"no-policy-units"},"policy_units":{"type":"array","items":{"$ref":"#/$defs/CanonicalId"},"uniqueItems":true}},"additionalProperties":false},"RelatedResult":{"type":"object","required":["kind","snapshot","target","policy_unit_mapping","relationships","next_operations"],"properties":{"kind":{"const":"related-result"},"snapshot":{"$ref":"#/$defs/SnapshotHandle"},"target":{"$ref":"#/$defs/CanonicalId"},"authoring_target":{"$ref":"#/$defs/AuthoringTargetHandle"},"policy_unit_mapping":{"$ref":"#/$defs/PolicyUnitMapping"},"relationships":{"type":"array","items":{"$ref":"#/$defs/RelationshipSummary"}},"next_operations":{"type":"array","items":{"$ref":"#/$defs/NextOperation"}},"summary":{"type":"string"}},"additionalProperties":false},"QueryResult":{"oneOf":[{"$ref":"#/$defs/RouteResult"},{"$ref":"#/$defs/ReadResult"},{"$ref":"#/$defs/RelatedResult"},{"$ref":"#/$defs/NavigationIndexesResult"},{"$ref":"#/$defs/ProvenanceReadResult"},{"$ref":"#/$defs/OperationalReadResult"}]},"ProposalRouteResult":{"type":"object","required":["kind","revision","reading_plan","unresolved_questions","next_operations"],"properties":{"kind":{"const":"proposal-route-result"},"revision":{"$ref":"#/$defs/ProposalRevisionHandle"},"reading_plan":{"type":"array","items":{"$ref":"#/$defs/ReadingPlanEntry"}},"unresolved_questions":{"type":"array","items":{"$ref":"#/$defs/Question"}},"next_operations":{"type":"array","items":{"$ref":"#/$defs/QueryProposalNextOperation"}},"summary":{"type":"string"}},"additionalProperties":false},"ProposalReadResult":{"type":"object","required":["kind","revision","policy","content","requires","specializes","related","next_operations"],"properties":{"kind":{"const":"proposal-read-result"},"revision":{"$ref":"#/$defs/ProposalRevisionHandle"},"policy":{"$ref":"#/$defs/ProposalPolicySummary"},"content":{"type":"string"},"requires":{"type":"array","items":{"$ref":"#/$defs/CanonicalId"},"uniqueItems":true},"specializes":{"type":"array","items":{"$ref":"#/$defs/CanonicalId"},"uniqueItems":true},"related":{"type":"array","items":{"$ref":"#/$defs/ProposalRelationshipSummary"}},"next_operations":{"type":"array","items":{"$ref":"#/$defs/QueryProposalNextOperation"}},"summary":{"type":"string"},"routing":{"$ref":"#/$defs/RoutingConfiguration"},"coverage":{"$ref":"#/$defs/ReadCoverage"},"application_exposure":{"$ref":"#/$defs/ApplicationExposureState"},"provenance":{"type":"array","items":{"$ref":"#/$defs/CanonicalId"}}},"additionalProperties":false},"ProposalRelatedResult":{"type":"object","required":["kind","revision","target","policy_unit_mapping","relationships","next_operations"],"properties":{"kind":{"const":"proposal-related-result"},"revision":{"$ref":"#/$defs/ProposalRevisionHandle"},"target":{"$ref":"#/$defs/CanonicalId"},"authoring_target":{"$ref":"#/$defs/AuthoringTargetHandle"},"policy_unit_mapping":{"$ref":"#/$defs/PolicyUnitMapping"},"relationships":{"type":"array","items":{"$ref":"#/$defs/ProposalRelationshipSummary"}},"next_operations":{"type":"array","items":{"$ref":"#/$defs/QueryProposalNextOperation"}},"summary":{"type":"string"}},"additionalProperties":false},"QueryProposalResult":{"oneOf":[{"$ref":"#/$defs/ProposalRouteResult"},{"$ref":"#/$defs/ProposalReadResult"},{"$ref":"#/$defs/ProposalRelatedResult"},{"$ref":"#/$defs/NavigationIndexesResult"},{"$ref":"#/$defs/ProvenanceReadResult"},{"$ref":"#/$defs/OperationalReadResult"}]},"AnalysisRequest":{"type":"object","required":["kind","base_snapshot","proposed_snapshot","changes","semantic_proposals","contract_version"],"properties":{"kind":{"const":"analysis-request"},"base_snapshot":{"$ref":"#/$defs/SnapshotHandle"},"proposed_snapshot":{"$ref":"#/$defs/SnapshotHandle"},"changes":{"type":"array","items":{"$ref":"#/$defs/ChangeDescriptor"},"minItems":1},"semantic_proposals":{"type":"array","items":{"$ref":"#/$defs/SemanticProposal"},"uniqueItems":true},"prior_analysis":{"$ref":"#/$defs/AnalysisHandle"},"contract_version":{"const":6}},"additionalProperties":false},"PrepareCall":{"type":"object","required":["request"],"properties":{"request":{"$ref":"#/$defs/AnalysisRequest"}},"additionalProperties":false},"AnalysisContext":{"type":"object","required":["kind","handle","subjects","changes","semantic_proposals"],"properties":{"kind":{"const":"analysis-context"},"handle":{"$ref":"#/$defs/AnalysisChildHandle"},"subjects":{"type":"array","items":{"$ref":"#/$defs/ChangedPolicyUnit"},"uniqueItems":true},"changes":{"type":"array","items":{"$ref":"#/$defs/ChangeDescriptor"},"minItems":1,"uniqueItems":true},"semantic_proposals":{"type":"array","items":{"$ref":"#/$defs/SemanticProposal"},"uniqueItems":true}},"additionalProperties":false},"AuthorizationReference":{"type":"object","required":["id","issuer","capability","authority_digest"],"properties":{"id":{"$ref":"#/$defs/AuthorizationId"},"issuer":{"$ref":"#/$defs/CanonicalId"},"capability":{"$ref":"#/$defs/CanonicalId"},"authority_digest":{"$ref":"#/$defs/Digest"}},"additionalProperties":false},"ProviderReference":{"type":"object","required":["id","contract","contract_version","input_digest"],"properties":{"id":{"$ref":"#/$defs/CanonicalId"},"contract":{"$ref":"#/$defs/CanonicalId"},"contract_version":{"$ref":"#/$defs/NonEmptyString"},"input_digest":{"$ref":"#/$defs/Digest"}},"additionalProperties":false},"AuthorizationRecord":{"type":"object","required":["reference","issuer_semantic_revision","principal","action","subject_kind","subject_id","authorization_evidence","revocation_authority","revocation_authority_semantic_revision","revocation_evidence"],"properties":{"reference":{"$ref":"#/$defs/AuthorizationReference"},"issuer_semantic_revision":{"type":"integer","minimum":1},"principal":{"$ref":"#/$defs/CanonicalId"},"action":{"$ref":"#/$defs/CanonicalId"},"subject_kind":{"$ref":"#/$defs/CanonicalId"},"subject_id":{"$ref":"#/$defs/NonEmptyString"},"authorization_evidence":{"type":"array","items":{"$ref":"#/$defs/EvidenceReference"},"minItems":1,"uniqueItems":true},"revocation_authority":{"$ref":"#/$defs/CanonicalId"},"revocation_authority_semantic_revision":{"type":"integer","minimum":1},"revocation_evidence":{"type":"array","items":{"$ref":"#/$defs/EvidenceReference"},"minItems":1,"uniqueItems":true}},"additionalProperties":false},"DomainContractReference":{"type":"object","required":["id","version"],"properties":{"id":{"$ref":"#/$defs/CanonicalId"},"version":{"$ref":"#/$defs/NonEmptyString"}},"additionalProperties":false},"AnalysisExecutionContractView":{"type":"object","required":["authorization_authority_digest","providers"],"properties":{"authorization_authority_digest":{"oneOf":[{"$ref":"#/$defs/Digest"},{"type":"null"}]},"providers":{"type":"array","items":{"$ref":"#/$defs/ProviderReference"},"uniqueItems":true}},"additionalProperties":false},"FactRequirement":{"type":"object","required":["kind","handle","fact","fact_semantic_revision","fact_contract_digest","context","value_contract","answer_contract","evidence_contract","authorization_capability"],"properties":{"kind":{"const":"fact-requirement"},"handle":{"$ref":"#/$defs/AnalysisChildHandle"},"fact":{"$ref":"#/$defs/CanonicalId"},"fact_semantic_revision":{"type":"integer","minimum":1},"fact_contract_digest":{"$ref":"#/$defs/Digest"},"context":{"$ref":"#/$defs/AnalysisChildHandle"},"value_contract":{"$ref":"#/$defs/FactValueContract"},"answer_contract":{"$ref":"#/$defs/CanonicalId"},"evidence_contract":{"$ref":"#/$defs/CanonicalId"},"authorization_capability":{"$ref":"#/$defs/CanonicalId"}},"additionalProperties":false},"FactRequirementWork":{"type":"object","required":["requirement","prompt","dependent_programs"],"properties":{"requirement":{"$ref":"#/$defs/FactRequirement"},"prompt":{"$ref":"#/$defs/NonEmptyString"},"dependent_programs":{"type":"array","items":{"$ref":"#/$defs/NonEmptyString"},"minItems":1,"uniqueItems":true}},"additionalProperties":false},"FactObservation":{"type":"object","required":["kind","handle","requirement","value","evidence","authorization"],"properties":{"kind":{"const":"fact-observation"},"handle":{"$ref":"#/$defs/AnalysisChildHandle"},"requirement":{"$ref":"#/$defs/AnalysisChildHandle"},"value":{"$ref":"#/$defs/FactValue"},"evidence":{"type":"array","items":{"$ref":"#/$defs/EvidenceReference"},"minItems":1,"uniqueItems":true},"authorization":{"$ref":"#/$defs/AuthorizationReference"},"provider":{"$ref":"#/$defs/ProviderReference"}},"additionalProperties":false},"Obligation":{"type":"object","required":["handle","kind","target","scope","reasons","state","permitted_submissions","fingerprint"],"properties":{"handle":{"$ref":"#/$defs/AnalysisChildHandle"},"kind":{"enum":["consumer-review","impact-review","lifecycle-impact-review","audit-coverage","unmapped-normative-change"]},"target":{"$ref":"#/$defs/CanonicalId"},"scope":{"$ref":"#/$defs/ReviewScope"},"reasons":{"type":"array","items":{"$ref":"#/$defs/SelectionReason"},"minItems":1,"uniqueItems":true},"state":{"enum":["required","resolved","blocked"]},"applicability":{"enum":["true","false","unknown","not-declared"]},"permitted_submissions":{"type":"array","items":{"enum":["consumer-disposition","impact-disposition","coverage-attestation"]},"minItems":1,"uniqueItems":true},"review_contract":{"$ref":"#/$defs/ConsumerReviewContract"},"fingerprint":{"$ref":"#/$defs/DecisionFingerprint"}},"additionalProperties":false},"ProvideFactSubmission":{"type":"object","required":["kind","requirement","value","evidence"],"properties":{"kind":{"const":"provide-fact"},"requirement":{"$ref":"#/$defs/AnalysisChildHandle"},"value":{"$ref":"#/$defs/FactValue"},"evidence":{"type":"array","items":{"$ref":"#/$defs/EvidenceReference"},"minItems":1,"uniqueItems":true}},"additionalProperties":false},"ConsumerDispositionSubmission":{"type":"object","required":["kind","obligation","result","rationale","evidence","fingerprint"],"properties":{"kind":{"const":"consumer-disposition"},"obligation":{"$ref":"#/$defs/AnalysisChildHandle"},"result":{"enum":["updated","reviewed-no-change","not-applicable","blocked"]},"rationale":{"$ref":"#/$defs/NonEmptyString"},"evidence":{"type":"array","items":{"$ref":"#/$defs/EvidenceReference"},"minItems":1},"fingerprint":{"$ref":"#/$defs/DecisionFingerprint"}},"additionalProperties":false},"ImpactDispositionSubmission":{"type":"object","required":["kind","obligation","result","rationale","evidence","fingerprint"],"properties":{"kind":{"const":"impact-disposition"},"obligation":{"$ref":"#/$defs/AnalysisChildHandle"},"result":{"enum":["confirmed","resolved-no-impact","requires-change","blocked"]},"rationale":{"$ref":"#/$defs/NonEmptyString"},"evidence":{"type":"array","items":{"$ref":"#/$defs/EvidenceReference"},"minItems":1},"fingerprint":{"$ref":"#/$defs/DecisionFingerprint"}},"additionalProperties":false},"CoverageAttestationClaim":{"type":"object","required":["requirement","conclusion","evidence","explicit_exclusions","rationale","auditor_provenance"],"properties":{"requirement":{"$ref":"#/$defs/AnalysisChildHandle"},"conclusion":{"const":"complete"},"evidence":{"type":"array","items":{"$ref":"#/$defs/EvidenceReference"},"minItems":1,"uniqueItems":true},"explicit_exclusions":{"type":"array","items":{"$ref":"#/$defs/EvidenceReference"},"uniqueItems":true},"rationale":{"$ref":"#/$defs/NonEmptyString"},"auditor_provenance":{"$ref":"#/$defs/NonEmptyString"}},"additionalProperties":false},"CoverageAttestationSubmission":{"type":"object","required":["kind","claim"],"properties":{"kind":{"const":"coverage-attestation"},"claim":{"$ref":"#/$defs/CoverageAttestationClaim"}},"additionalProperties":false},"Submission":{"oneOf":[{"$ref":"#/$defs/ProvideFactSubmission"},{"$ref":"#/$defs/ConsumerDispositionSubmission"},{"$ref":"#/$defs/ImpactDispositionSubmission"},{"$ref":"#/$defs/CoverageAttestationSubmission"}]},"ResolveCall":{"type":"object","required":["analysis","submission"],"properties":{"analysis":{"$ref":"#/$defs/AnalysisHandle"},"submission":{"$ref":"#/$defs/Submission"}},"additionalProperties":false},"CoverageRequirement":{"type":"object","required":["kind","handle","subject","owner","semantic_revision","relationship_kinds","horizon","required_evidence_contract"],"properties":{"kind":{"const":"coverage-requirement"},"handle":{"$ref":"#/$defs/AnalysisChildHandle"},"subject":{"$ref":"#/$defs/CanonicalId"},"owner":{"$ref":"#/$defs/CanonicalId"},"semantic_revision":{"type":"integer","minimum":1},"relationship_kinds":{"type":"array","items":{"$ref":"#/$defs/CanonicalId"},"uniqueItems":true},"horizon":{"$ref":"#/$defs/CanonicalId"},"required_evidence_contract":{"$ref":"#/$defs/CanonicalId"}},"additionalProperties":false},"CoverageAttestation":{"type":"object","required":["kind","requirement","conclusion","evidence","explicit_exclusions","rationale","auditor_provenance","schema_version","authorization"],"properties":{"kind":{"const":"coverage-attestation"},"requirement":{"$ref":"#/$defs/AnalysisChildHandle"},"conclusion":{"const":"complete"},"evidence":{"type":"array","items":{"$ref":"#/$defs/EvidenceReference"},"minItems":1},"explicit_exclusions":{"type":"array","items":{"$ref":"#/$defs/EvidenceReference"}},"rationale":{"$ref":"#/$defs/NonEmptyString"},"auditor_provenance":{"$ref":"#/$defs/NonEmptyString"},"schema_version":{"const":4},"authorization":{"$ref":"#/$defs/AuthorizationReference"}},"additionalProperties":false},"CoverageCertificate":{"type":"object","required":["kind","handle","requirement","subject","owner","semantic_revision","horizon_digest","relationship_digest","evidence_digests","fact_schema_digest"],"properties":{"kind":{"const":"coverage-certificate"},"handle":{"$ref":"#/$defs/AnalysisChildHandle"},"requirement":{"$ref":"#/$defs/AnalysisChildHandle"},"subject":{"$ref":"#/$defs/CanonicalId"},"owner":{"$ref":"#/$defs/CanonicalId"},"semantic_revision":{"type":"integer","minimum":1},"horizon_digest":{"$ref":"#/$defs/Digest"},"relationship_digest":{"$ref":"#/$defs/Digest"},"evidence_digests":{"type":"array","items":{"$ref":"#/$defs/Digest"},"uniqueItems":true},"fact_schema_digest":{"$ref":"#/$defs/Digest"}},"additionalProperties":false},"DispositionRecord":{"type":"object","required":["obligation","kind","result","rationale","evidence","authorization","fingerprint"],"properties":{"obligation":{"$ref":"#/$defs/AnalysisChildHandle"},"kind":{"enum":["consumer-disposition","impact-disposition"]},"result":{"$ref":"#/$defs/NonEmptyString"},"rationale":{"$ref":"#/$defs/NonEmptyString"},"evidence":{"type":"array","items":{"$ref":"#/$defs/EvidenceReference"}},"authorization":{"$ref":"#/$defs/AuthorizationReference"},"fingerprint":{"$ref":"#/$defs/DecisionFingerprint"}},"additionalProperties":false},"AnalysisState":{"type":"object","required":["kind","handle","base_snapshot","proposed_reference","changes","semantic_proposals","fact_observations","dispositions","coverage_attestations","authorization_records","domain_contracts","execution_contracts","contract_version"],"properties":{"kind":{"const":"analysis-state"},"handle":{"$ref":"#/$defs/AnalysisHandle"},"base_snapshot":{"$ref":"#/$defs/SnapshotHandle"},"proposed_reference":{"$ref":"#/$defs/AnalysisMaterialHandle"},"changes":{"type":"array","items":{"$ref":"#/$defs/ChangeDescriptor"},"minItems":1,"uniqueItems":true},"semantic_proposals":{"type":"array","items":{"$ref":"#/$defs/SemanticProposal"},"uniqueItems":true},"fact_observations":{"type":"array","items":{"$ref":"#/$defs/FactObservation"},"uniqueItems":true},"dispositions":{"type":"array","items":{"$ref":"#/$defs/DispositionRecord"},"uniqueItems":true},"coverage_attestations":{"type":"array","items":{"$ref":"#/$defs/CoverageAttestation"},"uniqueItems":true},"authorization_records":{"type":"array","items":{"$ref":"#/$defs/AuthorizationRecord"},"uniqueItems":true},"domain_contracts":{"type":"array","items":{"$ref":"#/$defs/DomainContractReference"},"minItems":1,"uniqueItems":true},"execution_contracts":{"$ref":"#/$defs/AnalysisExecutionContractView"},"contract_version":{"const":7}},"additionalProperties":false},"PendingResult":{"type":"object","required":["kind","handle","status","context","changes","changed_units","obligations","fact_requirements","reading_plan","next_operations"],"properties":{"kind":{"const":"pending-result"},"handle":{"$ref":"#/$defs/AnalysisHandle"},"status":{"const":"needs-action"},"context":{"$ref":"#/$defs/AnalysisContext"},"changes":{"type":"array","items":{"$ref":"#/$defs/ChangeDescriptor"}},"changed_units":{"type":"array","items":{"$ref":"#/$defs/ChangedPolicyUnit"}},"obligations":{"type":"array","items":{"$ref":"#/$defs/Obligation"}},"fact_requirements":{"type":"array","items":{"$ref":"#/$defs/FactRequirementWork"}},"reading_plan":{"type":"array","items":{"$ref":"#/$defs/ReadingPlanEntry"}},"next_operations":{"type":"array","items":{"$ref":"#/$defs/NextOperation"}},"summary":{"type":"string"}},"additionalProperties":false},"CompleteResult":{"type":"object","required":["kind","handle","status","context","changes","changed_units","coverage_certificates","fact_observations","dispositions","reading_plan","completion"],"properties":{"kind":{"const":"complete-result"},"handle":{"$ref":"#/$defs/AnalysisHandle"},"status":{"const":"complete"},"context":{"$ref":"#/$defs/AnalysisContext"},"changes":{"type":"array","items":{"$ref":"#/$defs/ChangeDescriptor"}},"changed_units":{"type":"array","items":{"$ref":"#/$defs/ChangedPolicyUnit"}},"coverage_certificates":{"type":"array","items":{"$ref":"#/$defs/CoverageCertificate"},"uniqueItems":true},"fact_observations":{"type":"array","items":{"$ref":"#/$defs/FactObservation"},"uniqueItems":true},"dispositions":{"type":"array","items":{"$ref":"#/$defs/DispositionRecord"}},"reading_plan":{"type":"array","items":{"$ref":"#/$defs/ReadingPlanEntry"}},"completion":{"$ref":"#/$defs/CompletionProof"},"summary":{"type":"string"}},"additionalProperties":false},"RepositoryPath":{"type":"array","items":{"$ref":"#/$defs/NonEmptyString"},"minItems":1},"ProvenanceRecord":{"type":"object","required":["snapshot","path"],"properties":{"snapshot":{"$ref":"#/$defs/SnapshotHandle"},"path":{"$ref":"#/$defs/RepositoryPath"}},"additionalProperties":false},"SnapshotInspectionResult":{"type":"object","required":["kind","snapshot"],"properties":{"kind":{"const":"snapshot-inspection-result"},"snapshot":{"$ref":"#/$defs/SnapshotSummary"}},"additionalProperties":false},"PolicyInspectionResult":{"type":"object","required":["kind","policy","declaration","representation_digest","structural_digest","provenance"],"properties":{"kind":{"const":"policy-inspection-result"},"policy":{"$ref":"#/$defs/SnapshotChildHandle"},"declaration":{"oneOf":[{"$ref":"#/$defs/CanonicalModuleDeclaration"},{"$ref":"#/$defs/PolicyUnitDeclaration"}]},"representation_digest":{"$ref":"#/$defs/Digest"},"structural_digest":{"$ref":"#/$defs/Digest"},"provenance":{"$ref":"#/$defs/ProvenanceRecord"}},"additionalProperties":false},"RelationshipInspectionResult":{"type":"object","required":["kind","relationship","policy_semantics","provenance"],"properties":{"kind":{"const":"relationship-inspection-result"},"relationship":{"$ref":"#/$defs/RelationshipSummary"},"policy_semantics":{"oneOf":[{"$ref":"#/$defs/PolicyRelationshipInspection"},{"type":"null"}]},"provenance":{"$ref":"#/$defs/ProvenanceRecord"}},"additionalProperties":false},"AnalysisInspectionResult":{"type":"object","required":["kind","state"],"properties":{"kind":{"const":"analysis-inspection-result"},"state":{"$ref":"#/$defs/AnalysisState"}},"additionalProperties":false},"AnalysisChildArtifact":{"oneOf":[{"$ref":"#/$defs/AnalysisContext"},{"$ref":"#/$defs/FactRequirement"},{"$ref":"#/$defs/FactObservation"},{"$ref":"#/$defs/Obligation"},{"$ref":"#/$defs/CoverageRequirement"},{"$ref":"#/$defs/CoverageCertificate"}]},"AnalysisChildInspectionResult":{"type":"object","required":["kind","handle","artifact"],"properties":{"kind":{"const":"analysis-child-inspection-result"},"handle":{"$ref":"#/$defs/AnalysisChildHandle"},"artifact":{"$ref":"#/$defs/AnalysisChildArtifact"}},"additionalProperties":false},"InspectionResult":{"oneOf":[{"$ref":"#/$defs/SnapshotInspectionResult"},{"$ref":"#/$defs/PolicyInspectionResult"},{"$ref":"#/$defs/RelationshipInspectionResult"},{"$ref":"#/$defs/AnalysisInspectionResult"},{"$ref":"#/$defs/AnalysisChildInspectionResult"}]},"InspectCall":{"type":"object","required":["handle"],"properties":{"handle":{"$ref":"#/$defs/InspectableHandle"}},"additionalProperties":false},"RejectedResult":{"type":"object","required":["kind","code","outcome","message","details","next_operations"],"properties":{"kind":{"const":"rejected-result"},"code":{"$ref":"#/$defs/CanonicalId"},"outcome":{"enum":["invalid","unavailable","unsupported","unauthorized"]},"target":{"$ref":"#/$defs/NonEmptyString"},"message":{"$ref":"#/$defs/NonEmptyString"},"details":{"type":"object","additionalProperties":{"$ref":"#/$defs/ScalarValue"}},"next_operations":{"type":"array","items":{"$ref":"#/$defs/NextOperation"}},"input_feedback":{"$ref":"#/$defs/InputFeedback"},"relationship_groups":{"$ref":"#/$defs/RelationshipGroupsResult"}},"additionalProperties":false},"AuthoredRoutingRule":{"type":"object","required":["id","target","when","condition"],"properties":{"id":{"$ref":"#/$defs/CanonicalId"},"target":{"$ref":"#/$defs/CanonicalId"},"when":{"$ref":"#/$defs/ApplicabilityExpression"},"condition":{"$ref":"#/$defs/NonEmptyString"}},"additionalProperties":false},"AuthoredRoutingFact":{"type":"object","required":["id","semantic_revision","type","nullable","values","aliases","meaning","prompt"],"properties":{"id":{"$ref":"#/$defs/CanonicalId"},"semantic_revision":{"type":"integer","minimum":1},"type":{"enum":["boolean","enum","string","string-set","enum-set","canonical-id"]},"nullable":{"type":"boolean"},"values":{"type":"array","items":{"type":"string"},"uniqueItems":true},"aliases":{"type":"array","items":{"$ref":"#/$defs/CanonicalId"},"uniqueItems":true},"meaning":{"$ref":"#/$defs/NonEmptyString"},"prompt":{"$ref":"#/$defs/NonEmptyString"}},"additionalProperties":false},"PutRoutingRuleEdit":{"type":"object","required":["kind","rule","rationale"],"properties":{"kind":{"const":"put-routing-rule"},"rule":{"$ref":"#/$defs/AuthoredRoutingRule"},"rationale":{"$ref":"#/$defs/NonEmptyString"}},"additionalProperties":false},"RemoveRoutingRuleEdit":{"type":"object","required":["kind","rule","rationale"],"properties":{"kind":{"const":"remove-routing-rule"},"rule":{"$ref":"#/$defs/CanonicalId"},"rationale":{"$ref":"#/$defs/NonEmptyString"}},"additionalProperties":false},"PutRoutingFactEdit":{"type":"object","required":["kind","fact","rationale"],"properties":{"kind":{"const":"put-routing-fact"},"fact":{"$ref":"#/$defs/AuthoredRoutingFact"},"rationale":{"$ref":"#/$defs/NonEmptyString"}},"additionalProperties":false},"RemoveRoutingFactEdit":{"type":"object","required":["kind","fact","rationale"],"properties":{"kind":{"const":"remove-routing-fact"},"fact":{"$ref":"#/$defs/CanonicalId"},"rationale":{"$ref":"#/$defs/NonEmptyString"}},"additionalProperties":false},"VerificationFailure":{"type":"object","additionalProperties":false,"required":["code","message","suite","check"],"properties":{"code":{"$ref":"#/$defs/NonEmptyString"},"message":{"$ref":"#/$defs/NonEmptyString"},"suite":{"type":["string","null"]},"check":{"type":["string","null"]}}},"VerificationReport":{"type":"object","additionalProperties":false,"required":["passed","exit_code","suites","checks","failures"],"properties":{"passed":{"type":"boolean"},"exit_code":{"enum":[0,1,2,3,4]},"suites":{"type":"integer","minimum":0},"checks":{"type":"integer","minimum":0},"failures":{"type":"array","items":{"$ref":"#/$defs/VerificationFailure"}}}},"VerifyRepositoryCall":{"type":"object","additionalProperties":false,"required":["kind","refresh_verification_inputs"],"properties":{"kind":{"const":"verify-repository"},"refresh_verification_inputs":{"type":"boolean"}}},"VerifyRepositoryResult":{"type":"object","additionalProperties":false,"required":["kind","refreshed_verification_inputs","verification"],"properties":{"kind":{"const":"verify-repository-result"},"refreshed_verification_inputs":{"type":"boolean"},"verification":{"$ref":"#/$defs/VerificationReport"}}},"VerifyProposalCall":{"type":"object","additionalProperties":false,"required":["kind","revision"],"properties":{"kind":{"const":"verify-proposal"},"revision":{"$ref":"#/$defs/ProposalRevisionHandle"},"readiness":{"$ref":"#/$defs/ReadinessHandle"}}},"VerifyProposalResult":{"type":"object","additionalProperties":false,"required":["kind","revision","verification"],"properties":{"kind":{"const":"verify-proposal-result"},"revision":{"$ref":"#/$defs/ProposalRevisionHandle"},"verification":{"$ref":"#/$defs/VerificationReport"},"readiness":{"$ref":"#/$defs/ReadinessHandle"}}},"RoutingConfiguration":{"type":"object","additionalProperties":false,"required":["facts","rules"],"properties":{"facts":{"type":"array","items":{"$ref":"#/$defs/AuthoredRoutingFact"}},"rules":{"type":"array","items":{"$ref":"#/$defs/AuthoredRoutingRule"}}}},"PolicyCoverageStatus":{"type":"object","required":["subject","requirement_id","status"],"properties":{"subject":{"$ref":"#/$defs/CanonicalId"},"requirement_id":{"$ref":"#/$defs/Digest"},"status":{"enum":["current-attestation","review-required"]},"authority":{"$ref":"#/$defs/CoverageAuditAuthority"}},"additionalProperties":false},"ReadCoverage":{"type":"object","description":"Repository attestation status bound to this snapshot or proposal. Empty subjects means no registered policy units in scope, not complete coverage. Analysis-local attestations are not repository certificates.","required":["subjects"],"properties":{"subjects":{"type":"array","items":{"$ref":"#/$defs/PolicyCoverageStatus"}}},"additionalProperties":false},"AuditPolicyUnitEdit":{"type":"object","required":["kind","policy","rationale"],"properties":{"kind":{"const":"audit-policy-unit"},"policy":{"$ref":"#/$defs/CanonicalId"},"rationale":{"$ref":"#/$defs/NonEmptyString"}},"additionalProperties":false},"CoverageAuditAuthority":{"type":"object","required":["issuer","principal","authorization_id"],"properties":{"issuer":{"$ref":"#/$defs/NonEmptyString"},"principal":{"$ref":"#/$defs/NonEmptyString"},"authorization_id":{"$ref":"#/$defs/NonEmptyString"}},"additionalProperties":false},"EvidenceCheckRetirement":{"type":"object","additionalProperties":false,"required":["suite","check"],"properties":{"suite":{"type":"string","minLength":1},"check":{"type":"string","minLength":1}}},"EvidenceSuiteDescription":{"type":"object","additionalProperties":false,"required":["suite","description"],"properties":{"suite":{"type":"string","minLength":1},"description":{"type":"string","minLength":1}}},"EvidenceRelationshipUpdate":{"type":"object","additionalProperties":false,"required":["source_policy","consumer","relation","evidence_owner","rationale"],"properties":{"source_policy":{"type":"string","minLength":1},"consumer":{"type":"string","minLength":1},"relation":{"type":"string","minLength":1},"evidence_owner":{"type":"string","minLength":1},"rationale":{"type":"string","minLength":1}}},"EvidenceConsumerRegistration":{"type":"object","additionalProperties":false,"required":["path","artifact_kind","source_policies","relation","evidence_owner","rationale"],"properties":{"path":{"type":"string","minLength":1},"artifact_kind":{"type":"string","enum":["implementation-artifact","fixture"]},"source_policies":{"type":"array","items":{"type":"string","minLength":1},"minItems":1,"uniqueItems":true},"relation":{"type":"string","enum":["implementation-projection","fixture-projection"]},"evidence_owner":{"type":"string","minLength":1},"rationale":{"type":"string","minLength":1}}},"EngineCertificateRetirement":{"type":"object","additionalProperties":false,"required":["subject","requirement_id","rationale"],"properties":{"subject":{"$ref":"#/$defs/CanonicalId"},"requirement_id":{"$ref":"#/$defs/Digest"},"rationale":{"$ref":"#/$defs/NonEmptyString"}}},"EvidenceMaintenancePlan":{"type":"object","additionalProperties":false,"required":["prune_stale_certificates","retire_suites","retire_checks","retire_inputs","suite_descriptions","replacement_evidence_owner","replacement_evidence_rationale","relationship_updates","consumer_registrations"],"properties":{"retire_engine_certificates":{"type":"array","items":{"$ref":"#/$defs/EngineCertificateRetirement"},"uniqueItems":true,"description":"Explicitly retire exact registered Engine-issued certificates by subject and requirement; preserve normative policy and consumer registrations."},"prune_stale_certificates":{"type":"boolean"},"retire_suites":{"type":"array","items":{"type":"string","minLength":1},"uniqueItems":true},"retire_checks":{"type":"array","items":{"$ref":"#/$defs/EvidenceCheckRetirement"}},"retire_inputs":{"type":"array","items":{"type":"string","minLength":1},"uniqueItems":true},"suite_descriptions":{"type":"array","items":{"$ref":"#/$defs/EvidenceSuiteDescription"}},"replacement_evidence_owner":{"type":"string","minLength":1},"replacement_evidence_rationale":{"type":"string","minLength":1},"relationship_updates":{"type":"array","items":{"$ref":"#/$defs/EvidenceRelationshipUpdate"}},"consumer_registrations":{"type":"array","items":{"$ref":"#/$defs/EvidenceConsumerRegistration"}},"unregister_policy_subjects":{"type":"array","items":{"type":"string","minLength":1},"uniqueItems":true,"description":"Remove selected review-subject registrations and their source relationships while preserving normative Markdown."}}},"MaintainEvidenceCall":{"type":"object","additionalProperties":false,"required":["kind","expected_revision","evidence","plan","apply"],"properties":{"kind":{"const":"maintain-evidence"},"expected_revision":{"type":"string","minLength":1},"evidence":{"type":"array","items":{"$ref":"#/$defs/EvidenceReference"},"minItems":1},"plan":{"$ref":"#/$defs/EvidenceMaintenancePlan"},"apply":{"type":"boolean"}}},"MaintainEvidenceResult":{"type":"object","additionalProperties":false,"required":["kind","applied","changed_files","removed_files","verification"],"properties":{"kind":{"const":"maintain-evidence-result"},"applied":{"type":"boolean"},"changed_files":{"type":"array","items":{"type":"string","minLength":1}},"removed_files":{"type":"array","items":{"type":"string","minLength":1}},"verification":{"$ref":"#/$defs/VerificationReport"}}},"RouteCall":{"type":"object","required":["facts"],"properties":{"facts":{"$ref":"#/$defs/RoutingFactAssertions"},"snapshot":{"$ref":"#/$defs/SnapshotHandle"},"content":{"$ref":"#/$defs/RouteContentSelection"},"detail":{"enum":["compact","full"],"description":"Compact authoring selection is default. Full returns the rule explanation. Application always retains its qualified projection."}},"additionalProperties":false},"ReadCall":{"type":"object","required":["target"],"properties":{"target":{"$ref":"#/$defs/CanonicalId"},"include_routing":{"type":"boolean"},"include_coverage":{"type":"boolean","description":"Include current repository attestation status for registered policy units in this read scope."},"snapshot":{"$ref":"#/$defs/SnapshotHandle"},"detail":{"enum":["compact","full"],"description":"Compact preserves exact policy and essential authority; full includes all relationship rows."}},"additionalProperties":false},"RelatedCall":{"type":"object","required":["target","groups","direction","transitive"],"properties":{"target":{"$ref":"#/$defs/CanonicalId"},"groups":{"type":"array","minItems":1,"uniqueItems":true,"items":{"$ref":"#/$defs/CanonicalId"}},"direction":{"enum":["incoming","outgoing","both"]},"transitive":{"type":"boolean","default":false},"snapshot":{"$ref":"#/$defs/SnapshotHandle"}},"additionalProperties":false},"CompactReadResult":{"type":"object","required":["kind","snapshot","policy","content","requires","specializes","next_operations","detail"],"properties":{"kind":{"const":"compact-read-result"},"snapshot":{"$ref":"#/$defs/SnapshotHandle"},"policy":{"$ref":"#/$defs/PolicySummary"},"content":{"type":"string"},"requires":{"type":"array","items":{"$ref":"#/$defs/CanonicalId"},"uniqueItems":true},"specializes":{"type":"array","items":{"$ref":"#/$defs/CanonicalId"},"uniqueItems":true},"next_operations":{"type":"array","items":{"$ref":"#/$defs/NextOperation"}},"summary":{"type":"string"},"routing":{"$ref":"#/$defs/RoutingConfiguration"},"coverage":{"$ref":"#/$defs/ReadCoverage"},"detail":{"const":"compact"},"application_exposure":{"$ref":"#/$defs/ApplicationExposureState"},"provenance":{"type":"array","items":{"$ref":"#/$defs/CanonicalId"}}},"additionalProperties":false},"RoutingFactsCall":{"type":"object","additionalProperties":false,"required":[],"properties":{"snapshot":{"$ref":"#/$defs/SnapshotHandle"}}},"RoutingFactsResult":{"type":"object","additionalProperties":false,"required":["kind","snapshot","facts"],"properties":{"kind":{"const":"routing-facts-result"},"snapshot":{"$ref":"#/$defs/SnapshotHandle"},"facts":{"type":"array","items":{"$ref":"#/$defs/AuthoredRoutingFact"}}}},"RoutingQuestion":{"type":"object","additionalProperties":false,"required":["id","kind","prompt","state","fact"],"properties":{"id":{"$ref":"#/$defs/CanonicalId"},"kind":{"const":"applicability-fact"},"prompt":{"$ref":"#/$defs/NonEmptyString"},"state":{"const":"required"},"fact":{"$ref":"#/$defs/AuthoredRoutingFact"}}},"RoutingRuleExplanation":{"type":"object","additionalProperties":false,"required":["id","target","when","state"],"properties":{"id":{"$ref":"#/$defs/CanonicalId"},"target":{"$ref":"#/$defs/CanonicalId"},"when":{"$ref":"#/$defs/ApplicabilityExpression"},"state":{"enum":["selected","unresolved"]}}},"AgentRouteResult":{"type":"object","required":["kind","snapshot","reading_plan","unresolved_questions","next_operations","facts","rules"],"properties":{"kind":{"const":"agent-route-result"},"snapshot":{"$ref":"#/$defs/SnapshotHandle"},"reading_plan":{"type":"array","items":{"$ref":"#/$defs/ReadingPlanEntry"}},"unresolved_questions":{"type":"array","items":{"$ref":"#/$defs/RoutingQuestion"}},"next_operations":{"type":"array","items":{"$ref":"#/$defs/NextOperation"}},"summary":{"type":"string"},"facts":{"$ref":"#/$defs/RoutingFactAssertions"},"rules":{"type":"array","items":{"$ref":"#/$defs/RoutingRuleExplanation"}},"content":{"$ref":"#/$defs/RoutedContentPage"}},"additionalProperties":false},"WorkflowContext":{"oneOf":[{"$ref":"#/$defs/ProposalRevisionHandle"},{"$ref":"#/$defs/AnalysisHandle"},{"$ref":"#/$defs/ReadinessHandle"}]},"ProposeCall":{"type":"object","additionalProperties":false,"properties":{"snapshot":{"$ref":"#/$defs/SnapshotHandle"},"change_set":{"$ref":"#/$defs/StandardsChangeSet"},"detail":{"enum":["compact","full"],"description":"Compact (default) returns an exact workflow summary; full returns complete analysis detail."}},"required":["change_set"]},"ReviseCall":{"type":"object","additionalProperties":false,"properties":{"context":{"$ref":"#/$defs/WorkflowContext"},"change_set":{"$ref":"#/$defs/StandardsChangeSet"},"detail":{"enum":["compact","full"],"description":"Compact (default) returns an exact workflow summary; full returns complete analysis detail."}},"required":["context","change_set"]},"AnalyzeCall":{"type":"object","additionalProperties":false,"properties":{"context":{"$ref":"#/$defs/WorkflowContext"},"detail":{"enum":["compact","full"],"description":"Compact (default) returns an exact workflow summary; full returns complete analysis detail."}},"required":["context"]},"ResolveWorkflowCall":{"type":"object","additionalProperties":false,"properties":{"context":{"$ref":"#/$defs/WorkflowContext"},"submission":{"$ref":"#/$defs/Submission"},"detail":{"enum":["compact","full"],"description":"Compact (default) returns an exact workflow summary; full returns complete analysis detail."}},"required":["context","submission"]},"ReviewCall":{"type":"object","additionalProperties":false,"properties":{"context":{"$ref":"#/$defs/WorkflowContext"},"decisions":{"type":"array","minItems":3,"maxItems":3,"uniqueItems":true,"items":{"$ref":"#/$defs/ReviewDecision"}},"detail":{"enum":["compact","full"],"description":"Compact (default) returns an exact workflow summary; full returns complete analysis detail."}},"required":["context","decisions"]},"ApplyCall":{"type":"object","additionalProperties":false,"properties":{"context":{"$ref":"#/$defs/WorkflowContext"},"detail":{"enum":["compact","full"],"description":"Compact (default) returns an exact workflow summary; full returns complete analysis detail."}},"required":["context"]},"RecoverCall":{"type":"object","additionalProperties":false,"properties":{"context":{"$ref":"#/$defs/WorkflowContext"},"action":{"enum":["observe","complete-publication"],"description":"Omit or select observe to reconcile only. Explicit complete-publication revalidates and attempts the same admitted candidate against its original expected target; it requires current publication authorization."},"detail":{"enum":["compact","full"],"description":"Compact (default) returns an exact workflow summary; full returns complete analysis detail."}},"required":["context"],"description":"Recover an admitted application. Observation performs no Git writes. Explicit completion reconstructs and verifies the exact admitted candidate before one compare-and-swap attempt."},"WorkflowStatusCall":{"type":"object","additionalProperties":false,"properties":{"context":{"$ref":"#/$defs/WorkflowContext"},"detail":{"enum":["compact","full"],"description":"Compact (default) returns an exact workflow summary; full returns complete analysis detail."}},"required":["context"]},"ResumeCall":{"type":"object","additionalProperties":false,"properties":{"context":{"$ref":"#/$defs/WorkflowContext"},"detail":{"enum":["compact","full"],"description":"Compact (default) returns an exact workflow summary; full returns complete analysis detail."}},"required":["context"]},"WorkflowContinuation":{"type":"object","additionalProperties":false,"properties":{"operation":{"enum":["revise","analyze","resolve_workflow","review","apply","recover","workflow_status","resume","resolve_many"]},"required_inputs":{"type":"array","uniqueItems":true,"items":{"enum":["change_set","submission","decisions","action","submissions"]}}},"required":["operation","required_inputs"],"description":"Select the named operation with the enclosing WorkflowResult context and explicit required inputs. This descriptor is not an authorization grant."},"WorkflowOutcome":{"oneOf":[{"$ref":"#/$defs/CreateProposalResult"},{"$ref":"#/$defs/ReviseProposalResult"},{"$ref":"#/$defs/PendingResult"},{"$ref":"#/$defs/CompleteResult"},{"$ref":"#/$defs/ReviewProposalResult"},{"$ref":"#/$defs/ApplyProposalResult"},{"$ref":"#/$defs/ApplicationRecoveryRequiredResult"},{"$ref":"#/$defs/RecoverApplicationResult"},{"$ref":"#/$defs/RejectedResult"},{"$ref":"#/$defs/WorkflowAnalysisSummary"}]},"WorkflowResult":{"type":"object","additionalProperties":false,"properties":{"kind":{"const":"workflow-result"},"context":{"$ref":"#/$defs/WorkflowContext"},"proposal":{"$ref":"#/$defs/ProposalHandle"},"revision":{"$ref":"#/$defs/ProposalRevisionHandle"},"publication":{"$ref":"#/$defs/ApplicationPublicationReceipt"},"checkout":{"$ref":"#/$defs/PublicationCheckoutObservation"},"status":{"enum":["draft","needs-action","complete","requires-change","ready","recovery-required","applied","rejected","stale"]},"next_operations":{"type":"array","items":{"$ref":"#/$defs/WorkflowContinuation"}},"outcome":{"$ref":"#/$defs/WorkflowOutcome"},"work":{"oneOf":[{"$ref":"#/$defs/WorkflowWorkPage"},{"$ref":"#/$defs/WorkflowWorkDeferred"}]}},"required":["kind","context","proposal","revision","status","next_operations"],"description":"Exact immutable workflow context and relative action descriptors. Successful compact pending propose, revise, analyze and decision submissions include work from the already-produced Analysis. Status observations, full results, stale contexts and other outcomes omit work."},"FocusedQueryNextOperation":{"type":"object","required":["operation","request_kind","snapshot"],"properties":{"operation":{"enum":["route","read","related"]},"request_kind":{"enum":["route","read","related"]},"target":{"$ref":"#/$defs/CanonicalId"},"snapshot":{"$ref":"#/$defs/SnapshotHandle"}},"additionalProperties":false},"RewriteNavigationIndexEdit":{"type":"object","required":["kind","entrypoint","destinations","rationale"],"properties":{"kind":{"const":"rewrite-navigation-index"},"entrypoint":{"$ref":"#/$defs/AuthoringTargetHandle"},"destinations":{"type":"array","items":{"$ref":"#/$defs/CanonicalId"},"minItems":1,"uniqueItems":true},"rationale":{"$ref":"#/$defs/NonEmptyString"},"retargets":{"type":"array","items":{"$ref":"#/$defs/NavigationRetarget"},"uniqueItems":true}},"additionalProperties":false},"NavigationIndexEntry":{"type":"object","required":["id","entrypoint","destinations"],"properties":{"id":{"$ref":"#/$defs/CanonicalId"},"entrypoint":{"$ref":"#/$defs/AuthoringTargetHandle"},"destinations":{"type":"array","items":{"$ref":"#/$defs/CanonicalId"},"uniqueItems":true},"content":{"$ref":"#/$defs/NonEmptyString"}},"additionalProperties":false},"NavigationIndexesResult":{"type":"object","required":["kind","authority","indexes","next_operations"],"properties":{"kind":{"const":"navigation-indexes-result"},"authority":{"oneOf":[{"$ref":"#/$defs/SnapshotHandle"},{"$ref":"#/$defs/ProposalRevisionHandle"}]},"indexes":{"type":"array","items":{"$ref":"#/$defs/NavigationIndexEntry"},"minItems":1},"next_operations":{"type":"array","items":{"$ref":"#/$defs/NextOperation"},"maxItems":0}},"additionalProperties":false},"NavigationRetarget":{"type":"object","required":["entrypoint","standard"],"properties":{"entrypoint":{"$ref":"#/$defs/AuthoringTargetHandle"},"standard":{"$ref":"#/$defs/CanonicalId"}},"additionalProperties":false},"ApplicationNextOperation":{"type":"object","additionalProperties":false,"required":["operation","snapshot"],"properties":{"operation":{"enum":["read","related","routing_facts","route","query","inspect"]},"snapshot":{"$ref":"#/$defs/SnapshotHandle"},"target":{"$ref":"#/$defs/CanonicalId"},"handle":{"$ref":"#/$defs/SnapshotChildHandle"}}},"ApplicationRejectedResult":{"type":"object","additionalProperties":false,"required":["kind","purpose","code","outcome","message","next_operations"],"properties":{"kind":{"const":"application-rejected-result"},"purpose":{"const":"application"},"code":{"enum":["APPLICATION.CONTENT_UNAVAILABLE","APPLICATION.INPUT_INVALID","APPLICATION.OPERATION_UNAVAILABLE","APPLICATION.INTERNAL_UNAVAILABLE","APPLICATION.UNSUPPORTED_CAPTURE","APPLICATION.RESULT_LIMIT","APPLICATION.UNKNOWN_GROUP"]},"outcome":{"enum":["invalid","unsupported","unavailable"]},"message":{"type":"string"},"next_operations":{"type":"array","items":{"$ref":"#/$defs/ApplicationNextOperation"}},"input_feedback":{"$ref":"#/$defs/InputFeedback"},"relationship_groups":{"$ref":"#/$defs/RelationshipGroupsResult"}}},"ApplicationPolicy":{"type":"object","additionalProperties":false,"required":["id","handle","role","level"],"properties":{"id":{"$ref":"#/$defs/CanonicalId"},"handle":{"$ref":"#/$defs/SnapshotChildHandle"},"role":{"enum":["core","router","topic","workflow","profile","reference","prompt","template","documentation"]},"level":{"enum":["MUST","SHOULD","PROFILE","REFERENCE"]}}},"ApplicationRelationship":{"type":"object","additionalProperties":false,"required":["handle","source","target","relation","groups","direction"],"properties":{"handle":{"$ref":"#/$defs/SnapshotChildHandle"},"source":{"$ref":"#/$defs/CanonicalId"},"target":{"$ref":"#/$defs/CanonicalId"},"relation":{"type":"string"},"groups":{"type":"array","items":{"$ref":"#/$defs/CanonicalId"}},"direction":{"enum":["incoming","outgoing"]}}},"ApplicationReadResult":{"type":"object","additionalProperties":false,"required":["kind","purpose","snapshot","policy","content","scope","requires","specializes","next_operations"],"properties":{"kind":{"const":"application-read-result"},"purpose":{"const":"application"},"snapshot":{"$ref":"#/$defs/SnapshotHandle"},"policy":{"$ref":"#/$defs/ApplicationPolicy"},"content":{"type":"string"},"scope":{"$ref":"#/$defs/ReviewScope"},"requires":{"type":"array","items":{"$ref":"#/$defs/CanonicalId"}},"specializes":{"type":"array","items":{"$ref":"#/$defs/CanonicalId"}},"related":{"type":"array","items":{"$ref":"#/$defs/ApplicationRelationship"}},"next_operations":{"type":"array","items":{"$ref":"#/$defs/ApplicationNextOperation"}}}},"ApplicationRelatedResult":{"type":"object","additionalProperties":false,"required":["kind","purpose","snapshot","target","relationships","next_operations"],"properties":{"kind":{"const":"application-related-result"},"purpose":{"const":"application"},"snapshot":{"$ref":"#/$defs/SnapshotHandle"},"target":{"$ref":"#/$defs/CanonicalId"},"relationships":{"type":"array","items":{"$ref":"#/$defs/ApplicationRelationship"}},"next_operations":{"type":"array","items":{"$ref":"#/$defs/ApplicationNextOperation"}}}},"ApplicationReadingEntry":{"type":"object","additionalProperties":false,"required":["target","scope","authority","state"],"properties":{"target":{"$ref":"#/$defs/CanonicalId"},"scope":{"$ref":"#/$defs/ReviewScope"},"authority":{"enum":["normative","contextual"]},"state":{"const":"selected"}}},"ApplicationQuestion":{"type":"object","additionalProperties":false,"required":["fact"],"properties":{"fact":{"$ref":"#/$defs/AuthoredRoutingFact"}}},"ApplicationRouteResult":{"type":"object","additionalProperties":false,"required":["kind","purpose","snapshot","status","reading_plan","unresolved_questions","next_operations"],"properties":{"kind":{"const":"application-route-result"},"purpose":{"const":"application"},"snapshot":{"$ref":"#/$defs/SnapshotHandle"},"status":{"enum":["complete","needs-facts"]},"reading_plan":{"type":"array","items":{"$ref":"#/$defs/ApplicationReadingEntry"}},"unresolved_questions":{"type":"array","items":{"$ref":"#/$defs/ApplicationQuestion"}},"next_operations":{"type":"array","items":{"$ref":"#/$defs/ApplicationNextOperation"}},"content":{"$ref":"#/$defs/ApplicationRoutedContentPage"}}},"ApplicationRoutingFactsResult":{"type":"object","additionalProperties":false,"required":["kind","purpose","snapshot","facts","next_operations"],"properties":{"kind":{"const":"application-routing-facts-result"},"purpose":{"const":"application"},"snapshot":{"$ref":"#/$defs/SnapshotHandle"},"facts":{"type":"array","items":{"$ref":"#/$defs/AuthoredRoutingFact"}},"next_operations":{"type":"array","items":{"$ref":"#/$defs/ApplicationNextOperation"}}}},"ApplicationReadCall":{"type":"object","additionalProperties":false,"required":["target"],"properties":{"target":{"$ref":"#/$defs/CanonicalId"},"snapshot":{"$ref":"#/$defs/SnapshotHandle"},"detail":{"enum":["compact","full"]}}},"ApplicationReadRequest":{"type":"object","additionalProperties":false,"required":["kind","target"],"properties":{"kind":{"const":"read"},"target":{"$ref":"#/$defs/CanonicalId"},"detail":{"enum":["compact","full"]}}},"ApplicationQueryRequest":{"oneOf":[{"$ref":"#/$defs/RouteRequest"},{"$ref":"#/$defs/ApplicationReadRequest"},{"$ref":"#/$defs/RelatedRequest"}]},"ApplicationQueryCall":{"type":"object","additionalProperties":false,"required":["snapshot","request"],"properties":{"snapshot":{"$ref":"#/$defs/SnapshotHandle"},"request":{"$ref":"#/$defs/ApplicationQueryRequest"}}},"ApplicationInspectCall":{"type":"object","additionalProperties":false,"required":["handle"],"properties":{"handle":{"$ref":"#/$defs/SnapshotChildHandle"}}},"AuthoredDecisionProvenance":{"type":"object","additionalProperties":false,"required":["id","subject","origin","rationale","evidence"],"properties":{"id":{"$ref":"#/$defs/CanonicalId"},"subject":{"$ref":"#/$defs/CanonicalId"},"origin":{"enum":["documented-original","reconstructed-history","current-justification","unrecorded"]},"rationale":{"type":"string"},"evidence":{"type":"array","items":{"$ref":"#/$defs/EvidenceReference"}},"assumptions":{"type":"array","items":{"type":"string"}},"limits":{"type":"array","items":{"type":"string"}},"alternatives":{"type":"array","items":{"type":"string"}},"reconsideration":{"type":"array","items":{"type":"string"}},"supersedes":{"type":"array","items":{"type":"string"}}}},"DecisionProvenanceRecord":{"type":"object","additionalProperties":false,"required":["id","subject","origin","rationale","evidence","assumptions","limits","alternatives","reconsideration","supersedes","subject_binding","retired"],"properties":{"id":{"$ref":"#/$defs/CanonicalId"},"subject":{"$ref":"#/$defs/CanonicalId"},"origin":{"enum":["documented-original","reconstructed-history","current-justification","unrecorded"]},"rationale":{"type":"string"},"evidence":{"type":"array","items":{"$ref":"#/$defs/EvidenceReference"}},"assumptions":{"type":"array","items":{"type":"string"}},"limits":{"type":"array","items":{"type":"string"}},"alternatives":{"type":"array","items":{"type":"string"}},"reconsideration":{"type":"array","items":{"type":"string"}},"supersedes":{"type":"array","items":{"type":"string"}},"subject_binding":{"$ref":"#/$defs/Digest"},"retired":{"type":"boolean"}}},"ApplicationExposureState":{"enum":["unreviewed","current","needs-review"]},"ProvenanceReadResult":{"type":"object","additionalProperties":false,"required":["kind","authority","record","state","next_operations"],"properties":{"kind":{"const":"provenance-read-result"},"authority":{"oneOf":[{"$ref":"#/$defs/SnapshotHandle"},{"$ref":"#/$defs/ProposalRevisionHandle"}]},"record":{"$ref":"#/$defs/DecisionProvenanceRecord"},"state":{"enum":["current","needs-review","retired"]},"next_operations":{"type":"array","items":{"$ref":"#/$defs/NextOperation"}}}},"OperationalReadResult":{"type":"object","additionalProperties":false,"required":["kind","authority","target","canonical_id","role","content","application_exposure","next_operations"],"properties":{"kind":{"const":"operational-read-result"},"authority":{"oneOf":[{"$ref":"#/$defs/SnapshotHandle"},{"$ref":"#/$defs/ProposalRevisionHandle"}]},"target":{"$ref":"#/$defs/AuthoringTargetHandle"},"canonical_id":{"$ref":"#/$defs/CanonicalId"},"role":{"enum":["prompt","template","documentation"]},"content":{"type":"string"},"application_exposure":{"$ref":"#/$defs/ApplicationExposureState"},"next_operations":{"type":"array","items":{"$ref":"#/$defs/NextOperation"}}}},"PutDecisionProvenanceEdit":{"type":"object","additionalProperties":false,"required":["kind","record"],"properties":{"kind":{"const":"put-provenance"},"record":{"$ref":"#/$defs/AuthoredDecisionProvenance"}}},"RetireDecisionProvenanceEdit":{"type":"object","additionalProperties":false,"required":["kind","id"],"properties":{"kind":{"const":"retire-provenance"},"id":{"$ref":"#/$defs/CanonicalId"}}},"ApproveApplicationContentEdit":{"type":"object","additionalProperties":false,"required":["kind","target"],"properties":{"kind":{"const":"approve-application-content"},"target":{"oneOf":[{"$ref":"#/$defs/CanonicalId"},{"$ref":"#/$defs/AuthoringTargetHandle"}]}}},"WithdrawApplicationContentEdit":{"type":"object","additionalProperties":false,"required":["kind","target"],"properties":{"kind":{"const":"withdraw-application-content"},"target":{"oneOf":[{"$ref":"#/$defs/CanonicalId"},{"$ref":"#/$defs/AuthoringTargetHandle"}]}}},"ReviseOperationalArtifactEdit":{"type":"object","additionalProperties":false,"required":["kind","target","title","body"],"properties":{"kind":{"const":"revise-operational-artifact"},"target":{"oneOf":[{"$ref":"#/$defs/CanonicalId"},{"$ref":"#/$defs/AuthoringTargetHandle"}]},"title":{"$ref":"#/$defs/NonEmptyString"},"body":{"type":"string"}}},"PolicyScopeUpdate":{"type":"object","additionalProperties":false,"required":["policy","heading_path","semantics"],"properties":{"policy":{"$ref":"#/$defs/CanonicalId"},"heading_path":{"type":"array","minItems":1,"items":{"$ref":"#/$defs/NonEmptyString"}},"semantics":{"$ref":"#/$defs/PolicySemanticIntent"}}},"ReadManyItem":{"type":"object","required":["target"],"properties":{"target":{"$ref":"#/$defs/CanonicalId"},"include_routing":{"type":"boolean"},"include_coverage":{"type":"boolean","description":"Include current repository attestation status for registered policy units in this read scope."},"detail":{"enum":["compact","full"],"description":"Compact preserves exact policy and essential authority; full includes all relationship rows."}},"additionalProperties":false},"ReadManyCall":{"type":"object","additionalProperties":false,"required":["snapshot","items"],"description":"Read 1–32 selected items from one explicit snapshot, preserving order. The complete JSON result is limited to 2 MiB; any failed item rejects the entire request.","properties":{"snapshot":{"$ref":"#/$defs/SnapshotHandle"},"items":{"type":"array","minItems":1,"maxItems":32,"uniqueItems":true,"items":{"$ref":"#/$defs/ReadManyItem"}}}},"ReadManyResult":{"type":"object","additionalProperties":false,"required":["kind","snapshot","items"],"properties":{"kind":{"const":"read-many-result"},"snapshot":{"$ref":"#/$defs/SnapshotHandle"},"items":{"type":"array","minItems":1,"maxItems":32,"items":{"oneOf":[{"$ref":"#/$defs/CompactReadResult"},{"$ref":"#/$defs/ReadResult"},{"$ref":"#/$defs/NavigationIndexesResult"},{"$ref":"#/$defs/ProvenanceReadResult"},{"$ref":"#/$defs/OperationalReadResult"}]}}}},"ApplicationReadManyItem":{"type":"object","additionalProperties":false,"required":["target"],"properties":{"target":{"$ref":"#/$defs/CanonicalId"},"detail":{"enum":["compact","full"]}}},"ApplicationReadManyCall":{"type":"object","additionalProperties":false,"required":["snapshot","items"],"description":"Read 1–32 selected items from one explicit snapshot, preserving order. The complete JSON result is limited to 2 MiB; any failed item rejects the entire request.","properties":{"snapshot":{"$ref":"#/$defs/SnapshotHandle"},"items":{"type":"array","minItems":1,"maxItems":32,"uniqueItems":true,"items":{"$ref":"#/$defs/ApplicationReadManyItem"}}}},"ApplicationReadManyResult":{"type":"object","additionalProperties":false,"required":["kind","snapshot","items","purpose"],"properties":{"kind":{"const":"application-read-many-result"},"snapshot":{"$ref":"#/$defs/SnapshotHandle"},"items":{"type":"array","minItems":1,"maxItems":32,"items":{"oneOf":[{"$ref":"#/$defs/ApplicationReadResult"}]}},"purpose":{"const":"application"}}},"RegisterConsumerEdit":{"type":"object","additionalProperties":false,"required":["kind","consumer","path","artifact_kind","authority"],"properties":{"kind":{"const":"register-consumer"},"consumer":{"$ref":"#/$defs/CanonicalId"},"path":{"$ref":"#/$defs/NonEmptyString"},"artifact_kind":{"enum":["fixture","documentation","implementation-artifact","prompt","template"]},"authority":{"enum":["evidence","projection"]}},"description":"Register an existing tracked consumer within this proposal. The Engine captures original-revision bytes; use separate policy relationships to declare consumers and review obligations."},"PreviewApplicationCall":{"type":"object","additionalProperties":false,"required":["revision","request"],"properties":{"revision":{"$ref":"#/$defs/ProposalRevisionHandle"},"request":{"$ref":"#/$defs/ApplicationQueryRequest"}},"description":"Authoring-only inspection of an exact draft through application qualification and filtering; this observation neither publishes nor grants ordinary application access."},"CandidateApplicationNextOperation":{"type":"object","additionalProperties":false,"required":["operation","revision","request"],"properties":{"operation":{"const":"preview_application"},"revision":{"$ref":"#/$defs/ProposalRevisionHandle"},"request":{"$ref":"#/$defs/ApplicationQueryRequest"}}},"CandidateApplicationPolicy":{"type":"object","additionalProperties":false,"required":["id","role","level"],"properties":{"id":{"$ref":"#/$defs/CanonicalId"},"role":{"enum":["core","router","topic","workflow","profile","reference","prompt","template","documentation"]},"level":{"enum":["MUST","SHOULD","PROFILE","REFERENCE"]}}},"CandidateApplicationRelationship":{"type":"object","additionalProperties":false,"required":["source","target","relation","groups","direction"],"properties":{"source":{"$ref":"#/$defs/CanonicalId"},"target":{"$ref":"#/$defs/CanonicalId"},"relation":{"type":"string"},"groups":{"type":"array","items":{"$ref":"#/$defs/CanonicalId"}},"direction":{"enum":["incoming","outgoing"]}}},"CandidateApplicationReadResult":{"type":"object","additionalProperties":false,"required":["kind","purpose","policy","content","scope","requires","specializes","next_operations","revision"],"properties":{"kind":{"const":"candidate-application-read-result"},"purpose":{"const":"application"},"policy":{"$ref":"#/$defs/CandidateApplicationPolicy"},"content":{"type":"string"},"scope":{"$ref":"#/$defs/ReviewScope"},"requires":{"type":"array","items":{"$ref":"#/$defs/CanonicalId"}},"specializes":{"type":"array","items":{"$ref":"#/$defs/CanonicalId"}},"related":{"type":"array","items":{"$ref":"#/$defs/CandidateApplicationRelationship"}},"next_operations":{"type":"array","items":{"$ref":"#/$defs/CandidateApplicationNextOperation"}},"revision":{"$ref":"#/$defs/ProposalRevisionHandle"}}},"CandidateApplicationRelatedResult":{"type":"object","additionalProperties":false,"required":["kind","purpose","target","relationships","next_operations","revision"],"properties":{"kind":{"const":"candidate-application-related-result"},"purpose":{"const":"application"},"target":{"$ref":"#/$defs/CanonicalId"},"relationships":{"type":"array","items":{"$ref":"#/$defs/CandidateApplicationRelationship"}},"next_operations":{"type":"array","items":{"$ref":"#/$defs/CandidateApplicationNextOperation"}},"revision":{"$ref":"#/$defs/ProposalRevisionHandle"}}},"CandidateApplicationRouteResult":{"type":"object","additionalProperties":false,"required":["kind","purpose","status","reading_plan","unresolved_questions","next_operations","revision"],"properties":{"kind":{"const":"candidate-application-route-result"},"purpose":{"const":"application"},"status":{"enum":["complete","needs-facts"]},"reading_plan":{"type":"array","items":{"$ref":"#/$defs/ApplicationReadingEntry"}},"unresolved_questions":{"type":"array","items":{"$ref":"#/$defs/ApplicationQuestion"}},"next_operations":{"type":"array","items":{"$ref":"#/$defs/CandidateApplicationNextOperation"}},"revision":{"$ref":"#/$defs/ProposalRevisionHandle"}}},"CandidateApplicationRejectedResult":{"type":"object","additionalProperties":false,"required":["kind","purpose","code","outcome","message","next_operations","revision"],"properties":{"kind":{"const":"candidate-application-rejected-result"},"purpose":{"const":"application"},"code":{"enum":["APPLICATION.CONTENT_UNAVAILABLE","APPLICATION.INPUT_INVALID","APPLICATION.OPERATION_UNAVAILABLE","APPLICATION.INTERNAL_UNAVAILABLE","APPLICATION.UNSUPPORTED_CAPTURE","APPLICATION.RESULT_LIMIT"]},"outcome":{"enum":["invalid","unsupported","unavailable"]},"message":{"type":"string"},"next_operations":{"type":"array","items":{"$ref":"#/$defs/CandidateApplicationNextOperation"}},"revision":{"$ref":"#/$defs/ProposalRevisionHandle"}}},"PreviewApplicationResult":{"oneOf":[{"$ref":"#/$defs/CandidateApplicationReadResult"},{"$ref":"#/$defs/CandidateApplicationRelatedResult"},{"$ref":"#/$defs/CandidateApplicationRouteResult"},{"$ref":"#/$defs/CandidateApplicationRejectedResult"}]},"ResolveManyCall":{"type":"object","additionalProperties":false,"properties":{"context":{"$ref":"#/$defs/AnalysisHandle"},"submissions":{"type":"array","items":{"$ref":"#/$defs/Submission"},"minItems":1,"maxItems":128},"detail":{"enum":["compact","full"]}},"required":["context","submissions"],"description":"Resolve ordered decisions bound to one original analysis. Validate every item before publishing a final immutable successor; an invalid batch persists no intermediate decisions."},"WorkflowSection":{"enum":["pending_obligations","obligations","fact_requirements","coverage_certificates","dispositions","fact_observations","reading_plan","changed_units"]},"WorkflowAnalysisSummary":{"type":"object","additionalProperties":false,"properties":{"kind":{"const":"workflow-analysis-summary"},"status":{"enum":["needs-action","complete"]},"required_obligations":{"type":"integer","minimum":0},"pending_facts":{"type":"integer","minimum":0},"sections":{"type":"array","items":{"$ref":"#/$defs/WorkflowSectionCount"}},"details":{"$ref":"#/$defs/WorkflowDetailsLink"}},"required":["kind","status","required_obligations","pending_facts","sections","details"],"description":"Counts for the enclosing immutable Analysis context. Observation remains summary-only; successful compact pending mutations additionally return a bounded work page."},"WorkflowSectionCount":{"type":"object","additionalProperties":false,"properties":{"section":{"$ref":"#/$defs/WorkflowSection"},"count":{"type":"integer","minimum":0}},"required":["section","count"]},"WorkflowDetailsLink":{"type":"object","additionalProperties":false,"properties":{"operation":{"const":"workflow_details"}},"required":["operation"],"description":"Supply the enclosing WorkflowResult Analysis context as analysis and explicitly select a section."},"WorkflowDetailsCall":{"type":"object","additionalProperties":false,"properties":{"analysis":{"$ref":"#/$defs/AnalysisHandle"},"section":{"$ref":"#/$defs/WorkflowSection"},"offset":{"type":"integer","minimum":0},"limit":{"type":"integer","minimum":1,"maximum":16},"observation":{"$ref":"#/$defs/Digest"},"detail":{"enum":["compact","full"],"description":"Compact is byte-bounded; full explicitly retrieves one whole record without the compact byte cap."}},"required":["analysis","section"],"description":"Read a section of an immutable historical Analysis. Compact pages (default eight items) contain up to 16 whole records and 64 KiB of result JSON, returning fewer items when needed. An oversized record returns an explicit full-detail retry. detail=full retrieves one complete record (limit omitted or 1) without the compact byte cap; choose it only when the client can receive that payload. Continuations bind the Analysis, section and projected contents. Decision and publication operations check current evidence and authorization. A full-record response resumes compact paging in its next request."},"WorkflowDetailItem":{"oneOf":[{"$ref":"#/$defs/Obligation"},{"$ref":"#/$defs/FactRequirementWork"},{"$ref":"#/$defs/CoverageCertificate"},{"$ref":"#/$defs/DispositionRecord"},{"$ref":"#/$defs/FactObservation"},{"$ref":"#/$defs/ReadingPlanEntry"},{"$ref":"#/$defs/ChangedPolicyUnit"},{"$ref":"#/$defs/WorkflowObligationWork"}]},"WorkflowDetailsResult":{"type":"object","additionalProperties":false,"properties":{"kind":{"const":"workflow-details-result"},"analysis":{"$ref":"#/$defs/AnalysisHandle"},"section":{"$ref":"#/$defs/WorkflowSection"},"observation":{"$ref":"#/$defs/Digest"},"offset":{"type":"integer","minimum":0},"total":{"type":"integer","minimum":0},"items":{"type":"array","items":{"$ref":"#/$defs/WorkflowDetailItem"},"maxItems":16},"next":{"$ref":"#/$defs/WorkflowDetailsCall"}},"required":["kind","analysis","section","observation","offset","total","items"],"description":"Whole records from an immutable Analysis section. Compact may return fewer than limit to respect 64 KiB. Full returns at most one complete record and may exceed 64 KiB. Follow next exactly; observation and total are independent of page size and detail mode."},"RuntimeInfoCall":{"type":"object","additionalProperties":false,"properties":{"expected_catalog":{"$ref":"#/$defs/Digest"}},"required":[]},"RuntimeInfoResult":{"type":"object","additionalProperties":false,"properties":{"kind":{"const":"runtime-info-result"},"purpose":{"enum":["application","authoring"]},"interface_version":{"type":"integer","minimum":1},"implementation_version":{"type":"string","minLength":1},"instance_id":{"type":"string","minLength":1},"implementation_digest":{"$ref":"#/$defs/Digest"},"catalog_digest":{"$ref":"#/$defs/Digest"},"schema_digest":{"$ref":"#/$defs/Digest"},"installation_state":{"enum":["current","restart-required","unavailable"]},"client_catalog_state":{"enum":["unspecified","matches","differs"]},"action":{"enum":["reuse","restart-and-reconnect","refresh-tools","check-installation"]}},"required":["kind","purpose","interface_version","implementation_version","instance_id","implementation_digest","catalog_digest","schema_digest","installation_state","client_catalog_state","action"]},"WorkflowObligationWork":{"type":"object","additionalProperties":false,"properties":{"kind":{"const":"workflow-obligation-work"},"obligation":{"$ref":"#/$defs/Obligation"},"work":{"$ref":"#/$defs/AnalysisChildHandle"}},"required":["kind","obligation","work"]},"WorkflowDetailsNextOperation":{"type":"object","additionalProperties":false,"properties":{"operation":{"const":"workflow_details"},"request_kind":{"const":"workflow-details"},"request":{"$ref":"#/$defs/WorkflowDetailsCall"}},"required":["operation","request_kind","request"],"description":"An explicit historical detail retrieval alternative. Invoke operation with request; do not automatically select size-unbounded full detail."},"WorkflowDetailsSelection":{"type":"object","additionalProperties":false,"properties":{"section":{"$ref":"#/$defs/WorkflowSection"},"offset":{"type":"integer","minimum":0},"limit":{"type":"integer","minimum":1,"maximum":16},"observation":{"$ref":"#/$defs/Digest"},"detail":{"enum":["compact","full"],"description":"Compact is byte-bounded; full explicitly retrieves one whole record without the compact byte cap."}},"required":["section"],"description":"A workflow_details selection relative to the enclosing WorkflowResult Analysis context. Add analysis from that context when invoking; preserve every returned selection field."},"WorkflowWorkPage":{"type":"object","additionalProperties":false,"description":"First actionable section of a successful compact pending mutation, bound to the enclosing Analysis context. Facts precede obligations. Up to eight whole items and 64 KiB of page JSON; next is a relative workflow_details selection. Work handles retain their complete authority.","properties":{"kind":{"const":"workflow-work-page"},"section":{"enum":["fact_requirements","pending_obligations"]},"observation":{"$ref":"#/$defs/Digest"},"offset":{"const":0},"total":{"type":"integer","minimum":0},"items":{"type":"array","maxItems":8,"items":{"oneOf":[{"$ref":"#/$defs/FactRequirementWork"},{"$ref":"#/$defs/WorkflowObligationWork"}]}},"next":{"$ref":"#/$defs/WorkflowDetailsSelection"}},"required":["kind","section","observation","offset","total","items"]},"WorkflowWorkDeferred":{"type":"object","additionalProperties":false,"description":"The mutation succeeded but its first complete work record exceeds the compact page budget. Preserve the enclosing context and counts; request explicitly selects that exact full record without the compact byte cap.","properties":{"kind":{"const":"workflow-work-deferred"},"code":{"const":"WORKFLOW.RESULT_LIMIT"},"section":{"enum":["fact_requirements","pending_obligations"]},"total":{"type":"integer","minimum":0},"request":{"$ref":"#/$defs/WorkflowDetailsSelection"}},"required":["kind","code","section","total","request"]},"AgentAuthoredDecisionProvenance":{"type":"object","additionalProperties":false,"required":["id","subject","origin","rationale","evidence"],"properties":{"id":{"$ref":"#/$defs/CanonicalId"},"subject":{"$ref":"#/$defs/CanonicalId"},"origin":{"enum":["documented-original","reconstructed-history","current-justification","unrecorded"]},"rationale":{"type":"string"},"evidence":{"type":"array","items":{"$ref":"#/$defs/AgentEvidenceReference"}},"assumptions":{"type":"array","items":{"type":"string"}},"limits":{"type":"array","items":{"type":"string"}},"alternatives":{"type":"array","items":{"type":"string"}},"reconsideration":{"type":"array","items":{"type":"string"}},"supersedes":{"type":"array","items":{"type":"string"}}}},"AgentConsumerDispositionSubmission":{"type":"object","required":["kind","obligation","result","rationale","evidence","fingerprint"],"properties":{"kind":{"const":"consumer-disposition"},"obligation":{"$ref":"#/$defs/AnalysisChildHandle"},"result":{"enum":["updated","reviewed-no-change","not-applicable","blocked"]},"rationale":{"$ref":"#/$defs/NonEmptyString"},"evidence":{"type":"array","items":{"$ref":"#/$defs/AgentEvidenceReference"},"minItems":1},"fingerprint":{"$ref":"#/$defs/DecisionFingerprint"}},"additionalProperties":false},"AgentCoverageAttestationClaim":{"type":"object","required":["requirement","conclusion","evidence","explicit_exclusions","rationale","auditor_provenance"],"properties":{"requirement":{"$ref":"#/$defs/AnalysisChildHandle"},"conclusion":{"const":"complete"},"evidence":{"type":"array","items":{"$ref":"#/$defs/AgentEvidenceReference"},"minItems":1,"uniqueItems":true},"explicit_exclusions":{"type":"array","items":{"$ref":"#/$defs/AgentEvidenceReference"},"uniqueItems":true},"rationale":{"$ref":"#/$defs/NonEmptyString"},"auditor_provenance":{"$ref":"#/$defs/NonEmptyString"}},"additionalProperties":false},"AgentCoverageAttestationSubmission":{"type":"object","required":["kind","claim"],"properties":{"kind":{"const":"coverage-attestation"},"claim":{"$ref":"#/$defs/AgentCoverageAttestationClaim"}},"additionalProperties":false},"AgentImpactDispositionSubmission":{"type":"object","required":["kind","obligation","result","rationale","evidence","fingerprint"],"properties":{"kind":{"const":"impact-disposition"},"obligation":{"$ref":"#/$defs/AnalysisChildHandle"},"result":{"enum":["confirmed","resolved-no-impact","requires-change","blocked"]},"rationale":{"$ref":"#/$defs/NonEmptyString"},"evidence":{"type":"array","items":{"$ref":"#/$defs/AgentEvidenceReference"},"minItems":1},"fingerprint":{"$ref":"#/$defs/DecisionFingerprint"}},"additionalProperties":false},"AgentProposeCall":{"type":"object","additionalProperties":false,"properties":{"snapshot":{"$ref":"#/$defs/SnapshotHandle"},"change_set":{"$ref":"#/$defs/AgentStandardsChangeSet"},"detail":{"enum":["compact","full"],"description":"Compact (default) returns an exact workflow summary; full returns complete analysis detail."},"evidence":{"$ref":"#/$defs/RequestEvidenceTable"}},"required":["change_set"]},"AgentProvideFactSubmission":{"type":"object","required":["kind","requirement","value","evidence"],"properties":{"kind":{"const":"provide-fact"},"requirement":{"$ref":"#/$defs/AnalysisChildHandle"},"value":{"$ref":"#/$defs/FactValue"},"evidence":{"type":"array","items":{"$ref":"#/$defs/AgentEvidenceReference"},"minItems":1,"uniqueItems":true}},"additionalProperties":false},"AgentPutDecisionProvenanceEdit":{"type":"object","additionalProperties":false,"required":["kind","record"],"properties":{"kind":{"const":"put-provenance"},"record":{"$ref":"#/$defs/AgentAuthoredDecisionProvenance"}}},"AgentRelationshipDisposition":{"type":"object","required":["relationship","disposition","rationale","evidence"],"properties":{"relationship":{"$ref":"#/$defs/RelationshipKey"},"disposition":{"enum":["remove","retarget"]},"replacement_consumer":{"$ref":"#/$defs/RelationshipConsumer"},"rationale":{"$ref":"#/$defs/NonEmptyString"},"evidence":{"type":"array","minItems":1,"uniqueItems":true,"items":{"$ref":"#/$defs/AgentEvidenceReference"}}},"additionalProperties":false},"AgentResolveManyCall":{"type":"object","additionalProperties":false,"properties":{"context":{"$ref":"#/$defs/AnalysisHandle"},"submissions":{"type":"array","items":{"$ref":"#/$defs/AgentSubmission"},"minItems":1,"maxItems":128},"detail":{"enum":["compact","full"]},"evidence":{"$ref":"#/$defs/RequestEvidenceTable"}},"required":["context","submissions"],"description":"Resolve ordered decisions bound to one original analysis. Validate every item before publishing a final immutable successor; an invalid batch persists no intermediate decisions."},"AgentResolveWorkflowCall":{"type":"object","additionalProperties":false,"properties":{"context":{"$ref":"#/$defs/WorkflowContext"},"submission":{"$ref":"#/$defs/AgentSubmission"},"detail":{"enum":["compact","full"],"description":"Compact (default) returns an exact workflow summary; full returns complete analysis detail."},"evidence":{"$ref":"#/$defs/RequestEvidenceTable"}},"required":["context","submission"]},"AgentRetirePolicyUnitEdit":{"type":"object","required":["kind","policy","retired_semantic_revision","successors","relationship_dispositions","evidence"],"properties":{"kind":{"const":"retire-policy-unit"},"policy":{"$ref":"#/$defs/CanonicalId"},"retired_semantic_revision":{"type":"integer","minimum":1},"successors":{"type":"array","uniqueItems":true,"items":{"$ref":"#/$defs/CanonicalId"}},"relationship_dispositions":{"type":"array","uniqueItems":true,"items":{"$ref":"#/$defs/AgentRelationshipDisposition"}},"evidence":{"type":"array","minItems":1,"uniqueItems":true,"items":{"$ref":"#/$defs/AgentEvidenceReference"}}},"additionalProperties":false},"AgentRetireStandardEdit":{"type":"object","required":["kind","standard","successors","relationship_dispositions","evidence"],"properties":{"kind":{"const":"retire-standard"},"standard":{"$ref":"#/$defs/CanonicalId"},"successors":{"type":"array","uniqueItems":true,"items":{"$ref":"#/$defs/CanonicalId"}},"relationship_dispositions":{"type":"array","uniqueItems":true,"items":{"$ref":"#/$defs/AgentRelationshipDisposition"}},"evidence":{"type":"array","minItems":1,"uniqueItems":true,"items":{"$ref":"#/$defs/AgentEvidenceReference"}}},"additionalProperties":false},"AgentReviewCall":{"type":"object","additionalProperties":false,"properties":{"context":{"$ref":"#/$defs/WorkflowContext"},"decisions":{"type":"array","minItems":3,"maxItems":3,"uniqueItems":true,"items":{"$ref":"#/$defs/AgentReviewDecision"}},"detail":{"enum":["compact","full"],"description":"Compact (default) returns an exact workflow summary; full returns complete analysis detail."},"evidence":{"$ref":"#/$defs/RequestEvidenceTable"}},"required":["context","decisions"]},"AgentReviewDecision":{"type":"object","required":["owner","decision","rationale","evidence"],"properties":{"owner":{"enum":["consumer","impact","audit"]},"decision":{"const":"accept"},"rationale":{"$ref":"#/$defs/NonEmptyString"},"evidence":{"type":"array","minItems":1,"uniqueItems":true,"items":{"$ref":"#/$defs/AgentEvidenceReference"}}},"additionalProperties":false},"AgentReviseCall":{"type":"object","additionalProperties":false,"properties":{"context":{"$ref":"#/$defs/WorkflowContext"},"change_set":{"$ref":"#/$defs/AgentStandardsChangeSet"},"detail":{"enum":["compact","full"],"description":"Compact (default) returns an exact workflow summary; full returns complete analysis detail."},"evidence":{"$ref":"#/$defs/RequestEvidenceTable"}},"required":["context","change_set"]},"AgentStandardEdit":{"oneOf":[{"$ref":"#/$defs/CreateStandardEdit"},{"$ref":"#/$defs/RegisterPolicyUnitEdit"},{"$ref":"#/$defs/ReviseStandardEdit"},{"$ref":"#/$defs/RevisePolicyUnitEdit"},{"$ref":"#/$defs/MovePolicyUnitEdit"},{"$ref":"#/$defs/AgentRetirePolicyUnitEdit"},{"$ref":"#/$defs/AgentRetireStandardEdit"},{"$ref":"#/$defs/ReplaceStandardRelationshipsEdit"},{"$ref":"#/$defs/PutPolicyRelationshipEdit"},{"$ref":"#/$defs/RemovePolicyRelationshipEdit"},{"$ref":"#/$defs/PutRoutingRuleEdit"},{"$ref":"#/$defs/RemoveRoutingRuleEdit"},{"$ref":"#/$defs/PutRoutingFactEdit"},{"$ref":"#/$defs/RemoveRoutingFactEdit"},{"$ref":"#/$defs/AuditPolicyUnitEdit"},{"$ref":"#/$defs/RewriteNavigationIndexEdit"},{"$ref":"#/$defs/AgentPutDecisionProvenanceEdit"},{"$ref":"#/$defs/RetireDecisionProvenanceEdit"},{"$ref":"#/$defs/ApproveApplicationContentEdit"},{"$ref":"#/$defs/WithdrawApplicationContentEdit"},{"$ref":"#/$defs/ReviseOperationalArtifactEdit"},{"$ref":"#/$defs/RegisterConsumerEdit"}]},"AgentStandardsChangePurpose":{"type":"object","required":["summary","rationale","evidence"],"properties":{"summary":{"$ref":"#/$defs/NonEmptyString"},"rationale":{"$ref":"#/$defs/NonEmptyString"},"evidence":{"type":"array","minItems":1,"uniqueItems":true,"items":{"$ref":"#/$defs/AgentEvidenceReference"}}},"additionalProperties":false},"AgentStandardsChangeSet":{"type":"object","required":["purpose","edits"],"properties":{"purpose":{"$ref":"#/$defs/AgentStandardsChangePurpose"},"edits":{"type":"array","minItems":1,"uniqueItems":true,"items":{"$ref":"#/$defs/AgentStandardEdit"}}},"additionalProperties":false},"AgentSubmission":{"oneOf":[{"$ref":"#/$defs/AgentProvideFactSubmission"},{"$ref":"#/$defs/AgentConsumerDispositionSubmission"},{"$ref":"#/$defs/AgentImpactDispositionSubmission"},{"$ref":"#/$defs/AgentCoverageAttestationSubmission"}]},"EvidenceUse":{"type":"object","required":["evidence_ref"],"properties":{"evidence_ref":{"$ref":"#/$defs/CanonicalId"}},"additionalProperties":false,"description":"Select one exact reference from the evidence table of this request only. This is not an authorization or an attestation."},"AgentEvidenceReference":{"oneOf":[{"$ref":"#/$defs/EvidenceReference"},{"$ref":"#/$defs/EvidenceUse"}]},"RequestEvidenceTable":{"type":"object","additionalProperties":{"$ref":"#/$defs/EvidenceReference"},"description":"At most 128 request-local named exact references. Every entry must be used; each evidence_ref must name an entry. Expanded native validation and all ordinary evidence checks still apply."},"RouteContentSelection":{"type":"object","properties":{"offset":{"type":"integer","minimum":0,"description":"Default zero. A nonzero offset requires an explicit snapshot from the same route."},"limit":{"type":"integer","minimum":1,"maximum":32,"description":"Maximum whole policy reads in this page; default eight. Byte pressure may return fewer."}},"additionalProperties":false},"RoutedContentPage":{"type":"object","required":["offset","total","items"],"properties":{"offset":{"type":"integer","minimum":0},"total":{"type":"integer","minimum":0},"items":{"type":"array","maxItems":32,"items":{"oneOf":[{"$ref":"#/$defs/CompactReadResult"},{"$ref":"#/$defs/ReadResult"},{"$ref":"#/$defs/NavigationIndexesResult"},{"$ref":"#/$defs/ProvenanceReadResult"},{"$ref":"#/$defs/OperationalReadResult"}]}},"next":{"$ref":"#/$defs/RouteCall"}},"additionalProperties":false,"description":"Exact compact reads of selected targets in Router order. Total counts selected targets, not unresolved applicability. Follow next unchanged for the remaining page."},"ApplicationRoutedContentPage":{"type":"object","required":["offset","total","items"],"properties":{"offset":{"type":"integer","minimum":0},"total":{"type":"integer","minimum":0},"items":{"type":"array","maxItems":32,"items":{"$ref":"#/$defs/ApplicationReadResult"}},"next":{"$ref":"#/$defs/RouteCall"}},"additionalProperties":false,"description":"Exact compact reads of selected targets in Router order. Total counts selected targets, not unresolved applicability. Follow next unchanged for the remaining page."},"DescribeInputCall":{"type":"object","additionalProperties":false,"properties":{"operation":{"type":"string","minLength":1,"description":"An operation published in this running catalog."},"selector":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9]*$","description":"A returned definition name (or the name in a schema $ref). Omit for the operation input root."},"expected_catalog":{"$ref":"#/$defs/Digest"},"offset":{"type":"integer","minimum":0,"description":"Record offset within the selected closure. Continue with the returned next request."},"limit":{"type":"integer","minimum":1,"maximum":16,"description":"Maximum whole schema records in this page; default 8. Byte pressure may return fewer."}},"required":["operation"]},"InputSchemaRecord":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":1},"schema_json":{"type":"string","minLength":1,"description":"Exact JSON Schema definition serialized as a JSON document; $refs name other returned/selectable definitions. Not a standalone validator without its closure."}},"required":["name","schema_json"]},"InputContractResult":{"type":"object","additionalProperties":false,"properties":{"kind":{"const":"input-contract-result"},"purpose":{"enum":["application","authoring"]},"interface_version":{"type":"integer","minimum":1},"catalog_digest":{"$ref":"#/$defs/Digest"},"operation":{"type":"string","minLength":1},"root":{"type":"string","minLength":1},"selector":{"type":"string","minLength":1},"dialect":{"const":"https://json-schema.org/draft/2020-12/schema"},"offset":{"type":"integer","minimum":0},"total":{"type":"integer","minimum":1},"records":{"type":"array","maxItems":16,"items":{"$ref":"#/$defs/InputSchemaRecord"}},"next":{"$ref":"#/$defs/DescribeInputCall"}},"required":["kind","purpose","interface_version","catalog_digest","operation","root","selector","dialect","offset","total","records"]},"InputContractRejectedResult":{"type":"object","additionalProperties":false,"properties":{"kind":{"const":"input-contract-rejected-result"},"purpose":{"enum":["application","authoring"]},"code":{"enum":["INPUT_DISCOVERY.INVALID_ARGUMENTS","INPUT_DISCOVERY.OPERATION_UNAVAILABLE","INPUT_DISCOVERY.CATALOG_CHANGED","INPUT_DISCOVERY.SELECTION_INVALID","INPUT_DISCOVERY.RESULT_LIMIT"]},"outcome":{"enum":["invalid","unavailable","unsupported"]},"message":{"type":"string","minLength":1},"input_feedback":{"$ref":"#/$defs/InputFeedback"}},"required":["kind","purpose","code","outcome","message"]},"InputIssue":{"type":"object","additionalProperties":false,"properties":{"instance_pointer":{"type":"string","description":"JSON Pointer to the invalid field; non-exact locations redact dynamic keys as * or use the root."},"location_exact":{"type":"boolean"},"keyword":{"type":"string"},"message":{"type":"string"}},"required":["instance_pointer","location_exact","keyword","message"]},"InputFeedback":{"type":"object","additionalProperties":false,"properties":{"issues":{"type":"array","maxItems":8,"items":{"$ref":"#/$defs/InputIssue"}},"truncated":{"type":"boolean","description":"Additional diagnostic detail was omitted due to a work, item or byte bound."},"describe_input":{"$ref":"#/$defs/DescribeInputCall"}},"required":["issues","truncated","describe_input"]},"RelationshipGroupsCall":{"type":"object","additionalProperties":false,"properties":{"snapshot":{"$ref":"#/$defs/SnapshotHandle"},"offset":{"type":"integer","minimum":0,"description":"Continue with the exact snapshot and offset returned by next. Nonzero offsets require a snapshot."},"limit":{"type":"integer","minimum":1,"maximum":32,"description":"Whole records per page, default 8; byte pressure may return fewer."}},"required":[]},"RelationshipGroup":{"type":"object","additionalProperties":false,"properties":{"id":{"$ref":"#/$defs/CanonicalId"},"description":{"type":"string"},"traversal_directions":{"type":"array","minItems":1,"uniqueItems":true,"items":{"enum":["incoming","outgoing"]},"description":"Directions permitted by this group for traversals; adjacency queries remain distinct."},"transitive":{"type":"boolean","description":"Whether the group permits transitive traversal."}},"required":["id","description","traversal_directions","transitive"]},"RelationshipGroupsResult":{"type":"object","additionalProperties":false,"properties":{"kind":{"const":"relationship-groups-result"},"purpose":{"enum":["application","authoring"]},"snapshot":{"$ref":"#/$defs/SnapshotHandle"},"offset":{"type":"integer","minimum":0},"total":{"type":"integer","minimum":0},"items":{"type":"array","maxItems":32,"items":{"$ref":"#/$defs/RelationshipGroup"}},"next":{"$ref":"#/$defs/RelationshipGroupsCall"}},"required":["kind","purpose","snapshot","offset","total","items"]},"CompactRouteResult":{"type":"object","additionalProperties":false,"properties":{"kind":{"const":"compact-route-result"},"snapshot":{"$ref":"#/$defs/SnapshotHandle"},"status":{"enum":["complete","needs-facts"]},"facts":{"$ref":"#/$defs/RoutingFactAssertions"},"reading_plan":{"type":"array","items":{"$ref":"#/$defs/ReadingPlanEntry"}},"unresolved_questions":{"type":"array","items":{"$ref":"#/$defs/RoutingQuestion"}},"unresolved_policy_count":{"type":"integer","minimum":0},"explanation":{"$ref":"#/$defs/RouteCall"},"next_operations":{"type":"array","items":{"$ref":"#/$defs/NextOperation"}},"summary":{"type":"string"},"content":{"$ref":"#/$defs/RoutedContentPage"}},"required":["kind","snapshot","status","facts","reading_plan","unresolved_questions","unresolved_policy_count","explanation","next_operations"]},"DescribeOutputCall":{"type":"object","additionalProperties":false,"properties":{"operation":{"type":"string","minLength":1,"description":"An operation published in this running catalog."},"selector":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9]*$","description":"A returned output definition name. Omit for the complete operation result algebra."},"expected_catalog":{"$ref":"#/$defs/Digest"},"offset":{"type":"integer","minimum":0,"description":"Record offset within the selected closure. Continue with the returned next request."},"limit":{"type":"integer","minimum":1,"maximum":16,"description":"Maximum whole schema records in this page; default 8. Byte pressure may return fewer."}},"required":["operation"]},"OutputSchemaRecord":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":1},"schema_json":{"type":"string","minLength":1,"description":"Exact JSON Schema definition serialized as a JSON document; $refs name other returned/selectable definitions. Not a standalone validator without its closure."}},"required":["name","schema_json"]},"OutputContractResult":{"type":"object","additionalProperties":false,"properties":{"kind":{"const":"output-contract-result"},"purpose":{"enum":["application","authoring"]},"interface_version":{"type":"integer","minimum":1},"catalog_digest":{"$ref":"#/$defs/Digest"},"operation":{"type":"string","minLength":1},"selector":{"type":"string","minLength":1},"dialect":{"const":"https://json-schema.org/draft/2020-12/schema"},"offset":{"type":"integer","minimum":0},"total":{"type":"integer","minimum":1},"records":{"type":"array","maxItems":16,"items":{"$ref":"#/$defs/OutputSchemaRecord"}},"next":{"$ref":"#/$defs/DescribeOutputCall"},"roots":{"type":"array","minItems":1,"uniqueItems":true,"items":{"type":"string","minLength":1}},"root_schema_json":{"type":"string","minLength":1,"description":"Exact operation result schema without $defs. Combine with all result-root definition pages for validation; schema_digest binds the full schema."},"schema_digest":{"$ref":"#/$defs/Digest"}},"required":["kind","purpose","interface_version","catalog_digest","operation","dialect","offset","total","records","roots","root_schema_json","schema_digest"]},"OutputContractRejectedResult":{"type":"object","additionalProperties":false,"properties":{"kind":{"const":"output-contract-rejected-result"},"purpose":{"enum":["application","authoring"]},"code":{"enum":["OUTPUT_DISCOVERY.INVALID_ARGUMENTS","OUTPUT_DISCOVERY.OPERATION_UNAVAILABLE","OUTPUT_DISCOVERY.CATALOG_CHANGED","OUTPUT_DISCOVERY.SELECTION_INVALID","OUTPUT_DISCOVERY.RESULT_LIMIT"]},"outcome":{"enum":["invalid","unavailable","unsupported"]},"message":{"type":"string","minLength":1},"input_feedback":{"$ref":"#/$defs/InputFeedback"}},"required":["kind","purpose","code","outcome","message"]},"RoutingFactAssertion":{"oneOf":[{"type":"boolean"},{"type":"null"},{"type":"string"},{"type":"array","items":{"type":"string"},"uniqueItems":true},{"type":"object","additionalProperties":false,"required":["state"],"properties":{"state":{"enum":["known-absent","unknown"]}}}]},"RoutingFactAssertions":{"type":"object","additionalProperties":{"$ref":"#/$defs/RoutingFactAssertion"}}}}') -DEFINITION_METADATA = freeze_json({'ActiveSnapshotSummary': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'lifecycle': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'source_revision': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'created_at': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'AgentAuthoredDecisionProvenance': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'id': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'subject': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'origin': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'rationale': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'evidence': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'assumptions': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'limits': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'alternatives': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'reconsideration': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'supersedes': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'AgentConsumerDispositionSubmission': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'obligation': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'result': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'rationale': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'evidence': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'fingerprint': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'AgentCoverageAttestationClaim': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'requirement': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'conclusion': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'evidence': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'explicit_exclusions': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'rationale': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'auditor_provenance': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'AgentCoverageAttestationSubmission': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'claim': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'AgentEvidenceReference': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'AgentImpactDispositionSubmission': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'obligation': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'result': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'rationale': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'evidence': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'fingerprint': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'AgentProposeCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'change_set': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'detail': {'title': None, 'description': 'Compact (default) returns an exact workflow summary; full returns complete analysis detail.', 'has_default': False, 'default': None}, 'evidence': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'AgentProvideFactSubmission': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'requirement': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'value': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'evidence': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'AgentPutDecisionProvenanceEdit': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'record': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'AgentRelationshipDisposition': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'relationship': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'disposition': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'replacement_consumer': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'rationale': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'evidence': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'AgentResolveManyCall': {'title': None, 'description': 'Resolve ordered decisions bound to one original analysis. Validate every item before publishing a final immutable successor; an invalid batch persists no intermediate decisions.', 'has_default': False, 'default': None, 'properties': {'context': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'submissions': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'detail': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'evidence': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'AgentResolveWorkflowCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'context': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'submission': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'detail': {'title': None, 'description': 'Compact (default) returns an exact workflow summary; full returns complete analysis detail.', 'has_default': False, 'default': None}, 'evidence': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'AgentRetirePolicyUnitEdit': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'policy': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'retired_semantic_revision': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'successors': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'relationship_dispositions': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'evidence': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'AgentRetireStandardEdit': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'standard': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'successors': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'relationship_dispositions': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'evidence': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'AgentReviewCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'context': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'decisions': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'detail': {'title': None, 'description': 'Compact (default) returns an exact workflow summary; full returns complete analysis detail.', 'has_default': False, 'default': None}, 'evidence': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'AgentReviewDecision': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'owner': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'decision': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'rationale': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'evidence': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'AgentReviseCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'context': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'change_set': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'detail': {'title': None, 'description': 'Compact (default) returns an exact workflow summary; full returns complete analysis detail.', 'has_default': False, 'default': None}, 'evidence': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'AgentRouteResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'reading_plan': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'unresolved_questions': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'next_operations': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'summary': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'facts': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'rules': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'content': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'AgentStandardEdit': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'AgentStandardsChangePurpose': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'summary': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'rationale': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'evidence': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'AgentStandardsChangeSet': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'purpose': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'edits': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'AgentSubmission': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'AllExpression': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'operator': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'expressions': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'AlwaysExpression': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'operator': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'AnalysisChildArtifact': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'AnalysisChildHandle': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'analysis': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'child_kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'child_id': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'schema_version': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'AnalysisChildInspectionResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'handle': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'artifact': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'AnalysisContext': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'handle': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'subjects': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'changes': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'semantic_proposals': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'AnalysisExecutionContractView': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'authorization_authority_digest': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'providers': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'AnalysisHandle': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'id': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'schema_version': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'AnalysisId': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'AnalysisInspectionResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'state': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'AnalysisMaterialHandle': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'AnalysisRequest': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'base_snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'proposed_snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'changes': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'semantic_proposals': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'prior_analysis': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'contract_version': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'AnalysisState': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'handle': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'base_snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'proposed_reference': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'changes': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'semantic_proposals': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'fact_observations': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'dispositions': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'coverage_attestations': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'authorization_records': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'domain_contracts': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'execution_contracts': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'contract_version': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'AnalyzeCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'context': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'detail': {'title': None, 'description': 'Compact (default) returns an exact workflow summary; full returns complete analysis detail.', 'has_default': False, 'default': None}}}, 'AnalyzeProposalCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'revision': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'AnyExpression': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'operator': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'expressions': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ApplicabilityExpression': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'ApplicationExposureState': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'ApplicationHandle': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'id': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'schema_version': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ApplicationId': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'ApplicationInspectCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'handle': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ApplicationNextOperation': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'operation': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'target': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'handle': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ApplicationPolicy': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'id': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'handle': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'role': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'level': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ApplicationPublicationReceipt': {'title': None, 'description': 'Durable application identity and exact candidate facts, separate from the fresh target observation.', 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'application': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'candidate_commit': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'candidate_tree': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'target_ref': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'expected_predecessor': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'durable_state': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'target_observation': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ApplicationQueryCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'request': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ApplicationQueryRequest': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'ApplicationQuestion': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'fact': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ApplicationReadCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'target': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'detail': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ApplicationReadManyCall': {'title': None, 'description': 'Read 1–32 selected items from one explicit snapshot, preserving order. The complete JSON result is limited to 2 MiB; any failed item rejects the entire request.', 'has_default': False, 'default': None, 'properties': {'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'items': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ApplicationReadManyItem': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'target': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'detail': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ApplicationReadManyResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'items': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'purpose': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ApplicationReadRequest': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'target': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'detail': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ApplicationReadResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'purpose': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'policy': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'content': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'scope': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'requires': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'specializes': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'related': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'next_operations': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ApplicationReadingEntry': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'target': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'scope': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'authority': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'state': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ApplicationRecoveryRequiredResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'application': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'status': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'code': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'outcome': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'message': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'publication': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'checkout': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'details': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ApplicationRejectedResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'purpose': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'code': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'outcome': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'message': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'next_operations': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'input_feedback': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'relationship_groups': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ApplicationRelatedResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'purpose': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'target': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'relationships': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'next_operations': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ApplicationRelationship': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'handle': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'source': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'target': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'relation': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'groups': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'direction': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ApplicationRouteResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'purpose': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'status': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'reading_plan': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'unresolved_questions': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'next_operations': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'content': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ApplicationRoutedContentPage': {'title': None, 'description': 'Exact compact reads of selected targets in Router order. Total counts selected targets, not unresolved applicability. Follow next unchanged for the remaining page.', 'has_default': False, 'default': None, 'properties': {'offset': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'total': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'items': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'next': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ApplicationRoutingFactsResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'purpose': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'facts': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'next_operations': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ApplyCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'context': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'detail': {'title': None, 'description': 'Compact (default) returns an exact workflow summary; full returns complete analysis detail.', 'has_default': False, 'default': None}}}, 'ApplyProposalCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'readiness': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ApplyProposalResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'application': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'status': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'publication': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'checkout': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ApproveApplicationContentEdit': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'target': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'AuditPolicyUnitEdit': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'policy': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'rationale': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'AuthoredDecisionProvenance': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'id': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'subject': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'origin': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'rationale': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'evidence': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'assumptions': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'limits': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'alternatives': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'reconsideration': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'supersedes': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'AuthoredRoutingFact': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'id': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'semantic_revision': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'type': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'nullable': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'values': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'aliases': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'meaning': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'prompt': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'AuthoredRoutingRule': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'id': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'target': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'when': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'condition': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'AuthoringTargetHandle': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'id': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'schema_version': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'AuthorizationId': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'AuthorizationRecord': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'reference': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'issuer_semantic_revision': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'principal': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'action': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'subject_kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'subject_id': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'authorization_evidence': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'revocation_authority': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'revocation_authority_semantic_revision': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'revocation_evidence': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'AuthorizationReference': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'id': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'issuer': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'capability': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'authority_digest': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'CandidateApplicationNextOperation': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'operation': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'revision': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'request': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'CandidateApplicationPolicy': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'id': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'role': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'level': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'CandidateApplicationReadResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'purpose': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'policy': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'content': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'scope': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'requires': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'specializes': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'related': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'next_operations': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'revision': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'CandidateApplicationRejectedResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'purpose': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'code': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'outcome': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'message': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'next_operations': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'revision': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'CandidateApplicationRelatedResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'purpose': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'target': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'relationships': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'next_operations': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'revision': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'CandidateApplicationRelationship': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'source': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'target': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'relation': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'groups': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'direction': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'CandidateApplicationRouteResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'purpose': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'status': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'reading_plan': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'unresolved_questions': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'next_operations': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'revision': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'CanonicalId': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'CanonicalModuleDeclaration': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'id': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'role': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'level': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'applies_when': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'does_not_apply_when': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'requires': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'specializes': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'verification': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ChangeDescriptor': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'accepted_ids': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'proposed_ids': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'scope': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'accepted_module': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'proposed_module': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ChangePolicySemantics': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'accepted_semantic_revision': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'proposed_semantic_revision': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'intent': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ChangedPolicyUnit': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'policy': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'change_kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'classification': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'accepted_representation_digest': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'proposed_representation_digest': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'accepted_structural_digest': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'proposed_structural_digest': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'accepted_semantic_revision': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'proposed_semantic_revision': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'semantic_state': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'scope': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ChildId': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'CompactReadResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'policy': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'content': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'requires': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'specializes': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'next_operations': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'summary': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'routing': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'coverage': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'detail': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'application_exposure': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'provenance': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'CompactRouteResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'status': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'facts': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'reading_plan': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'unresolved_questions': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'unresolved_policy_count': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'explanation': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'next_operations': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'summary': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'content': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'CompleteResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'handle': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'status': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'context': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'changes': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'changed_units': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'coverage_certificates': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'fact_observations': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'dispositions': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'reading_plan': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'completion': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'summary': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'CompletionProof': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'required_coverage_subjects': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'certificate_subjects': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'reached_consumer_obligations': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'disposition_obligations': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'required_fact_requirements': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'observed_fact_requirements': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'non_consumer_obligations_resolved': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'applicability_resolved': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'authorization_valid': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'evidence_valid': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ConsumerDispositionSubmission': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'obligation': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'result': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'rationale': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'evidence': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'fingerprint': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ConsumerReviewContract': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'id': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'version': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'permitted_dispositions': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'evidence_contract': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'authorization_capability': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'semantics': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ConsumerReviewObligationReadingReason': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'obligation': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ContainsExpression': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'operator': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'fact': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'value': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'CoverageAttestation': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'requirement': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'conclusion': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'evidence': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'explicit_exclusions': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'rationale': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'auditor_provenance': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'schema_version': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'authorization': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'CoverageAttestationClaim': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'requirement': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'conclusion': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'evidence': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'explicit_exclusions': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'rationale': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'auditor_provenance': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'CoverageAttestationSubmission': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'claim': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'CoverageAuditAuthority': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'issuer': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'principal': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'authorization_id': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'CoverageCertificate': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'handle': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'requirement': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'subject': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'owner': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'semantic_revision': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'horizon_digest': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'relationship_digest': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'evidence_digests': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'fact_schema_digest': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'CoverageRequirement': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'handle': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'subject': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'owner': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'semantic_revision': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'relationship_kinds': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'horizon': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'required_evidence_contract': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'CreateProposalCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'base_snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'change_set': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'CreateProposalResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'proposal': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'revision': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'CreateSnapshotCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'CreateSnapshotResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'CreateStandardEdit': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'standard': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'requires': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'specializes': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'policy_units': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'DecisionDependency': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'class': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'identity': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'digest': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'DecisionFingerprint': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'decision_kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'decision_contract': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'schema_version': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'dependencies': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'DecisionProvenanceRecord': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'id': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'subject': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'origin': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'rationale': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'evidence': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'assumptions': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'limits': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'alternatives': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'reconsideration': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'supersedes': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'subject_binding': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'retired': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'DeleteSnapshotCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'DeleteSnapshotResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'purge_deadline': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'DescribeInputCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'operation': {'title': None, 'description': 'An operation published in this running catalog.', 'has_default': False, 'default': None}, 'selector': {'title': None, 'description': 'A returned definition name (or the name in a schema $ref). Omit for the operation input root.', 'has_default': False, 'default': None}, 'expected_catalog': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'offset': {'title': None, 'description': 'Record offset within the selected closure. Continue with the returned next request.', 'has_default': False, 'default': None}, 'limit': {'title': None, 'description': 'Maximum whole schema records in this page; default 8. Byte pressure may return fewer.', 'has_default': False, 'default': None}}}, 'DescribeOutputCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'operation': {'title': None, 'description': 'An operation published in this running catalog.', 'has_default': False, 'default': None}, 'selector': {'title': None, 'description': 'A returned output definition name. Omit for the complete operation result algebra.', 'has_default': False, 'default': None}, 'expected_catalog': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'offset': {'title': None, 'description': 'Record offset within the selected closure. Continue with the returned next request.', 'has_default': False, 'default': None}, 'limit': {'title': None, 'description': 'Maximum whole schema records in this page; default 8. Byte pressure may return fewer.', 'has_default': False, 'default': None}}}, 'Digest': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'DispositionRecord': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'obligation': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'result': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'rationale': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'evidence': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'authorization': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'fingerprint': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'DomainContractReference': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'id': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'version': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'EdgeId': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'EngineCertificateRetirement': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'subject': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'requirement_id': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'rationale': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'EqualsExpression': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'operator': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'fact': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'value': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'EvidenceCheckRetirement': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'suite': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'check': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'EvidenceConsumerRegistration': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'path': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'artifact_kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'source_policies': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'relation': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'evidence_owner': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'rationale': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'EvidenceMaintenancePlan': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'retire_engine_certificates': {'title': None, 'description': 'Explicitly retire exact registered Engine-issued certificates by subject and requirement; preserve normative policy and consumer registrations.', 'has_default': False, 'default': None}, 'prune_stale_certificates': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'retire_suites': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'retire_checks': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'retire_inputs': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'suite_descriptions': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'replacement_evidence_owner': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'replacement_evidence_rationale': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'relationship_updates': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'consumer_registrations': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'unregister_policy_subjects': {'title': None, 'description': 'Remove selected review-subject registrations and their source relationships while preserving normative Markdown.', 'has_default': False, 'default': None}}}, 'EvidenceReference': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'id': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'digest': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'provider_contract': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'provider_contract_version': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'EvidenceRelationshipUpdate': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'source_policy': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'consumer': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'relation': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'evidence_owner': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'rationale': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'EvidenceSuiteDescription': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'suite': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'description': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'EvidenceUse': {'title': None, 'description': 'Select one exact reference from the evidence table of this request only. This is not an authorization or an attestation.', 'has_default': False, 'default': None, 'properties': {'evidence_ref': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ExistsExpression': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'operator': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'fact': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'FactObservation': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'handle': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'requirement': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'value': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'evidence': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'authorization': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'provider': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'FactRequirement': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'handle': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'fact': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'fact_semantic_revision': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'fact_contract_digest': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'context': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'value_contract': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'answer_contract': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'evidence_contract': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'authorization_capability': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'FactRequirementId': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'FactRequirementWork': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'requirement': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'prompt': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'dependent_programs': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'FactSet': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'FactValue': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'FactValueContract': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'type': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'states': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'nullable': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'values': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'FindProposalsCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'after': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'limit': {'title': None, 'description': None, 'has_default': True, 'default': 50}}}, 'FindProposalsResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'proposals': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'continuation': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'FindSnapshotsCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'lifecycle': {'title': None, 'description': None, 'has_default': True, 'default': 'active'}, 'after': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'limit': {'title': None, 'description': None, 'has_default': True, 'default': 50}}}, 'FindSnapshotsResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'snapshots': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'continuation': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'FocusedQueryNextOperation': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'operation': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'request_kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'target': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'GeneralSelectionReason': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'source': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'fact': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'edge': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'question': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'GitObjectId': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'ImpactDispositionSubmission': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'obligation': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'result': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'rationale': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'evidence': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'fingerprint': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ImpactTraceId': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'ImpactTraceReference': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'id': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'graph': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'applicability': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'InExpression': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'operator': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'fact': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'values': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'InputContractRejectedResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'purpose': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'code': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'outcome': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'message': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'input_feedback': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'InputContractResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'purpose': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'interface_version': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'catalog_digest': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'operation': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'root': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'selector': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'dialect': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'offset': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'total': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'records': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'next': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'InputFeedback': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'issues': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'truncated': {'title': None, 'description': 'Additional diagnostic detail was omitted due to a work, item or byte bound.', 'has_default': False, 'default': None}, 'describe_input': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'InputIssue': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'instance_pointer': {'title': None, 'description': 'JSON Pointer to the invalid field; non-exact locations redact dynamic keys as * or use the root.', 'has_default': False, 'default': None}, 'location_exact': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'keyword': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'message': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'InputSchemaRecord': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'name': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'schema_json': {'title': None, 'description': 'Exact JSON Schema definition serialized as a JSON document; $refs name other returned/selectable definitions. Not a standalone validator without its closure.', 'has_default': False, 'default': None}}}, 'InspectCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'handle': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'InspectNextOperation': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'operation': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'request_kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'handle': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'InspectableHandle': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'InspectionResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'MaintainEvidenceCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'expected_revision': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'evidence': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'plan': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'apply': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'MaintainEvidenceResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'applied': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'changed_files': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'removed_files': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'verification': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ModuleRelationshipKey': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'relation': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'source': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'target': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'MovePolicyUnitEdit': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'policy': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'standard': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'after_policy': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'semantics': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'NavigationIndexEntry': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'id': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'entrypoint': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'destinations': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'content': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'NavigationIndexesResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'authority': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'indexes': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'next_operations': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'NavigationRetarget': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'entrypoint': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'standard': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'NewPolicyUnit': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'id': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'heading_chain': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'semantic_revision': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'intent': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'aliases': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'predecessors': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'successors': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'NextOperation': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'NonEmptyString': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'NotExpression': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'operator': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'expression': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'Obligation': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'handle': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'target': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'scope': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'reasons': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'state': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'applicability': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'permitted_submissions': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'review_contract': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'fingerprint': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ObligationId': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'OperationalReadResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'authority': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'target': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'canonical_id': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'role': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'content': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'application_exposure': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'next_operations': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'OutputContractRejectedResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'purpose': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'code': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'outcome': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'message': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'input_feedback': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'OutputContractResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'purpose': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'interface_version': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'catalog_digest': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'operation': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'selector': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'dialect': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'offset': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'total': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'records': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'next': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'roots': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'root_schema_json': {'title': None, 'description': 'Exact operation result schema without $defs. Combine with all result-root definition pages for validation; schema_digest binds the full schema.', 'has_default': False, 'default': None}, 'schema_digest': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'OutputSchemaRecord': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'name': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'schema_json': {'title': None, 'description': 'Exact JSON Schema definition serialized as a JSON document; $refs name other returned/selectable definitions. Not a standalone validator without its closure.', 'has_default': False, 'default': None}}}, 'PendingResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'handle': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'status': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'context': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'changes': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'changed_units': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'obligations': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'fact_requirements': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'reading_plan': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'next_operations': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'summary': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'PolicyCoverageStatus': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'subject': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'requirement_id': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'status': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'authority': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'PolicyImpactSelectionReason': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'source': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'edge': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'relation': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'evidence_owner': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'traces': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'PolicyInspectionResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'policy': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'declaration': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'representation_digest': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'structural_digest': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'provenance': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'PolicyRelationship': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'source_policy': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'consumer': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'relation': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'applicability': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'source_scope': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'consumer_scope': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'evidence_owner': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'rationale': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'PolicyRelationshipInspection': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'relationship_kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'applicability': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'source_scope': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'consumer_scope': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'propagation': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'evidence_owner': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'rationale': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'PolicyRelationshipKey': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'source_policy': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'consumer': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'relation': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'PolicyScopeUpdate': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'policy': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'heading_path': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'semantics': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'PolicySemanticIntent': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'PolicySummary': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'handle': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'authority': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'scope': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'PolicyUnitDeclaration': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'id': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'module': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'heading_path': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'semantic_revision': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'lifecycle': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'aliases': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'predecessors': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'successors': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'PolicyUnitMapping': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'state': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'reason': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'policy_units': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'PrepareCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'request': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'PreservePolicySemantics': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'semantic_revision': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'intent': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'PreviewApplicationCall': {'title': None, 'description': 'Authoring-only inspection of an exact draft through application qualification and filtering; this observation neither publishes nor grants ordinary application access.', 'has_default': False, 'default': None, 'properties': {'revision': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'request': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'PreviewApplicationResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'ProposalHandle': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'id': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'schema_version': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ProposalId': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'ProposalPolicySummary': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'id': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'authority': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'scope': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ProposalReadResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'revision': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'policy': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'content': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'requires': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'specializes': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'related': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'next_operations': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'summary': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'routing': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'coverage': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'application_exposure': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'provenance': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ProposalRelatedResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'revision': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'target': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'authoring_target': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'policy_unit_mapping': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'relationships': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'next_operations': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'summary': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ProposalRelationshipSummary': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'source': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'target': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'relation': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'groups': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'direction': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'traversal_eligible': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'applicability': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ProposalRevisionHandle': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'id': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'schema_version': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ProposalRevisionId': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'ProposalRouteResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'revision': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'reading_plan': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'unresolved_questions': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'next_operations': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'summary': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ProposalSummary': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'proposal': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'head_revision': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ProposeCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'change_set': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'detail': {'title': None, 'description': 'Compact (default) returns an exact workflow summary; full returns complete analysis detail.', 'has_default': False, 'default': None}}}, 'ProvenanceReadResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'authority': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'record': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'state': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'next_operations': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ProvenanceRecord': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'path': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ProvideFactSubmission': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'requirement': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'value': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'evidence': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ProviderReference': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'id': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'contract': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'contract_version': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'input_digest': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'PublicationCheckoutObservation': {'title': None, 'description': 'Fresh read-only observation of one selected checkout. Unavailable observations use null for every fact that could not be established.', 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'status': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'worktree_id': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'symbolic_branch': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'head': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'index_observation': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'publication_path_count': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'index_paths': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'worktree_paths': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'PublicationPathCounts': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'predecessor': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'candidate': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'conflicted': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'PublicationTargetObservation': {'title': None, 'description': 'Fresh bounded observation of the configured target ref; an unavailable revision is null.', 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'status': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'revision': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'PutDecisionProvenanceEdit': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'record': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'PutPolicyRelationshipEdit': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'relationship': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'PutRoutingFactEdit': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'fact': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'rationale': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'PutRoutingRuleEdit': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'rule': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'rationale': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'QuarantinedSnapshotSummary': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'lifecycle': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'source_revision': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'created_at': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'purge_deadline': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'QueryCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'request': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'QueryNextOperation': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'operation': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'request_kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'target': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'QueryProposalCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'revision': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'request': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'QueryProposalNextOperation': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'operation': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'request_kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'target': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'revision': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'QueryProposalResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'QueryRequest': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'QueryResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'Question': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'id': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'prompt': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'state': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'permitted_answers': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ReadCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'target': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'include_routing': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'include_coverage': {'title': None, 'description': 'Include current repository attestation status for registered policy units in this read scope.', 'has_default': False, 'default': None}, 'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'detail': {'title': None, 'description': 'Compact preserves exact policy and essential authority; full includes all relationship rows.', 'has_default': False, 'default': None}}}, 'ReadCoverage': {'title': None, 'description': 'Repository attestation status bound to this snapshot or proposal. Empty subjects means no registered policy units in scope, not complete coverage. Analysis-local attestations are not repository certificates.', 'has_default': False, 'default': None, 'properties': {'subjects': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ReadManyCall': {'title': None, 'description': 'Read 1–32 selected items from one explicit snapshot, preserving order. The complete JSON result is limited to 2 MiB; any failed item rejects the entire request.', 'has_default': False, 'default': None, 'properties': {'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'items': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ReadManyItem': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'target': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'include_routing': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'include_coverage': {'title': None, 'description': 'Include current repository attestation status for registered policy units in this read scope.', 'has_default': False, 'default': None}, 'detail': {'title': None, 'description': 'Compact preserves exact policy and essential authority; full includes all relationship rows.', 'has_default': False, 'default': None}}}, 'ReadManyResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'items': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ReadRequest': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'target': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'include_routing': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'include_coverage': {'title': None, 'description': 'Include current repository attestation status for registered policy units in this read scope.', 'has_default': False, 'default': None}}}, 'ReadResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'policy': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'content': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'requires': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'specializes': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'related': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'next_operations': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'summary': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'routing': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'coverage': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'application_exposure': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'provenance': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ReadinessHandle': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'id': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'schema_version': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ReadinessId': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'ReadingPlanEntry': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'target': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'scope': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'authority': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'reasons': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'state': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ReadingPlanReason': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'RecoverApplicationCall': {'title': None, 'description': 'Recover an admitted application. Observation performs no Git writes. Explicit completion reconstructs and verifies the exact admitted candidate before one compare-and-swap attempt.', 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'readiness': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'action': {'title': None, 'description': 'Omit or select observe to reconcile only. Explicit complete-publication revalidates and attempts the same admitted candidate against its original expected target; it requires current publication authorization.', 'has_default': False, 'default': None}}}, 'RecoverApplicationResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'application': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'status': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'publication': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'checkout': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'RecoverCall': {'title': None, 'description': 'Recover an admitted application. Observation performs no Git writes. Explicit completion reconstructs and verifies the exact admitted candidate before one compare-and-swap attempt.', 'has_default': False, 'default': None, 'properties': {'context': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'action': {'title': None, 'description': 'Omit or select observe to reconcile only. Explicit complete-publication revalidates and attempts the same admitted candidate against its original expected target; it requires current publication authorization.', 'has_default': False, 'default': None}, 'detail': {'title': None, 'description': 'Compact (default) returns an exact workflow summary; full returns complete analysis detail.', 'has_default': False, 'default': None}}}, 'RegisterConsumerEdit': {'title': None, 'description': 'Register an existing tracked consumer within this proposal. The Engine captures original-revision bytes; use separate policy relationships to declare consumers and review obligations.', 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'consumer': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'path': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'artifact_kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'authority': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'RegisterPolicyUnitEdit': {'title': None, 'description': 'Register an explicitly selected policy scope in an existing standard. The Engine owns declaration placement and validates the final candidate.', 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'standard': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'policy_unit': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'RejectedResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'code': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'outcome': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'target': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'message': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'details': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'next_operations': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'input_feedback': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'relationship_groups': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'RelatedCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'target': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'groups': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'direction': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'transitive': {'title': None, 'description': None, 'has_default': True, 'default': False}, 'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'RelatedRequest': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'target': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'groups': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'direction': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'transitive': {'title': None, 'description': None, 'has_default': True, 'default': False}}}, 'RelatedResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'target': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'authoring_target': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'policy_unit_mapping': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'relationships': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'next_operations': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'summary': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'RelationshipConsumer': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'RelationshipDisposition': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'relationship': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'disposition': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'replacement_consumer': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'rationale': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'evidence': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'RelationshipGroup': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'id': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'description': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'traversal_directions': {'title': None, 'description': 'Directions permitted by this group for traversals; adjacency queries remain distinct.', 'has_default': False, 'default': None}, 'transitive': {'title': None, 'description': 'Whether the group permits transitive traversal.', 'has_default': False, 'default': None}}}, 'RelationshipGroupsCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'offset': {'title': None, 'description': 'Continue with the exact snapshot and offset returned by next. Nonzero offsets require a snapshot.', 'has_default': False, 'default': None}, 'limit': {'title': None, 'description': 'Whole records per page, default 8; byte pressure may return fewer.', 'has_default': False, 'default': None}}}, 'RelationshipGroupsResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'purpose': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'offset': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'total': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'items': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'next': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'RelationshipInspectionResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'relationship': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'policy_semantics': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'provenance': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'RelationshipKey': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'RelationshipSummary': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'handle': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'source': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'target': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'relation': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'groups': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'direction': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'traversal_eligible': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'applicability': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'RemovePolicyRelationshipEdit': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'relationship': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'RemoveRoutingFactEdit': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'fact': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'rationale': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'RemoveRoutingRuleEdit': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'rule': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'rationale': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ReplaceStandardRelationshipsEdit': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'standard': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'requires': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'specializes': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'rationale': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'RepositoryPath': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'RequestEvidenceTable': {'title': None, 'description': 'At most 128 request-local named exact references. Every entry must be used; each evidence_ref must name an entry. Expanded native validation and all ordinary evidence checks still apply.', 'has_default': False, 'default': None, 'properties': {}}, 'RequiresReadingReason': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'edge': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'source': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ResolveCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'analysis': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'submission': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ResolveManyCall': {'title': None, 'description': 'Resolve ordered decisions bound to one original analysis. Validate every item before publishing a final immutable successor; an invalid batch persists no intermediate decisions.', 'has_default': False, 'default': None, 'properties': {'context': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'submissions': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'detail': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ResolveNextOperation': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'operation': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'request_kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'target': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'work': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'analysis': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ResolveWorkflowCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'context': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'submission': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'detail': {'title': None, 'description': 'Compact (default) returns an exact workflow summary; full returns complete analysis detail.', 'has_default': False, 'default': None}}}, 'ResumeCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'context': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'detail': {'title': None, 'description': 'Compact (default) returns an exact workflow summary; full returns complete analysis detail.', 'has_default': False, 'default': None}}}, 'RetireDecisionProvenanceEdit': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'id': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'RetirePolicyUnitEdit': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'policy': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'retired_semantic_revision': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'successors': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'relationship_dispositions': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'evidence': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'RetireStandardEdit': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'standard': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'successors': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'relationship_dispositions': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'evidence': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ReviewCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'context': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'decisions': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'detail': {'title': None, 'description': 'Compact (default) returns an exact workflow summary; full returns complete analysis detail.', 'has_default': False, 'default': None}}}, 'ReviewDecision': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'owner': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'decision': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'rationale': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'evidence': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ReviewProposalCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'analysis': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'decisions': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'prior_readiness': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ReviewProposalResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'readiness': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'revision': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'status': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ReviewScope': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'ReviseCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'context': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'change_set': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'detail': {'title': None, 'description': 'Compact (default) returns an exact workflow summary; full returns complete analysis detail.', 'has_default': False, 'default': None}}}, 'ReviseOperationalArtifactEdit': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'target': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'title': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'body': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'RevisePolicyUnitEdit': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'policy': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'title': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'body': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'semantics': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ReviseProposalCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'expected_revision': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'change_set': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ReviseProposalResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'proposal': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'revision': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ReviseStandardEdit': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'standard': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'scope_updates': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'RewriteNavigationIndexEdit': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'entrypoint': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'destinations': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'rationale': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'retargets': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'RouteCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'facts': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'content': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'detail': {'title': None, 'description': 'Compact authoring selection is default. Full returns the rule explanation. Application always retains its qualified projection.', 'has_default': False, 'default': None}}}, 'RouteContentSelection': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'offset': {'title': None, 'description': 'Default zero. A nonzero offset requires an explicit snapshot from the same route.', 'has_default': False, 'default': None}, 'limit': {'title': None, 'description': 'Maximum whole policy reads in this page; default eight. Byte pressure may return fewer.', 'has_default': False, 'default': None}}}, 'RouteRequest': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'facts': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'RouteResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'reading_plan': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'unresolved_questions': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'next_operations': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'summary': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'RoutedContentPage': {'title': None, 'description': 'Exact compact reads of selected targets in Router order. Total counts selected targets, not unresolved applicability. Follow next unchanged for the remaining page.', 'has_default': False, 'default': None, 'properties': {'offset': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'total': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'items': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'next': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'RoutingBaseReadingReason': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'projection': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'RoutingConfiguration': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'facts': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'rules': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'RoutingFactAssertion': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'RoutingFactAssertions': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'RoutingFactsCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'RoutingFactsResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'facts': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'RoutingQuestion': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'id': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'prompt': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'state': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'fact': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'RoutingRuleExplanation': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'id': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'target': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'when': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'state': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'RoutingRuleReadingReason': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'rule': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'facts': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'RuntimeInfoCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'expected_catalog': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'RuntimeInfoResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'purpose': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'interface_version': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'implementation_version': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'instance_id': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'implementation_digest': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'catalog_digest': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'schema_digest': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'installation_state': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'client_catalog_state': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'action': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ScalarValue': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'SelectionReason': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'SemanticProposal': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'policy': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'accepted_semantic_revision': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'proposed_semantic_revision': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'intent': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'structural_digest': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'SnapshotChildHandle': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'child_kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'child_id': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'schema_version': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'SnapshotHandle': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'id': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'schema_version': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'SnapshotId': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'SnapshotInspectionResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'SnapshotSummary': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'SpecializesReadingReason': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'edge': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'source': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'StandardContent': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'id': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'title': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'role': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'level': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'applies_when': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'does_not_apply_when': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'verification': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'body': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'StandardEdit': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'StandardsChangePurpose': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'summary': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'rationale': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'evidence': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'StandardsChangeSet': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'purpose': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'edits': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'StructuredScope': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'heading_path': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'Submission': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'Timestamp': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'UndeleteSnapshotCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'UndeleteSnapshotResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'VerificationFailure': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'code': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'message': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'suite': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'check': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'VerificationReport': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'passed': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'exit_code': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'suites': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'checks': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'failures': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'VerifyProposalCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'revision': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'readiness': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'VerifyProposalResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'revision': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'verification': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'readiness': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'VerifyRepositoryCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'refresh_verification_inputs': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'VerifyRepositoryResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'refreshed_verification_inputs': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'verification': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'WholeArtifactScope': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'WithdrawApplicationContentEdit': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'target': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'WorkflowAnalysisSummary': {'title': None, 'description': 'Counts for the enclosing immutable Analysis context. Observation remains summary-only; successful compact pending mutations additionally return a bounded work page.', 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'status': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'required_obligations': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'pending_facts': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'sections': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'details': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'WorkflowContext': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'WorkflowContinuation': {'title': None, 'description': 'Select the named operation with the enclosing WorkflowResult context and explicit required inputs. This descriptor is not an authorization grant.', 'has_default': False, 'default': None, 'properties': {'operation': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'required_inputs': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'WorkflowDetailItem': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'WorkflowDetailsCall': {'title': None, 'description': 'Read a section of an immutable historical Analysis. Compact pages (default eight items) contain up to 16 whole records and 64 KiB of result JSON, returning fewer items when needed. An oversized record returns an explicit full-detail retry. detail=full retrieves one complete record (limit omitted or 1) without the compact byte cap; choose it only when the client can receive that payload. Continuations bind the Analysis, section and projected contents. Decision and publication operations check current evidence and authorization. A full-record response resumes compact paging in its next request.', 'has_default': False, 'default': None, 'properties': {'analysis': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'section': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'offset': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'limit': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'observation': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'detail': {'title': None, 'description': 'Compact is byte-bounded; full explicitly retrieves one whole record without the compact byte cap.', 'has_default': False, 'default': None}}}, 'WorkflowDetailsLink': {'title': None, 'description': 'Supply the enclosing WorkflowResult Analysis context as analysis and explicitly select a section.', 'has_default': False, 'default': None, 'properties': {'operation': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'WorkflowDetailsNextOperation': {'title': None, 'description': 'An explicit historical detail retrieval alternative. Invoke operation with request; do not automatically select size-unbounded full detail.', 'has_default': False, 'default': None, 'properties': {'operation': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'request_kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'request': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'WorkflowDetailsResult': {'title': None, 'description': 'Whole records from an immutable Analysis section. Compact may return fewer than limit to respect 64 KiB. Full returns at most one complete record and may exceed 64 KiB. Follow next exactly; observation and total are independent of page size and detail mode.', 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'analysis': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'section': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'observation': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'offset': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'total': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'items': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'next': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'WorkflowDetailsSelection': {'title': None, 'description': 'A workflow_details selection relative to the enclosing WorkflowResult Analysis context. Add analysis from that context when invoking; preserve every returned selection field.', 'has_default': False, 'default': None, 'properties': {'section': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'offset': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'limit': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'observation': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'detail': {'title': None, 'description': 'Compact is byte-bounded; full explicitly retrieves one whole record without the compact byte cap.', 'has_default': False, 'default': None}}}, 'WorkflowObligationWork': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'obligation': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'work': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'WorkflowOutcome': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'WorkflowResult': {'title': None, 'description': 'Exact immutable workflow context and relative action descriptors. Successful compact pending propose, revise, analyze and decision submissions include work from the already-produced Analysis. Status observations, full results, stale contexts and other outcomes omit work.', 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'context': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'proposal': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'revision': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'publication': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'checkout': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'status': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'next_operations': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'outcome': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'work': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'WorkflowSection': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'WorkflowSectionCount': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'section': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'count': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'WorkflowStatusCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'context': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'detail': {'title': None, 'description': 'Compact (default) returns an exact workflow summary; full returns complete analysis detail.', 'has_default': False, 'default': None}}}, 'WorkflowWorkDeferred': {'title': None, 'description': 'The mutation succeeded but its first complete work record exceeds the compact page budget. Preserve the enclosing context and counts; request explicitly selects that exact full record without the compact byte cap.', 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'code': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'section': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'total': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'request': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'WorkflowWorkPage': {'title': None, 'description': 'First actionable section of a successful compact pending mutation, bound to the enclosing Analysis context. Facts precede obligations. Up to eight whole items and 64 KiB of page JSON; next is a relative workflow_details selection. Work handles retain their complete authority.', 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'section': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'observation': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'offset': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'total': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'items': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'next': {'title': None, 'description': None, 'has_default': False, 'default': None}}}}) +_SCHEMA = json.loads('{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://coding-standards.local/contracts/standards-engine/a2-v40","title":"Standards Engine A2 contract","description":"Canonical typed contract for snapshot lifecycle, controlled authoring, navigation, inspection, and immutable standards-change analysis.","oneOf":[{"$ref":"#/$defs/AgentProposeCall"},{"$ref":"#/$defs/AgentResolveManyCall"},{"$ref":"#/$defs/AgentResolveWorkflowCall"},{"$ref":"#/$defs/AgentReviewCall"},{"$ref":"#/$defs/AgentReviseCall"},{"$ref":"#/$defs/AgentRouteResult"},{"$ref":"#/$defs/AnalyzeCall"},{"$ref":"#/$defs/AnalyzeProposalCall"},{"$ref":"#/$defs/ApplicationInspectCall"},{"$ref":"#/$defs/ApplicationQueryCall"},{"$ref":"#/$defs/ApplicationReadCall"},{"$ref":"#/$defs/ApplicationReadManyCall"},{"$ref":"#/$defs/ApplicationReadManyResult"},{"$ref":"#/$defs/ApplicationReadResult"},{"$ref":"#/$defs/ApplicationRecoveryRequiredResult"},{"$ref":"#/$defs/ApplicationRejectedResult"},{"$ref":"#/$defs/ApplicationRelatedResult"},{"$ref":"#/$defs/ApplicationRouteResult"},{"$ref":"#/$defs/ApplicationRoutingFactsResult"},{"$ref":"#/$defs/ApplyCall"},{"$ref":"#/$defs/ApplyProposalCall"},{"$ref":"#/$defs/ApplyProposalResult"},{"$ref":"#/$defs/CompactReadResult"},{"$ref":"#/$defs/CompactRouteResult"},{"$ref":"#/$defs/CompleteResult"},{"$ref":"#/$defs/CreateProposalCall"},{"$ref":"#/$defs/CreateProposalResult"},{"$ref":"#/$defs/CreateSnapshotCall"},{"$ref":"#/$defs/CreateSnapshotResult"},{"$ref":"#/$defs/DeleteSnapshotCall"},{"$ref":"#/$defs/DeleteSnapshotResult"},{"$ref":"#/$defs/DescribeInputCall"},{"$ref":"#/$defs/DescribeOutputCall"},{"$ref":"#/$defs/FindProposalsCall"},{"$ref":"#/$defs/FindProposalsResult"},{"$ref":"#/$defs/FindSnapshotsCall"},{"$ref":"#/$defs/FindSnapshotsResult"},{"$ref":"#/$defs/InputContractRejectedResult"},{"$ref":"#/$defs/InputContractResult"},{"$ref":"#/$defs/InspectCall"},{"$ref":"#/$defs/InspectionResult"},{"$ref":"#/$defs/MaintainEvidenceCall"},{"$ref":"#/$defs/MaintainEvidenceResult"},{"$ref":"#/$defs/NavigationIndexesResult"},{"$ref":"#/$defs/OperationalReadResult"},{"$ref":"#/$defs/OutputContractRejectedResult"},{"$ref":"#/$defs/OutputContractResult"},{"$ref":"#/$defs/PendingResult"},{"$ref":"#/$defs/PrepareCall"},{"$ref":"#/$defs/PreviewApplicationCall"},{"$ref":"#/$defs/PreviewApplicationResult"},{"$ref":"#/$defs/ProposeCall"},{"$ref":"#/$defs/ProvenanceReadResult"},{"$ref":"#/$defs/QueryCall"},{"$ref":"#/$defs/QueryProposalCall"},{"$ref":"#/$defs/QueryProposalResult"},{"$ref":"#/$defs/QueryResult"},{"$ref":"#/$defs/ReadCall"},{"$ref":"#/$defs/ReadManyCall"},{"$ref":"#/$defs/ReadManyResult"},{"$ref":"#/$defs/ReadResult"},{"$ref":"#/$defs/RecoverApplicationCall"},{"$ref":"#/$defs/RecoverApplicationResult"},{"$ref":"#/$defs/RecoverCall"},{"$ref":"#/$defs/RejectedResult"},{"$ref":"#/$defs/RelatedCall"},{"$ref":"#/$defs/RelatedResult"},{"$ref":"#/$defs/RelationshipGroupsCall"},{"$ref":"#/$defs/RelationshipGroupsResult"},{"$ref":"#/$defs/ResolveCall"},{"$ref":"#/$defs/ResolveManyCall"},{"$ref":"#/$defs/ResolveWorkflowCall"},{"$ref":"#/$defs/ResumeCall"},{"$ref":"#/$defs/ReviewCall"},{"$ref":"#/$defs/ReviewProposalCall"},{"$ref":"#/$defs/ReviewProposalResult"},{"$ref":"#/$defs/ReviseCall"},{"$ref":"#/$defs/ReviseProposalCall"},{"$ref":"#/$defs/ReviseProposalResult"},{"$ref":"#/$defs/RouteCall"},{"$ref":"#/$defs/RoutingFactsCall"},{"$ref":"#/$defs/RoutingFactsResult"},{"$ref":"#/$defs/RuntimeInfoCall"},{"$ref":"#/$defs/RuntimeInfoResult"},{"$ref":"#/$defs/UndeleteSnapshotCall"},{"$ref":"#/$defs/UndeleteSnapshotResult"},{"$ref":"#/$defs/VerifyProposalCall"},{"$ref":"#/$defs/VerifyProposalResult"},{"$ref":"#/$defs/VerifyRepositoryCall"},{"$ref":"#/$defs/VerifyRepositoryResult"},{"$ref":"#/$defs/WorkflowDetailsCall"},{"$ref":"#/$defs/WorkflowDetailsResult"},{"$ref":"#/$defs/WorkflowResult"},{"$ref":"#/$defs/WorkflowStatusCall"}],"$defs":{"NonEmptyString":{"type":"string","minLength":1},"CanonicalId":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9._:/-]*$"},"EdgeId":{"type":"string","minLength":1},"Digest":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$","maxLength":71},"GitObjectId":{"oneOf":[{"type":"string","pattern":"^[0-9a-f]{40}$"},{"type":"string","pattern":"^[0-9a-f]{64}$"}]},"ObligationId":{"type":"string","pattern":"^obligation:sha256:[0-9a-f]{64}$"},"ImpactTraceId":{"type":"string","pattern":"^impact-trace:sha256:[0-9a-f]{64}$"},"FactRequirementId":{"type":"string","pattern":"^fact-requirement:sha256:[0-9a-f]{64}$"},"ScalarValue":{"oneOf":[{"type":"boolean"},{"type":"integer"},{"type":"string"},{"type":"null"}]},"FactValue":{"oneOf":[{"type":"object","required":["type","state","value"],"properties":{"type":{"const":"boolean"},"state":{"const":"known"},"value":{"type":"boolean"}},"additionalProperties":false},{"type":"object","required":["type","state","value"],"properties":{"type":{"enum":["boolean","enum","string","string-set","enum-set","canonical-id"]},"state":{"const":"known"},"value":{"type":"null"}},"additionalProperties":false},{"type":"object","required":["type","state","value"],"properties":{"type":{"enum":["enum","string","canonical-id"]},"state":{"const":"known"},"value":{"type":"string"}},"additionalProperties":false},{"type":"object","required":["type","state","value"],"properties":{"type":{"enum":["string-set","enum-set"]},"state":{"const":"known"},"value":{"type":"array","items":{"type":"string"},"uniqueItems":true}},"additionalProperties":false},{"type":"object","required":["type","state"],"properties":{"type":{"enum":["boolean","enum","string","string-set","enum-set","canonical-id"]},"state":{"enum":["known-absent","unknown"]}},"additionalProperties":false}]},"FactSet":{"type":"object","additionalProperties":{"$ref":"#/$defs/FactValue"}},"StructuredScope":{"type":"object","required":["kind","heading_path"],"properties":{"kind":{"const":"structured"},"heading_path":{"type":"array","minItems":1,"items":{"$ref":"#/$defs/NonEmptyString"}}},"additionalProperties":false},"WholeArtifactScope":{"type":"object","required":["kind"],"properties":{"kind":{"const":"whole-artifact"}},"additionalProperties":false},"ReviewScope":{"oneOf":[{"$ref":"#/$defs/StructuredScope"},{"$ref":"#/$defs/WholeArtifactScope"}]},"AllExpression":{"type":"object","required":["operator","expressions"],"properties":{"operator":{"const":"all"},"expressions":{"type":"array","minItems":1,"items":{"$ref":"#/$defs/ApplicabilityExpression"}}},"additionalProperties":false},"AnyExpression":{"type":"object","required":["operator","expressions"],"properties":{"operator":{"const":"any"},"expressions":{"type":"array","minItems":1,"items":{"$ref":"#/$defs/ApplicabilityExpression"}}},"additionalProperties":false},"NotExpression":{"type":"object","required":["operator","expression"],"properties":{"operator":{"const":"not"},"expression":{"$ref":"#/$defs/ApplicabilityExpression"}},"additionalProperties":false},"EqualsExpression":{"type":"object","required":["operator","fact","value"],"properties":{"operator":{"const":"equals"},"fact":{"$ref":"#/$defs/CanonicalId"},"value":{"$ref":"#/$defs/ScalarValue"}},"additionalProperties":false},"InExpression":{"type":"object","required":["operator","fact","values"],"properties":{"operator":{"const":"in"},"fact":{"$ref":"#/$defs/CanonicalId"},"values":{"type":"array","minItems":1,"uniqueItems":true,"items":{"$ref":"#/$defs/ScalarValue"}}},"additionalProperties":false},"ContainsExpression":{"type":"object","required":["operator","fact","value"],"properties":{"operator":{"const":"contains"},"fact":{"$ref":"#/$defs/CanonicalId"},"value":{"$ref":"#/$defs/ScalarValue"}},"additionalProperties":false},"ExistsExpression":{"type":"object","required":["operator","fact"],"properties":{"operator":{"const":"exists"},"fact":{"$ref":"#/$defs/CanonicalId"}},"additionalProperties":false},"AlwaysExpression":{"type":"object","required":["operator"],"properties":{"operator":{"const":"always"}},"additionalProperties":false},"ApplicabilityExpression":{"oneOf":[{"$ref":"#/$defs/AlwaysExpression"},{"$ref":"#/$defs/AllExpression"},{"$ref":"#/$defs/AnyExpression"},{"$ref":"#/$defs/NotExpression"},{"$ref":"#/$defs/EqualsExpression"},{"$ref":"#/$defs/InExpression"},{"$ref":"#/$defs/ContainsExpression"},{"$ref":"#/$defs/ExistsExpression"}]},"GeneralSelectionReason":{"type":"object","required":["kind"],"properties":{"kind":{"enum":["routing-fact","requires","specializes","changed-policy","question","audit-coverage","unmapped-normative-change","structured-scope-analysis-unsupported","navigation-index-change","supporting-content-change"]},"source":{"$ref":"#/$defs/CanonicalId"},"fact":{"$ref":"#/$defs/CanonicalId"},"edge":{"$ref":"#/$defs/EdgeId"},"question":{"$ref":"#/$defs/CanonicalId"}},"additionalProperties":false},"PolicyImpactSelectionReason":{"type":"object","required":["kind","source","edge","relation","evidence_owner","traces"],"properties":{"kind":{"const":"policy-impact-edge"},"source":{"$ref":"#/$defs/CanonicalId"},"edge":{"$ref":"#/$defs/EdgeId"},"relation":{"$ref":"#/$defs/CanonicalId"},"evidence_owner":{"$ref":"#/$defs/CanonicalId"},"traces":{"type":"array","minItems":1,"uniqueItems":true,"items":{"$ref":"#/$defs/ImpactTraceReference"}}},"additionalProperties":false},"SelectionReason":{"oneOf":[{"$ref":"#/$defs/GeneralSelectionReason"},{"$ref":"#/$defs/PolicyImpactSelectionReason"}]},"ImpactTraceReference":{"type":"object","required":["id","graph","applicability"],"properties":{"id":{"$ref":"#/$defs/ImpactTraceId"},"graph":{"enum":["accepted","proposed"]},"applicability":{"enum":["true","false","unknown"]}},"additionalProperties":false},"ConsumerReviewObligationReadingReason":{"type":"object","required":["kind","obligation"],"properties":{"kind":{"const":"consumer-review-obligation"},"obligation":{"$ref":"#/$defs/ObligationId"}},"additionalProperties":false},"RoutingBaseReadingReason":{"type":"object","required":["kind","projection"],"properties":{"kind":{"const":"routing-base"},"projection":{"$ref":"#/$defs/CanonicalId"}},"additionalProperties":false},"RoutingRuleReadingReason":{"type":"object","required":["kind","rule","facts"],"properties":{"kind":{"const":"routing-rule"},"rule":{"$ref":"#/$defs/CanonicalId"},"facts":{"type":"array","uniqueItems":true,"items":{"$ref":"#/$defs/CanonicalId"}}},"additionalProperties":false},"RequiresReadingReason":{"type":"object","required":["kind","edge","source"],"properties":{"kind":{"const":"requires"},"edge":{"$ref":"#/$defs/EdgeId"},"source":{"$ref":"#/$defs/CanonicalId"}},"additionalProperties":false},"SpecializesReadingReason":{"type":"object","required":["kind","edge","source"],"properties":{"kind":{"const":"specializes"},"edge":{"$ref":"#/$defs/EdgeId"},"source":{"$ref":"#/$defs/CanonicalId"}},"additionalProperties":false},"ReadingPlanReason":{"oneOf":[{"$ref":"#/$defs/ConsumerReviewObligationReadingReason"},{"$ref":"#/$defs/RoutingBaseReadingReason"},{"$ref":"#/$defs/RoutingRuleReadingReason"},{"$ref":"#/$defs/RequiresReadingReason"},{"$ref":"#/$defs/SpecializesReadingReason"}]},"ReadingPlanEntry":{"type":"object","required":["target","scope","authority","reasons","state"],"properties":{"target":{"$ref":"#/$defs/CanonicalId"},"scope":{"$ref":"#/$defs/ReviewScope"},"authority":{"enum":["normative","projection","contextual","evidence"]},"reasons":{"type":"array","minItems":1,"uniqueItems":true,"items":{"$ref":"#/$defs/ReadingPlanReason"}},"state":{"enum":["selected","conditional","unresolved"]}},"additionalProperties":false},"RouteRequest":{"type":"object","required":["kind","facts"],"properties":{"kind":{"const":"route"},"facts":{"$ref":"#/$defs/FactSet"}},"additionalProperties":false},"ReadRequest":{"type":"object","required":["kind","target"],"properties":{"kind":{"const":"read"},"target":{"$ref":"#/$defs/CanonicalId"},"include_routing":{"type":"boolean"},"include_coverage":{"type":"boolean","description":"Include current repository attestation status for registered policy units in this read scope."}},"additionalProperties":false},"RelatedRequest":{"type":"object","required":["kind","target","groups","direction","transitive"],"properties":{"kind":{"const":"related"},"target":{"$ref":"#/$defs/CanonicalId"},"groups":{"type":"array","minItems":1,"uniqueItems":true,"items":{"$ref":"#/$defs/CanonicalId"}},"direction":{"enum":["incoming","outgoing","both"]},"transitive":{"type":"boolean","default":false}},"additionalProperties":false},"QueryRequest":{"oneOf":[{"$ref":"#/$defs/RouteRequest"},{"$ref":"#/$defs/ReadRequest"},{"$ref":"#/$defs/RelatedRequest"}]},"PolicyUnitDeclaration":{"type":"object","required":["kind","id","module","heading_path","semantic_revision","lifecycle"],"properties":{"kind":{"const":"policy-unit"},"id":{"$ref":"#/$defs/CanonicalId"},"module":{"$ref":"#/$defs/CanonicalId"},"heading_path":{"type":"array","minItems":1,"items":{"$ref":"#/$defs/NonEmptyString"}},"semantic_revision":{"type":"integer","minimum":1},"lifecycle":{"const":"active"},"aliases":{"type":"array","uniqueItems":true,"items":{"$ref":"#/$defs/CanonicalId"}},"predecessors":{"type":"array","uniqueItems":true,"items":{"$ref":"#/$defs/CanonicalId"}},"successors":{"type":"array","uniqueItems":true,"items":{"$ref":"#/$defs/CanonicalId"}}},"additionalProperties":false},"CanonicalModuleDeclaration":{"type":"object","required":["kind","id","role","level","applies_when","does_not_apply_when","requires","specializes","verification"],"properties":{"kind":{"const":"canonical-module"},"id":{"$ref":"#/$defs/CanonicalId"},"role":{"enum":["core","router","workflow","profile","topic","reference"]},"level":{"enum":["MUST","SHOULD","PROFILE","REFERENCE"]},"applies_when":{"$ref":"#/$defs/NonEmptyString"},"does_not_apply_when":{"$ref":"#/$defs/NonEmptyString"},"requires":{"type":"array","uniqueItems":true,"items":{"$ref":"#/$defs/CanonicalId"}},"specializes":{"type":"array","uniqueItems":true,"items":{"$ref":"#/$defs/CanonicalId"}},"verification":{"$ref":"#/$defs/NonEmptyString"}},"additionalProperties":false},"PolicyRelationshipInspection":{"type":"object","required":["relationship_kind","applicability","source_scope","consumer_scope","propagation","evidence_owner","rationale"],"properties":{"relationship_kind":{"enum":["normative-consumer","router-projection","prompt-projection","template-projection","reference-projection","fixture-projection","enforcement-suite-projection","documentation-projection","implementation-projection"]},"applicability":{"$ref":"#/$defs/ApplicabilityExpression"},"source_scope":{"oneOf":[{"$ref":"#/$defs/ReviewScope"},{"type":"null"}]},"consumer_scope":{"oneOf":[{"$ref":"#/$defs/ReviewScope"},{"type":"null"}]},"propagation":{"const":"source-to-consumer"},"evidence_owner":{"$ref":"#/$defs/CanonicalId"},"rationale":{"$ref":"#/$defs/NonEmptyString"}},"additionalProperties":false},"SemanticProposal":{"type":"object","required":["policy","accepted_semantic_revision","proposed_semantic_revision","intent","structural_digest"],"properties":{"policy":{"$ref":"#/$defs/CanonicalId"},"accepted_semantic_revision":{"oneOf":[{"type":"integer","minimum":1},{"type":"null"}]},"proposed_semantic_revision":{"type":"integer","minimum":1},"intent":{"$ref":"#/$defs/NonEmptyString"},"structural_digest":{"$ref":"#/$defs/Digest"}},"additionalProperties":false},"ChangeDescriptor":{"type":"object","required":["kind","accepted_ids","proposed_ids","scope"],"properties":{"kind":{"enum":["module","modification","addition","removal","move","split","merge","navigation-index","supporting-content"]},"accepted_ids":{"type":"array","uniqueItems":true,"items":{"$ref":"#/$defs/CanonicalId"}},"proposed_ids":{"type":"array","uniqueItems":true,"items":{"$ref":"#/$defs/CanonicalId"}},"scope":{"$ref":"#/$defs/ReviewScope"},"accepted_module":{"$ref":"#/$defs/CanonicalId"},"proposed_module":{"$ref":"#/$defs/CanonicalId"}},"additionalProperties":false},"ChangedPolicyUnit":{"type":"object","required":["policy","change_kind","classification","accepted_representation_digest","proposed_representation_digest","accepted_structural_digest","proposed_structural_digest","accepted_semantic_revision","proposed_semantic_revision","semantic_state","scope"],"properties":{"policy":{"$ref":"#/$defs/CanonicalId"},"change_kind":{"enum":["modification","addition","removal","move","split-predecessor","split-successor","merge-predecessor","merge-successor"]},"classification":{"enum":["unchanged","representation-only-candidate","possibly-semantically-changed","semantically-changed","unresolved"]},"accepted_representation_digest":{"oneOf":[{"$ref":"#/$defs/Digest"},{"type":"null"}]},"proposed_representation_digest":{"oneOf":[{"$ref":"#/$defs/Digest"},{"type":"null"}]},"accepted_structural_digest":{"oneOf":[{"$ref":"#/$defs/Digest"},{"type":"null"}]},"proposed_structural_digest":{"oneOf":[{"$ref":"#/$defs/Digest"},{"type":"null"}]},"accepted_semantic_revision":{"oneOf":[{"type":"integer","minimum":1},{"type":"null"}]},"proposed_semantic_revision":{"oneOf":[{"type":"integer","minimum":1},{"type":"null"}]},"semantic_state":{"enum":["accepted-unchanged","proposed","removed","unresolved"]},"scope":{"$ref":"#/$defs/ReviewScope"}},"additionalProperties":false},"Question":{"type":"object","required":["id","kind","prompt","state","permitted_answers"],"properties":{"id":{"$ref":"#/$defs/CanonicalId"},"kind":{"enum":["applicability-fact","normative-classification","identity-resolution","scope-resolution"]},"prompt":{"$ref":"#/$defs/NonEmptyString"},"state":{"enum":["required","answered","blocked"]},"permitted_answers":{"type":"array","minItems":1,"uniqueItems":true,"items":{"$ref":"#/$defs/NonEmptyString"}}},"additionalProperties":false},"ConsumerReviewContract":{"type":"object","required":["kind","id","version","permitted_dispositions","evidence_contract","authorization_capability","semantics"],"properties":{"kind":{"const":"consumer-review-contract"},"id":{"$ref":"#/$defs/CanonicalId"},"version":{"type":"integer","minimum":1},"permitted_dispositions":{"type":"array","minItems":1,"uniqueItems":true,"items":{"enum":["updated","reviewed-no-change","not-applicable","blocked"]}},"evidence_contract":{"$ref":"#/$defs/CanonicalId"},"authorization_capability":{"$ref":"#/$defs/CanonicalId"},"semantics":{"$ref":"#/$defs/NonEmptyString"}},"additionalProperties":false},"DecisionDependency":{"type":"object","required":["class","identity","digest"],"properties":{"class":{"enum":["policy-unit","semantic-revision","structure","representation","module-locator","applicability-fact","relationship","audit","exception","evidence","provider-contract","applicability-contract","analysis-contract"]},"identity":{"$ref":"#/$defs/NonEmptyString"},"digest":{"$ref":"#/$defs/Digest"}},"additionalProperties":false},"DecisionFingerprint":{"type":"object","required":["decision_kind","decision_contract","schema_version","dependencies"],"properties":{"decision_kind":{"$ref":"#/$defs/CanonicalId"},"decision_contract":{"$ref":"#/$defs/CanonicalId"},"schema_version":{"const":1},"dependencies":{"type":"array","minItems":1,"items":{"$ref":"#/$defs/DecisionDependency"}}},"additionalProperties":false},"FactValueContract":{"type":"object","required":["type","states","nullable"],"properties":{"type":{"enum":["boolean","enum","string","string-set","enum-set","canonical-id"]},"states":{"const":["known","known-absent"]},"nullable":{"type":"boolean"},"values":{"type":"array","minItems":1,"uniqueItems":true,"items":{"type":"string"}}},"additionalProperties":false},"EvidenceReference":{"type":"object","required":["id","digest","provider_contract","provider_contract_version"],"properties":{"id":{"$ref":"#/$defs/CanonicalId"},"digest":{"$ref":"#/$defs/Digest"},"provider_contract":{"$ref":"#/$defs/CanonicalId"},"provider_contract_version":{"$ref":"#/$defs/NonEmptyString"}},"additionalProperties":false},"CompletionProof":{"type":"object","required":["required_coverage_subjects","certificate_subjects","reached_consumer_obligations","disposition_obligations","required_fact_requirements","observed_fact_requirements","non_consumer_obligations_resolved","applicability_resolved","authorization_valid","evidence_valid"],"properties":{"required_coverage_subjects":{"type":"array","uniqueItems":true,"items":{"$ref":"#/$defs/CanonicalId"}},"certificate_subjects":{"type":"array","uniqueItems":true,"items":{"$ref":"#/$defs/CanonicalId"}},"reached_consumer_obligations":{"type":"array","uniqueItems":true,"items":{"$ref":"#/$defs/ObligationId"}},"disposition_obligations":{"type":"array","uniqueItems":true,"items":{"$ref":"#/$defs/ObligationId"}},"required_fact_requirements":{"type":"array","uniqueItems":true,"items":{"$ref":"#/$defs/FactRequirementId"}},"observed_fact_requirements":{"type":"array","uniqueItems":true,"items":{"$ref":"#/$defs/FactRequirementId"}},"non_consumer_obligations_resolved":{"const":true},"applicability_resolved":{"const":true},"authorization_valid":{"const":true},"evidence_valid":{"const":true}},"additionalProperties":false},"Timestamp":{"type":"integer","minimum":0},"SnapshotId":{"type":"string","pattern":"^snapshot:v1:[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"},"AnalysisId":{"type":"string","pattern":"^analysis:sha256:[0-9a-f]{64}$"},"ProposalId":{"type":"string","pattern":"^proposal:v1:[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"},"ProposalRevisionId":{"type":"string","pattern":"^proposal-revision:sha256:[0-9a-f]{64}$"},"ReadinessId":{"type":"string","pattern":"^readiness:sha256:[0-9a-f]{64}$"},"ApplicationId":{"type":"string","pattern":"^application:sha256:[0-9a-f]{64}$"},"ChildId":{"type":"string","pattern":"^sha256:[0-9a-f]{64}$"},"AuthorizationId":{"type":"string","pattern":"^authorization:sha256:[0-9a-f]{64}$"},"SnapshotHandle":{"type":"object","required":["kind","id","schema_version"],"properties":{"kind":{"const":"snapshot-handle"},"id":{"$ref":"#/$defs/SnapshotId"},"schema_version":{"const":5}},"additionalProperties":false},"AnalysisHandle":{"type":"object","required":["kind","id","schema_version"],"properties":{"kind":{"const":"analysis-handle"},"id":{"$ref":"#/$defs/AnalysisId"},"schema_version":{"const":7}},"additionalProperties":false},"ProposalHandle":{"type":"object","required":["kind","id","schema_version"],"properties":{"kind":{"const":"proposal-handle"},"id":{"$ref":"#/$defs/ProposalId"},"schema_version":{"const":1}},"additionalProperties":false},"ProposalRevisionHandle":{"type":"object","required":["kind","id","schema_version"],"properties":{"kind":{"const":"proposal-revision-handle"},"id":{"$ref":"#/$defs/ProposalRevisionId"},"schema_version":{"const":1}},"additionalProperties":false},"ReadinessHandle":{"type":"object","required":["kind","id","schema_version"],"properties":{"kind":{"const":"readiness-handle"},"id":{"$ref":"#/$defs/ReadinessId"},"schema_version":{"const":1}},"additionalProperties":false},"ApplicationHandle":{"type":"object","required":["kind","id","schema_version"],"properties":{"kind":{"const":"application-handle"},"id":{"$ref":"#/$defs/ApplicationId"},"schema_version":{"const":1}},"additionalProperties":false},"SnapshotChildHandle":{"type":"object","required":["kind","snapshot","child_kind","child_id","schema_version"],"properties":{"kind":{"const":"snapshot-child-handle"},"snapshot":{"$ref":"#/$defs/SnapshotHandle"},"child_kind":{"enum":["policy","relationship"]},"child_id":{"$ref":"#/$defs/NonEmptyString"},"schema_version":{"const":5}},"additionalProperties":false},"AnalysisChildHandle":{"type":"object","required":["kind","analysis","child_kind","child_id","schema_version"],"properties":{"kind":{"const":"analysis-child-handle"},"analysis":{"$ref":"#/$defs/AnalysisHandle"},"child_kind":{"enum":["context","fact-requirement","fact-observation","obligation","coverage-requirement","coverage-certificate"]},"child_id":{"$ref":"#/$defs/ChildId"},"schema_version":{"const":7}},"additionalProperties":false},"AnalysisMaterialHandle":{"oneOf":[{"$ref":"#/$defs/SnapshotHandle"},{"$ref":"#/$defs/ProposalRevisionHandle"}]},"InspectableHandle":{"oneOf":[{"$ref":"#/$defs/SnapshotHandle"},{"$ref":"#/$defs/AnalysisHandle"},{"$ref":"#/$defs/SnapshotChildHandle"},{"$ref":"#/$defs/AnalysisChildHandle"}]},"ActiveSnapshotSummary":{"type":"object","required":["snapshot","lifecycle","source_revision","created_at"],"properties":{"snapshot":{"$ref":"#/$defs/SnapshotHandle"},"lifecycle":{"const":"active"},"source_revision":{"$ref":"#/$defs/NonEmptyString"},"created_at":{"$ref":"#/$defs/Timestamp"}},"additionalProperties":false},"QuarantinedSnapshotSummary":{"type":"object","required":["snapshot","lifecycle","source_revision","created_at","purge_deadline"],"properties":{"snapshot":{"$ref":"#/$defs/SnapshotHandle"},"lifecycle":{"const":"quarantined"},"source_revision":{"$ref":"#/$defs/NonEmptyString"},"created_at":{"$ref":"#/$defs/Timestamp"},"purge_deadline":{"$ref":"#/$defs/Timestamp"}},"additionalProperties":false},"SnapshotSummary":{"oneOf":[{"$ref":"#/$defs/ActiveSnapshotSummary"},{"$ref":"#/$defs/QuarantinedSnapshotSummary"}]},"CreateSnapshotCall":{"type":"object","required":["kind"],"properties":{"kind":{"const":"create-snapshot"}},"additionalProperties":false},"CreateSnapshotResult":{"type":"object","required":["kind","snapshot"],"properties":{"kind":{"const":"create-snapshot-result"},"snapshot":{"$ref":"#/$defs/ActiveSnapshotSummary"}},"additionalProperties":false},"FindSnapshotsCall":{"type":"object","required":["kind"],"properties":{"kind":{"const":"find-snapshots"},"lifecycle":{"enum":["active","quarantined"],"default":"active"},"after":{"$ref":"#/$defs/SnapshotHandle"},"limit":{"type":"integer","minimum":1,"default":50}},"additionalProperties":false},"FindSnapshotsResult":{"type":"object","required":["kind","snapshots"],"properties":{"kind":{"const":"find-snapshots-result"},"snapshots":{"type":"array","items":{"$ref":"#/$defs/SnapshotSummary"}},"continuation":{"$ref":"#/$defs/SnapshotHandle"}},"additionalProperties":false},"StandardsChangePurpose":{"type":"object","required":["summary","rationale","evidence"],"properties":{"summary":{"$ref":"#/$defs/NonEmptyString"},"rationale":{"$ref":"#/$defs/NonEmptyString"},"evidence":{"type":"array","minItems":1,"uniqueItems":true,"items":{"$ref":"#/$defs/EvidenceReference"}}},"additionalProperties":false},"StandardContent":{"type":"object","required":["id","title","role","level","applies_when","does_not_apply_when","verification","body"],"properties":{"id":{"$ref":"#/$defs/CanonicalId"},"title":{"$ref":"#/$defs/NonEmptyString"},"role":{"enum":["core","router","workflow","profile","topic","reference"]},"level":{"enum":["MUST","SHOULD","PROFILE","REFERENCE"]},"applies_when":{"$ref":"#/$defs/NonEmptyString"},"does_not_apply_when":{"$ref":"#/$defs/NonEmptyString"},"verification":{"$ref":"#/$defs/NonEmptyString"},"body":{"$ref":"#/$defs/NonEmptyString"}},"additionalProperties":false},"NewPolicyUnit":{"type":"object","required":["id","heading_chain","semantic_revision","intent","aliases","predecessors","successors"],"properties":{"id":{"$ref":"#/$defs/CanonicalId"},"heading_chain":{"type":"array","minItems":1,"items":{"$ref":"#/$defs/NonEmptyString"}},"semantic_revision":{"const":1},"intent":{"$ref":"#/$defs/NonEmptyString"},"aliases":{"type":"array","uniqueItems":true,"items":{"$ref":"#/$defs/CanonicalId"}},"predecessors":{"type":"array","uniqueItems":true,"items":{"$ref":"#/$defs/CanonicalId"}},"successors":{"type":"array","uniqueItems":true,"items":{"$ref":"#/$defs/CanonicalId"}}},"additionalProperties":false},"PreservePolicySemantics":{"type":"object","required":["kind","semantic_revision","intent"],"properties":{"kind":{"const":"preserve"},"semantic_revision":{"type":"integer","minimum":1},"intent":{"$ref":"#/$defs/NonEmptyString"}},"additionalProperties":false},"ChangePolicySemantics":{"type":"object","required":["kind","accepted_semantic_revision","proposed_semantic_revision","intent"],"properties":{"kind":{"const":"change"},"accepted_semantic_revision":{"type":"integer","minimum":1},"proposed_semantic_revision":{"type":"integer","minimum":1},"intent":{"$ref":"#/$defs/NonEmptyString"}},"additionalProperties":false},"PolicySemanticIntent":{"oneOf":[{"$ref":"#/$defs/PreservePolicySemantics"},{"$ref":"#/$defs/ChangePolicySemantics"}]},"CreateStandardEdit":{"type":"object","required":["kind","standard","requires","specializes","policy_units"],"properties":{"kind":{"const":"create-standard"},"standard":{"$ref":"#/$defs/StandardContent"},"requires":{"type":"array","uniqueItems":true,"items":{"$ref":"#/$defs/CanonicalId"}},"specializes":{"type":"array","uniqueItems":true,"items":{"$ref":"#/$defs/CanonicalId"}},"policy_units":{"type":"array","uniqueItems":true,"items":{"$ref":"#/$defs/NewPolicyUnit"}}},"additionalProperties":false},"RegisterPolicyUnitEdit":{"type":"object","description":"Register an explicitly selected policy scope in an existing standard. The Engine owns declaration placement and validates the final candidate.","required":["kind","standard","policy_unit"],"properties":{"kind":{"const":"register-policy-unit"},"standard":{"$ref":"#/$defs/CanonicalId"},"policy_unit":{"$ref":"#/$defs/NewPolicyUnit"}},"additionalProperties":false},"ReviseStandardEdit":{"type":"object","required":["kind","standard"],"properties":{"kind":{"const":"revise-standard"},"standard":{"$ref":"#/$defs/StandardContent"},"scope_updates":{"type":"array","items":{"$ref":"#/$defs/PolicyScopeUpdate"}}},"additionalProperties":false},"RevisePolicyUnitEdit":{"type":"object","required":["kind","policy","title","body","semantics"],"properties":{"kind":{"const":"revise-policy-unit"},"policy":{"$ref":"#/$defs/CanonicalId"},"title":{"$ref":"#/$defs/NonEmptyString"},"body":{"$ref":"#/$defs/NonEmptyString"},"semantics":{"$ref":"#/$defs/PolicySemanticIntent"}},"additionalProperties":false},"MovePolicyUnitEdit":{"type":"object","required":["kind","policy","standard","semantics"],"properties":{"kind":{"const":"move-policy-unit"},"policy":{"$ref":"#/$defs/CanonicalId"},"standard":{"$ref":"#/$defs/CanonicalId"},"after_policy":{"$ref":"#/$defs/CanonicalId"},"semantics":{"$ref":"#/$defs/PolicySemanticIntent"}},"additionalProperties":false},"RetirePolicyUnitEdit":{"type":"object","required":["kind","policy","retired_semantic_revision","successors","relationship_dispositions","evidence"],"properties":{"kind":{"const":"retire-policy-unit"},"policy":{"$ref":"#/$defs/CanonicalId"},"retired_semantic_revision":{"type":"integer","minimum":1},"successors":{"type":"array","uniqueItems":true,"items":{"$ref":"#/$defs/CanonicalId"}},"relationship_dispositions":{"type":"array","uniqueItems":true,"items":{"$ref":"#/$defs/RelationshipDisposition"}},"evidence":{"type":"array","minItems":1,"uniqueItems":true,"items":{"$ref":"#/$defs/EvidenceReference"}}},"additionalProperties":false},"RetireStandardEdit":{"type":"object","required":["kind","standard","successors","relationship_dispositions","evidence"],"properties":{"kind":{"const":"retire-standard"},"standard":{"$ref":"#/$defs/CanonicalId"},"successors":{"type":"array","uniqueItems":true,"items":{"$ref":"#/$defs/CanonicalId"}},"relationship_dispositions":{"type":"array","uniqueItems":true,"items":{"$ref":"#/$defs/RelationshipDisposition"}},"evidence":{"type":"array","minItems":1,"uniqueItems":true,"items":{"$ref":"#/$defs/EvidenceReference"}}},"additionalProperties":false},"ReplaceStandardRelationshipsEdit":{"type":"object","required":["kind","standard","requires","specializes","rationale"],"properties":{"kind":{"const":"replace-standard-relationships"},"standard":{"$ref":"#/$defs/CanonicalId"},"requires":{"type":"array","uniqueItems":true,"items":{"$ref":"#/$defs/CanonicalId"}},"specializes":{"type":"array","uniqueItems":true,"items":{"$ref":"#/$defs/CanonicalId"}},"rationale":{"$ref":"#/$defs/NonEmptyString"}},"additionalProperties":false},"AuthoringTargetHandle":{"type":"object","required":["kind","snapshot","id","schema_version"],"properties":{"kind":{"const":"authoring-target-handle"},"snapshot":{"$ref":"#/$defs/SnapshotHandle"},"id":{"$ref":"#/$defs/ChildId"},"schema_version":{"const":5}},"additionalProperties":false},"RelationshipConsumer":{"oneOf":[{"$ref":"#/$defs/CanonicalId"},{"$ref":"#/$defs/AuthoringTargetHandle"}]},"PolicyRelationship":{"type":"object","required":["source_policy","consumer","relation","applicability","source_scope","consumer_scope","evidence_owner","rationale"],"properties":{"source_policy":{"$ref":"#/$defs/CanonicalId"},"consumer":{"$ref":"#/$defs/RelationshipConsumer"},"relation":{"enum":["normative-consumer","router-projection","prompt-projection","template-projection","reference-projection","fixture-projection","enforcement-suite-projection","documentation-projection","implementation-projection"]},"applicability":{"$ref":"#/$defs/ApplicabilityExpression"},"source_scope":{"oneOf":[{"$ref":"#/$defs/ReviewScope"},{"type":"null"}]},"consumer_scope":{"oneOf":[{"$ref":"#/$defs/ReviewScope"},{"type":"null"}]},"evidence_owner":{"$ref":"#/$defs/CanonicalId"},"rationale":{"$ref":"#/$defs/NonEmptyString"}},"additionalProperties":false},"PutPolicyRelationshipEdit":{"type":"object","required":["kind","relationship"],"properties":{"kind":{"const":"put-policy-relationship"},"relationship":{"$ref":"#/$defs/PolicyRelationship"}},"additionalProperties":false},"RemovePolicyRelationshipEdit":{"type":"object","required":["kind","relationship"],"properties":{"kind":{"const":"remove-policy-relationship"},"relationship":{"$ref":"#/$defs/PolicyRelationship"}},"additionalProperties":false},"ModuleRelationshipKey":{"type":"object","required":["kind","relation","source","target"],"properties":{"kind":{"const":"module-relationship"},"relation":{"enum":["requires","specializes"]},"source":{"$ref":"#/$defs/CanonicalId"},"target":{"$ref":"#/$defs/CanonicalId"}},"additionalProperties":false},"PolicyRelationshipKey":{"type":"object","required":["kind","source_policy","consumer","relation"],"properties":{"kind":{"const":"policy-relationship"},"source_policy":{"$ref":"#/$defs/CanonicalId"},"consumer":{"$ref":"#/$defs/RelationshipConsumer"},"relation":{"$ref":"#/$defs/CanonicalId"}},"additionalProperties":false},"RelationshipKey":{"oneOf":[{"$ref":"#/$defs/ModuleRelationshipKey"},{"$ref":"#/$defs/PolicyRelationshipKey"}]},"RelationshipDisposition":{"type":"object","required":["relationship","disposition","rationale","evidence"],"properties":{"relationship":{"$ref":"#/$defs/RelationshipKey"},"disposition":{"enum":["remove","retarget"]},"replacement_consumer":{"$ref":"#/$defs/RelationshipConsumer"},"rationale":{"$ref":"#/$defs/NonEmptyString"},"evidence":{"type":"array","minItems":1,"uniqueItems":true,"items":{"$ref":"#/$defs/EvidenceReference"}}},"additionalProperties":false},"StandardEdit":{"oneOf":[{"$ref":"#/$defs/CreateStandardEdit"},{"$ref":"#/$defs/RegisterPolicyUnitEdit"},{"$ref":"#/$defs/ReviseStandardEdit"},{"$ref":"#/$defs/RevisePolicyUnitEdit"},{"$ref":"#/$defs/MovePolicyUnitEdit"},{"$ref":"#/$defs/RetirePolicyUnitEdit"},{"$ref":"#/$defs/RetireStandardEdit"},{"$ref":"#/$defs/ReplaceStandardRelationshipsEdit"},{"$ref":"#/$defs/PutPolicyRelationshipEdit"},{"$ref":"#/$defs/RemovePolicyRelationshipEdit"},{"$ref":"#/$defs/PutRoutingRuleEdit"},{"$ref":"#/$defs/RemoveRoutingRuleEdit"},{"$ref":"#/$defs/PutRoutingFactEdit"},{"$ref":"#/$defs/RemoveRoutingFactEdit"},{"$ref":"#/$defs/AuditPolicyUnitEdit"},{"$ref":"#/$defs/RewriteNavigationIndexEdit"},{"$ref":"#/$defs/PutDecisionProvenanceEdit"},{"$ref":"#/$defs/RetireDecisionProvenanceEdit"},{"$ref":"#/$defs/ApproveApplicationContentEdit"},{"$ref":"#/$defs/WithdrawApplicationContentEdit"},{"$ref":"#/$defs/ReviseOperationalArtifactEdit"},{"$ref":"#/$defs/RegisterConsumerEdit"}]},"StandardsChangeSet":{"type":"object","required":["purpose","edits"],"properties":{"purpose":{"$ref":"#/$defs/StandardsChangePurpose"},"edits":{"type":"array","minItems":1,"uniqueItems":true,"items":{"$ref":"#/$defs/StandardEdit"}}},"additionalProperties":false},"ProposalSummary":{"type":"object","required":["proposal","head_revision"],"properties":{"proposal":{"$ref":"#/$defs/ProposalHandle"},"head_revision":{"$ref":"#/$defs/ProposalRevisionHandle"}},"additionalProperties":false},"CreateProposalCall":{"type":"object","required":["kind","base_snapshot","change_set"],"properties":{"kind":{"const":"create-proposal"},"base_snapshot":{"$ref":"#/$defs/SnapshotHandle"},"change_set":{"$ref":"#/$defs/StandardsChangeSet"}},"additionalProperties":false},"CreateProposalResult":{"type":"object","required":["kind","proposal","revision"],"properties":{"kind":{"const":"create-proposal-result"},"proposal":{"$ref":"#/$defs/ProposalHandle"},"revision":{"$ref":"#/$defs/ProposalRevisionHandle"}},"additionalProperties":false},"FindProposalsCall":{"type":"object","required":["kind"],"properties":{"kind":{"const":"find-proposals"},"after":{"$ref":"#/$defs/ProposalHandle"},"limit":{"type":"integer","minimum":1,"default":50}},"additionalProperties":false},"FindProposalsResult":{"type":"object","required":["kind","proposals"],"properties":{"kind":{"const":"find-proposals-result"},"proposals":{"type":"array","items":{"$ref":"#/$defs/ProposalSummary"}},"continuation":{"$ref":"#/$defs/ProposalHandle"}},"additionalProperties":false},"ReviseProposalCall":{"type":"object","required":["kind","expected_revision","change_set"],"properties":{"kind":{"const":"revise-proposal"},"expected_revision":{"$ref":"#/$defs/ProposalRevisionHandle"},"change_set":{"$ref":"#/$defs/StandardsChangeSet"}},"additionalProperties":false},"ReviseProposalResult":{"type":"object","required":["kind","proposal","revision"],"properties":{"kind":{"const":"revise-proposal-result"},"proposal":{"$ref":"#/$defs/ProposalHandle"},"revision":{"$ref":"#/$defs/ProposalRevisionHandle"}},"additionalProperties":false},"DeleteSnapshotCall":{"type":"object","required":["kind","snapshot"],"properties":{"kind":{"const":"delete-snapshot"},"snapshot":{"$ref":"#/$defs/SnapshotHandle"}},"additionalProperties":false},"DeleteSnapshotResult":{"type":"object","required":["kind","snapshot","purge_deadline"],"properties":{"kind":{"const":"delete-snapshot-result"},"snapshot":{"$ref":"#/$defs/SnapshotHandle"},"purge_deadline":{"$ref":"#/$defs/Timestamp"}},"additionalProperties":false},"UndeleteSnapshotCall":{"type":"object","required":["kind","snapshot"],"properties":{"kind":{"const":"undelete-snapshot"},"snapshot":{"$ref":"#/$defs/SnapshotHandle"}},"additionalProperties":false},"UndeleteSnapshotResult":{"type":"object","required":["kind","snapshot"],"properties":{"kind":{"const":"undelete-snapshot-result"},"snapshot":{"$ref":"#/$defs/ActiveSnapshotSummary"}},"additionalProperties":false},"QueryNextOperation":{"type":"object","required":["operation","request_kind","snapshot"],"properties":{"operation":{"const":"query"},"request_kind":{"enum":["route","read","related"]},"target":{"$ref":"#/$defs/CanonicalId"},"snapshot":{"$ref":"#/$defs/SnapshotHandle"}},"additionalProperties":false},"QueryProposalNextOperation":{"type":"object","required":["operation","request_kind","revision"],"properties":{"operation":{"const":"query_proposal"},"request_kind":{"enum":["route","read","related"]},"target":{"$ref":"#/$defs/CanonicalId"},"revision":{"$ref":"#/$defs/ProposalRevisionHandle"}},"additionalProperties":false},"ResolveNextOperation":{"type":"object","required":["operation","request_kind","analysis"],"properties":{"operation":{"const":"resolve"},"request_kind":{"enum":["provide-fact","consumer-disposition","impact-disposition","coverage-attestation"]},"target":{"$ref":"#/$defs/CanonicalId"},"work":{"$ref":"#/$defs/AnalysisChildHandle"},"analysis":{"$ref":"#/$defs/AnalysisHandle"}},"additionalProperties":false},"InspectNextOperation":{"type":"object","required":["operation","request_kind","handle"],"properties":{"operation":{"const":"inspect"},"request_kind":{"const":"inspect"},"handle":{"$ref":"#/$defs/InspectableHandle"}},"additionalProperties":false},"NextOperation":{"oneOf":[{"$ref":"#/$defs/QueryNextOperation"},{"$ref":"#/$defs/ResolveNextOperation"},{"$ref":"#/$defs/InspectNextOperation"},{"$ref":"#/$defs/FocusedQueryNextOperation"},{"$ref":"#/$defs/WorkflowDetailsNextOperation"}]},"QueryCall":{"type":"object","required":["snapshot","request"],"properties":{"snapshot":{"$ref":"#/$defs/SnapshotHandle"},"request":{"$ref":"#/$defs/QueryRequest"}},"additionalProperties":false},"QueryProposalCall":{"type":"object","required":["revision","request"],"properties":{"revision":{"$ref":"#/$defs/ProposalRevisionHandle"},"request":{"$ref":"#/$defs/QueryRequest"}},"additionalProperties":false},"AnalyzeProposalCall":{"type":"object","required":["revision"],"properties":{"revision":{"$ref":"#/$defs/ProposalRevisionHandle"}},"additionalProperties":false},"ReviewDecision":{"type":"object","required":["owner","decision","rationale","evidence"],"properties":{"owner":{"enum":["consumer","impact","audit"]},"decision":{"const":"accept"},"rationale":{"$ref":"#/$defs/NonEmptyString"},"evidence":{"type":"array","minItems":1,"uniqueItems":true,"items":{"$ref":"#/$defs/EvidenceReference"}}},"additionalProperties":false},"ReviewProposalCall":{"type":"object","required":["kind","analysis","decisions"],"properties":{"kind":{"const":"review-proposal"},"analysis":{"$ref":"#/$defs/AnalysisHandle"},"decisions":{"type":"array","minItems":3,"maxItems":3,"uniqueItems":true,"items":{"$ref":"#/$defs/ReviewDecision"}},"prior_readiness":{"$ref":"#/$defs/ReadinessHandle"}},"additionalProperties":false},"ReviewProposalResult":{"type":"object","required":["kind","readiness","revision","status"],"properties":{"kind":{"const":"review-proposal-result"},"readiness":{"$ref":"#/$defs/ReadinessHandle"},"revision":{"$ref":"#/$defs/ProposalRevisionHandle"},"status":{"const":"ready"}},"additionalProperties":false},"ApplyProposalCall":{"type":"object","required":["kind","readiness"],"properties":{"kind":{"const":"apply-proposal"},"readiness":{"$ref":"#/$defs/ReadinessHandle"}},"additionalProperties":false},"ApplyProposalResult":{"type":"object","required":["kind","application","status","publication","checkout"],"properties":{"kind":{"const":"apply-proposal-result"},"application":{"$ref":"#/$defs/ApplicationHandle"},"status":{"const":"applied"},"publication":{"$ref":"#/$defs/ApplicationPublicationReceipt"},"checkout":{"$ref":"#/$defs/PublicationCheckoutObservation"}},"additionalProperties":false},"RecoverApplicationCall":{"type":"object","required":["kind","readiness"],"properties":{"kind":{"const":"recover-application"},"readiness":{"$ref":"#/$defs/ReadinessHandle"},"action":{"enum":["observe","complete-publication"],"description":"Omit or select observe to reconcile only. Explicit complete-publication revalidates and attempts the same admitted candidate against its original expected target; it requires current publication authorization."}},"additionalProperties":false,"description":"Recover an admitted application. Observation performs no Git writes. Explicit completion reconstructs and verifies the exact admitted candidate before one compare-and-swap attempt."},"RecoverApplicationResult":{"type":"object","required":["kind","application","status","publication","checkout"],"properties":{"kind":{"const":"recover-application-result"},"application":{"$ref":"#/$defs/ApplicationHandle"},"status":{"const":"applied"},"publication":{"$ref":"#/$defs/ApplicationPublicationReceipt"},"checkout":{"$ref":"#/$defs/PublicationCheckoutObservation"}},"additionalProperties":false},"ApplicationRecoveryRequiredResult":{"type":"object","required":["kind","application","status","code","outcome","message","publication","checkout"],"properties":{"kind":{"const":"application-recovery-required-result"},"application":{"$ref":"#/$defs/ApplicationHandle"},"status":{"const":"recovery-required"},"code":{"enum":["APPLICATION.PUBLICATION_UNAVAILABLE","APPLICATION.OBSERVATION_UNAVAILABLE","APPLICATION.OUTCOME_OBSERVATION_UNAVAILABLE","APPLICATION.OUTCOME_PERSISTENCE_UNAVAILABLE","APPLICATION.RECOVERY_TARGET_UNCERTAIN","APPLICATION.RECOVERY_TARGET_DIVERGED","APPLICATION.RECOVERY_BLOCKED"]},"outcome":{"const":"unavailable"},"message":{"$ref":"#/$defs/NonEmptyString"},"publication":{"$ref":"#/$defs/ApplicationPublicationReceipt"},"checkout":{"$ref":"#/$defs/PublicationCheckoutObservation"},"details":{"type":"object","additionalProperties":{"$ref":"#/$defs/ScalarValue"}}},"additionalProperties":false},"PublicationTargetObservation":{"description":"Fresh bounded observation of the configured target ref; an unavailable revision is null.","type":"object","required":["kind","status","revision"],"properties":{"kind":{"const":"publication-target-observation"},"status":{"enum":["candidate","expected","diverged","unavailable"]},"revision":{"oneOf":[{"$ref":"#/$defs/GitObjectId"},{"type":"null"}]}},"additionalProperties":false},"ApplicationPublicationReceipt":{"description":"Durable application identity and exact candidate facts, separate from the fresh target observation.","type":"object","required":["kind","application","candidate_commit","candidate_tree","target_ref","expected_predecessor","durable_state","target_observation"],"properties":{"kind":{"const":"application-publication-receipt"},"application":{"$ref":"#/$defs/ApplicationHandle"},"candidate_commit":{"$ref":"#/$defs/GitObjectId"},"candidate_tree":{"oneOf":[{"$ref":"#/$defs/GitObjectId"},{"type":"null"}]},"target_ref":{"const":"refs/heads/main"},"expected_predecessor":{"$ref":"#/$defs/GitObjectId"},"durable_state":{"enum":["applied","admitted","unknown"]},"target_observation":{"$ref":"#/$defs/PublicationTargetObservation"}},"additionalProperties":false},"PublicationPathCounts":{"type":"object","required":["predecessor","candidate","conflicted"],"properties":{"predecessor":{"type":["integer","null"],"minimum":0},"candidate":{"type":["integer","null"],"minimum":0},"conflicted":{"type":["integer","null"],"minimum":0}},"additionalProperties":false},"PublicationCheckoutObservation":{"description":"Fresh read-only observation of one selected checkout. Unavailable observations use null for every fact that could not be established.","type":"object","required":["kind","status","worktree_id","symbolic_branch","head","index_observation","publication_path_count","index_paths","worktree_paths"],"properties":{"kind":{"const":"publication-checkout-observation"},"status":{"enum":["not-observed","unavailable","not-target-checkout","current","needs-reconciliation","conflicted"]},"worktree_id":{"oneOf":[{"$ref":"#/$defs/Digest"},{"type":"null"}]},"symbolic_branch":{"oneOf":[{"$ref":"#/$defs/NonEmptyString"},{"type":"null"}]},"head":{"oneOf":[{"$ref":"#/$defs/GitObjectId"},{"type":"null"}]},"index_observation":{"oneOf":[{"$ref":"#/$defs/Digest"},{"type":"null"}]},"publication_path_count":{"type":["integer","null"],"minimum":0},"index_paths":{"$ref":"#/$defs/PublicationPathCounts"},"worktree_paths":{"$ref":"#/$defs/PublicationPathCounts"}},"additionalProperties":false},"PolicySummary":{"type":"object","required":["handle","authority","scope"],"properties":{"handle":{"$ref":"#/$defs/SnapshotChildHandle"},"authority":{"enum":["normative","projection","contextual","evidence"]},"scope":{"$ref":"#/$defs/ReviewScope"}},"additionalProperties":false},"RelationshipSummary":{"type":"object","required":["handle","source","target","relation","groups","direction","traversal_eligible","applicability"],"properties":{"handle":{"$ref":"#/$defs/SnapshotChildHandle"},"source":{"$ref":"#/$defs/CanonicalId"},"target":{"$ref":"#/$defs/CanonicalId"},"relation":{"$ref":"#/$defs/CanonicalId"},"groups":{"type":"array","items":{"$ref":"#/$defs/CanonicalId"},"minItems":1,"uniqueItems":true},"direction":{"enum":["incoming","outgoing"]},"traversal_eligible":{"type":"boolean"},"applicability":{"enum":["true","false","unknown","not-declared"]}},"additionalProperties":false},"ProposalPolicySummary":{"type":"object","required":["id","authority","scope"],"properties":{"id":{"$ref":"#/$defs/CanonicalId"},"authority":{"enum":["normative","projection","contextual","evidence"]},"scope":{"$ref":"#/$defs/ReviewScope"}},"additionalProperties":false},"ProposalRelationshipSummary":{"type":"object","required":["source","target","relation","groups","direction","traversal_eligible","applicability"],"properties":{"source":{"$ref":"#/$defs/CanonicalId"},"target":{"$ref":"#/$defs/CanonicalId"},"relation":{"$ref":"#/$defs/CanonicalId"},"groups":{"type":"array","items":{"$ref":"#/$defs/CanonicalId"},"minItems":1,"uniqueItems":true},"direction":{"enum":["incoming","outgoing"]},"traversal_eligible":{"type":"boolean"},"applicability":{"enum":["true","false","unknown","not-declared"]}},"additionalProperties":false},"RouteResult":{"type":"object","required":["kind","snapshot","reading_plan","unresolved_questions","next_operations"],"properties":{"kind":{"const":"route-result"},"snapshot":{"$ref":"#/$defs/SnapshotHandle"},"reading_plan":{"type":"array","items":{"$ref":"#/$defs/ReadingPlanEntry"}},"unresolved_questions":{"type":"array","items":{"$ref":"#/$defs/Question"}},"next_operations":{"type":"array","items":{"$ref":"#/$defs/NextOperation"}},"summary":{"type":"string"}},"additionalProperties":false},"ReadResult":{"type":"object","required":["kind","snapshot","policy","content","requires","specializes","related","next_operations"],"properties":{"kind":{"const":"read-result"},"snapshot":{"$ref":"#/$defs/SnapshotHandle"},"policy":{"$ref":"#/$defs/PolicySummary"},"content":{"type":"string"},"requires":{"type":"array","items":{"$ref":"#/$defs/CanonicalId"},"uniqueItems":true},"specializes":{"type":"array","items":{"$ref":"#/$defs/CanonicalId"},"uniqueItems":true},"related":{"type":"array","items":{"$ref":"#/$defs/RelationshipSummary"}},"next_operations":{"type":"array","items":{"$ref":"#/$defs/NextOperation"}},"summary":{"type":"string"},"routing":{"$ref":"#/$defs/RoutingConfiguration"},"coverage":{"$ref":"#/$defs/ReadCoverage"},"application_exposure":{"$ref":"#/$defs/ApplicationExposureState"},"provenance":{"type":"array","items":{"$ref":"#/$defs/CanonicalId"}}},"additionalProperties":false},"PolicyUnitMapping":{"type":"object","required":["state","policy_units"],"properties":{"state":{"enum":["exact-policy-unit","policy-units-present","incomplete"]},"reason":{"const":"no-policy-units"},"policy_units":{"type":"array","items":{"$ref":"#/$defs/CanonicalId"},"uniqueItems":true}},"additionalProperties":false},"RelatedResult":{"type":"object","required":["kind","snapshot","target","policy_unit_mapping","relationships","next_operations"],"properties":{"kind":{"const":"related-result"},"snapshot":{"$ref":"#/$defs/SnapshotHandle"},"target":{"$ref":"#/$defs/CanonicalId"},"authoring_target":{"$ref":"#/$defs/AuthoringTargetHandle"},"policy_unit_mapping":{"$ref":"#/$defs/PolicyUnitMapping"},"relationships":{"type":"array","items":{"$ref":"#/$defs/RelationshipSummary"}},"next_operations":{"type":"array","items":{"$ref":"#/$defs/NextOperation"}},"summary":{"type":"string"}},"additionalProperties":false},"QueryResult":{"oneOf":[{"$ref":"#/$defs/RouteResult"},{"$ref":"#/$defs/ReadResult"},{"$ref":"#/$defs/RelatedResult"},{"$ref":"#/$defs/NavigationIndexesResult"},{"$ref":"#/$defs/ProvenanceReadResult"},{"$ref":"#/$defs/OperationalReadResult"}]},"ProposalRouteResult":{"type":"object","required":["kind","revision","reading_plan","unresolved_questions","next_operations"],"properties":{"kind":{"const":"proposal-route-result"},"revision":{"$ref":"#/$defs/ProposalRevisionHandle"},"reading_plan":{"type":"array","items":{"$ref":"#/$defs/ReadingPlanEntry"}},"unresolved_questions":{"type":"array","items":{"$ref":"#/$defs/Question"}},"next_operations":{"type":"array","items":{"$ref":"#/$defs/QueryProposalNextOperation"}},"summary":{"type":"string"}},"additionalProperties":false},"ProposalReadResult":{"type":"object","required":["kind","revision","policy","content","requires","specializes","related","next_operations"],"properties":{"kind":{"const":"proposal-read-result"},"revision":{"$ref":"#/$defs/ProposalRevisionHandle"},"policy":{"$ref":"#/$defs/ProposalPolicySummary"},"content":{"type":"string"},"requires":{"type":"array","items":{"$ref":"#/$defs/CanonicalId"},"uniqueItems":true},"specializes":{"type":"array","items":{"$ref":"#/$defs/CanonicalId"},"uniqueItems":true},"related":{"type":"array","items":{"$ref":"#/$defs/ProposalRelationshipSummary"}},"next_operations":{"type":"array","items":{"$ref":"#/$defs/QueryProposalNextOperation"}},"summary":{"type":"string"},"routing":{"$ref":"#/$defs/RoutingConfiguration"},"coverage":{"$ref":"#/$defs/ReadCoverage"},"application_exposure":{"$ref":"#/$defs/ApplicationExposureState"},"provenance":{"type":"array","items":{"$ref":"#/$defs/CanonicalId"}}},"additionalProperties":false},"ProposalRelatedResult":{"type":"object","required":["kind","revision","target","policy_unit_mapping","relationships","next_operations"],"properties":{"kind":{"const":"proposal-related-result"},"revision":{"$ref":"#/$defs/ProposalRevisionHandle"},"target":{"$ref":"#/$defs/CanonicalId"},"authoring_target":{"$ref":"#/$defs/AuthoringTargetHandle"},"policy_unit_mapping":{"$ref":"#/$defs/PolicyUnitMapping"},"relationships":{"type":"array","items":{"$ref":"#/$defs/ProposalRelationshipSummary"}},"next_operations":{"type":"array","items":{"$ref":"#/$defs/QueryProposalNextOperation"}},"summary":{"type":"string"}},"additionalProperties":false},"QueryProposalResult":{"oneOf":[{"$ref":"#/$defs/ProposalRouteResult"},{"$ref":"#/$defs/ProposalReadResult"},{"$ref":"#/$defs/ProposalRelatedResult"},{"$ref":"#/$defs/NavigationIndexesResult"},{"$ref":"#/$defs/ProvenanceReadResult"},{"$ref":"#/$defs/OperationalReadResult"}]},"AnalysisRequest":{"type":"object","required":["kind","base_snapshot","proposed_snapshot","changes","semantic_proposals","contract_version"],"properties":{"kind":{"const":"analysis-request"},"base_snapshot":{"$ref":"#/$defs/SnapshotHandle"},"proposed_snapshot":{"$ref":"#/$defs/SnapshotHandle"},"changes":{"type":"array","items":{"$ref":"#/$defs/ChangeDescriptor"},"minItems":1},"semantic_proposals":{"type":"array","items":{"$ref":"#/$defs/SemanticProposal"},"uniqueItems":true},"prior_analysis":{"$ref":"#/$defs/AnalysisHandle"},"contract_version":{"const":6}},"additionalProperties":false},"PrepareCall":{"type":"object","required":["request"],"properties":{"request":{"$ref":"#/$defs/AnalysisRequest"}},"additionalProperties":false},"AnalysisContext":{"type":"object","required":["kind","handle","subjects","changes","semantic_proposals"],"properties":{"kind":{"const":"analysis-context"},"handle":{"$ref":"#/$defs/AnalysisChildHandle"},"subjects":{"type":"array","items":{"$ref":"#/$defs/ChangedPolicyUnit"},"uniqueItems":true},"changes":{"type":"array","items":{"$ref":"#/$defs/ChangeDescriptor"},"minItems":1,"uniqueItems":true},"semantic_proposals":{"type":"array","items":{"$ref":"#/$defs/SemanticProposal"},"uniqueItems":true}},"additionalProperties":false},"AuthorizationReference":{"type":"object","required":["id","issuer","capability","authority_digest"],"properties":{"id":{"$ref":"#/$defs/AuthorizationId"},"issuer":{"$ref":"#/$defs/CanonicalId"},"capability":{"$ref":"#/$defs/CanonicalId"},"authority_digest":{"$ref":"#/$defs/Digest"}},"additionalProperties":false},"ProviderReference":{"type":"object","required":["id","contract","contract_version","input_digest"],"properties":{"id":{"$ref":"#/$defs/CanonicalId"},"contract":{"$ref":"#/$defs/CanonicalId"},"contract_version":{"$ref":"#/$defs/NonEmptyString"},"input_digest":{"$ref":"#/$defs/Digest"}},"additionalProperties":false},"AuthorizationRecord":{"type":"object","required":["reference","issuer_semantic_revision","principal","action","subject_kind","subject_id","authorization_evidence","revocation_authority","revocation_authority_semantic_revision","revocation_evidence"],"properties":{"reference":{"$ref":"#/$defs/AuthorizationReference"},"issuer_semantic_revision":{"type":"integer","minimum":1},"principal":{"$ref":"#/$defs/CanonicalId"},"action":{"$ref":"#/$defs/CanonicalId"},"subject_kind":{"$ref":"#/$defs/CanonicalId"},"subject_id":{"$ref":"#/$defs/NonEmptyString"},"authorization_evidence":{"type":"array","items":{"$ref":"#/$defs/EvidenceReference"},"minItems":1,"uniqueItems":true},"revocation_authority":{"$ref":"#/$defs/CanonicalId"},"revocation_authority_semantic_revision":{"type":"integer","minimum":1},"revocation_evidence":{"type":"array","items":{"$ref":"#/$defs/EvidenceReference"},"minItems":1,"uniqueItems":true}},"additionalProperties":false},"DomainContractReference":{"type":"object","required":["id","version"],"properties":{"id":{"$ref":"#/$defs/CanonicalId"},"version":{"$ref":"#/$defs/NonEmptyString"}},"additionalProperties":false},"AnalysisExecutionContractView":{"type":"object","required":["authorization_authority_digest","providers"],"properties":{"authorization_authority_digest":{"oneOf":[{"$ref":"#/$defs/Digest"},{"type":"null"}]},"providers":{"type":"array","items":{"$ref":"#/$defs/ProviderReference"},"uniqueItems":true}},"additionalProperties":false},"FactRequirement":{"type":"object","required":["kind","handle","fact","fact_semantic_revision","fact_contract_digest","context","value_contract","answer_contract","evidence_contract","authorization_capability"],"properties":{"kind":{"const":"fact-requirement"},"handle":{"$ref":"#/$defs/AnalysisChildHandle"},"fact":{"$ref":"#/$defs/CanonicalId"},"fact_semantic_revision":{"type":"integer","minimum":1},"fact_contract_digest":{"$ref":"#/$defs/Digest"},"context":{"$ref":"#/$defs/AnalysisChildHandle"},"value_contract":{"$ref":"#/$defs/FactValueContract"},"answer_contract":{"$ref":"#/$defs/CanonicalId"},"evidence_contract":{"$ref":"#/$defs/CanonicalId"},"authorization_capability":{"$ref":"#/$defs/CanonicalId"}},"additionalProperties":false},"FactRequirementWork":{"type":"object","required":["requirement","prompt","dependent_programs"],"properties":{"requirement":{"$ref":"#/$defs/FactRequirement"},"prompt":{"$ref":"#/$defs/NonEmptyString"},"dependent_programs":{"type":"array","items":{"$ref":"#/$defs/NonEmptyString"},"minItems":1,"uniqueItems":true}},"additionalProperties":false},"FactObservation":{"type":"object","required":["kind","handle","requirement","value","evidence","authorization"],"properties":{"kind":{"const":"fact-observation"},"handle":{"$ref":"#/$defs/AnalysisChildHandle"},"requirement":{"$ref":"#/$defs/AnalysisChildHandle"},"value":{"$ref":"#/$defs/FactValue"},"evidence":{"type":"array","items":{"$ref":"#/$defs/EvidenceReference"},"minItems":1,"uniqueItems":true},"authorization":{"$ref":"#/$defs/AuthorizationReference"},"provider":{"$ref":"#/$defs/ProviderReference"}},"additionalProperties":false},"Obligation":{"type":"object","required":["handle","kind","target","scope","reasons","state","permitted_submissions","fingerprint"],"properties":{"handle":{"$ref":"#/$defs/AnalysisChildHandle"},"kind":{"enum":["consumer-review","impact-review","lifecycle-impact-review","audit-coverage","unmapped-normative-change"]},"target":{"$ref":"#/$defs/CanonicalId"},"scope":{"$ref":"#/$defs/ReviewScope"},"reasons":{"type":"array","items":{"$ref":"#/$defs/SelectionReason"},"minItems":1,"uniqueItems":true},"state":{"enum":["required","resolved","blocked"]},"applicability":{"enum":["true","false","unknown","not-declared"]},"permitted_submissions":{"type":"array","items":{"enum":["consumer-disposition","impact-disposition","coverage-attestation"]},"minItems":1,"uniqueItems":true},"review_contract":{"$ref":"#/$defs/ConsumerReviewContract"},"fingerprint":{"$ref":"#/$defs/DecisionFingerprint"}},"additionalProperties":false},"ProvideFactSubmission":{"type":"object","required":["kind","requirement","value","evidence"],"properties":{"kind":{"const":"provide-fact"},"requirement":{"$ref":"#/$defs/AnalysisChildHandle"},"value":{"$ref":"#/$defs/FactValue"},"evidence":{"type":"array","items":{"$ref":"#/$defs/EvidenceReference"},"minItems":1,"uniqueItems":true}},"additionalProperties":false},"ConsumerDispositionSubmission":{"type":"object","required":["kind","obligation","result","rationale","evidence","fingerprint"],"properties":{"kind":{"const":"consumer-disposition"},"obligation":{"$ref":"#/$defs/AnalysisChildHandle"},"result":{"enum":["updated","reviewed-no-change","not-applicable","blocked"]},"rationale":{"$ref":"#/$defs/NonEmptyString"},"evidence":{"type":"array","items":{"$ref":"#/$defs/EvidenceReference"},"minItems":1},"fingerprint":{"$ref":"#/$defs/DecisionFingerprint"}},"additionalProperties":false},"ImpactDispositionSubmission":{"type":"object","required":["kind","obligation","result","rationale","evidence","fingerprint"],"properties":{"kind":{"const":"impact-disposition"},"obligation":{"$ref":"#/$defs/AnalysisChildHandle"},"result":{"enum":["confirmed","resolved-no-impact","requires-change","blocked"]},"rationale":{"$ref":"#/$defs/NonEmptyString"},"evidence":{"type":"array","items":{"$ref":"#/$defs/EvidenceReference"},"minItems":1},"fingerprint":{"$ref":"#/$defs/DecisionFingerprint"}},"additionalProperties":false},"CoverageAttestationClaim":{"type":"object","required":["requirement","conclusion","evidence","explicit_exclusions","rationale","auditor_provenance"],"properties":{"requirement":{"$ref":"#/$defs/AnalysisChildHandle"},"conclusion":{"const":"complete"},"evidence":{"type":"array","items":{"$ref":"#/$defs/EvidenceReference"},"minItems":1,"uniqueItems":true},"explicit_exclusions":{"type":"array","items":{"$ref":"#/$defs/EvidenceReference"},"uniqueItems":true},"rationale":{"$ref":"#/$defs/NonEmptyString"},"auditor_provenance":{"$ref":"#/$defs/NonEmptyString"}},"additionalProperties":false},"CoverageAttestationSubmission":{"type":"object","required":["kind","claim"],"properties":{"kind":{"const":"coverage-attestation"},"claim":{"$ref":"#/$defs/CoverageAttestationClaim"}},"additionalProperties":false},"Submission":{"oneOf":[{"$ref":"#/$defs/ProvideFactSubmission"},{"$ref":"#/$defs/ConsumerDispositionSubmission"},{"$ref":"#/$defs/ImpactDispositionSubmission"},{"$ref":"#/$defs/CoverageAttestationSubmission"}]},"ResolveCall":{"type":"object","required":["analysis","submission"],"properties":{"analysis":{"$ref":"#/$defs/AnalysisHandle"},"submission":{"$ref":"#/$defs/Submission"}},"additionalProperties":false},"CoverageRequirement":{"type":"object","required":["kind","handle","subject","owner","semantic_revision","relationship_kinds","horizon","required_evidence_contract"],"properties":{"kind":{"const":"coverage-requirement"},"handle":{"$ref":"#/$defs/AnalysisChildHandle"},"subject":{"$ref":"#/$defs/CanonicalId"},"owner":{"$ref":"#/$defs/CanonicalId"},"semantic_revision":{"type":"integer","minimum":1},"relationship_kinds":{"type":"array","items":{"$ref":"#/$defs/CanonicalId"},"uniqueItems":true},"horizon":{"$ref":"#/$defs/CanonicalId"},"required_evidence_contract":{"$ref":"#/$defs/CanonicalId"}},"additionalProperties":false},"CoverageAttestation":{"type":"object","required":["kind","requirement","conclusion","evidence","explicit_exclusions","rationale","auditor_provenance","schema_version","authorization"],"properties":{"kind":{"const":"coverage-attestation"},"requirement":{"$ref":"#/$defs/AnalysisChildHandle"},"conclusion":{"const":"complete"},"evidence":{"type":"array","items":{"$ref":"#/$defs/EvidenceReference"},"minItems":1},"explicit_exclusions":{"type":"array","items":{"$ref":"#/$defs/EvidenceReference"}},"rationale":{"$ref":"#/$defs/NonEmptyString"},"auditor_provenance":{"$ref":"#/$defs/NonEmptyString"},"schema_version":{"const":4},"authorization":{"$ref":"#/$defs/AuthorizationReference"}},"additionalProperties":false},"CoverageCertificate":{"type":"object","required":["kind","handle","requirement","subject","owner","semantic_revision","horizon_digest","relationship_digest","evidence_digests","fact_schema_digest"],"properties":{"kind":{"const":"coverage-certificate"},"handle":{"$ref":"#/$defs/AnalysisChildHandle"},"requirement":{"$ref":"#/$defs/AnalysisChildHandle"},"subject":{"$ref":"#/$defs/CanonicalId"},"owner":{"$ref":"#/$defs/CanonicalId"},"semantic_revision":{"type":"integer","minimum":1},"horizon_digest":{"$ref":"#/$defs/Digest"},"relationship_digest":{"$ref":"#/$defs/Digest"},"evidence_digests":{"type":"array","items":{"$ref":"#/$defs/Digest"},"uniqueItems":true},"fact_schema_digest":{"$ref":"#/$defs/Digest"}},"additionalProperties":false},"DispositionRecord":{"type":"object","required":["obligation","kind","result","rationale","evidence","authorization","fingerprint"],"properties":{"obligation":{"$ref":"#/$defs/AnalysisChildHandle"},"kind":{"enum":["consumer-disposition","impact-disposition"]},"result":{"$ref":"#/$defs/NonEmptyString"},"rationale":{"$ref":"#/$defs/NonEmptyString"},"evidence":{"type":"array","items":{"$ref":"#/$defs/EvidenceReference"}},"authorization":{"$ref":"#/$defs/AuthorizationReference"},"fingerprint":{"$ref":"#/$defs/DecisionFingerprint"}},"additionalProperties":false},"AnalysisState":{"type":"object","required":["kind","handle","base_snapshot","proposed_reference","changes","semantic_proposals","fact_observations","dispositions","coverage_attestations","authorization_records","domain_contracts","execution_contracts","contract_version"],"properties":{"kind":{"const":"analysis-state"},"handle":{"$ref":"#/$defs/AnalysisHandle"},"base_snapshot":{"$ref":"#/$defs/SnapshotHandle"},"proposed_reference":{"$ref":"#/$defs/AnalysisMaterialHandle"},"changes":{"type":"array","items":{"$ref":"#/$defs/ChangeDescriptor"},"minItems":1,"uniqueItems":true},"semantic_proposals":{"type":"array","items":{"$ref":"#/$defs/SemanticProposal"},"uniqueItems":true},"fact_observations":{"type":"array","items":{"$ref":"#/$defs/FactObservation"},"uniqueItems":true},"dispositions":{"type":"array","items":{"$ref":"#/$defs/DispositionRecord"},"uniqueItems":true},"coverage_attestations":{"type":"array","items":{"$ref":"#/$defs/CoverageAttestation"},"uniqueItems":true},"authorization_records":{"type":"array","items":{"$ref":"#/$defs/AuthorizationRecord"},"uniqueItems":true},"domain_contracts":{"type":"array","items":{"$ref":"#/$defs/DomainContractReference"},"minItems":1,"uniqueItems":true},"execution_contracts":{"$ref":"#/$defs/AnalysisExecutionContractView"},"contract_version":{"const":7}},"additionalProperties":false},"PendingResult":{"type":"object","required":["kind","handle","status","context","changes","changed_units","obligations","fact_requirements","reading_plan","next_operations"],"properties":{"kind":{"const":"pending-result"},"handle":{"$ref":"#/$defs/AnalysisHandle"},"status":{"const":"needs-action"},"context":{"$ref":"#/$defs/AnalysisContext"},"changes":{"type":"array","items":{"$ref":"#/$defs/ChangeDescriptor"}},"changed_units":{"type":"array","items":{"$ref":"#/$defs/ChangedPolicyUnit"}},"obligations":{"type":"array","items":{"$ref":"#/$defs/Obligation"}},"fact_requirements":{"type":"array","items":{"$ref":"#/$defs/FactRequirementWork"}},"reading_plan":{"type":"array","items":{"$ref":"#/$defs/ReadingPlanEntry"}},"next_operations":{"type":"array","items":{"$ref":"#/$defs/NextOperation"}},"summary":{"type":"string"}},"additionalProperties":false},"CompleteResult":{"type":"object","required":["kind","handle","status","context","changes","changed_units","coverage_certificates","fact_observations","dispositions","reading_plan","completion"],"properties":{"kind":{"const":"complete-result"},"handle":{"$ref":"#/$defs/AnalysisHandle"},"status":{"const":"complete"},"context":{"$ref":"#/$defs/AnalysisContext"},"changes":{"type":"array","items":{"$ref":"#/$defs/ChangeDescriptor"}},"changed_units":{"type":"array","items":{"$ref":"#/$defs/ChangedPolicyUnit"}},"coverage_certificates":{"type":"array","items":{"$ref":"#/$defs/CoverageCertificate"},"uniqueItems":true},"fact_observations":{"type":"array","items":{"$ref":"#/$defs/FactObservation"},"uniqueItems":true},"dispositions":{"type":"array","items":{"$ref":"#/$defs/DispositionRecord"}},"reading_plan":{"type":"array","items":{"$ref":"#/$defs/ReadingPlanEntry"}},"completion":{"$ref":"#/$defs/CompletionProof"},"summary":{"type":"string"}},"additionalProperties":false},"RepositoryPath":{"type":"array","items":{"$ref":"#/$defs/NonEmptyString"},"minItems":1},"ProvenanceRecord":{"type":"object","required":["snapshot","path"],"properties":{"snapshot":{"$ref":"#/$defs/SnapshotHandle"},"path":{"$ref":"#/$defs/RepositoryPath"}},"additionalProperties":false},"SnapshotInspectionResult":{"type":"object","required":["kind","snapshot"],"properties":{"kind":{"const":"snapshot-inspection-result"},"snapshot":{"$ref":"#/$defs/SnapshotSummary"}},"additionalProperties":false},"PolicyInspectionResult":{"type":"object","required":["kind","policy","declaration","representation_digest","structural_digest","provenance"],"properties":{"kind":{"const":"policy-inspection-result"},"policy":{"$ref":"#/$defs/SnapshotChildHandle"},"declaration":{"oneOf":[{"$ref":"#/$defs/CanonicalModuleDeclaration"},{"$ref":"#/$defs/PolicyUnitDeclaration"}]},"representation_digest":{"$ref":"#/$defs/Digest"},"structural_digest":{"$ref":"#/$defs/Digest"},"provenance":{"$ref":"#/$defs/ProvenanceRecord"}},"additionalProperties":false},"RelationshipInspectionResult":{"type":"object","required":["kind","relationship","policy_semantics","provenance"],"properties":{"kind":{"const":"relationship-inspection-result"},"relationship":{"$ref":"#/$defs/RelationshipSummary"},"policy_semantics":{"oneOf":[{"$ref":"#/$defs/PolicyRelationshipInspection"},{"type":"null"}]},"provenance":{"$ref":"#/$defs/ProvenanceRecord"}},"additionalProperties":false},"AnalysisInspectionResult":{"type":"object","required":["kind","state"],"properties":{"kind":{"const":"analysis-inspection-result"},"state":{"$ref":"#/$defs/AnalysisState"}},"additionalProperties":false},"AnalysisChildArtifact":{"oneOf":[{"$ref":"#/$defs/AnalysisContext"},{"$ref":"#/$defs/FactRequirement"},{"$ref":"#/$defs/FactObservation"},{"$ref":"#/$defs/Obligation"},{"$ref":"#/$defs/CoverageRequirement"},{"$ref":"#/$defs/CoverageCertificate"}]},"AnalysisChildInspectionResult":{"type":"object","required":["kind","handle","artifact"],"properties":{"kind":{"const":"analysis-child-inspection-result"},"handle":{"$ref":"#/$defs/AnalysisChildHandle"},"artifact":{"$ref":"#/$defs/AnalysisChildArtifact"}},"additionalProperties":false},"InspectionResult":{"oneOf":[{"$ref":"#/$defs/SnapshotInspectionResult"},{"$ref":"#/$defs/PolicyInspectionResult"},{"$ref":"#/$defs/RelationshipInspectionResult"},{"$ref":"#/$defs/AnalysisInspectionResult"},{"$ref":"#/$defs/AnalysisChildInspectionResult"}]},"InspectCall":{"type":"object","required":["handle"],"properties":{"handle":{"$ref":"#/$defs/InspectableHandle"}},"additionalProperties":false},"RejectedResult":{"type":"object","required":["kind","code","outcome","message","details","next_operations"],"properties":{"kind":{"const":"rejected-result"},"code":{"$ref":"#/$defs/CanonicalId"},"outcome":{"enum":["invalid","unavailable","unsupported","unauthorized"]},"target":{"$ref":"#/$defs/NonEmptyString"},"message":{"$ref":"#/$defs/NonEmptyString"},"details":{"type":"object","additionalProperties":{"$ref":"#/$defs/ScalarValue"}},"next_operations":{"type":"array","items":{"$ref":"#/$defs/NextOperation"}},"input_feedback":{"$ref":"#/$defs/InputFeedback"},"relationship_groups":{"$ref":"#/$defs/RelationshipGroupsResult"}},"additionalProperties":false},"AuthoredRoutingRule":{"type":"object","required":["id","target","when","condition"],"properties":{"id":{"$ref":"#/$defs/CanonicalId"},"target":{"$ref":"#/$defs/CanonicalId"},"when":{"$ref":"#/$defs/ApplicabilityExpression"},"condition":{"$ref":"#/$defs/NonEmptyString"}},"additionalProperties":false},"AuthoredRoutingFact":{"type":"object","required":["id","semantic_revision","type","nullable","values","aliases","meaning","prompt"],"properties":{"id":{"$ref":"#/$defs/CanonicalId"},"semantic_revision":{"type":"integer","minimum":1},"type":{"enum":["boolean","enum","string","string-set","enum-set","canonical-id"]},"nullable":{"type":"boolean"},"values":{"type":"array","items":{"type":"string"},"uniqueItems":true},"aliases":{"type":"array","items":{"$ref":"#/$defs/CanonicalId"},"uniqueItems":true},"meaning":{"$ref":"#/$defs/NonEmptyString"},"prompt":{"$ref":"#/$defs/NonEmptyString"}},"additionalProperties":false},"PutRoutingRuleEdit":{"type":"object","required":["kind","rule","rationale"],"properties":{"kind":{"const":"put-routing-rule"},"rule":{"$ref":"#/$defs/AuthoredRoutingRule"},"rationale":{"$ref":"#/$defs/NonEmptyString"}},"additionalProperties":false},"RemoveRoutingRuleEdit":{"type":"object","required":["kind","rule","rationale"],"properties":{"kind":{"const":"remove-routing-rule"},"rule":{"$ref":"#/$defs/CanonicalId"},"rationale":{"$ref":"#/$defs/NonEmptyString"}},"additionalProperties":false},"PutRoutingFactEdit":{"type":"object","required":["kind","fact","rationale"],"properties":{"kind":{"const":"put-routing-fact"},"fact":{"$ref":"#/$defs/AuthoredRoutingFact"},"rationale":{"$ref":"#/$defs/NonEmptyString"}},"additionalProperties":false},"RemoveRoutingFactEdit":{"type":"object","required":["kind","fact","rationale"],"properties":{"kind":{"const":"remove-routing-fact"},"fact":{"$ref":"#/$defs/CanonicalId"},"rationale":{"$ref":"#/$defs/NonEmptyString"}},"additionalProperties":false},"VerificationFailure":{"type":"object","additionalProperties":false,"required":["code","message","suite","check"],"properties":{"code":{"$ref":"#/$defs/NonEmptyString"},"message":{"$ref":"#/$defs/NonEmptyString"},"suite":{"type":["string","null"]},"check":{"type":["string","null"]}}},"VerificationReport":{"type":"object","additionalProperties":false,"required":["passed","exit_code","suites","checks","failures"],"properties":{"passed":{"type":"boolean"},"exit_code":{"enum":[0,1,2,3,4]},"suites":{"type":"integer","minimum":0},"checks":{"type":"integer","minimum":0},"failures":{"type":"array","items":{"$ref":"#/$defs/VerificationFailure"}}}},"VerifyRepositoryCall":{"type":"object","additionalProperties":false,"required":["kind","refresh_verification_inputs"],"properties":{"kind":{"const":"verify-repository"},"refresh_verification_inputs":{"type":"boolean"}}},"VerifyRepositoryResult":{"type":"object","additionalProperties":false,"required":["kind","refreshed_verification_inputs","verification"],"properties":{"kind":{"const":"verify-repository-result"},"refreshed_verification_inputs":{"type":"boolean"},"verification":{"$ref":"#/$defs/VerificationReport"}}},"VerifyProposalCall":{"type":"object","additionalProperties":false,"required":["kind","revision"],"properties":{"kind":{"const":"verify-proposal"},"revision":{"$ref":"#/$defs/ProposalRevisionHandle"},"readiness":{"$ref":"#/$defs/ReadinessHandle"}}},"VerifyProposalResult":{"type":"object","additionalProperties":false,"required":["kind","revision","verification"],"properties":{"kind":{"const":"verify-proposal-result"},"revision":{"$ref":"#/$defs/ProposalRevisionHandle"},"verification":{"$ref":"#/$defs/VerificationReport"},"readiness":{"$ref":"#/$defs/ReadinessHandle"}}},"RoutingConfiguration":{"type":"object","additionalProperties":false,"required":["facts","rules"],"properties":{"facts":{"type":"array","items":{"$ref":"#/$defs/AuthoredRoutingFact"}},"rules":{"type":"array","items":{"$ref":"#/$defs/AuthoredRoutingRule"}}}},"PolicyCoverageStatus":{"type":"object","required":["subject","requirement_id","status"],"properties":{"subject":{"$ref":"#/$defs/CanonicalId"},"requirement_id":{"$ref":"#/$defs/Digest"},"status":{"enum":["current-attestation","review-required"]},"authority":{"$ref":"#/$defs/CoverageAuditAuthority"}},"additionalProperties":false},"ReadCoverage":{"type":"object","description":"Repository attestation status bound to this snapshot or proposal. Empty subjects means no registered policy units in scope, not complete coverage. Analysis-local attestations are not repository certificates.","required":["subjects"],"properties":{"subjects":{"type":"array","items":{"$ref":"#/$defs/PolicyCoverageStatus"}}},"additionalProperties":false},"AuditPolicyUnitEdit":{"type":"object","required":["kind","policy","rationale"],"properties":{"kind":{"const":"audit-policy-unit"},"policy":{"$ref":"#/$defs/CanonicalId"},"rationale":{"$ref":"#/$defs/NonEmptyString"}},"additionalProperties":false},"CoverageAuditAuthority":{"type":"object","required":["issuer","principal","authorization_id"],"properties":{"issuer":{"$ref":"#/$defs/NonEmptyString"},"principal":{"$ref":"#/$defs/NonEmptyString"},"authorization_id":{"$ref":"#/$defs/NonEmptyString"}},"additionalProperties":false},"EvidenceCheckRetirement":{"type":"object","additionalProperties":false,"required":["suite","check"],"properties":{"suite":{"type":"string","minLength":1},"check":{"type":"string","minLength":1}}},"EvidenceSuiteDescription":{"type":"object","additionalProperties":false,"required":["suite","description"],"properties":{"suite":{"type":"string","minLength":1},"description":{"type":"string","minLength":1}}},"EvidenceRelationshipUpdate":{"type":"object","additionalProperties":false,"required":["source_policy","consumer","relation","evidence_owner","rationale"],"properties":{"source_policy":{"type":"string","minLength":1},"consumer":{"type":"string","minLength":1},"relation":{"type":"string","minLength":1},"evidence_owner":{"type":"string","minLength":1},"rationale":{"type":"string","minLength":1}}},"EvidenceConsumerRegistration":{"type":"object","additionalProperties":false,"required":["path","artifact_kind","source_policies","relation","evidence_owner","rationale"],"properties":{"path":{"type":"string","minLength":1},"artifact_kind":{"type":"string","enum":["implementation-artifact","fixture"]},"source_policies":{"type":"array","items":{"type":"string","minLength":1},"minItems":1,"uniqueItems":true},"relation":{"type":"string","enum":["implementation-projection","fixture-projection"]},"evidence_owner":{"type":"string","minLength":1},"rationale":{"type":"string","minLength":1}}},"EngineCertificateRetirement":{"type":"object","additionalProperties":false,"required":["subject","requirement_id","rationale"],"properties":{"subject":{"$ref":"#/$defs/CanonicalId"},"requirement_id":{"$ref":"#/$defs/Digest"},"rationale":{"$ref":"#/$defs/NonEmptyString"}}},"EvidenceMaintenancePlan":{"type":"object","additionalProperties":false,"required":["prune_stale_certificates","retire_suites","retire_checks","retire_inputs","suite_descriptions","replacement_evidence_owner","replacement_evidence_rationale","relationship_updates","consumer_registrations"],"properties":{"retire_engine_certificates":{"type":"array","items":{"$ref":"#/$defs/EngineCertificateRetirement"},"uniqueItems":true,"description":"Explicitly retire exact registered Engine-issued certificates by subject and requirement; preserve normative policy and consumer registrations."},"prune_stale_certificates":{"type":"boolean"},"retire_suites":{"type":"array","items":{"type":"string","minLength":1},"uniqueItems":true},"retire_checks":{"type":"array","items":{"$ref":"#/$defs/EvidenceCheckRetirement"}},"retire_inputs":{"type":"array","items":{"type":"string","minLength":1},"uniqueItems":true},"suite_descriptions":{"type":"array","items":{"$ref":"#/$defs/EvidenceSuiteDescription"}},"replacement_evidence_owner":{"type":"string","minLength":1},"replacement_evidence_rationale":{"type":"string","minLength":1},"relationship_updates":{"type":"array","items":{"$ref":"#/$defs/EvidenceRelationshipUpdate"}},"consumer_registrations":{"type":"array","items":{"$ref":"#/$defs/EvidenceConsumerRegistration"}},"unregister_policy_subjects":{"type":"array","items":{"type":"string","minLength":1},"uniqueItems":true,"description":"Remove selected review-subject registrations and their source relationships while preserving normative Markdown."}}},"MaintainEvidenceCall":{"type":"object","additionalProperties":false,"required":["kind","expected_revision","evidence","plan","apply"],"properties":{"kind":{"const":"maintain-evidence"},"expected_revision":{"type":"string","minLength":1},"evidence":{"type":"array","items":{"$ref":"#/$defs/EvidenceReference"},"minItems":1},"plan":{"$ref":"#/$defs/EvidenceMaintenancePlan"},"apply":{"type":"boolean"}}},"MaintainEvidenceResult":{"type":"object","additionalProperties":false,"required":["kind","applied","changed_files","removed_files","verification"],"properties":{"kind":{"const":"maintain-evidence-result"},"applied":{"type":"boolean"},"changed_files":{"type":"array","items":{"type":"string","minLength":1}},"removed_files":{"type":"array","items":{"type":"string","minLength":1}},"verification":{"$ref":"#/$defs/VerificationReport"}}},"RouteCall":{"type":"object","required":["facts"],"properties":{"facts":{"$ref":"#/$defs/RoutingFactAssertions"},"snapshot":{"$ref":"#/$defs/SnapshotHandle"},"content":{"$ref":"#/$defs/RouteContentSelection"},"detail":{"enum":["compact","full"],"description":"Compact authoring selection is default. Full returns the rule explanation. Application always retains its qualified projection."}},"additionalProperties":false},"ReadCall":{"type":"object","required":["target"],"properties":{"target":{"$ref":"#/$defs/CanonicalId"},"include_routing":{"type":"boolean"},"include_coverage":{"type":"boolean","description":"Include current repository attestation status for registered policy units in this read scope."},"snapshot":{"$ref":"#/$defs/SnapshotHandle"},"detail":{"enum":["compact","full"],"description":"Compact preserves exact policy and essential authority; full includes all relationship rows."}},"additionalProperties":false},"RelatedCall":{"type":"object","required":["target","groups","direction","transitive"],"properties":{"target":{"$ref":"#/$defs/CanonicalId"},"groups":{"type":"array","minItems":1,"uniqueItems":true,"items":{"$ref":"#/$defs/CanonicalId"}},"direction":{"enum":["incoming","outgoing","both"]},"transitive":{"type":"boolean","default":false},"snapshot":{"$ref":"#/$defs/SnapshotHandle"}},"additionalProperties":false},"CompactReadResult":{"type":"object","required":["kind","snapshot","policy","content","requires","specializes","next_operations","detail"],"properties":{"kind":{"const":"compact-read-result"},"snapshot":{"$ref":"#/$defs/SnapshotHandle"},"policy":{"$ref":"#/$defs/PolicySummary"},"content":{"type":"string"},"requires":{"type":"array","items":{"$ref":"#/$defs/CanonicalId"},"uniqueItems":true},"specializes":{"type":"array","items":{"$ref":"#/$defs/CanonicalId"},"uniqueItems":true},"next_operations":{"type":"array","items":{"$ref":"#/$defs/NextOperation"}},"summary":{"type":"string"},"routing":{"$ref":"#/$defs/RoutingConfiguration"},"coverage":{"$ref":"#/$defs/ReadCoverage"},"detail":{"const":"compact"},"application_exposure":{"$ref":"#/$defs/ApplicationExposureState"},"provenance":{"type":"array","items":{"$ref":"#/$defs/CanonicalId"}}},"additionalProperties":false},"RoutingFactsCall":{"type":"object","additionalProperties":false,"required":[],"properties":{"snapshot":{"$ref":"#/$defs/SnapshotHandle"}}},"RoutingFactsResult":{"type":"object","additionalProperties":false,"required":["kind","snapshot","facts"],"properties":{"kind":{"const":"routing-facts-result"},"snapshot":{"$ref":"#/$defs/SnapshotHandle"},"facts":{"type":"array","items":{"$ref":"#/$defs/AuthoredRoutingFact"}}}},"RoutingQuestion":{"type":"object","additionalProperties":false,"required":["id","kind","prompt","state","fact"],"properties":{"id":{"$ref":"#/$defs/CanonicalId"},"kind":{"const":"applicability-fact"},"prompt":{"$ref":"#/$defs/NonEmptyString"},"state":{"const":"required"},"fact":{"$ref":"#/$defs/AuthoredRoutingFact"}}},"RoutingRuleExplanation":{"type":"object","additionalProperties":false,"required":["id","target","when","state"],"properties":{"id":{"$ref":"#/$defs/CanonicalId"},"target":{"$ref":"#/$defs/CanonicalId"},"when":{"$ref":"#/$defs/ApplicabilityExpression"},"state":{"enum":["selected","unresolved"]}}},"AgentRouteResult":{"type":"object","required":["kind","snapshot","reading_plan","unresolved_questions","next_operations","facts","rules"],"properties":{"kind":{"const":"agent-route-result"},"snapshot":{"$ref":"#/$defs/SnapshotHandle"},"reading_plan":{"type":"array","items":{"$ref":"#/$defs/ReadingPlanEntry"}},"unresolved_questions":{"type":"array","items":{"$ref":"#/$defs/RoutingQuestion"}},"next_operations":{"type":"array","items":{"$ref":"#/$defs/NextOperation"}},"summary":{"type":"string"},"facts":{"$ref":"#/$defs/RoutingFactAssertions"},"rules":{"type":"array","items":{"$ref":"#/$defs/RoutingRuleExplanation"}},"content":{"$ref":"#/$defs/RoutedContentPage"}},"additionalProperties":false},"WorkflowContext":{"oneOf":[{"$ref":"#/$defs/ProposalRevisionHandle"},{"$ref":"#/$defs/AnalysisHandle"},{"$ref":"#/$defs/ReadinessHandle"}]},"ProposeCall":{"type":"object","additionalProperties":false,"properties":{"snapshot":{"$ref":"#/$defs/SnapshotHandle"},"change_set":{"$ref":"#/$defs/StandardsChangeSet"},"detail":{"enum":["compact","full"],"description":"Compact (default) returns an exact workflow summary; full returns complete analysis detail."}},"required":["change_set"]},"ReviseCall":{"type":"object","additionalProperties":false,"properties":{"context":{"$ref":"#/$defs/WorkflowContext"},"change_set":{"$ref":"#/$defs/StandardsChangeSet"},"detail":{"enum":["compact","full"],"description":"Compact (default) returns an exact workflow summary; full returns complete analysis detail."}},"required":["context","change_set"]},"AnalyzeCall":{"type":"object","additionalProperties":false,"properties":{"context":{"$ref":"#/$defs/WorkflowContext"},"detail":{"enum":["compact","full"],"description":"Compact (default) returns an exact workflow summary; full returns complete analysis detail."}},"required":["context"]},"ResolveWorkflowCall":{"type":"object","additionalProperties":false,"properties":{"context":{"$ref":"#/$defs/WorkflowContext"},"submission":{"$ref":"#/$defs/Submission"},"detail":{"enum":["compact","full"],"description":"Compact (default) returns an exact workflow summary; full returns complete analysis detail."}},"required":["context","submission"]},"ReviewCall":{"type":"object","additionalProperties":false,"properties":{"context":{"$ref":"#/$defs/WorkflowContext"},"decisions":{"type":"array","minItems":3,"maxItems":3,"uniqueItems":true,"items":{"$ref":"#/$defs/ReviewDecision"}},"detail":{"enum":["compact","full"],"description":"Compact (default) returns an exact workflow summary; full returns complete analysis detail."}},"required":["context","decisions"]},"ApplyCall":{"type":"object","additionalProperties":false,"properties":{"context":{"$ref":"#/$defs/WorkflowContext"},"detail":{"enum":["compact","full"],"description":"Compact (default) returns an exact workflow summary; full returns complete analysis detail."}},"required":["context"]},"RecoverCall":{"type":"object","additionalProperties":false,"properties":{"context":{"$ref":"#/$defs/WorkflowContext"},"action":{"enum":["observe","complete-publication"],"description":"Omit or select observe to reconcile only. Explicit complete-publication revalidates and attempts the same admitted candidate against its original expected target; it requires current publication authorization."},"detail":{"enum":["compact","full"],"description":"Compact (default) returns an exact workflow summary; full returns complete analysis detail."}},"required":["context"],"description":"Recover an admitted application. Observation performs no Git writes. Explicit completion reconstructs and verifies the exact admitted candidate before one compare-and-swap attempt."},"WorkflowStatusCall":{"type":"object","additionalProperties":false,"properties":{"context":{"$ref":"#/$defs/WorkflowContext"},"detail":{"enum":["compact","full"],"description":"Compact (default) returns an exact workflow summary; full returns complete analysis detail."}},"required":["context"]},"ResumeCall":{"type":"object","additionalProperties":false,"properties":{"context":{"$ref":"#/$defs/WorkflowContext"},"detail":{"enum":["compact","full"],"description":"Compact (default) returns an exact workflow summary; full returns complete analysis detail."}},"required":["context"]},"WorkflowContinuation":{"type":"object","additionalProperties":false,"properties":{"operation":{"enum":["revise","analyze","resolve_workflow","review","apply","recover","workflow_status","resume","resolve_many"]},"required_inputs":{"type":"array","uniqueItems":true,"items":{"enum":["change_set","submission","decisions","action","submissions"]}}},"required":["operation","required_inputs"],"description":"Select the named operation with the enclosing WorkflowResult context and explicit required inputs. This descriptor is not an authorization grant."},"WorkflowOutcome":{"oneOf":[{"$ref":"#/$defs/CreateProposalResult"},{"$ref":"#/$defs/ReviseProposalResult"},{"$ref":"#/$defs/PendingResult"},{"$ref":"#/$defs/CompleteResult"},{"$ref":"#/$defs/ReviewProposalResult"},{"$ref":"#/$defs/ApplyProposalResult"},{"$ref":"#/$defs/ApplicationRecoveryRequiredResult"},{"$ref":"#/$defs/RecoverApplicationResult"},{"$ref":"#/$defs/RejectedResult"},{"$ref":"#/$defs/WorkflowAnalysisSummary"}]},"WorkflowResult":{"type":"object","additionalProperties":false,"properties":{"kind":{"const":"workflow-result"},"context":{"$ref":"#/$defs/WorkflowContext"},"proposal":{"$ref":"#/$defs/ProposalHandle"},"revision":{"$ref":"#/$defs/ProposalRevisionHandle"},"publication":{"$ref":"#/$defs/ApplicationPublicationReceipt"},"checkout":{"$ref":"#/$defs/PublicationCheckoutObservation"},"status":{"enum":["draft","needs-action","complete","requires-change","ready","recovery-required","applied","rejected","stale"]},"next_operations":{"type":"array","items":{"$ref":"#/$defs/WorkflowContinuation"}},"outcome":{"$ref":"#/$defs/WorkflowOutcome"},"work":{"oneOf":[{"$ref":"#/$defs/WorkflowWorkPage"},{"$ref":"#/$defs/WorkflowWorkDeferred"}]}},"required":["kind","context","proposal","revision","status","next_operations"],"description":"Exact immutable workflow context and relative action descriptors. Successful compact pending propose, revise, analyze and decision submissions include work from the already-produced Analysis. Status observations, full results, stale contexts and other outcomes omit work."},"FocusedQueryNextOperation":{"type":"object","required":["operation","request_kind","snapshot"],"properties":{"operation":{"enum":["route","read","related"]},"request_kind":{"enum":["route","read","related"]},"target":{"$ref":"#/$defs/CanonicalId"},"snapshot":{"$ref":"#/$defs/SnapshotHandle"}},"additionalProperties":false},"RewriteNavigationIndexEdit":{"type":"object","required":["kind","entrypoint","destinations","rationale"],"properties":{"kind":{"const":"rewrite-navigation-index"},"entrypoint":{"$ref":"#/$defs/AuthoringTargetHandle"},"destinations":{"type":"array","items":{"$ref":"#/$defs/CanonicalId"},"minItems":1,"uniqueItems":true},"rationale":{"$ref":"#/$defs/NonEmptyString"},"retargets":{"type":"array","items":{"$ref":"#/$defs/NavigationRetarget"},"uniqueItems":true}},"additionalProperties":false},"NavigationIndexEntry":{"type":"object","required":["id","entrypoint","destinations"],"properties":{"id":{"$ref":"#/$defs/CanonicalId"},"entrypoint":{"$ref":"#/$defs/AuthoringTargetHandle"},"destinations":{"type":"array","items":{"$ref":"#/$defs/CanonicalId"},"uniqueItems":true},"content":{"$ref":"#/$defs/NonEmptyString"}},"additionalProperties":false},"NavigationIndexesResult":{"type":"object","required":["kind","authority","indexes","next_operations"],"properties":{"kind":{"const":"navigation-indexes-result"},"authority":{"oneOf":[{"$ref":"#/$defs/SnapshotHandle"},{"$ref":"#/$defs/ProposalRevisionHandle"}]},"indexes":{"type":"array","items":{"$ref":"#/$defs/NavigationIndexEntry"},"minItems":1},"next_operations":{"type":"array","items":{"$ref":"#/$defs/NextOperation"},"maxItems":0}},"additionalProperties":false},"NavigationRetarget":{"type":"object","required":["entrypoint","standard"],"properties":{"entrypoint":{"$ref":"#/$defs/AuthoringTargetHandle"},"standard":{"$ref":"#/$defs/CanonicalId"}},"additionalProperties":false},"ApplicationNextOperation":{"type":"object","additionalProperties":false,"required":["operation","snapshot"],"properties":{"operation":{"enum":["read","related","routing_facts","route","query","inspect"]},"snapshot":{"$ref":"#/$defs/SnapshotHandle"},"target":{"$ref":"#/$defs/CanonicalId"},"handle":{"$ref":"#/$defs/SnapshotChildHandle"}}},"ApplicationRejectedResult":{"type":"object","additionalProperties":false,"required":["kind","purpose","code","outcome","message","next_operations"],"properties":{"kind":{"const":"application-rejected-result"},"purpose":{"const":"application"},"code":{"enum":["APPLICATION.UNKNOWN_TARGET","APPLICATION.INPUT_INVALID","APPLICATION.OPERATION_UNAVAILABLE","APPLICATION.INTERNAL_UNAVAILABLE","APPLICATION.UNSUPPORTED_CAPTURE","APPLICATION.RESULT_LIMIT","APPLICATION.UNKNOWN_GROUP","APPLICATION.TRAVERSAL_NOT_PERMITTED"]},"outcome":{"enum":["invalid","unsupported","unavailable"]},"message":{"type":"string"},"next_operations":{"type":"array","items":{"$ref":"#/$defs/ApplicationNextOperation"}},"input_feedback":{"$ref":"#/$defs/InputFeedback"},"relationship_groups":{"$ref":"#/$defs/RelationshipGroupsResult"}}},"ApplicationPolicy":{"type":"object","additionalProperties":false,"required":["id","handle","role","level"],"properties":{"id":{"$ref":"#/$defs/CanonicalId"},"handle":{"$ref":"#/$defs/SnapshotChildHandle"},"role":{"enum":["core","router","topic","workflow","profile","reference","prompt","template","documentation"]},"level":{"enum":["MUST","SHOULD","PROFILE","REFERENCE"]}}},"ApplicationRelationship":{"type":"object","additionalProperties":false,"required":["handle","source","target","relation","groups","direction"],"properties":{"handle":{"$ref":"#/$defs/SnapshotChildHandle"},"source":{"$ref":"#/$defs/CanonicalId"},"target":{"$ref":"#/$defs/CanonicalId"},"relation":{"type":"string"},"groups":{"type":"array","items":{"$ref":"#/$defs/CanonicalId"}},"direction":{"enum":["incoming","outgoing"]}}},"ApplicationReadResult":{"type":"object","additionalProperties":false,"required":["kind","purpose","snapshot","policy","review_state","content","scope","requires","specializes","next_operations"],"properties":{"kind":{"const":"application-read-result"},"purpose":{"const":"application"},"snapshot":{"$ref":"#/$defs/SnapshotHandle"},"policy":{"$ref":"#/$defs/ApplicationPolicy"},"review_state":{"$ref":"#/$defs/ApplicationReviewState"},"content":{"type":"string"},"scope":{"$ref":"#/$defs/ReviewScope"},"requires":{"type":"array","items":{"$ref":"#/$defs/CanonicalId"}},"specializes":{"type":"array","items":{"$ref":"#/$defs/CanonicalId"}},"related":{"type":"array","items":{"$ref":"#/$defs/ApplicationRelationship"}},"next_operations":{"type":"array","items":{"$ref":"#/$defs/ApplicationNextOperation"}}}},"ApplicationRelatedResult":{"type":"object","additionalProperties":false,"required":["kind","purpose","snapshot","target","relationships","next_operations"],"properties":{"kind":{"const":"application-related-result"},"purpose":{"const":"application"},"snapshot":{"$ref":"#/$defs/SnapshotHandle"},"target":{"$ref":"#/$defs/CanonicalId"},"relationships":{"type":"array","items":{"$ref":"#/$defs/ApplicationRelationship"}},"next_operations":{"type":"array","items":{"$ref":"#/$defs/ApplicationNextOperation"}}}},"ApplicationReadingEntry":{"type":"object","additionalProperties":false,"required":["target","scope","authority","state","review_state"],"properties":{"target":{"$ref":"#/$defs/CanonicalId"},"scope":{"$ref":"#/$defs/ReviewScope"},"authority":{"enum":["normative","contextual"]},"state":{"const":"selected"},"review_state":{"$ref":"#/$defs/ApplicationReviewState"}}},"ApplicationQuestion":{"type":"object","additionalProperties":false,"required":["fact"],"properties":{"fact":{"$ref":"#/$defs/AuthoredRoutingFact"}}},"ApplicationRouteResult":{"type":"object","additionalProperties":false,"required":["kind","purpose","snapshot","status","reading_plan","unresolved_questions","next_operations"],"properties":{"kind":{"const":"application-route-result"},"purpose":{"const":"application"},"snapshot":{"$ref":"#/$defs/SnapshotHandle"},"status":{"enum":["complete","needs-facts"]},"reading_plan":{"type":"array","items":{"$ref":"#/$defs/ApplicationReadingEntry"}},"unresolved_questions":{"type":"array","items":{"$ref":"#/$defs/ApplicationQuestion"}},"next_operations":{"type":"array","items":{"$ref":"#/$defs/ApplicationNextOperation"}},"content":{"$ref":"#/$defs/ApplicationRoutedContentPage"}}},"ApplicationRoutingFactsResult":{"type":"object","additionalProperties":false,"required":["kind","purpose","snapshot","facts","next_operations"],"properties":{"kind":{"const":"application-routing-facts-result"},"purpose":{"const":"application"},"snapshot":{"$ref":"#/$defs/SnapshotHandle"},"facts":{"type":"array","items":{"$ref":"#/$defs/AuthoredRoutingFact"}},"next_operations":{"type":"array","items":{"$ref":"#/$defs/ApplicationNextOperation"}}}},"ApplicationReadCall":{"type":"object","additionalProperties":false,"required":["target"],"properties":{"target":{"$ref":"#/$defs/CanonicalId"},"snapshot":{"$ref":"#/$defs/SnapshotHandle"},"detail":{"enum":["compact","full"]}}},"ApplicationReadRequest":{"type":"object","additionalProperties":false,"required":["kind","target"],"properties":{"kind":{"const":"read"},"target":{"$ref":"#/$defs/CanonicalId"},"detail":{"enum":["compact","full"]}}},"ApplicationQueryRequest":{"oneOf":[{"$ref":"#/$defs/RouteRequest"},{"$ref":"#/$defs/ApplicationReadRequest"},{"$ref":"#/$defs/RelatedRequest"}]},"ApplicationQueryCall":{"type":"object","additionalProperties":false,"required":["snapshot","request"],"properties":{"snapshot":{"$ref":"#/$defs/SnapshotHandle"},"request":{"$ref":"#/$defs/ApplicationQueryRequest"}}},"ApplicationInspectCall":{"type":"object","additionalProperties":false,"required":["handle"],"properties":{"handle":{"$ref":"#/$defs/SnapshotChildHandle"}}},"AuthoredDecisionProvenance":{"type":"object","additionalProperties":false,"required":["id","subject","origin","rationale","evidence"],"properties":{"id":{"$ref":"#/$defs/CanonicalId"},"subject":{"$ref":"#/$defs/CanonicalId"},"origin":{"enum":["documented-original","reconstructed-history","current-justification","unrecorded"]},"rationale":{"type":"string"},"evidence":{"type":"array","items":{"$ref":"#/$defs/EvidenceReference"}},"assumptions":{"type":"array","items":{"type":"string"}},"limits":{"type":"array","items":{"type":"string"}},"alternatives":{"type":"array","items":{"type":"string"}},"reconsideration":{"type":"array","items":{"type":"string"}},"supersedes":{"type":"array","items":{"type":"string"}}}},"DecisionProvenanceRecord":{"type":"object","additionalProperties":false,"required":["id","subject","origin","rationale","evidence","assumptions","limits","alternatives","reconsideration","supersedes","subject_binding","retired"],"properties":{"id":{"$ref":"#/$defs/CanonicalId"},"subject":{"$ref":"#/$defs/CanonicalId"},"origin":{"enum":["documented-original","reconstructed-history","current-justification","unrecorded"]},"rationale":{"type":"string"},"evidence":{"type":"array","items":{"$ref":"#/$defs/EvidenceReference"}},"assumptions":{"type":"array","items":{"type":"string"}},"limits":{"type":"array","items":{"type":"string"}},"alternatives":{"type":"array","items":{"type":"string"}},"reconsideration":{"type":"array","items":{"type":"string"}},"supersedes":{"type":"array","items":{"type":"string"}},"subject_binding":{"$ref":"#/$defs/Digest"},"retired":{"type":"boolean"}}},"ApplicationExposureState":{"enum":["unreviewed","current","needs-review"]},"ApplicationReviewState":{"enum":["current","changed-since-review","not-reviewed"],"description":"Review label of delivered application material. current: this exact text was approved for application use. changed-since-review: the text was edited after its approval. not-reviewed: the text has never been approved. The label never withholds material; a scoped policy read carries the label of its containing module."},"ProvenanceReadResult":{"type":"object","additionalProperties":false,"required":["kind","authority","record","state","next_operations"],"properties":{"kind":{"const":"provenance-read-result"},"authority":{"oneOf":[{"$ref":"#/$defs/SnapshotHandle"},{"$ref":"#/$defs/ProposalRevisionHandle"}]},"record":{"$ref":"#/$defs/DecisionProvenanceRecord"},"state":{"enum":["current","needs-review","retired"]},"next_operations":{"type":"array","items":{"$ref":"#/$defs/NextOperation"}}}},"OperationalReadResult":{"type":"object","additionalProperties":false,"required":["kind","authority","target","canonical_id","role","content","application_exposure","next_operations"],"properties":{"kind":{"const":"operational-read-result"},"authority":{"oneOf":[{"$ref":"#/$defs/SnapshotHandle"},{"$ref":"#/$defs/ProposalRevisionHandle"}]},"target":{"$ref":"#/$defs/AuthoringTargetHandle"},"canonical_id":{"$ref":"#/$defs/CanonicalId"},"role":{"enum":["prompt","template","documentation"]},"content":{"type":"string"},"application_exposure":{"$ref":"#/$defs/ApplicationExposureState"},"next_operations":{"type":"array","items":{"$ref":"#/$defs/NextOperation"}}}},"PutDecisionProvenanceEdit":{"type":"object","additionalProperties":false,"required":["kind","record"],"properties":{"kind":{"const":"put-provenance"},"record":{"$ref":"#/$defs/AuthoredDecisionProvenance"}}},"RetireDecisionProvenanceEdit":{"type":"object","additionalProperties":false,"required":["kind","id"],"properties":{"kind":{"const":"retire-provenance"},"id":{"$ref":"#/$defs/CanonicalId"}}},"ApproveApplicationContentEdit":{"type":"object","additionalProperties":false,"required":["kind","target"],"properties":{"kind":{"const":"approve-application-content"},"target":{"oneOf":[{"$ref":"#/$defs/CanonicalId"},{"$ref":"#/$defs/AuthoringTargetHandle"}]}}},"WithdrawApplicationContentEdit":{"type":"object","additionalProperties":false,"required":["kind","target"],"properties":{"kind":{"const":"withdraw-application-content"},"target":{"oneOf":[{"$ref":"#/$defs/CanonicalId"},{"$ref":"#/$defs/AuthoringTargetHandle"}]}}},"ReviseOperationalArtifactEdit":{"type":"object","additionalProperties":false,"required":["kind","target","title","body"],"properties":{"kind":{"const":"revise-operational-artifact"},"target":{"oneOf":[{"$ref":"#/$defs/CanonicalId"},{"$ref":"#/$defs/AuthoringTargetHandle"}]},"title":{"$ref":"#/$defs/NonEmptyString"},"body":{"type":"string"}}},"PolicyScopeUpdate":{"type":"object","additionalProperties":false,"required":["policy","heading_path","semantics"],"properties":{"policy":{"$ref":"#/$defs/CanonicalId"},"heading_path":{"type":"array","minItems":1,"items":{"$ref":"#/$defs/NonEmptyString"}},"semantics":{"$ref":"#/$defs/PolicySemanticIntent"}}},"ReadManyItem":{"type":"object","required":["target"],"properties":{"target":{"$ref":"#/$defs/CanonicalId"},"include_routing":{"type":"boolean"},"include_coverage":{"type":"boolean","description":"Include current repository attestation status for registered policy units in this read scope."},"detail":{"enum":["compact","full"],"description":"Compact preserves exact policy and essential authority; full includes all relationship rows."}},"additionalProperties":false},"ReadManyCall":{"type":"object","additionalProperties":false,"required":["snapshot","items"],"description":"Read 1–32 selected items from one explicit snapshot, preserving order. The complete JSON result is limited to 2 MiB; any failed item rejects the entire request.","properties":{"snapshot":{"$ref":"#/$defs/SnapshotHandle"},"items":{"type":"array","minItems":1,"maxItems":32,"uniqueItems":true,"items":{"$ref":"#/$defs/ReadManyItem"}}}},"ReadManyResult":{"type":"object","additionalProperties":false,"required":["kind","snapshot","items"],"properties":{"kind":{"const":"read-many-result"},"snapshot":{"$ref":"#/$defs/SnapshotHandle"},"items":{"type":"array","minItems":1,"maxItems":32,"items":{"oneOf":[{"$ref":"#/$defs/CompactReadResult"},{"$ref":"#/$defs/ReadResult"},{"$ref":"#/$defs/NavigationIndexesResult"},{"$ref":"#/$defs/ProvenanceReadResult"},{"$ref":"#/$defs/OperationalReadResult"}]}}}},"ApplicationReadManyItem":{"type":"object","additionalProperties":false,"required":["target"],"properties":{"target":{"$ref":"#/$defs/CanonicalId"},"detail":{"enum":["compact","full"]}}},"ApplicationReadManyCall":{"type":"object","additionalProperties":false,"required":["snapshot","items"],"description":"Read 1–32 selected items from one explicit snapshot, preserving order. The complete JSON result is limited to 2 MiB; any failed item rejects the entire request.","properties":{"snapshot":{"$ref":"#/$defs/SnapshotHandle"},"items":{"type":"array","minItems":1,"maxItems":32,"uniqueItems":true,"items":{"$ref":"#/$defs/ApplicationReadManyItem"}}}},"ApplicationReadManyResult":{"type":"object","additionalProperties":false,"required":["kind","snapshot","items","purpose"],"properties":{"kind":{"const":"application-read-many-result"},"snapshot":{"$ref":"#/$defs/SnapshotHandle"},"items":{"type":"array","minItems":1,"maxItems":32,"items":{"oneOf":[{"$ref":"#/$defs/ApplicationReadResult"}]}},"purpose":{"const":"application"}}},"RegisterConsumerEdit":{"type":"object","additionalProperties":false,"required":["kind","consumer","path","artifact_kind","authority"],"properties":{"kind":{"const":"register-consumer"},"consumer":{"$ref":"#/$defs/CanonicalId"},"path":{"$ref":"#/$defs/NonEmptyString"},"artifact_kind":{"enum":["fixture","documentation","implementation-artifact","prompt","template"]},"authority":{"enum":["evidence","projection"]}},"description":"Register an existing tracked consumer within this proposal. The Engine captures original-revision bytes; use separate policy relationships to declare consumers and review obligations."},"PreviewApplicationCall":{"type":"object","additionalProperties":false,"required":["revision","request"],"properties":{"revision":{"$ref":"#/$defs/ProposalRevisionHandle"},"request":{"$ref":"#/$defs/ApplicationQueryRequest"}},"description":"Authoring-only inspection of an exact draft as an application agent would receive it, including each item\'s review label; this observation neither publishes nor grants ordinary application access."},"CandidateApplicationNextOperation":{"type":"object","additionalProperties":false,"required":["operation","revision","request"],"properties":{"operation":{"const":"preview_application"},"revision":{"$ref":"#/$defs/ProposalRevisionHandle"},"request":{"$ref":"#/$defs/ApplicationQueryRequest"}}},"CandidateApplicationPolicy":{"type":"object","additionalProperties":false,"required":["id","role","level"],"properties":{"id":{"$ref":"#/$defs/CanonicalId"},"role":{"enum":["core","router","topic","workflow","profile","reference","prompt","template","documentation"]},"level":{"enum":["MUST","SHOULD","PROFILE","REFERENCE"]}}},"CandidateApplicationRelationship":{"type":"object","additionalProperties":false,"required":["source","target","relation","groups","direction"],"properties":{"source":{"$ref":"#/$defs/CanonicalId"},"target":{"$ref":"#/$defs/CanonicalId"},"relation":{"type":"string"},"groups":{"type":"array","items":{"$ref":"#/$defs/CanonicalId"}},"direction":{"enum":["incoming","outgoing"]}}},"CandidateApplicationReadResult":{"type":"object","additionalProperties":false,"required":["kind","purpose","policy","review_state","content","scope","requires","specializes","next_operations","revision"],"properties":{"kind":{"const":"candidate-application-read-result"},"purpose":{"const":"application"},"policy":{"$ref":"#/$defs/CandidateApplicationPolicy"},"review_state":{"$ref":"#/$defs/ApplicationReviewState"},"content":{"type":"string"},"scope":{"$ref":"#/$defs/ReviewScope"},"requires":{"type":"array","items":{"$ref":"#/$defs/CanonicalId"}},"specializes":{"type":"array","items":{"$ref":"#/$defs/CanonicalId"}},"related":{"type":"array","items":{"$ref":"#/$defs/CandidateApplicationRelationship"}},"next_operations":{"type":"array","items":{"$ref":"#/$defs/CandidateApplicationNextOperation"}},"revision":{"$ref":"#/$defs/ProposalRevisionHandle"}}},"CandidateApplicationRelatedResult":{"type":"object","additionalProperties":false,"required":["kind","purpose","target","relationships","next_operations","revision"],"properties":{"kind":{"const":"candidate-application-related-result"},"purpose":{"const":"application"},"target":{"$ref":"#/$defs/CanonicalId"},"relationships":{"type":"array","items":{"$ref":"#/$defs/CandidateApplicationRelationship"}},"next_operations":{"type":"array","items":{"$ref":"#/$defs/CandidateApplicationNextOperation"}},"revision":{"$ref":"#/$defs/ProposalRevisionHandle"}}},"CandidateApplicationRouteResult":{"type":"object","additionalProperties":false,"required":["kind","purpose","status","reading_plan","unresolved_questions","next_operations","revision"],"properties":{"kind":{"const":"candidate-application-route-result"},"purpose":{"const":"application"},"status":{"enum":["complete","needs-facts"]},"reading_plan":{"type":"array","items":{"$ref":"#/$defs/ApplicationReadingEntry"}},"unresolved_questions":{"type":"array","items":{"$ref":"#/$defs/ApplicationQuestion"}},"next_operations":{"type":"array","items":{"$ref":"#/$defs/CandidateApplicationNextOperation"}},"revision":{"$ref":"#/$defs/ProposalRevisionHandle"}}},"CandidateApplicationRejectedResult":{"type":"object","additionalProperties":false,"required":["kind","purpose","code","outcome","message","next_operations","revision"],"properties":{"kind":{"const":"candidate-application-rejected-result"},"purpose":{"const":"application"},"code":{"enum":["APPLICATION.UNKNOWN_TARGET","APPLICATION.INPUT_INVALID","APPLICATION.OPERATION_UNAVAILABLE","APPLICATION.INTERNAL_UNAVAILABLE","APPLICATION.UNSUPPORTED_CAPTURE","APPLICATION.RESULT_LIMIT","APPLICATION.UNKNOWN_GROUP","APPLICATION.TRAVERSAL_NOT_PERMITTED"]},"outcome":{"enum":["invalid","unsupported","unavailable"]},"message":{"type":"string"},"next_operations":{"type":"array","items":{"$ref":"#/$defs/CandidateApplicationNextOperation"}},"revision":{"$ref":"#/$defs/ProposalRevisionHandle"}}},"PreviewApplicationResult":{"oneOf":[{"$ref":"#/$defs/CandidateApplicationReadResult"},{"$ref":"#/$defs/CandidateApplicationRelatedResult"},{"$ref":"#/$defs/CandidateApplicationRouteResult"},{"$ref":"#/$defs/CandidateApplicationRejectedResult"}]},"ResolveManyCall":{"type":"object","additionalProperties":false,"properties":{"context":{"$ref":"#/$defs/AnalysisHandle"},"submissions":{"type":"array","items":{"$ref":"#/$defs/Submission"},"minItems":1,"maxItems":128},"detail":{"enum":["compact","full"]}},"required":["context","submissions"],"description":"Resolve ordered decisions bound to one original analysis. Validate every item before publishing a final immutable successor; an invalid batch persists no intermediate decisions."},"WorkflowSection":{"enum":["pending_obligations","obligations","fact_requirements","coverage_certificates","dispositions","fact_observations","reading_plan","changed_units"]},"WorkflowAnalysisSummary":{"type":"object","additionalProperties":false,"properties":{"kind":{"const":"workflow-analysis-summary"},"status":{"enum":["needs-action","complete"]},"required_obligations":{"type":"integer","minimum":0},"pending_facts":{"type":"integer","minimum":0},"sections":{"type":"array","items":{"$ref":"#/$defs/WorkflowSectionCount"}},"details":{"$ref":"#/$defs/WorkflowDetailsLink"}},"required":["kind","status","required_obligations","pending_facts","sections","details"],"description":"Counts for the enclosing immutable Analysis context. Observation remains summary-only; successful compact pending mutations additionally return a bounded work page."},"WorkflowSectionCount":{"type":"object","additionalProperties":false,"properties":{"section":{"$ref":"#/$defs/WorkflowSection"},"count":{"type":"integer","minimum":0}},"required":["section","count"]},"WorkflowDetailsLink":{"type":"object","additionalProperties":false,"properties":{"operation":{"const":"workflow_details"}},"required":["operation"],"description":"Supply the enclosing WorkflowResult Analysis context as analysis and explicitly select a section."},"WorkflowDetailsCall":{"type":"object","additionalProperties":false,"properties":{"analysis":{"$ref":"#/$defs/AnalysisHandle"},"section":{"$ref":"#/$defs/WorkflowSection"},"offset":{"type":"integer","minimum":0},"limit":{"type":"integer","minimum":1,"maximum":16},"observation":{"$ref":"#/$defs/Digest"},"detail":{"enum":["compact","full"],"description":"Compact is byte-bounded; full explicitly retrieves one whole record without the compact byte cap."}},"required":["analysis","section"],"description":"Read a section of an immutable historical Analysis. Compact pages (default eight items) contain up to 16 whole records and 64 KiB of result JSON, returning fewer items when needed. An oversized record returns an explicit full-detail retry. detail=full retrieves one complete record (limit omitted or 1) without the compact byte cap; choose it only when the client can receive that payload. Continuations bind the Analysis, section and projected contents. Decision and publication operations check current evidence and authorization. A full-record response resumes compact paging in its next request."},"WorkflowDetailItem":{"oneOf":[{"$ref":"#/$defs/Obligation"},{"$ref":"#/$defs/FactRequirementWork"},{"$ref":"#/$defs/CoverageCertificate"},{"$ref":"#/$defs/DispositionRecord"},{"$ref":"#/$defs/FactObservation"},{"$ref":"#/$defs/ReadingPlanEntry"},{"$ref":"#/$defs/ChangedPolicyUnit"},{"$ref":"#/$defs/WorkflowObligationWork"}]},"WorkflowDetailsResult":{"type":"object","additionalProperties":false,"properties":{"kind":{"const":"workflow-details-result"},"analysis":{"$ref":"#/$defs/AnalysisHandle"},"section":{"$ref":"#/$defs/WorkflowSection"},"observation":{"$ref":"#/$defs/Digest"},"offset":{"type":"integer","minimum":0},"total":{"type":"integer","minimum":0},"items":{"type":"array","items":{"$ref":"#/$defs/WorkflowDetailItem"},"maxItems":16},"next":{"$ref":"#/$defs/WorkflowDetailsCall"}},"required":["kind","analysis","section","observation","offset","total","items"],"description":"Whole records from an immutable Analysis section. Compact may return fewer than limit to respect 64 KiB. Full returns at most one complete record and may exceed 64 KiB. Follow next exactly; observation and total are independent of page size and detail mode."},"RuntimeInfoCall":{"type":"object","additionalProperties":false,"properties":{"expected_catalog":{"$ref":"#/$defs/Digest"}},"required":[]},"RuntimeInfoResult":{"type":"object","additionalProperties":false,"properties":{"kind":{"const":"runtime-info-result"},"purpose":{"enum":["application","authoring"]},"interface_version":{"type":"integer","minimum":1},"implementation_version":{"type":"string","minLength":1},"instance_id":{"type":"string","minLength":1},"implementation_digest":{"$ref":"#/$defs/Digest"},"catalog_digest":{"$ref":"#/$defs/Digest"},"schema_digest":{"$ref":"#/$defs/Digest"},"installation_state":{"enum":["current","restart-required","unavailable"]},"client_catalog_state":{"enum":["unspecified","matches","differs"]},"action":{"enum":["reuse","restart-and-reconnect","refresh-tools","check-installation"]}},"required":["kind","purpose","interface_version","implementation_version","instance_id","implementation_digest","catalog_digest","schema_digest","installation_state","client_catalog_state","action"]},"WorkflowObligationWork":{"type":"object","additionalProperties":false,"properties":{"kind":{"const":"workflow-obligation-work"},"obligation":{"$ref":"#/$defs/Obligation"},"work":{"$ref":"#/$defs/AnalysisChildHandle"}},"required":["kind","obligation","work"]},"WorkflowDetailsNextOperation":{"type":"object","additionalProperties":false,"properties":{"operation":{"const":"workflow_details"},"request_kind":{"const":"workflow-details"},"request":{"$ref":"#/$defs/WorkflowDetailsCall"}},"required":["operation","request_kind","request"],"description":"An explicit historical detail retrieval alternative. Invoke operation with request; do not automatically select size-unbounded full detail."},"WorkflowDetailsSelection":{"type":"object","additionalProperties":false,"properties":{"section":{"$ref":"#/$defs/WorkflowSection"},"offset":{"type":"integer","minimum":0},"limit":{"type":"integer","minimum":1,"maximum":16},"observation":{"$ref":"#/$defs/Digest"},"detail":{"enum":["compact","full"],"description":"Compact is byte-bounded; full explicitly retrieves one whole record without the compact byte cap."}},"required":["section"],"description":"A workflow_details selection relative to the enclosing WorkflowResult Analysis context. Add analysis from that context when invoking; preserve every returned selection field."},"WorkflowWorkPage":{"type":"object","additionalProperties":false,"description":"First actionable section of a successful compact pending mutation, bound to the enclosing Analysis context. Facts precede obligations. Up to eight whole items and 64 KiB of page JSON; next is a relative workflow_details selection. Work handles retain their complete authority.","properties":{"kind":{"const":"workflow-work-page"},"section":{"enum":["fact_requirements","pending_obligations"]},"observation":{"$ref":"#/$defs/Digest"},"offset":{"const":0},"total":{"type":"integer","minimum":0},"items":{"type":"array","maxItems":8,"items":{"oneOf":[{"$ref":"#/$defs/FactRequirementWork"},{"$ref":"#/$defs/WorkflowObligationWork"}]}},"next":{"$ref":"#/$defs/WorkflowDetailsSelection"}},"required":["kind","section","observation","offset","total","items"]},"WorkflowWorkDeferred":{"type":"object","additionalProperties":false,"description":"The mutation succeeded but its first complete work record exceeds the compact page budget. Preserve the enclosing context and counts; request explicitly selects that exact full record without the compact byte cap.","properties":{"kind":{"const":"workflow-work-deferred"},"code":{"const":"WORKFLOW.RESULT_LIMIT"},"section":{"enum":["fact_requirements","pending_obligations"]},"total":{"type":"integer","minimum":0},"request":{"$ref":"#/$defs/WorkflowDetailsSelection"}},"required":["kind","code","section","total","request"]},"AgentAuthoredDecisionProvenance":{"type":"object","additionalProperties":false,"required":["id","subject","origin","rationale","evidence"],"properties":{"id":{"$ref":"#/$defs/CanonicalId"},"subject":{"$ref":"#/$defs/CanonicalId"},"origin":{"enum":["documented-original","reconstructed-history","current-justification","unrecorded"]},"rationale":{"type":"string"},"evidence":{"type":"array","items":{"$ref":"#/$defs/AgentEvidenceReference"}},"assumptions":{"type":"array","items":{"type":"string"}},"limits":{"type":"array","items":{"type":"string"}},"alternatives":{"type":"array","items":{"type":"string"}},"reconsideration":{"type":"array","items":{"type":"string"}},"supersedes":{"type":"array","items":{"type":"string"}}}},"AgentConsumerDispositionSubmission":{"type":"object","required":["kind","obligation","result","rationale","evidence","fingerprint"],"properties":{"kind":{"const":"consumer-disposition"},"obligation":{"$ref":"#/$defs/AnalysisChildHandle"},"result":{"enum":["updated","reviewed-no-change","not-applicable","blocked"]},"rationale":{"$ref":"#/$defs/NonEmptyString"},"evidence":{"type":"array","items":{"$ref":"#/$defs/AgentEvidenceReference"},"minItems":1},"fingerprint":{"$ref":"#/$defs/DecisionFingerprint"}},"additionalProperties":false},"AgentCoverageAttestationClaim":{"type":"object","required":["requirement","conclusion","evidence","explicit_exclusions","rationale","auditor_provenance"],"properties":{"requirement":{"$ref":"#/$defs/AnalysisChildHandle"},"conclusion":{"const":"complete"},"evidence":{"type":"array","items":{"$ref":"#/$defs/AgentEvidenceReference"},"minItems":1,"uniqueItems":true},"explicit_exclusions":{"type":"array","items":{"$ref":"#/$defs/AgentEvidenceReference"},"uniqueItems":true},"rationale":{"$ref":"#/$defs/NonEmptyString"},"auditor_provenance":{"$ref":"#/$defs/NonEmptyString"}},"additionalProperties":false},"AgentCoverageAttestationSubmission":{"type":"object","required":["kind","claim"],"properties":{"kind":{"const":"coverage-attestation"},"claim":{"$ref":"#/$defs/AgentCoverageAttestationClaim"}},"additionalProperties":false},"AgentImpactDispositionSubmission":{"type":"object","required":["kind","obligation","result","rationale","evidence","fingerprint"],"properties":{"kind":{"const":"impact-disposition"},"obligation":{"$ref":"#/$defs/AnalysisChildHandle"},"result":{"enum":["confirmed","resolved-no-impact","requires-change","blocked"]},"rationale":{"$ref":"#/$defs/NonEmptyString"},"evidence":{"type":"array","items":{"$ref":"#/$defs/AgentEvidenceReference"},"minItems":1},"fingerprint":{"$ref":"#/$defs/DecisionFingerprint"}},"additionalProperties":false},"AgentProposeCall":{"type":"object","additionalProperties":false,"properties":{"snapshot":{"$ref":"#/$defs/SnapshotHandle"},"change_set":{"$ref":"#/$defs/AgentStandardsChangeSet"},"detail":{"enum":["compact","full"],"description":"Compact (default) returns an exact workflow summary; full returns complete analysis detail."},"evidence":{"$ref":"#/$defs/RequestEvidenceTable"}},"required":["change_set"]},"AgentProvideFactSubmission":{"type":"object","required":["kind","requirement","value","evidence"],"properties":{"kind":{"const":"provide-fact"},"requirement":{"$ref":"#/$defs/AnalysisChildHandle"},"value":{"$ref":"#/$defs/FactValue"},"evidence":{"type":"array","items":{"$ref":"#/$defs/AgentEvidenceReference"},"minItems":1,"uniqueItems":true}},"additionalProperties":false},"AgentPutDecisionProvenanceEdit":{"type":"object","additionalProperties":false,"required":["kind","record"],"properties":{"kind":{"const":"put-provenance"},"record":{"$ref":"#/$defs/AgentAuthoredDecisionProvenance"}}},"AgentRelationshipDisposition":{"type":"object","required":["relationship","disposition","rationale","evidence"],"properties":{"relationship":{"$ref":"#/$defs/RelationshipKey"},"disposition":{"enum":["remove","retarget"]},"replacement_consumer":{"$ref":"#/$defs/RelationshipConsumer"},"rationale":{"$ref":"#/$defs/NonEmptyString"},"evidence":{"type":"array","minItems":1,"uniqueItems":true,"items":{"$ref":"#/$defs/AgentEvidenceReference"}}},"additionalProperties":false},"AgentResolveManyCall":{"type":"object","additionalProperties":false,"properties":{"context":{"$ref":"#/$defs/AnalysisHandle"},"submissions":{"type":"array","items":{"$ref":"#/$defs/AgentSubmission"},"minItems":1,"maxItems":128},"detail":{"enum":["compact","full"]},"evidence":{"$ref":"#/$defs/RequestEvidenceTable"}},"required":["context","submissions"],"description":"Resolve ordered decisions bound to one original analysis. Validate every item before publishing a final immutable successor; an invalid batch persists no intermediate decisions."},"AgentResolveWorkflowCall":{"type":"object","additionalProperties":false,"properties":{"context":{"$ref":"#/$defs/WorkflowContext"},"submission":{"$ref":"#/$defs/AgentSubmission"},"detail":{"enum":["compact","full"],"description":"Compact (default) returns an exact workflow summary; full returns complete analysis detail."},"evidence":{"$ref":"#/$defs/RequestEvidenceTable"}},"required":["context","submission"]},"AgentRetirePolicyUnitEdit":{"type":"object","required":["kind","policy","retired_semantic_revision","successors","relationship_dispositions","evidence"],"properties":{"kind":{"const":"retire-policy-unit"},"policy":{"$ref":"#/$defs/CanonicalId"},"retired_semantic_revision":{"type":"integer","minimum":1},"successors":{"type":"array","uniqueItems":true,"items":{"$ref":"#/$defs/CanonicalId"}},"relationship_dispositions":{"type":"array","uniqueItems":true,"items":{"$ref":"#/$defs/AgentRelationshipDisposition"}},"evidence":{"type":"array","minItems":1,"uniqueItems":true,"items":{"$ref":"#/$defs/AgentEvidenceReference"}}},"additionalProperties":false},"AgentRetireStandardEdit":{"type":"object","required":["kind","standard","successors","relationship_dispositions","evidence"],"properties":{"kind":{"const":"retire-standard"},"standard":{"$ref":"#/$defs/CanonicalId"},"successors":{"type":"array","uniqueItems":true,"items":{"$ref":"#/$defs/CanonicalId"}},"relationship_dispositions":{"type":"array","uniqueItems":true,"items":{"$ref":"#/$defs/AgentRelationshipDisposition"}},"evidence":{"type":"array","minItems":1,"uniqueItems":true,"items":{"$ref":"#/$defs/AgentEvidenceReference"}}},"additionalProperties":false},"AgentReviewCall":{"type":"object","additionalProperties":false,"properties":{"context":{"$ref":"#/$defs/WorkflowContext"},"decisions":{"type":"array","minItems":3,"maxItems":3,"uniqueItems":true,"items":{"$ref":"#/$defs/AgentReviewDecision"}},"detail":{"enum":["compact","full"],"description":"Compact (default) returns an exact workflow summary; full returns complete analysis detail."},"evidence":{"$ref":"#/$defs/RequestEvidenceTable"}},"required":["context","decisions"]},"AgentReviewDecision":{"type":"object","required":["owner","decision","rationale","evidence"],"properties":{"owner":{"enum":["consumer","impact","audit"]},"decision":{"const":"accept"},"rationale":{"$ref":"#/$defs/NonEmptyString"},"evidence":{"type":"array","minItems":1,"uniqueItems":true,"items":{"$ref":"#/$defs/AgentEvidenceReference"}}},"additionalProperties":false},"AgentReviseCall":{"type":"object","additionalProperties":false,"properties":{"context":{"$ref":"#/$defs/WorkflowContext"},"change_set":{"$ref":"#/$defs/AgentStandardsChangeSet"},"detail":{"enum":["compact","full"],"description":"Compact (default) returns an exact workflow summary; full returns complete analysis detail."},"evidence":{"$ref":"#/$defs/RequestEvidenceTable"}},"required":["context","change_set"]},"AgentStandardEdit":{"oneOf":[{"$ref":"#/$defs/CreateStandardEdit"},{"$ref":"#/$defs/RegisterPolicyUnitEdit"},{"$ref":"#/$defs/ReviseStandardEdit"},{"$ref":"#/$defs/RevisePolicyUnitEdit"},{"$ref":"#/$defs/MovePolicyUnitEdit"},{"$ref":"#/$defs/AgentRetirePolicyUnitEdit"},{"$ref":"#/$defs/AgentRetireStandardEdit"},{"$ref":"#/$defs/ReplaceStandardRelationshipsEdit"},{"$ref":"#/$defs/PutPolicyRelationshipEdit"},{"$ref":"#/$defs/RemovePolicyRelationshipEdit"},{"$ref":"#/$defs/PutRoutingRuleEdit"},{"$ref":"#/$defs/RemoveRoutingRuleEdit"},{"$ref":"#/$defs/PutRoutingFactEdit"},{"$ref":"#/$defs/RemoveRoutingFactEdit"},{"$ref":"#/$defs/AuditPolicyUnitEdit"},{"$ref":"#/$defs/RewriteNavigationIndexEdit"},{"$ref":"#/$defs/AgentPutDecisionProvenanceEdit"},{"$ref":"#/$defs/RetireDecisionProvenanceEdit"},{"$ref":"#/$defs/ApproveApplicationContentEdit"},{"$ref":"#/$defs/WithdrawApplicationContentEdit"},{"$ref":"#/$defs/ReviseOperationalArtifactEdit"},{"$ref":"#/$defs/RegisterConsumerEdit"}]},"AgentStandardsChangePurpose":{"type":"object","required":["summary","rationale","evidence"],"properties":{"summary":{"$ref":"#/$defs/NonEmptyString"},"rationale":{"$ref":"#/$defs/NonEmptyString"},"evidence":{"type":"array","minItems":1,"uniqueItems":true,"items":{"$ref":"#/$defs/AgentEvidenceReference"}}},"additionalProperties":false},"AgentStandardsChangeSet":{"type":"object","required":["purpose","edits"],"properties":{"purpose":{"$ref":"#/$defs/AgentStandardsChangePurpose"},"edits":{"type":"array","minItems":1,"uniqueItems":true,"items":{"$ref":"#/$defs/AgentStandardEdit"}}},"additionalProperties":false},"AgentSubmission":{"oneOf":[{"$ref":"#/$defs/AgentProvideFactSubmission"},{"$ref":"#/$defs/AgentConsumerDispositionSubmission"},{"$ref":"#/$defs/AgentImpactDispositionSubmission"},{"$ref":"#/$defs/AgentCoverageAttestationSubmission"}]},"EvidenceUse":{"type":"object","required":["evidence_ref"],"properties":{"evidence_ref":{"$ref":"#/$defs/CanonicalId"}},"additionalProperties":false,"description":"Select one exact reference from the evidence table of this request only. This is not an authorization or an attestation."},"AgentEvidenceReference":{"oneOf":[{"$ref":"#/$defs/EvidenceReference"},{"$ref":"#/$defs/EvidenceUse"}]},"RequestEvidenceTable":{"type":"object","additionalProperties":{"$ref":"#/$defs/EvidenceReference"},"description":"At most 128 request-local named exact references. Every entry must be used; each evidence_ref must name an entry. Expanded native validation and all ordinary evidence checks still apply."},"RouteContentSelection":{"type":"object","properties":{"offset":{"type":"integer","minimum":0,"description":"Default zero. A nonzero offset requires an explicit snapshot from the same route."},"limit":{"type":"integer","minimum":1,"maximum":32,"description":"Maximum whole policy reads in this page; default eight. Byte pressure may return fewer."}},"additionalProperties":false},"RoutedContentPage":{"type":"object","required":["offset","total","items"],"properties":{"offset":{"type":"integer","minimum":0},"total":{"type":"integer","minimum":0},"items":{"type":"array","maxItems":32,"items":{"oneOf":[{"$ref":"#/$defs/CompactReadResult"},{"$ref":"#/$defs/ReadResult"},{"$ref":"#/$defs/NavigationIndexesResult"},{"$ref":"#/$defs/ProvenanceReadResult"},{"$ref":"#/$defs/OperationalReadResult"}]}},"next":{"$ref":"#/$defs/RouteCall"}},"additionalProperties":false,"description":"Exact compact reads of selected targets in Router order. Total counts selected targets, not unresolved applicability. Follow next unchanged for the remaining page."},"ApplicationRoutedContentPage":{"type":"object","required":["offset","total","items"],"properties":{"offset":{"type":"integer","minimum":0},"total":{"type":"integer","minimum":0},"items":{"type":"array","maxItems":32,"items":{"$ref":"#/$defs/ApplicationReadResult"}},"next":{"$ref":"#/$defs/RouteCall"}},"additionalProperties":false,"description":"Exact compact reads of selected targets in Router order, each with its review label. Total counts selected targets, not unresolved applicability. A page ends early at the host\'s page byte budget but holds at least one whole item while targets remain. Follow next unchanged for the remaining page."},"DescribeInputCall":{"type":"object","additionalProperties":false,"properties":{"operation":{"type":"string","minLength":1,"description":"An operation published in this running catalog."},"selector":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9]*$","description":"A returned definition name (or the name in a schema $ref). Omit for the operation input root."},"expected_catalog":{"$ref":"#/$defs/Digest"},"offset":{"type":"integer","minimum":0,"description":"Record offset within the selected closure. Continue with the returned next request."},"limit":{"type":"integer","minimum":1,"maximum":16,"description":"Maximum whole schema records in this page; default 8. Byte pressure may return fewer."}},"required":["operation"]},"InputSchemaRecord":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":1},"schema_json":{"type":"string","minLength":1,"description":"Exact JSON Schema definition serialized as a JSON document; $refs name other returned/selectable definitions. Not a standalone validator without its closure."}},"required":["name","schema_json"]},"InputContractResult":{"type":"object","additionalProperties":false,"properties":{"kind":{"const":"input-contract-result"},"purpose":{"enum":["application","authoring"]},"interface_version":{"type":"integer","minimum":1},"catalog_digest":{"$ref":"#/$defs/Digest"},"operation":{"type":"string","minLength":1},"root":{"type":"string","minLength":1},"selector":{"type":"string","minLength":1},"dialect":{"const":"https://json-schema.org/draft/2020-12/schema"},"offset":{"type":"integer","minimum":0},"total":{"type":"integer","minimum":1},"records":{"type":"array","maxItems":16,"items":{"$ref":"#/$defs/InputSchemaRecord"}},"next":{"$ref":"#/$defs/DescribeInputCall"}},"required":["kind","purpose","interface_version","catalog_digest","operation","root","selector","dialect","offset","total","records"]},"InputContractRejectedResult":{"type":"object","additionalProperties":false,"properties":{"kind":{"const":"input-contract-rejected-result"},"purpose":{"enum":["application","authoring"]},"code":{"enum":["INPUT_DISCOVERY.INVALID_ARGUMENTS","INPUT_DISCOVERY.OPERATION_UNAVAILABLE","INPUT_DISCOVERY.CATALOG_CHANGED","INPUT_DISCOVERY.SELECTION_INVALID","INPUT_DISCOVERY.RESULT_LIMIT"]},"outcome":{"enum":["invalid","unavailable","unsupported"]},"message":{"type":"string","minLength":1},"input_feedback":{"$ref":"#/$defs/InputFeedback"}},"required":["kind","purpose","code","outcome","message"]},"InputIssue":{"type":"object","additionalProperties":false,"properties":{"instance_pointer":{"type":"string","description":"JSON Pointer to the invalid field; non-exact locations redact dynamic keys as * or use the root."},"location_exact":{"type":"boolean"},"keyword":{"type":"string"},"message":{"type":"string"}},"required":["instance_pointer","location_exact","keyword","message"]},"InputFeedback":{"type":"object","additionalProperties":false,"properties":{"issues":{"type":"array","maxItems":8,"items":{"$ref":"#/$defs/InputIssue"}},"truncated":{"type":"boolean","description":"Additional diagnostic detail was omitted due to a work, item or byte bound."},"describe_input":{"$ref":"#/$defs/DescribeInputCall"}},"required":["issues","truncated","describe_input"]},"RelationshipGroupsCall":{"type":"object","additionalProperties":false,"properties":{"snapshot":{"$ref":"#/$defs/SnapshotHandle"},"offset":{"type":"integer","minimum":0,"description":"Continue with the exact snapshot and offset returned by next. Nonzero offsets require a snapshot."},"limit":{"type":"integer","minimum":1,"maximum":32,"description":"Whole records per page, default 8; byte pressure may return fewer."}},"required":[]},"RelationshipGroup":{"type":"object","additionalProperties":false,"properties":{"id":{"$ref":"#/$defs/CanonicalId"},"description":{"type":"string"},"traversal_directions":{"type":"array","minItems":1,"uniqueItems":true,"items":{"enum":["incoming","outgoing"]},"description":"Directions permitted by this group for traversals; adjacency queries remain distinct."},"transitive":{"type":"boolean","description":"Whether the group permits transitive traversal."}},"required":["id","description","traversal_directions","transitive"]},"RelationshipGroupsResult":{"type":"object","additionalProperties":false,"properties":{"kind":{"const":"relationship-groups-result"},"purpose":{"enum":["application","authoring"]},"snapshot":{"$ref":"#/$defs/SnapshotHandle"},"offset":{"type":"integer","minimum":0},"total":{"type":"integer","minimum":0},"items":{"type":"array","maxItems":32,"items":{"$ref":"#/$defs/RelationshipGroup"}},"next":{"$ref":"#/$defs/RelationshipGroupsCall"}},"required":["kind","purpose","snapshot","offset","total","items"]},"CompactRouteResult":{"type":"object","additionalProperties":false,"properties":{"kind":{"const":"compact-route-result"},"snapshot":{"$ref":"#/$defs/SnapshotHandle"},"status":{"enum":["complete","needs-facts"]},"facts":{"$ref":"#/$defs/RoutingFactAssertions"},"reading_plan":{"type":"array","items":{"$ref":"#/$defs/ReadingPlanEntry"}},"unresolved_questions":{"type":"array","items":{"$ref":"#/$defs/RoutingQuestion"}},"unresolved_policy_count":{"type":"integer","minimum":0},"explanation":{"$ref":"#/$defs/RouteCall"},"next_operations":{"type":"array","items":{"$ref":"#/$defs/NextOperation"}},"summary":{"type":"string"},"content":{"$ref":"#/$defs/RoutedContentPage"}},"required":["kind","snapshot","status","facts","reading_plan","unresolved_questions","unresolved_policy_count","explanation","next_operations"]},"DescribeOutputCall":{"type":"object","additionalProperties":false,"properties":{"operation":{"type":"string","minLength":1,"description":"An operation published in this running catalog."},"selector":{"type":"string","pattern":"^[A-Za-z][A-Za-z0-9]*$","description":"A returned output definition name. Omit for the complete operation result algebra."},"expected_catalog":{"$ref":"#/$defs/Digest"},"offset":{"type":"integer","minimum":0,"description":"Record offset within the selected closure. Continue with the returned next request."},"limit":{"type":"integer","minimum":1,"maximum":16,"description":"Maximum whole schema records in this page; default 8. Byte pressure may return fewer."}},"required":["operation"]},"OutputSchemaRecord":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","minLength":1},"schema_json":{"type":"string","minLength":1,"description":"Exact JSON Schema definition serialized as a JSON document; $refs name other returned/selectable definitions. Not a standalone validator without its closure."}},"required":["name","schema_json"]},"OutputContractResult":{"type":"object","additionalProperties":false,"properties":{"kind":{"const":"output-contract-result"},"purpose":{"enum":["application","authoring"]},"interface_version":{"type":"integer","minimum":1},"catalog_digest":{"$ref":"#/$defs/Digest"},"operation":{"type":"string","minLength":1},"selector":{"type":"string","minLength":1},"dialect":{"const":"https://json-schema.org/draft/2020-12/schema"},"offset":{"type":"integer","minimum":0},"total":{"type":"integer","minimum":1},"records":{"type":"array","maxItems":16,"items":{"$ref":"#/$defs/OutputSchemaRecord"}},"next":{"$ref":"#/$defs/DescribeOutputCall"},"roots":{"type":"array","minItems":1,"uniqueItems":true,"items":{"type":"string","minLength":1}},"root_schema_json":{"type":"string","minLength":1,"description":"Exact operation result schema without $defs. Combine with all result-root definition pages for validation; schema_digest binds the full schema."},"schema_digest":{"$ref":"#/$defs/Digest"}},"required":["kind","purpose","interface_version","catalog_digest","operation","dialect","offset","total","records","roots","root_schema_json","schema_digest"]},"OutputContractRejectedResult":{"type":"object","additionalProperties":false,"properties":{"kind":{"const":"output-contract-rejected-result"},"purpose":{"enum":["application","authoring"]},"code":{"enum":["OUTPUT_DISCOVERY.INVALID_ARGUMENTS","OUTPUT_DISCOVERY.OPERATION_UNAVAILABLE","OUTPUT_DISCOVERY.CATALOG_CHANGED","OUTPUT_DISCOVERY.SELECTION_INVALID","OUTPUT_DISCOVERY.RESULT_LIMIT"]},"outcome":{"enum":["invalid","unavailable","unsupported"]},"message":{"type":"string","minLength":1},"input_feedback":{"$ref":"#/$defs/InputFeedback"}},"required":["kind","purpose","code","outcome","message"]},"RoutingFactAssertion":{"oneOf":[{"type":"boolean"},{"type":"null"},{"type":"string"},{"type":"array","items":{"type":"string"},"uniqueItems":true},{"type":"object","additionalProperties":false,"required":["state"],"properties":{"state":{"enum":["known-absent","unknown"]}}}]},"RoutingFactAssertions":{"type":"object","additionalProperties":{"$ref":"#/$defs/RoutingFactAssertion"}}}}') +VALIDATED_SCHEMA_DIGEST = 'sha256:3c1ab714f50b24ebf09b29d8b0112d50f3294343e67571ec72a69aa43fd0a20d' +DEFINITION_METADATA = freeze_json({'ActiveSnapshotSummary': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'lifecycle': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'source_revision': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'created_at': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'AgentAuthoredDecisionProvenance': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'id': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'subject': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'origin': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'rationale': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'evidence': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'assumptions': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'limits': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'alternatives': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'reconsideration': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'supersedes': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'AgentConsumerDispositionSubmission': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'obligation': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'result': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'rationale': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'evidence': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'fingerprint': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'AgentCoverageAttestationClaim': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'requirement': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'conclusion': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'evidence': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'explicit_exclusions': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'rationale': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'auditor_provenance': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'AgentCoverageAttestationSubmission': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'claim': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'AgentEvidenceReference': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'AgentImpactDispositionSubmission': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'obligation': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'result': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'rationale': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'evidence': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'fingerprint': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'AgentProposeCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'change_set': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'detail': {'title': None, 'description': 'Compact (default) returns an exact workflow summary; full returns complete analysis detail.', 'has_default': False, 'default': None}, 'evidence': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'AgentProvideFactSubmission': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'requirement': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'value': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'evidence': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'AgentPutDecisionProvenanceEdit': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'record': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'AgentRelationshipDisposition': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'relationship': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'disposition': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'replacement_consumer': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'rationale': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'evidence': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'AgentResolveManyCall': {'title': None, 'description': 'Resolve ordered decisions bound to one original analysis. Validate every item before publishing a final immutable successor; an invalid batch persists no intermediate decisions.', 'has_default': False, 'default': None, 'properties': {'context': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'submissions': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'detail': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'evidence': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'AgentResolveWorkflowCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'context': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'submission': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'detail': {'title': None, 'description': 'Compact (default) returns an exact workflow summary; full returns complete analysis detail.', 'has_default': False, 'default': None}, 'evidence': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'AgentRetirePolicyUnitEdit': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'policy': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'retired_semantic_revision': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'successors': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'relationship_dispositions': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'evidence': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'AgentRetireStandardEdit': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'standard': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'successors': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'relationship_dispositions': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'evidence': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'AgentReviewCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'context': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'decisions': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'detail': {'title': None, 'description': 'Compact (default) returns an exact workflow summary; full returns complete analysis detail.', 'has_default': False, 'default': None}, 'evidence': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'AgentReviewDecision': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'owner': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'decision': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'rationale': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'evidence': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'AgentReviseCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'context': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'change_set': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'detail': {'title': None, 'description': 'Compact (default) returns an exact workflow summary; full returns complete analysis detail.', 'has_default': False, 'default': None}, 'evidence': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'AgentRouteResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'reading_plan': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'unresolved_questions': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'next_operations': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'summary': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'facts': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'rules': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'content': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'AgentStandardEdit': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'AgentStandardsChangePurpose': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'summary': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'rationale': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'evidence': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'AgentStandardsChangeSet': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'purpose': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'edits': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'AgentSubmission': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'AllExpression': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'operator': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'expressions': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'AlwaysExpression': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'operator': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'AnalysisChildArtifact': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'AnalysisChildHandle': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'analysis': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'child_kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'child_id': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'schema_version': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'AnalysisChildInspectionResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'handle': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'artifact': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'AnalysisContext': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'handle': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'subjects': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'changes': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'semantic_proposals': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'AnalysisExecutionContractView': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'authorization_authority_digest': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'providers': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'AnalysisHandle': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'id': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'schema_version': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'AnalysisId': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'AnalysisInspectionResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'state': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'AnalysisMaterialHandle': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'AnalysisRequest': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'base_snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'proposed_snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'changes': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'semantic_proposals': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'prior_analysis': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'contract_version': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'AnalysisState': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'handle': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'base_snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'proposed_reference': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'changes': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'semantic_proposals': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'fact_observations': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'dispositions': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'coverage_attestations': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'authorization_records': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'domain_contracts': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'execution_contracts': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'contract_version': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'AnalyzeCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'context': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'detail': {'title': None, 'description': 'Compact (default) returns an exact workflow summary; full returns complete analysis detail.', 'has_default': False, 'default': None}}}, 'AnalyzeProposalCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'revision': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'AnyExpression': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'operator': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'expressions': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ApplicabilityExpression': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'ApplicationExposureState': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'ApplicationHandle': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'id': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'schema_version': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ApplicationId': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'ApplicationInspectCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'handle': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ApplicationNextOperation': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'operation': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'target': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'handle': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ApplicationPolicy': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'id': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'handle': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'role': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'level': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ApplicationPublicationReceipt': {'title': None, 'description': 'Durable application identity and exact candidate facts, separate from the fresh target observation.', 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'application': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'candidate_commit': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'candidate_tree': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'target_ref': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'expected_predecessor': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'durable_state': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'target_observation': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ApplicationQueryCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'request': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ApplicationQueryRequest': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'ApplicationQuestion': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'fact': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ApplicationReadCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'target': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'detail': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ApplicationReadManyCall': {'title': None, 'description': 'Read 1–32 selected items from one explicit snapshot, preserving order. The complete JSON result is limited to 2 MiB; any failed item rejects the entire request.', 'has_default': False, 'default': None, 'properties': {'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'items': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ApplicationReadManyItem': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'target': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'detail': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ApplicationReadManyResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'items': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'purpose': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ApplicationReadRequest': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'target': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'detail': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ApplicationReadResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'purpose': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'policy': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'review_state': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'content': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'scope': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'requires': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'specializes': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'related': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'next_operations': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ApplicationReadingEntry': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'target': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'scope': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'authority': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'state': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'review_state': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ApplicationRecoveryRequiredResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'application': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'status': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'code': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'outcome': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'message': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'publication': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'checkout': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'details': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ApplicationRejectedResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'purpose': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'code': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'outcome': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'message': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'next_operations': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'input_feedback': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'relationship_groups': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ApplicationRelatedResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'purpose': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'target': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'relationships': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'next_operations': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ApplicationRelationship': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'handle': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'source': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'target': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'relation': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'groups': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'direction': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ApplicationReviewState': {'title': None, 'description': 'Review label of delivered application material. current: this exact text was approved for application use. changed-since-review: the text was edited after its approval. not-reviewed: the text has never been approved. The label never withholds material; a scoped policy read carries the label of its containing module.', 'has_default': False, 'default': None, 'properties': {}}, 'ApplicationRouteResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'purpose': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'status': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'reading_plan': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'unresolved_questions': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'next_operations': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'content': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ApplicationRoutedContentPage': {'title': None, 'description': "Exact compact reads of selected targets in Router order, each with its review label. Total counts selected targets, not unresolved applicability. A page ends early at the host's page byte budget but holds at least one whole item while targets remain. Follow next unchanged for the remaining page.", 'has_default': False, 'default': None, 'properties': {'offset': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'total': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'items': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'next': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ApplicationRoutingFactsResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'purpose': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'facts': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'next_operations': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ApplyCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'context': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'detail': {'title': None, 'description': 'Compact (default) returns an exact workflow summary; full returns complete analysis detail.', 'has_default': False, 'default': None}}}, 'ApplyProposalCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'readiness': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ApplyProposalResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'application': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'status': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'publication': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'checkout': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ApproveApplicationContentEdit': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'target': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'AuditPolicyUnitEdit': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'policy': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'rationale': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'AuthoredDecisionProvenance': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'id': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'subject': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'origin': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'rationale': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'evidence': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'assumptions': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'limits': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'alternatives': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'reconsideration': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'supersedes': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'AuthoredRoutingFact': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'id': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'semantic_revision': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'type': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'nullable': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'values': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'aliases': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'meaning': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'prompt': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'AuthoredRoutingRule': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'id': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'target': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'when': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'condition': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'AuthoringTargetHandle': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'id': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'schema_version': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'AuthorizationId': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'AuthorizationRecord': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'reference': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'issuer_semantic_revision': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'principal': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'action': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'subject_kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'subject_id': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'authorization_evidence': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'revocation_authority': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'revocation_authority_semantic_revision': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'revocation_evidence': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'AuthorizationReference': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'id': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'issuer': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'capability': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'authority_digest': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'CandidateApplicationNextOperation': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'operation': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'revision': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'request': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'CandidateApplicationPolicy': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'id': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'role': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'level': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'CandidateApplicationReadResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'purpose': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'policy': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'review_state': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'content': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'scope': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'requires': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'specializes': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'related': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'next_operations': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'revision': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'CandidateApplicationRejectedResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'purpose': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'code': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'outcome': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'message': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'next_operations': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'revision': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'CandidateApplicationRelatedResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'purpose': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'target': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'relationships': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'next_operations': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'revision': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'CandidateApplicationRelationship': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'source': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'target': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'relation': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'groups': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'direction': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'CandidateApplicationRouteResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'purpose': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'status': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'reading_plan': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'unresolved_questions': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'next_operations': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'revision': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'CanonicalId': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'CanonicalModuleDeclaration': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'id': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'role': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'level': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'applies_when': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'does_not_apply_when': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'requires': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'specializes': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'verification': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ChangeDescriptor': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'accepted_ids': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'proposed_ids': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'scope': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'accepted_module': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'proposed_module': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ChangePolicySemantics': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'accepted_semantic_revision': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'proposed_semantic_revision': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'intent': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ChangedPolicyUnit': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'policy': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'change_kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'classification': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'accepted_representation_digest': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'proposed_representation_digest': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'accepted_structural_digest': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'proposed_structural_digest': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'accepted_semantic_revision': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'proposed_semantic_revision': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'semantic_state': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'scope': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ChildId': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'CompactReadResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'policy': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'content': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'requires': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'specializes': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'next_operations': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'summary': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'routing': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'coverage': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'detail': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'application_exposure': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'provenance': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'CompactRouteResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'status': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'facts': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'reading_plan': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'unresolved_questions': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'unresolved_policy_count': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'explanation': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'next_operations': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'summary': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'content': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'CompleteResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'handle': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'status': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'context': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'changes': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'changed_units': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'coverage_certificates': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'fact_observations': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'dispositions': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'reading_plan': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'completion': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'summary': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'CompletionProof': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'required_coverage_subjects': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'certificate_subjects': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'reached_consumer_obligations': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'disposition_obligations': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'required_fact_requirements': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'observed_fact_requirements': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'non_consumer_obligations_resolved': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'applicability_resolved': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'authorization_valid': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'evidence_valid': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ConsumerDispositionSubmission': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'obligation': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'result': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'rationale': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'evidence': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'fingerprint': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ConsumerReviewContract': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'id': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'version': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'permitted_dispositions': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'evidence_contract': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'authorization_capability': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'semantics': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ConsumerReviewObligationReadingReason': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'obligation': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ContainsExpression': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'operator': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'fact': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'value': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'CoverageAttestation': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'requirement': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'conclusion': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'evidence': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'explicit_exclusions': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'rationale': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'auditor_provenance': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'schema_version': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'authorization': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'CoverageAttestationClaim': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'requirement': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'conclusion': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'evidence': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'explicit_exclusions': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'rationale': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'auditor_provenance': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'CoverageAttestationSubmission': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'claim': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'CoverageAuditAuthority': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'issuer': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'principal': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'authorization_id': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'CoverageCertificate': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'handle': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'requirement': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'subject': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'owner': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'semantic_revision': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'horizon_digest': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'relationship_digest': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'evidence_digests': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'fact_schema_digest': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'CoverageRequirement': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'handle': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'subject': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'owner': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'semantic_revision': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'relationship_kinds': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'horizon': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'required_evidence_contract': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'CreateProposalCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'base_snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'change_set': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'CreateProposalResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'proposal': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'revision': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'CreateSnapshotCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'CreateSnapshotResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'CreateStandardEdit': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'standard': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'requires': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'specializes': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'policy_units': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'DecisionDependency': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'class': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'identity': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'digest': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'DecisionFingerprint': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'decision_kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'decision_contract': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'schema_version': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'dependencies': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'DecisionProvenanceRecord': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'id': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'subject': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'origin': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'rationale': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'evidence': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'assumptions': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'limits': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'alternatives': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'reconsideration': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'supersedes': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'subject_binding': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'retired': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'DeleteSnapshotCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'DeleteSnapshotResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'purge_deadline': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'DescribeInputCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'operation': {'title': None, 'description': 'An operation published in this running catalog.', 'has_default': False, 'default': None}, 'selector': {'title': None, 'description': 'A returned definition name (or the name in a schema $ref). Omit for the operation input root.', 'has_default': False, 'default': None}, 'expected_catalog': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'offset': {'title': None, 'description': 'Record offset within the selected closure. Continue with the returned next request.', 'has_default': False, 'default': None}, 'limit': {'title': None, 'description': 'Maximum whole schema records in this page; default 8. Byte pressure may return fewer.', 'has_default': False, 'default': None}}}, 'DescribeOutputCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'operation': {'title': None, 'description': 'An operation published in this running catalog.', 'has_default': False, 'default': None}, 'selector': {'title': None, 'description': 'A returned output definition name. Omit for the complete operation result algebra.', 'has_default': False, 'default': None}, 'expected_catalog': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'offset': {'title': None, 'description': 'Record offset within the selected closure. Continue with the returned next request.', 'has_default': False, 'default': None}, 'limit': {'title': None, 'description': 'Maximum whole schema records in this page; default 8. Byte pressure may return fewer.', 'has_default': False, 'default': None}}}, 'Digest': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'DispositionRecord': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'obligation': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'result': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'rationale': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'evidence': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'authorization': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'fingerprint': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'DomainContractReference': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'id': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'version': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'EdgeId': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'EngineCertificateRetirement': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'subject': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'requirement_id': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'rationale': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'EqualsExpression': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'operator': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'fact': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'value': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'EvidenceCheckRetirement': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'suite': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'check': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'EvidenceConsumerRegistration': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'path': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'artifact_kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'source_policies': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'relation': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'evidence_owner': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'rationale': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'EvidenceMaintenancePlan': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'retire_engine_certificates': {'title': None, 'description': 'Explicitly retire exact registered Engine-issued certificates by subject and requirement; preserve normative policy and consumer registrations.', 'has_default': False, 'default': None}, 'prune_stale_certificates': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'retire_suites': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'retire_checks': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'retire_inputs': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'suite_descriptions': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'replacement_evidence_owner': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'replacement_evidence_rationale': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'relationship_updates': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'consumer_registrations': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'unregister_policy_subjects': {'title': None, 'description': 'Remove selected review-subject registrations and their source relationships while preserving normative Markdown.', 'has_default': False, 'default': None}}}, 'EvidenceReference': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'id': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'digest': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'provider_contract': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'provider_contract_version': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'EvidenceRelationshipUpdate': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'source_policy': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'consumer': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'relation': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'evidence_owner': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'rationale': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'EvidenceSuiteDescription': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'suite': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'description': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'EvidenceUse': {'title': None, 'description': 'Select one exact reference from the evidence table of this request only. This is not an authorization or an attestation.', 'has_default': False, 'default': None, 'properties': {'evidence_ref': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ExistsExpression': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'operator': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'fact': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'FactObservation': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'handle': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'requirement': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'value': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'evidence': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'authorization': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'provider': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'FactRequirement': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'handle': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'fact': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'fact_semantic_revision': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'fact_contract_digest': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'context': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'value_contract': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'answer_contract': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'evidence_contract': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'authorization_capability': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'FactRequirementId': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'FactRequirementWork': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'requirement': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'prompt': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'dependent_programs': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'FactSet': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'FactValue': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'FactValueContract': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'type': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'states': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'nullable': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'values': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'FindProposalsCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'after': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'limit': {'title': None, 'description': None, 'has_default': True, 'default': 50}}}, 'FindProposalsResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'proposals': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'continuation': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'FindSnapshotsCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'lifecycle': {'title': None, 'description': None, 'has_default': True, 'default': 'active'}, 'after': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'limit': {'title': None, 'description': None, 'has_default': True, 'default': 50}}}, 'FindSnapshotsResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'snapshots': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'continuation': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'FocusedQueryNextOperation': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'operation': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'request_kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'target': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'GeneralSelectionReason': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'source': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'fact': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'edge': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'question': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'GitObjectId': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'ImpactDispositionSubmission': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'obligation': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'result': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'rationale': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'evidence': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'fingerprint': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ImpactTraceId': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'ImpactTraceReference': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'id': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'graph': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'applicability': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'InExpression': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'operator': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'fact': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'values': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'InputContractRejectedResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'purpose': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'code': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'outcome': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'message': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'input_feedback': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'InputContractResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'purpose': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'interface_version': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'catalog_digest': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'operation': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'root': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'selector': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'dialect': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'offset': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'total': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'records': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'next': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'InputFeedback': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'issues': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'truncated': {'title': None, 'description': 'Additional diagnostic detail was omitted due to a work, item or byte bound.', 'has_default': False, 'default': None}, 'describe_input': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'InputIssue': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'instance_pointer': {'title': None, 'description': 'JSON Pointer to the invalid field; non-exact locations redact dynamic keys as * or use the root.', 'has_default': False, 'default': None}, 'location_exact': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'keyword': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'message': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'InputSchemaRecord': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'name': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'schema_json': {'title': None, 'description': 'Exact JSON Schema definition serialized as a JSON document; $refs name other returned/selectable definitions. Not a standalone validator without its closure.', 'has_default': False, 'default': None}}}, 'InspectCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'handle': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'InspectNextOperation': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'operation': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'request_kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'handle': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'InspectableHandle': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'InspectionResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'MaintainEvidenceCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'expected_revision': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'evidence': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'plan': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'apply': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'MaintainEvidenceResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'applied': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'changed_files': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'removed_files': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'verification': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ModuleRelationshipKey': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'relation': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'source': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'target': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'MovePolicyUnitEdit': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'policy': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'standard': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'after_policy': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'semantics': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'NavigationIndexEntry': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'id': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'entrypoint': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'destinations': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'content': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'NavigationIndexesResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'authority': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'indexes': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'next_operations': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'NavigationRetarget': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'entrypoint': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'standard': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'NewPolicyUnit': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'id': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'heading_chain': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'semantic_revision': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'intent': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'aliases': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'predecessors': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'successors': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'NextOperation': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'NonEmptyString': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'NotExpression': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'operator': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'expression': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'Obligation': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'handle': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'target': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'scope': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'reasons': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'state': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'applicability': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'permitted_submissions': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'review_contract': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'fingerprint': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ObligationId': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'OperationalReadResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'authority': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'target': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'canonical_id': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'role': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'content': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'application_exposure': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'next_operations': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'OutputContractRejectedResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'purpose': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'code': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'outcome': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'message': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'input_feedback': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'OutputContractResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'purpose': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'interface_version': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'catalog_digest': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'operation': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'selector': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'dialect': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'offset': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'total': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'records': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'next': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'roots': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'root_schema_json': {'title': None, 'description': 'Exact operation result schema without $defs. Combine with all result-root definition pages for validation; schema_digest binds the full schema.', 'has_default': False, 'default': None}, 'schema_digest': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'OutputSchemaRecord': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'name': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'schema_json': {'title': None, 'description': 'Exact JSON Schema definition serialized as a JSON document; $refs name other returned/selectable definitions. Not a standalone validator without its closure.', 'has_default': False, 'default': None}}}, 'PendingResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'handle': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'status': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'context': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'changes': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'changed_units': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'obligations': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'fact_requirements': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'reading_plan': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'next_operations': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'summary': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'PolicyCoverageStatus': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'subject': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'requirement_id': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'status': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'authority': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'PolicyImpactSelectionReason': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'source': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'edge': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'relation': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'evidence_owner': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'traces': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'PolicyInspectionResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'policy': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'declaration': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'representation_digest': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'structural_digest': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'provenance': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'PolicyRelationship': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'source_policy': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'consumer': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'relation': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'applicability': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'source_scope': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'consumer_scope': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'evidence_owner': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'rationale': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'PolicyRelationshipInspection': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'relationship_kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'applicability': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'source_scope': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'consumer_scope': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'propagation': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'evidence_owner': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'rationale': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'PolicyRelationshipKey': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'source_policy': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'consumer': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'relation': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'PolicyScopeUpdate': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'policy': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'heading_path': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'semantics': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'PolicySemanticIntent': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'PolicySummary': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'handle': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'authority': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'scope': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'PolicyUnitDeclaration': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'id': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'module': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'heading_path': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'semantic_revision': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'lifecycle': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'aliases': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'predecessors': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'successors': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'PolicyUnitMapping': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'state': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'reason': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'policy_units': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'PrepareCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'request': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'PreservePolicySemantics': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'semantic_revision': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'intent': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'PreviewApplicationCall': {'title': None, 'description': "Authoring-only inspection of an exact draft as an application agent would receive it, including each item's review label; this observation neither publishes nor grants ordinary application access.", 'has_default': False, 'default': None, 'properties': {'revision': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'request': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'PreviewApplicationResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'ProposalHandle': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'id': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'schema_version': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ProposalId': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'ProposalPolicySummary': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'id': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'authority': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'scope': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ProposalReadResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'revision': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'policy': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'content': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'requires': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'specializes': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'related': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'next_operations': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'summary': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'routing': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'coverage': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'application_exposure': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'provenance': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ProposalRelatedResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'revision': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'target': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'authoring_target': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'policy_unit_mapping': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'relationships': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'next_operations': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'summary': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ProposalRelationshipSummary': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'source': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'target': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'relation': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'groups': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'direction': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'traversal_eligible': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'applicability': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ProposalRevisionHandle': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'id': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'schema_version': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ProposalRevisionId': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'ProposalRouteResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'revision': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'reading_plan': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'unresolved_questions': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'next_operations': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'summary': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ProposalSummary': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'proposal': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'head_revision': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ProposeCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'change_set': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'detail': {'title': None, 'description': 'Compact (default) returns an exact workflow summary; full returns complete analysis detail.', 'has_default': False, 'default': None}}}, 'ProvenanceReadResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'authority': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'record': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'state': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'next_operations': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ProvenanceRecord': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'path': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ProvideFactSubmission': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'requirement': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'value': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'evidence': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ProviderReference': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'id': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'contract': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'contract_version': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'input_digest': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'PublicationCheckoutObservation': {'title': None, 'description': 'Fresh read-only observation of one selected checkout. Unavailable observations use null for every fact that could not be established.', 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'status': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'worktree_id': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'symbolic_branch': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'head': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'index_observation': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'publication_path_count': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'index_paths': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'worktree_paths': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'PublicationPathCounts': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'predecessor': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'candidate': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'conflicted': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'PublicationTargetObservation': {'title': None, 'description': 'Fresh bounded observation of the configured target ref; an unavailable revision is null.', 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'status': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'revision': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'PutDecisionProvenanceEdit': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'record': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'PutPolicyRelationshipEdit': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'relationship': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'PutRoutingFactEdit': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'fact': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'rationale': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'PutRoutingRuleEdit': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'rule': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'rationale': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'QuarantinedSnapshotSummary': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'lifecycle': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'source_revision': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'created_at': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'purge_deadline': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'QueryCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'request': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'QueryNextOperation': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'operation': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'request_kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'target': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'QueryProposalCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'revision': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'request': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'QueryProposalNextOperation': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'operation': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'request_kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'target': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'revision': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'QueryProposalResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'QueryRequest': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'QueryResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'Question': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'id': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'prompt': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'state': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'permitted_answers': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ReadCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'target': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'include_routing': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'include_coverage': {'title': None, 'description': 'Include current repository attestation status for registered policy units in this read scope.', 'has_default': False, 'default': None}, 'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'detail': {'title': None, 'description': 'Compact preserves exact policy and essential authority; full includes all relationship rows.', 'has_default': False, 'default': None}}}, 'ReadCoverage': {'title': None, 'description': 'Repository attestation status bound to this snapshot or proposal. Empty subjects means no registered policy units in scope, not complete coverage. Analysis-local attestations are not repository certificates.', 'has_default': False, 'default': None, 'properties': {'subjects': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ReadManyCall': {'title': None, 'description': 'Read 1–32 selected items from one explicit snapshot, preserving order. The complete JSON result is limited to 2 MiB; any failed item rejects the entire request.', 'has_default': False, 'default': None, 'properties': {'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'items': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ReadManyItem': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'target': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'include_routing': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'include_coverage': {'title': None, 'description': 'Include current repository attestation status for registered policy units in this read scope.', 'has_default': False, 'default': None}, 'detail': {'title': None, 'description': 'Compact preserves exact policy and essential authority; full includes all relationship rows.', 'has_default': False, 'default': None}}}, 'ReadManyResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'items': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ReadRequest': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'target': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'include_routing': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'include_coverage': {'title': None, 'description': 'Include current repository attestation status for registered policy units in this read scope.', 'has_default': False, 'default': None}}}, 'ReadResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'policy': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'content': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'requires': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'specializes': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'related': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'next_operations': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'summary': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'routing': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'coverage': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'application_exposure': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'provenance': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ReadinessHandle': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'id': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'schema_version': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ReadinessId': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'ReadingPlanEntry': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'target': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'scope': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'authority': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'reasons': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'state': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ReadingPlanReason': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'RecoverApplicationCall': {'title': None, 'description': 'Recover an admitted application. Observation performs no Git writes. Explicit completion reconstructs and verifies the exact admitted candidate before one compare-and-swap attempt.', 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'readiness': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'action': {'title': None, 'description': 'Omit or select observe to reconcile only. Explicit complete-publication revalidates and attempts the same admitted candidate against its original expected target; it requires current publication authorization.', 'has_default': False, 'default': None}}}, 'RecoverApplicationResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'application': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'status': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'publication': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'checkout': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'RecoverCall': {'title': None, 'description': 'Recover an admitted application. Observation performs no Git writes. Explicit completion reconstructs and verifies the exact admitted candidate before one compare-and-swap attempt.', 'has_default': False, 'default': None, 'properties': {'context': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'action': {'title': None, 'description': 'Omit or select observe to reconcile only. Explicit complete-publication revalidates and attempts the same admitted candidate against its original expected target; it requires current publication authorization.', 'has_default': False, 'default': None}, 'detail': {'title': None, 'description': 'Compact (default) returns an exact workflow summary; full returns complete analysis detail.', 'has_default': False, 'default': None}}}, 'RegisterConsumerEdit': {'title': None, 'description': 'Register an existing tracked consumer within this proposal. The Engine captures original-revision bytes; use separate policy relationships to declare consumers and review obligations.', 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'consumer': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'path': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'artifact_kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'authority': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'RegisterPolicyUnitEdit': {'title': None, 'description': 'Register an explicitly selected policy scope in an existing standard. The Engine owns declaration placement and validates the final candidate.', 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'standard': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'policy_unit': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'RejectedResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'code': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'outcome': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'target': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'message': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'details': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'next_operations': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'input_feedback': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'relationship_groups': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'RelatedCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'target': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'groups': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'direction': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'transitive': {'title': None, 'description': None, 'has_default': True, 'default': False}, 'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'RelatedRequest': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'target': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'groups': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'direction': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'transitive': {'title': None, 'description': None, 'has_default': True, 'default': False}}}, 'RelatedResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'target': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'authoring_target': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'policy_unit_mapping': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'relationships': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'next_operations': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'summary': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'RelationshipConsumer': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'RelationshipDisposition': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'relationship': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'disposition': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'replacement_consumer': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'rationale': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'evidence': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'RelationshipGroup': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'id': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'description': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'traversal_directions': {'title': None, 'description': 'Directions permitted by this group for traversals; adjacency queries remain distinct.', 'has_default': False, 'default': None}, 'transitive': {'title': None, 'description': 'Whether the group permits transitive traversal.', 'has_default': False, 'default': None}}}, 'RelationshipGroupsCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'offset': {'title': None, 'description': 'Continue with the exact snapshot and offset returned by next. Nonzero offsets require a snapshot.', 'has_default': False, 'default': None}, 'limit': {'title': None, 'description': 'Whole records per page, default 8; byte pressure may return fewer.', 'has_default': False, 'default': None}}}, 'RelationshipGroupsResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'purpose': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'offset': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'total': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'items': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'next': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'RelationshipInspectionResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'relationship': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'policy_semantics': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'provenance': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'RelationshipKey': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'RelationshipSummary': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'handle': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'source': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'target': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'relation': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'groups': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'direction': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'traversal_eligible': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'applicability': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'RemovePolicyRelationshipEdit': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'relationship': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'RemoveRoutingFactEdit': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'fact': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'rationale': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'RemoveRoutingRuleEdit': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'rule': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'rationale': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ReplaceStandardRelationshipsEdit': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'standard': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'requires': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'specializes': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'rationale': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'RepositoryPath': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'RequestEvidenceTable': {'title': None, 'description': 'At most 128 request-local named exact references. Every entry must be used; each evidence_ref must name an entry. Expanded native validation and all ordinary evidence checks still apply.', 'has_default': False, 'default': None, 'properties': {}}, 'RequiresReadingReason': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'edge': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'source': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ResolveCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'analysis': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'submission': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ResolveManyCall': {'title': None, 'description': 'Resolve ordered decisions bound to one original analysis. Validate every item before publishing a final immutable successor; an invalid batch persists no intermediate decisions.', 'has_default': False, 'default': None, 'properties': {'context': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'submissions': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'detail': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ResolveNextOperation': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'operation': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'request_kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'target': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'work': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'analysis': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ResolveWorkflowCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'context': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'submission': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'detail': {'title': None, 'description': 'Compact (default) returns an exact workflow summary; full returns complete analysis detail.', 'has_default': False, 'default': None}}}, 'ResumeCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'context': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'detail': {'title': None, 'description': 'Compact (default) returns an exact workflow summary; full returns complete analysis detail.', 'has_default': False, 'default': None}}}, 'RetireDecisionProvenanceEdit': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'id': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'RetirePolicyUnitEdit': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'policy': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'retired_semantic_revision': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'successors': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'relationship_dispositions': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'evidence': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'RetireStandardEdit': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'standard': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'successors': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'relationship_dispositions': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'evidence': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ReviewCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'context': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'decisions': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'detail': {'title': None, 'description': 'Compact (default) returns an exact workflow summary; full returns complete analysis detail.', 'has_default': False, 'default': None}}}, 'ReviewDecision': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'owner': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'decision': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'rationale': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'evidence': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ReviewProposalCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'analysis': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'decisions': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'prior_readiness': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ReviewProposalResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'readiness': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'revision': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'status': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ReviewScope': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'ReviseCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'context': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'change_set': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'detail': {'title': None, 'description': 'Compact (default) returns an exact workflow summary; full returns complete analysis detail.', 'has_default': False, 'default': None}}}, 'ReviseOperationalArtifactEdit': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'target': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'title': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'body': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'RevisePolicyUnitEdit': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'policy': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'title': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'body': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'semantics': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ReviseProposalCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'expected_revision': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'change_set': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ReviseProposalResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'proposal': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'revision': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ReviseStandardEdit': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'standard': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'scope_updates': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'RewriteNavigationIndexEdit': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'entrypoint': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'destinations': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'rationale': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'retargets': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'RouteCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'facts': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'content': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'detail': {'title': None, 'description': 'Compact authoring selection is default. Full returns the rule explanation. Application always retains its qualified projection.', 'has_default': False, 'default': None}}}, 'RouteContentSelection': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'offset': {'title': None, 'description': 'Default zero. A nonzero offset requires an explicit snapshot from the same route.', 'has_default': False, 'default': None}, 'limit': {'title': None, 'description': 'Maximum whole policy reads in this page; default eight. Byte pressure may return fewer.', 'has_default': False, 'default': None}}}, 'RouteRequest': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'facts': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'RouteResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'reading_plan': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'unresolved_questions': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'next_operations': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'summary': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'RoutedContentPage': {'title': None, 'description': 'Exact compact reads of selected targets in Router order. Total counts selected targets, not unresolved applicability. Follow next unchanged for the remaining page.', 'has_default': False, 'default': None, 'properties': {'offset': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'total': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'items': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'next': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'RoutingBaseReadingReason': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'projection': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'RoutingConfiguration': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'facts': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'rules': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'RoutingFactAssertion': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'RoutingFactAssertions': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'RoutingFactsCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'RoutingFactsResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'facts': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'RoutingQuestion': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'id': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'prompt': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'state': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'fact': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'RoutingRuleExplanation': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'id': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'target': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'when': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'state': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'RoutingRuleReadingReason': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'rule': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'facts': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'RuntimeInfoCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'expected_catalog': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'RuntimeInfoResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'purpose': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'interface_version': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'implementation_version': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'instance_id': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'implementation_digest': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'catalog_digest': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'schema_digest': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'installation_state': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'client_catalog_state': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'action': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'ScalarValue': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'SelectionReason': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'SemanticProposal': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'policy': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'accepted_semantic_revision': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'proposed_semantic_revision': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'intent': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'structural_digest': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'SnapshotChildHandle': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'child_kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'child_id': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'schema_version': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'SnapshotHandle': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'id': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'schema_version': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'SnapshotId': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'SnapshotInspectionResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'SnapshotSummary': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'SpecializesReadingReason': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'edge': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'source': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'StandardContent': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'id': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'title': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'role': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'level': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'applies_when': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'does_not_apply_when': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'verification': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'body': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'StandardEdit': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'StandardsChangePurpose': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'summary': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'rationale': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'evidence': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'StandardsChangeSet': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'purpose': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'edits': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'StructuredScope': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'heading_path': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'Submission': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'Timestamp': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'UndeleteSnapshotCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'UndeleteSnapshotResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'snapshot': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'VerificationFailure': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'code': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'message': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'suite': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'check': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'VerificationReport': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'passed': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'exit_code': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'suites': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'checks': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'failures': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'VerifyProposalCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'revision': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'readiness': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'VerifyProposalResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'revision': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'verification': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'readiness': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'VerifyRepositoryCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'refresh_verification_inputs': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'VerifyRepositoryResult': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'refreshed_verification_inputs': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'verification': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'WholeArtifactScope': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'WithdrawApplicationContentEdit': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'target': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'WorkflowAnalysisSummary': {'title': None, 'description': 'Counts for the enclosing immutable Analysis context. Observation remains summary-only; successful compact pending mutations additionally return a bounded work page.', 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'status': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'required_obligations': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'pending_facts': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'sections': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'details': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'WorkflowContext': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'WorkflowContinuation': {'title': None, 'description': 'Select the named operation with the enclosing WorkflowResult context and explicit required inputs. This descriptor is not an authorization grant.', 'has_default': False, 'default': None, 'properties': {'operation': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'required_inputs': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'WorkflowDetailItem': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'WorkflowDetailsCall': {'title': None, 'description': 'Read a section of an immutable historical Analysis. Compact pages (default eight items) contain up to 16 whole records and 64 KiB of result JSON, returning fewer items when needed. An oversized record returns an explicit full-detail retry. detail=full retrieves one complete record (limit omitted or 1) without the compact byte cap; choose it only when the client can receive that payload. Continuations bind the Analysis, section and projected contents. Decision and publication operations check current evidence and authorization. A full-record response resumes compact paging in its next request.', 'has_default': False, 'default': None, 'properties': {'analysis': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'section': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'offset': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'limit': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'observation': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'detail': {'title': None, 'description': 'Compact is byte-bounded; full explicitly retrieves one whole record without the compact byte cap.', 'has_default': False, 'default': None}}}, 'WorkflowDetailsLink': {'title': None, 'description': 'Supply the enclosing WorkflowResult Analysis context as analysis and explicitly select a section.', 'has_default': False, 'default': None, 'properties': {'operation': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'WorkflowDetailsNextOperation': {'title': None, 'description': 'An explicit historical detail retrieval alternative. Invoke operation with request; do not automatically select size-unbounded full detail.', 'has_default': False, 'default': None, 'properties': {'operation': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'request_kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'request': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'WorkflowDetailsResult': {'title': None, 'description': 'Whole records from an immutable Analysis section. Compact may return fewer than limit to respect 64 KiB. Full returns at most one complete record and may exceed 64 KiB. Follow next exactly; observation and total are independent of page size and detail mode.', 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'analysis': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'section': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'observation': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'offset': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'total': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'items': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'next': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'WorkflowDetailsSelection': {'title': None, 'description': 'A workflow_details selection relative to the enclosing WorkflowResult Analysis context. Add analysis from that context when invoking; preserve every returned selection field.', 'has_default': False, 'default': None, 'properties': {'section': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'offset': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'limit': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'observation': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'detail': {'title': None, 'description': 'Compact is byte-bounded; full explicitly retrieves one whole record without the compact byte cap.', 'has_default': False, 'default': None}}}, 'WorkflowObligationWork': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'obligation': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'work': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'WorkflowOutcome': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'WorkflowResult': {'title': None, 'description': 'Exact immutable workflow context and relative action descriptors. Successful compact pending propose, revise, analyze and decision submissions include work from the already-produced Analysis. Status observations, full results, stale contexts and other outcomes omit work.', 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'context': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'proposal': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'revision': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'publication': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'checkout': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'status': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'next_operations': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'outcome': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'work': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'WorkflowSection': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {}}, 'WorkflowSectionCount': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'section': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'count': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'WorkflowStatusCall': {'title': None, 'description': None, 'has_default': False, 'default': None, 'properties': {'context': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'detail': {'title': None, 'description': 'Compact (default) returns an exact workflow summary; full returns complete analysis detail.', 'has_default': False, 'default': None}}}, 'WorkflowWorkDeferred': {'title': None, 'description': 'The mutation succeeded but its first complete work record exceeds the compact page budget. Preserve the enclosing context and counts; request explicitly selects that exact full record without the compact byte cap.', 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'code': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'section': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'total': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'request': {'title': None, 'description': None, 'has_default': False, 'default': None}}}, 'WorkflowWorkPage': {'title': None, 'description': 'First actionable section of a successful compact pending mutation, bound to the enclosing Analysis context. Facts precede obligations. Up to eight whole items and 64 KiB of page JSON; next is a relative workflow_details selection. Work handles retain their complete authority.', 'has_default': False, 'default': None, 'properties': {'kind': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'section': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'observation': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'offset': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'total': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'items': {'title': None, 'description': None, 'has_default': False, 'default': None}, 'next': {'title': None, 'description': None, 'has_default': False, 'default': None}}}}) @dataclass(frozen=True, slots=True) class ActiveSnapshotSummary: @@ -1284,6 +1285,7 @@ class ApplicationReadResult: 'purpose': 'purpose', 'snapshot': 'snapshot', 'policy': 'policy', + 'review_state': 'review_state', 'content': 'content', 'scope': 'scope', 'requires': 'requires', @@ -1295,6 +1297,7 @@ class ApplicationReadResult: purpose: Literal['application'] snapshot: SnapshotHandle policy: ApplicationPolicy + review_state: ApplicationReviewState content: str scope: ReviewScope requires: tuple[CanonicalId, ...] @@ -1324,11 +1327,13 @@ class ApplicationReadingEntry: 'scope': 'scope', 'authority': 'authority', 'state': 'state', + 'review_state': 'review_state', }) target: CanonicalId scope: ReviewScope authority: Literal['normative', 'contextual'] state: Literal['selected'] + review_state: ApplicationReviewState def __post_init__(self) -> None: _RUNTIME.normalize_model(self) @@ -1397,7 +1402,7 @@ class ApplicationRejectedResult: }) kind: Literal['application-rejected-result'] purpose: Literal['application'] - code: Literal['APPLICATION.CONTENT_UNAVAILABLE', 'APPLICATION.INPUT_INVALID', 'APPLICATION.OPERATION_UNAVAILABLE', 'APPLICATION.INTERNAL_UNAVAILABLE', 'APPLICATION.UNSUPPORTED_CAPTURE', 'APPLICATION.RESULT_LIMIT', 'APPLICATION.UNKNOWN_GROUP'] + code: Literal['APPLICATION.UNKNOWN_TARGET', 'APPLICATION.INPUT_INVALID', 'APPLICATION.OPERATION_UNAVAILABLE', 'APPLICATION.INTERNAL_UNAVAILABLE', 'APPLICATION.UNSUPPORTED_CAPTURE', 'APPLICATION.RESULT_LIMIT', 'APPLICATION.UNKNOWN_GROUP', 'APPLICATION.TRAVERSAL_NOT_PERMITTED'] outcome: Literal['invalid', 'unsupported', 'unavailable'] message: str next_operations: tuple[ApplicationNextOperation, ...] @@ -1519,7 +1524,7 @@ def as_contract(self) -> dict[str, object]: @dataclass(frozen=True, slots=True) class ApplicationRoutedContentPage: - 'Exact compact reads of selected targets in Router order. Total counts selected targets, not unresolved applicability. Follow next unchanged for the remaining page.' + "Exact compact reads of selected targets in Router order, each with its review label. Total counts selected targets, not unresolved applicability. A page ends early at the host's page byte budget but holds at least one whole item while targets remain. Follow next unchanged for the remaining page." __definition__: ClassVar[str] = 'ApplicationRoutedContentPage' __contract_fields__: ClassVar = MappingProxyType({ 'offset': 'offset', @@ -1963,6 +1968,7 @@ class CandidateApplicationReadResult: 'kind': 'kind', 'purpose': 'purpose', 'policy': 'policy', + 'review_state': 'review_state', 'content': 'content', 'scope': 'scope', 'requires': 'requires', @@ -1974,6 +1980,7 @@ class CandidateApplicationReadResult: kind: Literal['candidate-application-read-result'] purpose: Literal['application'] policy: CandidateApplicationPolicy + review_state: ApplicationReviewState content: str scope: ReviewScope requires: tuple[CanonicalId, ...] @@ -2010,7 +2017,7 @@ class CandidateApplicationRejectedResult: }) kind: Literal['candidate-application-rejected-result'] purpose: Literal['application'] - code: Literal['APPLICATION.CONTENT_UNAVAILABLE', 'APPLICATION.INPUT_INVALID', 'APPLICATION.OPERATION_UNAVAILABLE', 'APPLICATION.INTERNAL_UNAVAILABLE', 'APPLICATION.UNSUPPORTED_CAPTURE', 'APPLICATION.RESULT_LIMIT'] + code: Literal['APPLICATION.UNKNOWN_TARGET', 'APPLICATION.INPUT_INVALID', 'APPLICATION.OPERATION_UNAVAILABLE', 'APPLICATION.INTERNAL_UNAVAILABLE', 'APPLICATION.UNSUPPORTED_CAPTURE', 'APPLICATION.RESULT_LIMIT', 'APPLICATION.UNKNOWN_GROUP', 'APPLICATION.TRAVERSAL_NOT_PERMITTED'] outcome: Literal['invalid', 'unsupported', 'unavailable'] message: str next_operations: tuple[CandidateApplicationNextOperation, ...] @@ -4833,7 +4840,7 @@ def as_contract(self) -> dict[str, object]: @dataclass(frozen=True, slots=True) class PreviewApplicationCall: - 'Authoring-only inspection of an exact draft through application qualification and filtering; this observation neither publishes nor grants ordinary application access.' + "Authoring-only inspection of an exact draft as an application agent would receive it, including each item's review label; this observation neither publishes nor grants ordinary application access." __definition__: ClassVar[str] = 'PreviewApplicationCall' __contract_fields__: ClassVar = MappingProxyType({ 'revision': 'revision', @@ -8231,6 +8238,7 @@ def as_contract(self) -> dict[str, object]: ApplicationExposureState: TypeAlias = Literal['unreviewed', 'current', 'needs-review'] ApplicationId: TypeAlias = str ApplicationQueryRequest: TypeAlias = RouteRequest | ApplicationReadRequest | RelatedRequest +ApplicationReviewState: TypeAlias = Literal['current', 'changed-since-review', 'not-reviewed'] AuthorizationId: TypeAlias = str CanonicalId: TypeAlias = str ChildId: TypeAlias = str @@ -8625,6 +8633,7 @@ def decode_contract(definition: str, value: object) -> object: 'ApplicationRejectedResult', 'ApplicationRelatedResult', 'ApplicationRelationship', + 'ApplicationReviewState', 'ApplicationRouteResult', 'ApplicationRoutedContentPage', 'ApplicationRoutingFactsResult', diff --git a/tools/standards_engine/standards_engine/agent_navigation.py b/tools/standards_engine/standards_engine/agent_navigation.py index c494c338..01dfb41a 100644 --- a/tools/standards_engine/standards_engine/agent_navigation.py +++ b/tools/standards_engine/standards_engine/agent_navigation.py @@ -16,6 +16,22 @@ # A composed route response includes its reading plan, questions and continuation. ROUTE_CONTENT_RESULT_BYTES = 2 * 1024 * 1024 ROUTE_CONTENT_DEFAULT_ITEMS = 8 +# Application route pages are sized for a client that shows a bounded tool +# result inline. The budget counts one serialization of the structured result. +ROUTE_PAGE_BYTES = 40 * 1024 +ROUTE_PAGE_MIN_BYTES = 8 * 1024 + + +def admit_route_page_bytes(value: int | None = None) -> int: + """Admit the host's application page budget; None selects the default.""" + if value is None: + return ROUTE_PAGE_BYTES + if type(value) is not int or not ROUTE_PAGE_MIN_BYTES <= value <= ROUTE_CONTENT_RESULT_BYTES: + raise ValueError( + f"The route page budget is a whole number of bytes from {ROUTE_PAGE_MIN_BYTES} " + f"to {ROUTE_CONTENT_RESULT_BYTES}." + ) + return value def focused_continuations(value): @@ -205,8 +221,11 @@ def with_route_content(engine, call, snapshot, compiled, routed, *, bound_facts, """Compose a bounded selected read page without another capture or compile. Results remain private through the final lifecycle check. Byte pressure ends - a page before a whole record; a single oversized record returns a typed limit - rejection so the caller can explicitly route without content and read it. + a page before a whole record. An application page uses the host's page budget + and keeps its first whole record even when that record alone exceeds the + budget, so following content.next always makes progress. Authoring keeps the + transport bound: a single oversized record returns a typed limit rejection so + the caller can explicitly route without content and read it. """ arguments = call.as_contract() if "content" not in arguments: @@ -245,8 +264,11 @@ def continuation(): if not (hint["operation"] == "read" and hint.get("target") in covered) ] - def too_large(): - return len(json.dumps(value).encode("utf-8")) > ROUTE_CONTENT_RESULT_BYTES + application = application_view is not None + budget = engine.route_page_bytes if application else ROUTE_CONTENT_RESULT_BYTES + + def exceeds(limit_bytes): + return len(json.dumps(value).encode("utf-8")) > limit_bytes for target in targets[offset:offset + limit]: engine._snapshots.snapshot(snapshot_id) @@ -256,7 +278,9 @@ def too_large(): return result page["items"].append(result.as_contract()) continuation() - if too_large(): + if exceeds(budget): + if application and len(page["items"]) == 1: + break page["items"].pop() if not page["items"]: return _route_content_rejection( @@ -265,7 +289,7 @@ def too_large(): ) break continuation() - if too_large(): + if exceeds(ROUTE_CONTENT_RESULT_BYTES): return _route_content_rejection(engine, "ROUTE.CONTENT_LIMIT", "unsupported", "Route without content to inspect this selection.") engine._snapshots.snapshot(snapshot_id) diff --git a/tools/standards_engine/standards_engine/compiled_cache.py b/tools/standards_engine/standards_engine/compiled_cache.py index 2cf0cc26..b3ad2c06 100644 --- a/tools/standards_engine/standards_engine/compiled_cache.py +++ b/tools/standards_engine/standards_engine/compiled_cache.py @@ -1,8 +1,11 @@ """Bounded reuse of pure identity and compilation products of exact material. -An MCP process owns one cache for its repository, purpose and installed code. -Its serial calls borrow results; stores, handles, decisions and responses remain -per-call. Capacity overflow changes only whether the result is retained. +Every Engine has one cache for its repository, purpose and installed code. It +keeps its own until it closes unless an owner lends one that outlives it. The +one Engine of an MCP server process therefore keeps it for the process; a CLI +invocation or a test's Engine keeps it for that Engine. Operations borrow +results; lifecycle observations, handles, decisions and responses are made by +every operation. Capacity overflow changes only whether the result is retained. """ from __future__ import annotations diff --git a/tools/standards_engine/standards_engine/context_projection.py b/tools/standards_engine/standards_engine/context_projection.py index a26f8ecd..10c6096d 100644 --- a/tools/standards_engine/standards_engine/context_projection.py +++ b/tools/standards_engine/standards_engine/context_projection.py @@ -7,7 +7,10 @@ from pathlib import Path from typing import Callable, TYPE_CHECKING -from tools.graph_engine.graph_engine import Direction, EdgeRegistry, GraphContribution, GraphError +from tools.graph_engine.graph_engine import ( + Direction, EdgeRegistry, ForbiddenTraversalError, GraphContribution, GraphError, + UnknownEdgeError, UnknownGroupError, UnknownNodeError, +) from tools.standards_graph.standards_graph import Provider from tools.standards_contracts.standards_contracts import ContractError @@ -35,10 +38,15 @@ class Purpose(str, Enum): } -def application_rejection(code: str = "APPLICATION.CONTENT_UNAVAILABLE", outcome: str = "unavailable"): +# Approval is a label on delivered material, never a condition of delivery. +REVIEW_STATES = {"current": "current", "needs-review": "changed-since-review", "unreviewed": "not-reviewed"} + + +def application_rejection(code: str = "APPLICATION.INTERNAL_UNAVAILABLE", outcome: str = "unavailable"): messages = { - "APPLICATION.CONTENT_UNAVAILABLE": "The requested guidance is awaiting application publication.", + "APPLICATION.UNKNOWN_TARGET": "That identity is not registered. Use an ID or handle exactly as returned by route, read or related; nothing was inferred.", "APPLICATION.UNKNOWN_GROUP": "Choose a permitted group from relationship_groups; no group was inferred.", + "APPLICATION.TRAVERSAL_NOT_PERMITTED": "That relationship group does not permit the requested direction or transitive traversal; relationship_groups lists what each group permits.", "APPLICATION.RESULT_LIMIT": "Select fewer items or narrower policy scopes within the 2 MiB reading limit.", "APPLICATION.INPUT_INVALID": "Supply arguments from this interface's published contract.", "APPLICATION.OPERATION_UNAVAILABLE": "This interface provides application navigation operations.", @@ -62,17 +70,36 @@ def invoke(engine, call): logging.getLogger(__name__).error( "Application observation failed: %s", type(error).__name__ ) + # The caller receives the same bounded rejection as for a typed + # failure, so record here that this one was not classified: an + # owner that keeps the engine across calls must not reuse it. + engine._failed = True return application_rejection("APPLICATION.INTERNAL_UNAVAILABLE") return function(engine, call) return invoke -class _UnqualifiedContent(Exception): +class _UnknownTarget(Exception): pass +def _lookup_rejection(error: Exception): + """Name what the caller can correct; any other graph failure is internal.""" + if isinstance(error, (_UnknownTarget, UnknownEdgeError, UnknownNodeError)): + return application_rejection("APPLICATION.UNKNOWN_TARGET", "invalid") + if isinstance(error, UnknownGroupError): + return application_rejection("APPLICATION.UNKNOWN_GROUP", "invalid") + if isinstance(error, ForbiddenTraversalError): + return application_rejection("APPLICATION.TRAVERSAL_NOT_PERMITTED", "invalid") + return application_rejection("APPLICATION.INTERNAL_UNAVAILABLE") + + class ApplicationView: - """Build application values from the qualified portion of one snapshot.""" + """Build application values from the registered material of one snapshot. + + Every registered standard and operational aid is delivered with its review + label. Authoring-only provenance and unregistered consumers stay outside. + """ def __init__(self, compiled: CompiledSnapshot, authority: c.SnapshotHandle | c.ProposalRevisionHandle): @@ -80,12 +107,12 @@ def __init__(self, compiled: CompiledSnapshot, self.authority = authority.as_contract() self.candidate = isinstance(authority, c.ProposalRevisionHandle) self.snapshot = None if self.candidate else self.authority - self.eligible = frozenset( - identity for identity, material in compiled.materials.items() - if compiled.supporting.exposure_state(identity, material.binding) == "current" - ) - visible = set(self.eligible) - visible.update(unit.id for unit in compiled.corpus.policy_units if unit.module in self.eligible) + self.review = { + identity: REVIEW_STATES[compiled.supporting.exposure_state(identity, material.binding)] + for identity, material in compiled.materials.items() + } + visible = set(self.review) + visible.update(unit.id for unit in compiled.corpus.policy_units if unit.module in self.review) groups = {key: value for key, value in compiled.graph.groups.items() if key in { "standards-requires", "standards-specializes", "standards-dependencies", "policy-impact", "semantic", }} @@ -102,24 +129,13 @@ def __init__(self, compiled: CompiledSnapshot, sources = tuple(Provider(identity, GraphContribution(*(tuple(rows) for rows in records))) for identity, records in sorted(by_source.items())) self.graph = EdgeRegistry(Path("/"), sources, - logical_artifacts=(compiled.materials[key].path for key in self.eligible)) + logical_artifacts=(material.path for material in compiled.materials.values())) - def _require(self, target: str): + def _resolve(self, target: str): selected = resolve_material(self.compiled, target) if selected is None: - raise _UnqualifiedContent() - material, unit = selected - pending, checked = [material.id], set() - while pending: - identity = pending.pop() - if identity in checked: - continue - if identity not in self.eligible: - raise _UnqualifiedContent() - checked.add(identity) - owner = self.compiled.materials[identity] - pending.extend((*owner.requires, *owner.specializes)) - return material, unit + raise _UnknownTarget() + return selected def _child(self, kind: str, identity: str) -> dict: return {"kind": "snapshot-child-handle", "snapshot": self.snapshot, @@ -148,13 +164,15 @@ def _decode(self, value: dict): return types[value["kind"]].from_value(value) def read(self, target: str, detail: str = "compact"): - material, unit = self._require(target) + material, unit = self._resolve(target) identity = unit.id if unit is not None else material.id value = self._result( "application-read-result", policy={"id": identity, **({} if self.candidate else {"handle": self._child("policy", identity)}), "role": material.role, "level": material.level}, + # A scoped policy read carries the label of its containing module. + review_state=self.review[material.id], content=unit.content if unit is not None else material.content, scope={"kind": "structured", "heading_path": list(unit.heading_path)} if unit else {"kind": "whole-artifact"}, requires=list(material.requires), specializes=list(material.specializes), @@ -192,7 +210,7 @@ def relationships(self, target: str, groups, direction: Direction, transitive: b return [selected[key] for key in sorted(selected)] def related(self, target: str, groups: tuple[str, ...], direction: str, transitive: bool): - material, unit = self._require(target) + material, unit = self._resolve(target) identity = unit.id if unit else material.id relationships = self.relationships(identity, groups, Direction.parse(direction), transitive) neighbors = sorted({entry[key] for entry in relationships for key in ("source", "target")} - set(self._scope_targets(identity))) @@ -206,10 +224,8 @@ def inspect(self, handle): return self.read(handle.child_id, "full") way, _, edge_id = handle.child_id.partition(":") if way not in {"incoming", "outgoing"}: - raise _UnqualifiedContent() + raise _UnknownTarget() edge = self.graph.edge(edge_id) - self._require(edge.source) - self._require(edge.target) target = edge.target if way == "incoming" else edge.source relationships = [entry for entry in self.relationships(target, tuple(edge.groups), Direction.parse(way), False) if entry["handle"]["child_id"] == handle.child_id] @@ -219,26 +235,25 @@ def inspect(self, handle): )) def routing_facts(self): - self._require("router") return c.ApplicationRoutingFactsResult.from_value(self._result( "application-routing-facts-result", facts=self.compiled.router.fact_definitions(), next_operations=[], )) def route(self, engine, call): - self._require("router") facts = self.compiled.router.fact_schema.bind(call.as_contract()["facts"]) return self._route_bound(engine, facts) def _route_bound(self, engine, facts): - """Render a route whose Router qualification and fact binding already passed.""" + """Render every selected entry of an already bound route with its review label.""" _facts, _rules, _ordered, entries, unresolved = engine._bound_routing_selection(self.compiled, facts) reading = [] for entry in entries: if entry.state != "selected": continue - self._require(entry.target) + material, _unit = self._resolve(entry.target) reading.append({"target": entry.target, "scope": entry.scope.as_contract(), - "authority": entry.authority, "state": "selected"}) + "authority": entry.authority, "state": "selected", + "review_state": self.review[material.id]}) facts = {fact["id"]: fact for fact in self.compiled.router.fact_definitions()} return self._decode(self._result( "application-route-result", status="needs-facts" if unresolved else "complete", @@ -249,7 +264,7 @@ def _route_bound(self, engine, facts): def preview_application(engine: StandardsEngine, compiled: CompiledSnapshot, call: c.PreviewApplicationCall): - """Use application eligibility and field selection at an exact draft revision.""" + """Use application delivery, labels and field selection at an exact draft revision.""" view = ApplicationView(compiled, call.revision) request = call.request.as_contract() try: @@ -259,12 +274,10 @@ def preview_application(engine: StandardsEngine, compiled: CompiledSnapshot, return view.related(request["target"], tuple(request["groups"]), request["direction"], request["transitive"]) return view.route(engine, call.request) - except (_UnqualifiedContent, GraphError): - result = application_rejection().as_contract() + except (_UnknownTarget, GraphError) as error: return c.CandidateApplicationRejectedResult.from_value({ - **result, "kind": "candidate-application-rejected-result", + **_lookup_rejection(error).as_contract(), "kind": "candidate-application-rejected-result", "revision": call.revision.as_contract(), - "message": "Inspect the candidate's exposure and prerequisite states through authoring reads, then preview its qualified application content.", }) @@ -313,11 +326,9 @@ def application_dispatch(engine: StandardsEngine, operation: str, call): return view.read(values["target"], values.get("detail", "compact")) if operation == "relationship_groups": from .relationship_vocabulary import group_page, GROUP_PAGE_DEFAULT_ITEMS - view._require("router") return group_page(engine, snapshot, view.graph, offset=values.get("offset", 0), limit=values.get("limit", GROUP_PAGE_DEFAULT_ITEMS)) if operation == "related": - from tools.graph_engine.graph_engine import UnknownGroupError from .relationship_vocabulary import unknown_group_result try: return view.related(values["target"], tuple(values["groups"]), values["direction"], values["transitive"]) @@ -329,8 +340,6 @@ def application_dispatch(engine: StandardsEngine, operation: str, call): from tools.standards_applicability.standards_applicability import ApplicabilityError from .agent_navigation import with_route_content from .routing_inputs import bind_facts, binding_rejection - # Private vocabulary is interpreted only after Router qualification. - view._require("router") try: facts = bind_facts(compiled.router.fact_schema, values["facts"]) except (ApplicabilityError, ContractError) as error: @@ -342,8 +351,8 @@ def application_dispatch(engine: StandardsEngine, operation: str, call): if operation == "routing_facts": return view.routing_facts() return view.inspect(checked.handle) - except (_UnqualifiedContent, GraphError): - return application_rejection() + except (_UnknownTarget, GraphError) as error: + return _lookup_rejection(error) except engine._domain_errors() as error: failure = getattr(error, "failure", None) if getattr(failure, "outcome", None) == "unsupported": diff --git a/tools/standards_engine/standards_engine/engine.py b/tools/standards_engine/standards_engine/engine.py index a7b3f926..14d56b6a 100644 --- a/tools/standards_engine/standards_engine/engine.py +++ b/tools/standards_engine/standards_engine/engine.py @@ -71,7 +71,6 @@ ApplicabilityError, FactSet as ApplicabilityFacts, LANGUAGE_VERSION, - Truth, ) from tools.standards_contracts.standards_contracts import MissingValue from tools.standards_graph.standards_graph import ( @@ -475,9 +474,19 @@ def __init__( execution_context: AnalysisExecutionContext | None = None, temporary_store: tempfile.TemporaryDirectory[str] | None = None, compiled_cache: CompiledSnapshotCache | None = None, + route_page_bytes: int | None = None, ) -> None: + from .agent_navigation import admit_route_page_bytes + self._purpose = Purpose(purpose) - if compiled_cache is not None: + self._route_page_bytes = admit_route_page_bytes(route_page_bytes) + # Compilation is a pure function of an exact capture, so an engine + # always reuses it. An owner may lend a cache it keeps longer than this + # engine; otherwise the engine keeps its own until it closes. + self._owns_compiled_cache = compiled_cache is None + if compiled_cache is None: + compiled_cache = CompiledSnapshotCache(repository.root, self._purpose) + else: compiled_cache.require_scope(repository.root, self._purpose) self._compiled_cache = compiled_cache self._repository = repository @@ -487,6 +496,11 @@ def __init__( self._execution_context = execution_context or AnalysisExecutionContext() self._application_verifier = run_complete_verification self._temporary_store = temporary_store + # What `open_repository` selected and what that resolved to, when it + # opened this engine: (root, resolved root, store path, opened path). + self._opened: tuple[Path, Path, Path, Path] | None = None + # Set when an operation ended in a failure no owner classified. + self._failed = False @classmethod def open_repository( @@ -498,6 +512,7 @@ def open_repository( purpose: Purpose | str, execution_context: AnalysisExecutionContext | None = None, compiled_cache: CompiledSnapshotCache | None = None, + route_page_bytes: int | None = None, ) -> StandardsEngine: selected_purpose = Purpose(purpose) selected_root = root.resolve() @@ -510,27 +525,78 @@ def open_repository( else: temporary = tempfile.TemporaryDirectory(prefix="coding-standards-a1c-") store_path = Path(temporary.name) / "snapshots.sqlite3" - return cls( + # Normalize the parent, but let the store inspect the selected final + # component before following it. Relative paths remain cwd-relative; + # intermediate symlinks are allowed by the local store contract. + opened_path = store_path.parent.resolve() / store_path.name + engine = cls( GitRepository(selected_root), - # Normalize the parent, but let the store inspect the selected final - # component before following it. Relative paths remain cwd-relative; - # intermediate symlinks are allowed by the local store contract. - SnapshotModule.open(store_path.parent.resolve() / store_path.name), + SnapshotModule.open(opened_path), purpose=selected_purpose, execution_context=execution_context, temporary_store=temporary, compiled_cache=compiled_cache, + route_page_bytes=route_page_bytes, ) + engine._opened = (root, selected_root, store_path, opened_path) + return engine @property def purpose(self) -> Purpose: return self._purpose + @property + def route_page_bytes(self) -> int: + """Host-selected byte budget of one application route content page.""" + return self._route_page_bytes + + def release(self) -> None: + """Close the store connection until `readmit` opens the next one. + + An owner that keeps this engine across calls releases it after each + one: between calls the engine holds no store connection, lock or open + store file, and a transaction a call did not end is rolled back. The + compilation cache and everything else about the engine stay. + """ + self._snapshots.release() + + def readmit(self) -> bool: + """Open the store for another operation, as opening this engine again would. + + An owner that keeps this engine across calls asks before each one. + False means `open_repository` with the same arguments would now reach + another repository root or another store file: a selected path resolves + elsewhere, or the store path names another file or none. The owner then + closes this engine and opens a new one. Otherwise the store runs its + admission checks and due maintenance on a new connection, and their + failures are raised as they are from `open_repository`. + """ + if self._opened is not None: + root, opened_root, store, opened_store = self._opened + if root.resolve() != opened_root or store.parent.resolve() / store.name != opened_store: + return False + return self._snapshots.readmit() + + @property + def reusable(self) -> bool: + """False once this engine must not serve another operation. + + An operation that ended in an unclassified failure leaves state that + nothing has checked. A failure raised to the caller is its own signal; + this reports the one an application operation turned into its bounded + rejection. + """ + return not self._failed + def close(self) -> None: - self._snapshots.close() - if self._temporary_store is not None: - self._temporary_store.cleanup() - self._temporary_store = None + try: + self._snapshots.close() + finally: + if self._owns_compiled_cache: + self._compiled_cache.close() + if self._temporary_store is not None: + self._temporary_store.cleanup() + self._temporary_store = None def __enter__(self) -> StandardsEngine: return self @@ -584,8 +650,7 @@ def _capture_snapshot( result = CreateSnapshotResult.from_value( {"kind": "create-snapshot-result", "snapshot": self._summary(summary)} ) - if (self._compiled_cache is not None and isinstance(second, CompiledSnapshot) - and second.source is replay): + if isinstance(second, CompiledSnapshot) and second.source is replay: # Both independent proofs and snapshot admission have succeeded. # Drop the mutable recording wrapper; reuse still requires the # normal durable load/identity/lifecycle checks for any handle. @@ -2127,13 +2192,7 @@ def inspect(self, call: InspectCall) -> InspectionResult | RejectedResult: def _compiled_snapshot(self, snapshot: SnapshotId) -> CompiledSnapshot: capture = self._snapshots.load_content(snapshot, identity_reuse=self._compiled_cache) - if self._compiled_cache is not None: - return self._compiled_cache.compile_verified(capture, self._compile) - return self._compile( - FrozenContentSource( - (str(item.path), item.content) for item in capture.files - ) - ) + return self._compiled_cache.compile_verified(capture, self._compile) def _compiled_revision(self, revision: ProposalRevision) -> CompiledSnapshot: return self._proposal_projection(revision).compiled @@ -2151,7 +2210,7 @@ def _proposal_projection( if accepted is None else accepted ) - if reuse and self._compiled_cache is not None: + if reuse: return self._compiled_cache.project_verified( revision, accepted, self._logical_authoring, predecessor=predecessor, ) @@ -2161,7 +2220,6 @@ def _proposal_projection( base_snapshot=str(revision.base_snapshot), base_repository_paths=revision.base_repository_paths, compiled_base=accepted, - predecessor=predecessor if reuse else None, ) @staticmethod @@ -3015,17 +3073,10 @@ def _routing_selection(compiled: CompiledSnapshot, request): @staticmethod def _bound_routing_selection(compiled: CompiledSnapshot, facts: ApplicabilityFacts): # Program evaluation retains the applicability owner's schema-digest guard. - selected = set(compiled.router.base_modules) - unresolved: set[str] = set() - rule_results: list[tuple[object, str]] = [] - for rule in compiled.router.rules: - result = rule.program.evaluate(facts) - if result.truth is Truth.TRUE: - selected.add(rule.target) - rule_results.append((rule, "selected")) - elif result.truth is Truth.UNKNOWN: - rule_results.append((rule, "unresolved")) - unresolved.update(result.unresolved_facts) + decision = compiled.router.decide(facts) + selected = set(decision.selected) + unresolved = set(decision.unresolved_facts) + rule_results = decision.rule_states ordered = compiled.graph.dependency_order(METADATA_REQUIRES, selected=selected) closure = set(ordered) preferred = ( diff --git a/tools/standards_engine/standards_engine/interaction_observer.py b/tools/standards_engine/standards_engine/interaction_observer.py index 197b060a..12e997f4 100644 --- a/tools/standards_engine/standards_engine/interaction_observer.py +++ b/tools/standards_engine/standards_engine/interaction_observer.py @@ -1,40 +1,61 @@ -"""Opt-in operator observations. Never an Engine store or an agent tool. +"""Always-on operator observations. Never an Engine store or an agent tool. The recorder owns sanitization, SQLite transactions, retention and fail-open -health. No caller-supplied scalar is persisted. A missing terminal event means -unknown outcome; restarting a recorder never manufactures a completion. +health. Caller values are persisted only through the explicit allow-lists below. +A row that cannot be written waits in a bounded in-memory backlog. A missing +terminal event means unknown outcome; a recorder never manufactures a completion. """ from __future__ import annotations import argparse -from collections import Counter +from collections import Counter, deque from dataclasses import dataclass +from datetime import datetime, timezone import hashlib +import hmac +from itertools import islice import json +import math import os from pathlib import Path import re +import secrets import sqlite3 import stat import sys import time -from typing import TextIO +from typing import Iterable, TextIO import uuid -SCHEMA_VERSION = 1 +SCHEMA_VERSION = 2 APPLICATION_ID = 0x53454F42 # SEOB, separate from every Engine domain database. +DEFAULT_DATABASE_NAME = 'interactions-v2.sqlite3' +DEFAULT_DEPLOYMENT = 'local' DEFAULT_MAX_CALLS = 10_000 DEFAULT_MAX_AGE_SECONDS = 7 * 24 * 60 * 60 DEFAULT_MAX_BYTES = 32 * 1024 * 1024 -BUSY_TIMEOUT_MS = 20 +BUSY_TIMEOUT_MS = 20 # Lock wait per begin/finish; the backlog delivers later. +OPEN_TIMEOUT_MS = 250 # Lock wait at process start, before any request is served. +CLOSE_TIMEOUT_MS = 5_000 # Lock wait for the last delivery at orderly close. +LOCK_POLL_SECONDS = 0.0005 +MAX_BACKLOG = 1_000 MAX_SHAPE_NODES = 64 MAX_SHAPE_DEPTH = 5 MAX_SHAPE_BYTES = 8 * 1024 MAX_ARRAY_ITEMS = 4 +MAX_VALUE_CHARS = 200 +MAX_VALUE_ITEMS = 32 +MAX_VALUE_DEPTH = 3 +MAX_VALUE_NODES = 512 +MAX_ARGUMENT_BYTES = 8 * 1024 +MAX_RESULT_IDS = 128 MAX_FEEDBACK_ISSUES = 8 MAX_FEEDBACK_POINTER_CHARS = 512 +MAX_THREAD_CHARS = 256 MAX_REPORT_ROWS = 1000 MAX_SEQUENCE_SCAN = 10_000 +TEXT_ROWS = 10 +TRUNCATED = '[truncated]' METHODS = frozenset({'initialize', 'tools/list', 'tools/call', 'ping'}) SENSITIVE_FIELDS = frozenset({ 'body', 'content', 'text', 'prompt', 'message', 'rationale', 'reason', @@ -45,20 +66,63 @@ 'type', 'required', 'additionalProperties', 'enum', 'const', 'oneOf', 'anyOf', 'allOf', 'not', 'minimum', 'maximum', 'minItems', 'maxItems', 'minLength', 'maxLength', 'pattern', 'format', 'uniqueItems', + 'fact', 'evidence_ref', # The Engine's own fixed keywords. }) -OUTCOMES = frozenset({'invalid', 'unsupported', 'unavailable', 'stale', - 'rejected', 'recovery-required', 'needs-action', - 'requires-change', 'complete', 'ready'}) +OUTCOMES = frozenset({'invalid', 'unsupported', 'unavailable', 'unauthorized', 'stale', + 'rejected', 'recovery-required', 'needs-action', 'needs-facts', + 'requires-change', 'complete', 'ready', 'draft', 'applied'}) + +# Values that may be persisted, by operation. A name absent from these lists is +# never stored as a value; it remains a type in input_shape. +_PAGE = ('limit', 'offset') +_READ = ('target', 'detail', 'include_coverage', 'include_routing') +_RELATED = ('target', 'direction', 'transitive', 'groups') +_DESCRIBE = ('operation', 'selector', *_PAGE) +# Navigation: values exactly as sent. Structured members (snapshot, read_many +# items, route content and facts, handles, nested requests) are projected by +# navigation_values() for the operations named here. +NAVIGATION = { + 'read': _READ, 'read_many': (), 'route': ('detail',), 'routing_facts': (), + 'related': _RELATED, 'relationship_groups': _PAGE, 'inspect': (), + 'describe_input': _DESCRIBE, 'describe_output': _DESCRIBE, 'runtime_info': (), + 'query': (), 'query_proposal': (), 'preview_application': (), +} +HANDLES = {'inspect': 'handle', 'query_proposal': 'revision', 'preview_application': 'revision'} +REQUESTS = {'route': ('kind',), 'read': ('kind', *_READ), 'related': ('kind', *_RELATED)} +# Every other operation is authoring: only these names, and only values shaped +# like a canonical identifier, an enum word, a boolean or a small integer. +IDENTIFIER_FIELDS = frozenset({ + 'kind', 'child_kind', 'detail', 'action', 'section', 'result', 'decision', 'owner', + 'disposition', 'relation', 'artifact_kind', 'authority', 'level', 'role', 'origin', + 'lifecycle', 'direction', + 'id', 'policy', 'standard', 'consumer', 'target', 'source_policy', 'subject', + 'evidence_owner', 'after_policy', 'rule', 'fact', 'requires', 'specializes', + 'successors', 'predecessors', 'groups', + 'limit', 'offset', 'apply', 'transitive', +}) +IDENTIFIER = re.compile(r'[A-Za-z0-9][A-Za-z0-9._:/-]{0,199}') +OPAQUE = re.compile(r'[0-9a-fA-F]{16}|[0-9a-f]{8}-[0-9a-f]{4}-') # Digests, handle ids, UUIDs. +RESULT_KIND = re.compile(r'[a-z][a-z0-9-]{0,63}') +RESULT_CODE = re.compile(r'[A-Z][A-Z0-9_]{0,31}(\.[A-Z][A-Z0-9_]{0,47}){1,3}') SCHEMA_DDL = ( - 'CREATE TABLE sessions (id TEXT PRIMARY KEY, started REAL NOT NULL, runtime TEXT NOT NULL, deployment TEXT NOT NULL, catalog TEXT NOT NULL, pruned INTEGER NOT NULL DEFAULT 0)', - 'CREATE TABLE interactions (id TEXT PRIMARY KEY, session TEXT NOT NULL REFERENCES sessions(id), ordinal INTEGER NOT NULL, started REAL NOT NULL, method TEXT NOT NULL, operation TEXT NOT NULL, input_shape TEXT NOT NULL, shape_digest TEXT NOT NULL, discovery_operation TEXT, catalog_state TEXT NOT NULL, request_bytes INTEGER, scope TEXT NOT NULL, UNIQUE(session, ordinal))', - "CREATE TABLE events (interaction TEXT PRIMARY KEY REFERENCES interactions(id) ON DELETE CASCADE, phase TEXT NOT NULL CHECK(phase IN ('end','error','incomplete')), finished REAL NOT NULL, duration_ms REAL NOT NULL, response_bytes INTEGER, outcome TEXT NOT NULL, feedback TEXT NOT NULL)", + 'CREATE TABLE meta (key TEXT PRIMARY KEY, value TEXT NOT NULL)', + 'CREATE TABLE catalogs (digest TEXT PRIMARY KEY, tools TEXT NOT NULL)', + 'CREATE TABLE sessions (id TEXT PRIMARY KEY, started REAL NOT NULL, runtime TEXT NOT NULL, deployment TEXT NOT NULL, catalog TEXT NOT NULL REFERENCES catalogs(digest), client_name TEXT, client_version TEXT, pruned INTEGER NOT NULL DEFAULT 0, lost INTEGER NOT NULL DEFAULT 0)', + 'CREATE TABLE interactions (id TEXT PRIMARY KEY, session TEXT NOT NULL REFERENCES sessions(id), ordinal INTEGER NOT NULL, started REAL NOT NULL, method TEXT NOT NULL, operation TEXT NOT NULL, input_shape TEXT NOT NULL, shape_digest TEXT NOT NULL, discovery_operation TEXT, catalog_state TEXT NOT NULL, request_bytes INTEGER, scope TEXT NOT NULL, arguments TEXT NOT NULL, arguments_bytes INTEGER, thread TEXT, origin TEXT NOT NULL, UNIQUE(session, ordinal))', + "CREATE TABLE events (interaction TEXT PRIMARY KEY REFERENCES interactions(id) ON DELETE CASCADE, phase TEXT NOT NULL CHECK(phase IN ('end','error','incomplete')), finished REAL NOT NULL, duration_ms REAL NOT NULL, response_bytes INTEGER, outcome TEXT NOT NULL, feedback TEXT NOT NULL, result TEXT NOT NULL, result_bytes INTEGER)", 'CREATE INDEX interaction_age ON interactions(started)', ) +def default_database() -> Path: + """${XDG_DATA_HOME:-~/.local/share}/standards-engine/observations/.""" + base = os.environ.get('XDG_DATA_HOME', '') + base = Path(base) if os.path.isabs(base) else Path.home() / '.local' / 'share' + return base / 'standards-engine' / 'observations' / DEFAULT_DATABASE_NAME + + def _json(value: object) -> str: return json.dumps(value, ensure_ascii=True, sort_keys=True, separators=(',', ':')) @@ -84,12 +148,158 @@ def _kind(value: object) -> str: return 'object' if isinstance(value, dict) else 'array' if isinstance(value, list) else 'unknown' +def _number(value: object) -> bool: + return isinstance(value, (int, float)) and not isinstance(value, bool) and abs(value) < 2 ** 53 + + +def _identifier(value: object) -> bool: + """A canonical identifier or enum word. Prose, digests and handle ids never match.""" + return isinstance(value, str) and bool(IDENTIFIER.fullmatch(value)) and not OPAQUE.search(value) + + +def _identifiers(values: Iterable[object]) -> list: + return [value for value in islice(values, MAX_RESULT_IDS) if _identifier(value)] + + +def _label(value: object) -> str | None: + """A client's self-reported name or version: bounded printable ASCII.""" + return re.sub(r'[^ -~]', '?', value)[:64] if isinstance(value, str) and value else None + + +def _sent(value: object, depth: int = 0) -> object: + """A caller value as sent, bounded. Cut strings and containers carry a marker.""" + if isinstance(value, str): + return value if len(value) <= MAX_VALUE_CHARS else value[:MAX_VALUE_CHARS] + TRUNCATED + if value is None or isinstance(value, bool) or _number(value): + return value + if isinstance(value, list) and depth < MAX_VALUE_DEPTH: + kept = [_sent(item, depth + 1) for item in value[:MAX_VALUE_ITEMS]] + return kept + [TRUNCATED] if len(value) > MAX_VALUE_ITEMS else kept + if isinstance(value, dict) and depth < MAX_VALUE_DEPTH: + kept = {_sent(str(name)): _sent(item, depth + 1) + for name, item in islice(value.items(), MAX_VALUE_ITEMS)} + if len(value) > MAX_VALUE_ITEMS: + kept[TRUNCATED] = len(value) - MAX_VALUE_ITEMS + return kept + return {'type': _kind(value)} + + +def _pick(value: object, names: tuple[str, ...]) -> dict: + """Allow-listed members as sent. A non-object keeps only its type.""" + if not isinstance(value, dict): + return {'type': _kind(value)} + return {name: _sent(value[name]) for name in names if name in value} + + +def _snapshot(handle: object) -> str: + """Reuse is visible through a short stable hash; the handle id is not kept.""" + identity = handle.get('id') if isinstance(handle, dict) else None + if not isinstance(identity, str): + return 'malformed' + return hashlib.sha256(identity.encode('utf-8', 'replace')).hexdigest()[:12] + + +def navigation_values(operation: str, arguments: dict) -> dict: + """The recorded values of one navigation call, from its explicit allow-list.""" + values = _pick(arguments, NAVIGATION[operation]) + if 'snapshot' in arguments: + values['snapshot'] = _snapshot(arguments['snapshot']) + handle = HANDLES.get(operation) + if handle in arguments: + values[handle] = _pick(arguments[handle], ('kind', 'child_kind')) + if operation == 'read_many' and isinstance(arguments.get('items'), list): + values['items'] = [_pick(item, _READ) for item in arguments['items'][:MAX_VALUE_ITEMS]] + if operation == 'route': + if 'content' in arguments: + values['content'] = _pick(arguments['content'], _PAGE) + if 'facts' in arguments: + # Names and values exactly as sent: invented facts are the signal. + values['facts'] = _sent(arguments['facts']) + request = arguments.get('request') + if operation in ('query', 'query_proposal', 'preview_application') and isinstance(request, dict): + kind = request.get('kind') + values['request'] = _pick(request, REQUESTS.get(kind if isinstance(kind, str) else '', ('kind',))) + if 'facts' in request: + values['request']['facts'] = _sent(request['facts']) + return values + + +def _recorded_facts(values: dict) -> dict: + """Route facts inside a recorded arguments object, top-level or in a nested request.""" + request = values.get('request') + facts = values.get('facts', request.get('facts') if isinstance(request, dict) else None) + return facts if isinstance(facts, dict) else {} + + +def _bounded(values: dict) -> dict: + """Whole-object cap: an oversized projection keeps its scalars and says so.""" + if len(_json(values)) <= MAX_ARGUMENT_BYTES: + return values + return {'truncated': True, **{name: value for name, value in values.items() + if not isinstance(value, (dict, list))}} + + +def _thread(meta: object) -> tuple[str | None, str]: + """Client thread id (hashed with the database salt before storage) and origin. + + Codex supplies both in x-codex-turn-metadata. No other _meta member is read, + so workspace paths, repository URLs, models and turn ids never reach storage. + """ + meta = meta if isinstance(meta, dict) else {} + turn = meta.get('x-codex-turn-metadata') + turn = turn if isinstance(turn, dict) else {} + candidates = (turn.get('thread_id'), meta.get('threadId'), turn.get('session_id'), meta.get('sessionId')) + identity = next((value[:MAX_THREAD_CHARS] for value in candidates + if isinstance(value, str) and value), None) + source = turn.get('thread_source') + origin = {'user': 'main', 'subagent': 'subagent'}.get(source, 'unknown') if isinstance(source, str) else 'unknown' + return identity, origin + + +def _returned(read: object) -> object: + """The canonical id a read result is about, wherever that result kind keeps it.""" + if not isinstance(read, dict): + return None + policy = read.get('policy') + if isinstance(policy, dict): + handle = policy.get('handle') + return policy.get('id') or (handle.get('child_id') if isinstance(handle, dict) else None) + return read.get('canonical_id') + + +def result_summary(value: dict) -> dict: + """Engine-produced identifiers and counts from structuredContent; never text.""" + summary = {} + for name, pattern in (('kind', RESULT_KIND), ('code', RESULT_CODE)): + if isinstance(value.get(name), str) and pattern.fullmatch(value[name]): + summary[name] = value[name] + for name in ('status', 'outcome'): + if isinstance(value.get(name), str) and value[name] in OUTCOMES: + summary[name] = value[name] + plan, questions, page = value.get('reading_plan'), value.get('unresolved_questions'), value.get('content') + if isinstance(plan, list): + summary['selected'] = _identifiers(entry.get('target') for entry in plan + if isinstance(entry, dict) and entry.get('state') == 'selected') + if isinstance(questions, list): + summary['unresolved'] = _identifiers(question['fact'].get('id') for question in questions + if isinstance(question, dict) and isinstance(question.get('fact'), dict)) + if isinstance(page, dict): # A route's content page. A read's content is text and is not inspected. + items = page.get('items') if isinstance(page.get('items'), list) else [] + summary['content'] = {**{name: page[name] for name in ('offset', 'total') if _number(page.get(name))}, + 'items': len(items), 'targets': _identifiers(map(_returned, items))} + reads = value['items'] if isinstance(value.get('items'), list) else [value] + targets = _identifiers(map(_returned, reads)) + if targets: + summary['targets'] = targets + return summary + + class InputShape: - """Value-free disclosure projection, not a second input validator. + """Disclosure projections of one operation's input, not a second validator. - Static property names come only from the installed schema. Unknown names and - every scalar value disappear before SQLite sees anything. Sensitive children - are not traversed even if their properties occur elsewhere in the schema. + Static property names come only from the installed schema. Unknown names + disappear before SQLite sees anything. Sensitive children are not traversed + even if their properties occur elsewhere in the schema. """ def __init__(self, schema: dict) -> None: self.schema = schema @@ -122,6 +332,7 @@ def _items(self, nodes: list[dict]) -> list[dict]: if isinstance(node.get('items'), dict)] def project(self, value: object) -> dict: + """Value-free structure: every scalar becomes only its type.""" budget = MAX_SHAPE_NODES def visit(item, nodes, depth): nonlocal budget @@ -156,7 +367,41 @@ def visit(item, nodes, depth): return {'type': _kind(value), 'truncated': True} return shape - def feedback(self, value: object) -> list[dict]: + def identifiers(self, value: object) -> dict: + """Authoring calls: identifiers and enums at schema-declared, allow-listed names. + + The walk follows project(): dynamic keys and sensitive subtrees are never + entered, nor are evidence references under their other name. A string + survives only if it has the shape of an identifier, so prose placed in an + identifier field is dropped like any body or rationale. + """ + budget = MAX_VALUE_NODES + def visit(item, nodes, name, depth): + nonlocal budget + budget -= 1 + if budget <= 0 or depth > 2 * MAX_SHAPE_DEPTH: + return None + if isinstance(item, dict): + properties, kept = self._properties(nodes), {} + for key, child in islice(item.items(), MAX_SHAPE_NODES): + if (key in properties and key.lower() not in SENSITIVE_FIELDS + and key != 'explicit_exclusions'): + found = visit(child, properties[key], key, depth + 1) + if found is not None and found != {} and found != []: + kept[key] = found + return kept + if isinstance(item, list): + children = self._items(nodes) + found = [visit(child, children, name, depth + 1) for child in item[:MAX_VALUE_ITEMS]] + return [entry for entry in found if entry is not None and entry != {} and entry != []] + if name in IDENTIFIER_FIELDS and (isinstance(item, bool) or _number(item) or _identifier(item)): + return item + return None + found = visit(value, [self.schema], '', 0) + return found if isinstance(found, dict) else {} + + def feedback(self, value: object, names: frozenset = frozenset()) -> list[dict]: + """Validation locations. `names` are route fact names this call already recorded.""" if not isinstance(value, dict) or not isinstance(value.get('issues'), list): return [] result = [] @@ -174,7 +419,8 @@ def feedback(self, value: object) -> list[dict]: safe.append(name.replace('~', '~0').replace('/', '~1')) nodes = [] if name.lower() in SENSITIVE_FIELDS else properties[name] else: - safe.append('*') + known = bool(safe) and safe[-1] == 'facts' and name in names + safe.append(name.replace('~', '~0').replace('/', '~1') if known else '*') nodes = items if part.isdecimal() else [] keyword = issue.get('keyword') result.append({'pointer': '/' + '/'.join(safe) if safe else '', @@ -184,8 +430,8 @@ def feedback(self, value: object) -> list[dict]: @dataclass(frozen=True) class RecorderConfig: - database: Path - deployment: str + database: Path | None = None # None selects default_database(). + deployment: str = DEFAULT_DEPLOYMENT max_calls: int = DEFAULT_MAX_CALLS max_age_seconds: int = DEFAULT_MAX_AGE_SECONDS max_bytes: int = DEFAULT_MAX_BYTES @@ -206,12 +452,37 @@ class Observation: identity: str started: float operation: str + facts: frozenset = frozenset() class StorageRejected(Exception): """Fixed operator code; never includes paths, SQL or payloads.""" +def _busy(error: Exception) -> bool: + return (isinstance(error, sqlite3.Error) and getattr(error, 'sqlite_errorcode', 0) & 255 + in (sqlite3.SQLITE_BUSY, sqlite3.SQLITE_LOCKED)) + + +def _deadline(wait_ms: int) -> float: + return time.monotonic() + wait_ms / 1000 + + +def _locked(db: sqlite3.Connection, deadline: float, statement: str = 'BEGIN IMMEDIATE') -> sqlite3.Cursor: + """Run a statement that needs the write lock, polling until the deadline. + + SQLite's own busy handler backs off in steps of up to 25 ms, far coarser than + a lock that other recorders hold for microseconds, so connections use none. + """ + while True: + try: + return db.execute(statement) + except sqlite3.OperationalError as error: + if not _busy(error) or time.monotonic() >= deadline: + raise + time.sleep(LOCK_POLL_SECONDS) + + class InteractionRecorder: def __init__(self, config: RecorderConfig, runtime: dict, catalog: list[dict], *, diagnostics: TextIO | None = None) -> None: @@ -219,57 +490,79 @@ def __init__(self, config: RecorderConfig, runtime: dict, catalog: list[dict], self.runtime = dict(runtime) self._diagnostics = diagnostics if diagnostics is not None else sys.stderr self._connection: sqlite3.Connection | None = None + self._salt = b'' + self._pages = 0 self._active: dict[str, Observation] = {} + self._backlog: deque[tuple[str, tuple]] = deque() + self._unsaved_lost = 0 + self._started = time.time() + self._client: tuple[str | None, str | None] = (None, None) self._sequence = 0 self._closed = False + self._silent = True self.health = {'state': 'starting', 'reason': None, 'recorded_starts': 0, - 'recorded_terminals': 0, 'dropped_observations': 0, + 'recorded_terminals': 0, 'backlog': 0, 'lost': 0, 'pruned_interactions': 0} self._shapes = {tool['name']: InputShape(tool['inputSchema']) for tool in catalog} - self._catalog = {tool['name']: { + self._catalog = _json({tool['name']: { 'input_digest': _digest(tool['inputSchema']), 'output_digest': (tool.get('_meta', {}).get('standards-engine/output-schema-digest') or _digest(tool.get('outputSchema'))), - } for tool in catalog} + } for tool in catalog}) try: - self._open() - self.health['state'] = 'healthy' - self._emit() + self._connection = self._open(_deadline(OPEN_TIMEOUT_MS)) + self._note('healthy') except Exception as error: self._degrade(error) def _emit(self) -> None: + self._silent = False try: print('standards-engine observer ' + _json(self.health), file=self._diagnostics, flush=True) except Exception: # Operator stderr can itself be broken. Never change a domain result. pass + def _note(self, state: str, reason: str | None = None) -> None: + """Operator stderr only when health changes; a healthy recorder is silent.""" + previous = (self.health['state'], self.health['reason']) + self.health.update(state=state, reason=reason, backlog=len(self._backlog)) + if previous != (state, reason) and 'degraded' in (previous[0], state): + self._emit() + def _degrade(self, error: Exception) -> None: + """Keep the backlog. Reconnect on a later call unless the database was only busy.""" reason = 'storage-unavailable' if isinstance(error, StorageRejected): reason = str(error) + elif _busy(error): + reason = 'storage-locked' elif isinstance(error, sqlite3.Error): - reason = {sqlite3.SQLITE_BUSY: 'storage-locked', sqlite3.SQLITE_LOCKED: 'storage-locked', - sqlite3.SQLITE_FULL: 'storage-full', sqlite3.SQLITE_CORRUPT: 'storage-corrupt', + reason = {sqlite3.SQLITE_FULL: 'storage-full', sqlite3.SQLITE_CORRUPT: 'storage-corrupt', sqlite3.SQLITE_NOTADB: 'storage-corrupt'}.get( getattr(error, 'sqlite_errorcode', 0) & 255, 'storage-error') - self.health.update(state='degraded', reason=reason) - self.health['dropped_observations'] += 1 - if self._connection is not None: + if reason != 'storage-locked' and self._connection is not None: try: self._connection.close() except Exception: pass self._connection = None - self._emit() + self._note('degraded', reason) - def _open(self) -> None: - path = self.config.database + def _lose(self, rows: int) -> None: + self.health['lost'] += rows + self._unsaved_lost += rows + + def _open(self, deadline: float) -> sqlite3.Connection: if os.name != 'posix': raise StorageRejected('unsupported-filesystem') - # The operator owns the existing directory; no recursive mkdir or changes - # to existing paths/permissions. O_NOFOLLOW protects the final component. + path = self.config.database + if path is None: + # Only the default location is created. An operator-supplied directory + # must already exist; existing paths and permissions are never changed. + path = default_database() + path.parent.mkdir(mode=0o700, parents=True, exist_ok=True) + # O_NOFOLLOW protects the final component. descriptor = os.open(path, os.O_RDWR | os.O_CREAT | os.O_NOFOLLOW, 0o600) try: info = os.fstat(descriptor) @@ -277,78 +570,153 @@ def _open(self) -> None: raise StorageRejected('unsafe-database-file') finally: os.close(descriptor) - db = sqlite3.connect(path, timeout=BUSY_TIMEOUT_MS / 1000, isolation_level=None) - self._connection = db - db.execute('PRAGMA foreign_keys=ON') - db.execute(f'PRAGMA busy_timeout={BUSY_TIMEOUT_MS}') - db.execute('BEGIN IMMEDIATE') + db = sqlite3.connect(path, timeout=0, isolation_level=None) try: - # Reject unsupported capabilities before publishing a migration. - if db.execute('PRAGMA journal_mode').fetchone()[0] != 'delete': + db.execute('PRAGMA foreign_keys=ON') + _locked(db, deadline) + try: + # Reject unsupported capabilities before publishing a migration. + pages = self.config.max_bytes // db.execute('PRAGMA page_size').fetchone()[0] + if db.execute('PRAGMA page_count').fetchone()[0] > pages: + raise StorageRejected('database-over-budget') + db.execute(f'PRAGMA max_page_count={pages}') + version = db.execute('PRAGMA user_version').fetchone()[0] + app = db.execute('PRAGMA application_id').fetchone()[0] + tables = db.execute("SELECT name FROM sqlite_master WHERE type='table'").fetchall() + if version == 0 and app == 0 and not tables: + # Table absence cannot prove privacy: dropped SQLite content may + # remain in freelist pages or sqlite_master slack. Only a truly + # new zero-length source is admitted; never wipe/reuse old bytes. + # Simultaneous creators queue on this lock: the first publishes + # the whole schema in one commit and the rest find it complete. + if info.st_size != 0 or path.stat().st_size != 0: + raise StorageRejected('nonpristine-database') + for statement in SCHEMA_DDL: + db.execute(statement) + db.execute("INSERT INTO meta VALUES('salt',?)", (secrets.token_hex(16),)) + db.execute(f'PRAGMA application_id={APPLICATION_ID}') + db.execute(f'PRAGMA user_version={SCHEMA_VERSION}') + elif version != SCHEMA_VERSION or app != APPLICATION_ID: + # Includes schema v1: historical evidence, never migrated or deleted. + raise StorageRejected('unsupported-database-schema') + actual = {row[0]: row[1] for row in db.execute( + "SELECT name,sql FROM sqlite_master WHERE name NOT LIKE 'sqlite_%'")} + expected = {statement.split()[2]: statement for statement in SCHEMA_DDL} + if actual != expected: + raise StorageRejected('invalid-database-schema') + salt = bytes.fromhex(db.execute("SELECT value FROM meta WHERE key='salt'").fetchone()[0]) + _locked(db, deadline, 'COMMIT') + except BaseException: + db.execute('ROLLBACK') + raise + # WAL keeps the write lock to microseconds (no fsync per commit) and lets + # a report read while servers write. Idempotent for every later opener. + if _locked(db, deadline, 'PRAGMA journal_mode=WAL').fetchone()[0] != 'wal': raise StorageRejected('unsupported-journal-mode') - pages = self.config.max_bytes // db.execute('PRAGMA page_size').fetchone()[0] - if db.execute('PRAGMA page_count').fetchone()[0] > pages: - raise StorageRejected('database-over-budget') - db.execute(f'PRAGMA max_page_count={pages}') - version = db.execute('PRAGMA user_version').fetchone()[0] - app = db.execute('PRAGMA application_id').fetchone()[0] - tables = db.execute("SELECT name FROM sqlite_master WHERE type='table'").fetchall() - if version == 0 and app == 0 and not tables: - # Table absence cannot prove privacy: dropped SQLite content may - # remain in freelist pages or sqlite_master slack. Only a truly - # new zero-length source is admitted; never wipe/reuse old bytes. - if info.st_size != 0 or path.stat().st_size != 0: - raise StorageRejected('nonpristine-database') - for statement in SCHEMA_DDL: - db.execute(statement) - db.execute(f'PRAGMA application_id={APPLICATION_ID}') - db.execute(f'PRAGMA user_version={SCHEMA_VERSION}') - elif version != SCHEMA_VERSION or app != APPLICATION_ID: - raise StorageRejected('unsupported-database-schema') - actual = {row[0]: row[1] for row in db.execute( - "SELECT name,sql FROM sqlite_master WHERE name NOT LIKE 'sqlite_%'")} - expected = {statement.split()[2]: statement for statement in SCHEMA_DDL} - if actual != expected: - raise StorageRejected('invalid-database-schema') - db.execute('COMMIT') + db.execute('PRAGMA synchronous=NORMAL') + db.execute('PRAGMA secure_delete=ON') except BaseException: - db.execute('ROLLBACK') + db.close() raise - db.execute('PRAGMA synchronous=FULL') - db.execute('PRAGMA secure_delete=ON') - - def _transaction(self, action): - db = self._connection - if db is None: - self.health['dropped_observations'] += 1 - return False + self._salt, self._pages = salt, pages + return db + + def _pseudonym(self, thread: str | None) -> str | None: + if thread is None: + return None + return hmac.new(self._salt, thread.encode('utf-8', 'replace'), 'sha256').hexdigest()[:16] + + def _write(self, db: sqlite3.Connection) -> tuple[Counter, int, int]: + """One transaction: prune to policy, then store the whole backlog in order.""" + session, now = self.runtime['instance_id'], time.time() + starts = sum(kind == 'start' for kind, _ in self._backlog) + pruned = 0 + if starts: + pruned = db.execute('DELETE FROM interactions WHERE started < ?', + (now - self.config.max_age_seconds,)).rowcount + count = db.execute('SELECT count(*) FROM interactions').fetchone()[0] + excess = max(0, count + starts - self.config.max_calls) + used = db.execute('PRAGMA page_count').fetchone()[0] - db.execute('PRAGMA freelist_count').fetchone()[0] + if used > self._pages - self._pages // 16: + # The byte cap bounds retention like the count cap: a nearly full file + # gives up its oldest sixteenth instead of refusing new observations. + excess = max(excess, count // 16 + starts) + if excess: + pruned += db.execute('DELETE FROM interactions WHERE id IN ' + '(SELECT id FROM interactions ORDER BY started,id LIMIT ?)', (excess,)).rowcount + if pruned: + # A session that only carries a loss count stays until it ages out. + db.execute('DELETE FROM sessions WHERE id != ? AND (lost = 0 OR started < ?) AND NOT EXISTS ' + '(SELECT 1 FROM interactions WHERE session=sessions.id)', + (session, now - self.config.max_age_seconds)) + db.execute('DELETE FROM catalogs WHERE digest NOT IN (SELECT catalog FROM sessions)') + catalog = _digest(self._catalog) + db.execute('INSERT OR IGNORE INTO catalogs VALUES(?,?)', (catalog, self._catalog)) + db.execute('INSERT OR IGNORE INTO sessions(id,started,runtime,deployment,catalog) VALUES(?,?,?,?,?)', + (session, self._started, _json(self.runtime), self.config.deployment, catalog)) + recorded = Counter() + for kind, row in self._backlog: + if kind == 'start': + recorded[kind] += db.execute( + 'INSERT OR IGNORE INTO interactions VALUES(?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?)', + (*row[:-2], self._pseudonym(row[-2]), row[-1])).rowcount + else: + # Retention or a backlog overflow may have removed this start. Do + # not recreate it or claim a terminal event was retained. + recorded[kind] += db.execute( + 'INSERT OR IGNORE INTO events SELECT ?,?,?,?,?,?,?,?,? WHERE EXISTS ' + '(SELECT 1 FROM interactions WHERE id=?)', (*row, row[0])).rowcount + orphans = len(self._backlog) - starts - recorded['end'] + db.execute('UPDATE sessions SET client_name=?,client_version=?,pruned=pruned+?,lost=lost+? WHERE id=?', + (*self._client, pruned, self._unsaved_lost + orphans, session)) + return recorded, pruned, orphans + + def _flush(self, wait_ms: int) -> None: + """Deliver the backlog, or keep all of it for a later call. Never raises.""" + if not self._backlog and not self._unsaved_lost: + return + deadline = _deadline(wait_ms) try: - db.execute('BEGIN IMMEDIATE') - action(db) - db.execute('COMMIT') - return True - except Exception as error: + if self._connection is None: + self._connection = self._open(deadline) + db = self._connection + _locked(db, deadline) try: - db.execute('ROLLBACK') - except sqlite3.Error: - pass + recorded, pruned, orphans = self._write(db) + db.execute('COMMIT') + except BaseException: + try: + db.execute('ROLLBACK') + except sqlite3.Error: + pass + raise + except Exception as error: self._degrade(error) - return False + return + self._backlog.clear() + self._unsaved_lost = 0 + self.health['recorded_starts'] += recorded['start'] + self.health['recorded_terminals'] += recorded['end'] + self.health['pruned_interactions'] += pruned + self.health['lost'] += orphans + self._note('healthy') + + def _record(self, kind: str, row: tuple) -> None: + if len(self._backlog) >= MAX_BACKLOG: + # Bounded memory: the oldest waiting row gives way and is counted. + self._backlog.popleft() + self._lose(1) + self._backlog.append((kind, row)) + self._flush(BUSY_TIMEOUT_MS) def begin(self, message: object, *, request_bytes: int | None, scope: str, parse_error: bool = False) -> Observation | None: if self._closed: return None - if self._active: - self._degrade(StorageRejected('overlapping-recorder-call')) - return None # Notifications have no response pair. Invalid envelopes and parse errors do. if (isinstance(message, dict) and 'id' not in message and not parse_error and message.get('jsonrpc') == '2.0' and isinstance(message.get('method'), str)): return None - if self._connection is None: - self.health['dropped_observations'] += 1 - return None try: params = message.get('params', {}) if isinstance(message, dict) else {} params = params if isinstance(params, dict) else {} @@ -356,43 +724,41 @@ def begin(self, message: object, *, request_bytes: int | None, scope: str, method = method if isinstance(method, str) and method in METHODS else 'invalid-json' if parse_error else 'other' name = params.get('name') operation = name if method == 'tools/call' and isinstance(name, str) and name in self._shapes else 'other' - shape = self._shapes[operation].project(params.get('arguments', {})) if operation in self._shapes else {} arguments = params.get('arguments', {}) + shape, values, arguments_bytes = {}, {}, None + if operation in self._shapes: + shape = self._shapes[operation].project(arguments) + if operation not in NAVIGATION: + values = self._shapes[operation].identifiers(arguments) + elif isinstance(arguments, dict): + values = navigation_values(operation, arguments) + values = _bounded(values) + try: + arguments_bytes = len(json.dumps(arguments, ensure_ascii=False, separators=(',', ':')).encode('utf-8')) + except Exception: + pass discovery = arguments.get('operation') if isinstance(arguments, dict) else None discovery = discovery if operation in {'describe_input', 'describe_output'} and isinstance(discovery, str) and discovery in self._shapes else None expected = arguments.get('expected_catalog') if isinstance(arguments, dict) else None catalog_state = ('unspecified' if expected is None else 'matches' if expected == self.runtime['catalog_digest'] else 'differs') - now = time.time() - observation = Observation(str(uuid.uuid4()), time.monotonic(), operation) + if method == 'initialize' and self._client == (None, None): + client = params.get('clientInfo') + client = client if isinstance(client, dict) else {} + self._client = (_label(client.get('name')), _label(client.get('version'))) + thread, origin = _thread(params.get('_meta')) + observation = Observation(str(uuid.uuid4()), time.monotonic(), operation, + frozenset(_recorded_facts(values))) self._sequence += 1 - pruned = 0 - def write(db): - nonlocal pruned - db.execute('INSERT OR IGNORE INTO sessions(id,started,runtime,deployment,catalog) VALUES(?,?,?,?,?)', - (self.runtime['instance_id'], now, _json(self.runtime), self.config.deployment, _json(self._catalog))) - pruned += db.execute('DELETE FROM interactions WHERE started < ?', - (now - self.config.max_age_seconds,)).rowcount - excess = db.execute('SELECT max(0,count(*)-?) FROM interactions', - (self.config.max_calls - 1,)).fetchone()[0] - if excess: - pruned += db.execute('DELETE FROM interactions WHERE id IN ' - '(SELECT id FROM interactions ORDER BY started,id LIMIT ?)', (excess,)).rowcount - db.execute('DELETE FROM sessions WHERE id != ? AND NOT EXISTS ' - '(SELECT 1 FROM interactions WHERE session=sessions.id)', (self.runtime['instance_id'],)) - db.execute('UPDATE sessions SET pruned=pruned+? WHERE id=?', (pruned, self.runtime['instance_id'])) - db.execute('INSERT INTO interactions VALUES(?,?,?,?,?,?,?,?,?,?,?,?)', - (observation.identity, self.runtime['instance_id'], self._sequence, now, - method, operation, _json(shape), _digest(shape), discovery, catalog_state, - request_bytes, scope)) - if not self._transaction(write): - return None - self.health['recorded_starts'] += 1 - self.health['pruned_interactions'] += pruned + row = (observation.identity, self.runtime['instance_id'], self._sequence, time.time(), + method, operation, _json(shape), _digest(shape), discovery, catalog_state, + request_bytes, scope, _json(values), arguments_bytes, thread, origin) self._active[observation.identity] = observation + self._record('start', row) return observation - except Exception as error: - self._degrade(error) + except Exception: + self._lose(1) + self._note('degraded', 'recorder-error') return None def finish(self, observation: Observation | None, response: object = None, @@ -401,7 +767,7 @@ def finish(self, observation: Observation | None, response: object = None, return self._active.pop(observation.identity, None) try: - phase, outcome, feedback = 'end', 'response', [] + phase, outcome, feedback, summary, result_bytes = 'end', 'response', [], {}, None if incomplete: phase, outcome = 'incomplete', 'unknown' elif isinstance(response, dict): @@ -421,30 +787,24 @@ def finish(self, observation: Observation | None, response: object = None, outcome = value['outcome'] elif isinstance(value.get('status'), str) and value['status'] in OUTCOMES: outcome = value['status'] + summary = result_summary(value) + if 'structuredContent' in result: + try: + # One serialization: the text copy the transport already made. + result_bytes = len(result['content'][0]['text'].encode('utf-8')) + except Exception: + pass if observation.operation in self._shapes: - feedback = self._shapes[observation.operation].feedback(value.get('input_feedback')) + feedback = self._shapes[observation.operation].feedback( + value.get('input_feedback'), observation.facts) if 'input_feedback' in value: phase, outcome = 'error', 'input-invalid' - evicted = False - def write(db): - nonlocal evicted - # Retention in another process may have evicted this start. Do not - # recreate it or claim a terminal event was retained. - if not db.execute('SELECT 1 FROM interactions WHERE id=?', (observation.identity,)).fetchone(): - evicted = True - return - db.execute('INSERT INTO events VALUES(?,?,?,?,?,?,?)', - (observation.identity, phase, time.time(), - max(0, (time.monotonic() - observation.started) * 1000), - response_bytes, outcome, _json(feedback))) - if self._transaction(write): - if evicted: - self.health['dropped_observations'] += 1 - self._emit() - else: - self.health['recorded_terminals'] += 1 - except Exception as error: - self._degrade(error) + self._record('end', (observation.identity, phase, time.time(), + max(0, (time.monotonic() - observation.started) * 1000), + response_bytes, outcome, _json(feedback), _json(summary), result_bytes)) + except Exception: + self._lose(1) + self._note('degraded', 'recorder-error') def close(self) -> None: if self._closed: @@ -452,13 +812,22 @@ def close(self) -> None: for observation in tuple(self._active.values()): self.finish(observation, incomplete=True) self._closed = True + self._flush(CLOSE_TIMEOUT_MS) + if self._backlog: + # The process is ending: nothing can deliver these rows any more. + # Save the count if the database can still be reached at all. + self._lose(len(self._backlog)) + self._backlog.clear() + self._flush(BUSY_TIMEOUT_MS) if self._connection is not None: try: self._connection.close() - except Exception as error: - self._degrade(error) + except Exception: + pass self._connection = None - self._emit() + self.health['backlog'] = 0 + if not self._silent or self.health['lost']: + self._emit() def open_report(database: Path) -> sqlite3.Connection: @@ -476,38 +845,171 @@ def open_report(database: Path) -> sqlite3.Connection: raise -def report(database: Path, *, limit: int = 100) -> dict: +def _percentile(values: list, fraction: float): + ordered = sorted(values) + return ordered[max(0, math.ceil(fraction * len(ordered)) - 1)] if ordered else None + + +def _top(counter: Counter, limit: int, *names: str) -> list[dict]: + """Most common keys as rows; ties break on the key so reports are stable.""" + rows = sorted(counter.items(), key=lambda item: (-item[1], _json(item[0])))[:limit] + return [{**dict(zip(names, key if isinstance(key, tuple) else (key,))), 'count': count} + for key, count in rows] + + +def _fact_values(value: object) -> list[str]: + """The vocabulary words inside one routing fact value as sent.""" + if isinstance(value, dict): # Native typed form {type, state, value}. + value = value.get('value') + return [item for item in (value if isinstance(value, list) else [value]) if isinstance(item, str)] + + +def _usage(db: sqlite3.Connection, since: float, limit: int) -> dict: + """What agents asked for and what came back, from the recorded values.""" + sessions = {} + for row in db.execute('SELECT id,runtime,client_name,client_version FROM sessions'): + runtime = json.loads(row['runtime']) + sessions[row['id']] = (' '.join(filter(None, (row['client_name'], row['client_version']))) or 'unknown', + runtime.get('purpose'), runtime.get('interface_version')) + clients, calls, rejected = {}, Counter(), Counter() + durations, sizes = {}, {} + rejections, read_targets, origins, tool_calls = Counter(), Counter(), {}, Counter() + reads, accepted, declared, refused = {}, {}, set(), [] + routes = without_snapshot = 0 + for row in db.execute( + 'SELECT i.session,i.method,i.operation,i.arguments,i.thread,i.origin,e.phase,e.outcome,' + 'e.feedback,e.duration_ms,e.result,e.result_bytes FROM interactions i LEFT JOIN events e ' + 'ON e.interaction=i.id WHERE i.started >= ? ORDER BY i.started,i.id', (since,)): + client = clients.setdefault(sessions.get(row['session'], ('unknown', None, None)), [set(), 0]) + client[0].add(row['session']) + client[1] += 1 + thread = row['thread'] or 'process:' + row['session'] + if row['method'] == 'tools/call': + origins[thread] = row['origin'] + tool_calls[thread] += 1 + operation = row['operation'] if row['method'] == 'tools/call' else row['method'] + calls[operation] += 1 + if row['duration_ms'] is not None: + durations.setdefault(operation, []).append(row['duration_ms']) + if row['result_bytes'] is not None: + sizes.setdefault(operation, []).append(row['result_bytes']) + arguments = json.loads(row['arguments']) + result = json.loads(row['result']) if row['result'] else {} + facts = _recorded_facts(arguments) + if row['operation'] == 'route': + routes += 1 + without_snapshot += 'snapshot' not in arguments + if row['phase'] == 'end': + declared.update(result.get('unresolved', ())) + for name, value in facts.items(): + accepted.setdefault(name, set()).update(_fact_values(value)) + delivered = result.get('targets', []) + result.get('content', {}).get('targets', []) + read_targets.update(delivered) + if delivered: + reads.setdefault(thread, Counter()).update(delivered) + elif row['phase'] == 'error' and row['method'] == 'tools/call': + rejected[operation] += 1 + issue = (json.loads(row['feedback']) or [{}])[0] + # The offending value is whatever the validation pointer names in the + # recorded arguments; without a pointer, everything recorded but the snapshot. + value = arguments + for part in issue.get('pointer', '').split('/')[1:]: + part = part.replace('~1', '/').replace('~0', '~') + inner = (value.get(part) if isinstance(value, dict) + else value[int(part)] if isinstance(value, list) and part.isdecimal() and int(part) < len(value) + else None) + if inner is None: + break + value = inner + if value is arguments: + value = {name: item for name, item in arguments.items() if name != 'snapshot'} + rejections[(operation, result.get('code') or row['outcome'], issue.get('pointer', ''), + issue.get('keyword', ''), _json(value)[:MAX_VALUE_CHARS])] += 1 + if issue.get('keyword') == 'fact': + pointed = issue['pointer'].rpartition('/facts/')[2].replace('~1', '/').replace('~0', '~') + refused.append((facts, pointed if '/facts/' in issue['pointer'] else None)) + # Out-of-vocabulary is inferred, never looked up: a name or value counts when + # the server refused its route and never accepted or asked for it in this window. + names, values = Counter(), Counter() + for facts, pointed in refused: + names.update(name for name in facts if name not in accepted and name not in declared) + for name in ([pointed] if pointed in facts else []): + values.update((name, word) for word in _fact_values(facts[name]) + if word not in accepted.get(name, ())) + repeats = {thread: sum(seen.values()) - len(seen) for thread, seen in reads.items()} + total_reads = sum(sum(seen.values()) for seen in reads.values()) + threads = {} + for thread, origin in origins.items(): + entry = threads.setdefault(origin, {'origin': origin, 'threads': 0, 'calls': 0, 'reads': 0, 'repeats': 0}) + entry['threads'] += 1 + entry['calls'] += tool_calls[thread] + entry['reads'] += sum(reads.get(thread, {}).values()) + entry['repeats'] += repeats.get(thread, 0) + return { + 'clients': [{'client': key[0], 'purpose': key[1], 'interface_version': key[2], + 'sessions': len(value[0]), 'calls': value[1]} + for key, value in sorted(clients.items(), key=lambda item: (-item[1][1], _json(item[0])))][:limit], + 'usage': [{'operation': operation, 'calls': count, 'rejected': rejected[operation], + 'rejection_rate': rejected[operation] / count, + 'duration_p50_ms': _percentile(durations.get(operation, []), 0.5), + 'duration_p90_ms': _percentile(durations.get(operation, []), 0.9), + 'duration_max_ms': max(durations.get(operation, []), default=None), + 'result_p50_bytes': _percentile(sizes.get(operation, []), 0.5), + 'result_max_bytes': max(sizes.get(operation, []), default=None)} + for operation, count in sorted(calls.items(), key=lambda item: (-item[1], item[0]))][:limit], + 'rejections': _top(rejections, limit, 'operation', 'code', 'pointer', 'keyword', 'value'), + 'unaccepted_facts': {'names': _top(names, limit, 'name'), 'values': _top(values, limit, 'fact', 'value')}, + 'read_targets': _top(read_targets, limit, 'target'), + 'repeat_reads': {'reads': total_reads, 'repeats': sum(repeats.values()), 'threads': len(reads), + 'threads_repeating': sum(count > 0 for count in repeats.values()), + 'worst_thread_rate': max((count / sum(reads[thread].values()) + for thread, count in repeats.items() if count), default=0.0)}, + 'routes': {'calls': routes, 'without_snapshot': without_snapshot}, + 'threads': [threads[origin] for origin in sorted(threads)], + } + + +def report(database: Path, *, limit: int = 100, since_days: float | None = None) -> dict: if not 1 <= limit <= MAX_REPORT_ROWS: raise ValueError('report limit must be in 1..1000') + if since_days is not None and not 0 < since_days <= 3650: + raise ValueError('since_days must be in 0..3650') + since = time.time() - since_days * 24 * 60 * 60 if since_days is not None else 0.0 db = open_report(database) db.row_factory = sqlite3.Row try: db.execute('BEGIN') # One consistent read snapshot, including denominators. - total = db.execute('SELECT count(*) FROM interactions').fetchone()[0] - terminals = db.execute('SELECT count(*) FROM events').fetchone()[0] + total, first, last = db.execute('SELECT count(*),min(started),max(started) FROM interactions ' + 'WHERE started >= ?', (since,)).fetchone() + terminals = db.execute('SELECT count(*) FROM events e JOIN interactions i ON i.id=e.interaction ' + 'WHERE i.started >= ?', (since,)).fetchone()[0] + lost, pruned = db.execute('SELECT coalesce(sum(lost),0),coalesce(sum(pruned),0) FROM sessions').fetchone() operations = [dict(row) for row in db.execute( 'SELECT i.scope,i.method,i.operation,count(*) AS starts,count(e.interaction) AS terminals,' 'sum(CASE WHEN e.phase=\'error\' THEN 1 ELSE 0 END) AS errors,' 'sum(CASE WHEN e.interaction IS NULL OR e.phase=\'incomplete\' THEN 1 ELSE 0 END) AS incomplete,' 'sum(i.request_bytes) AS request_bytes,count(i.request_bytes) AS request_measurements,' + 'sum(i.arguments_bytes) AS arguments_bytes,count(i.arguments_bytes) AS arguments_measurements,' 'sum(e.response_bytes) AS response_bytes,count(e.response_bytes) AS response_measurements,' + 'sum(e.result_bytes) AS result_bytes,count(e.result_bytes) AS result_measurements,' 'count(e.duration_ms) AS duration_measurements,' 'avg(e.duration_ms) AS observed_duration_ms FROM interactions i LEFT JOIN events e ' - 'ON e.interaction=i.id GROUP BY i.scope,i.method,i.operation ORDER BY starts DESC,i.scope,i.method,i.operation LIMIT ?', (limit + 1,))] + 'ON e.interaction=i.id WHERE i.started >= ? GROUP BY i.scope,i.method,i.operation ' + 'ORDER BY starts DESC,i.scope,i.method,i.operation LIMIT ?', (since, limit + 1))] operations_truncated = len(operations) > limit operations = operations[:limit] failures = [dict(row) for row in db.execute( 'SELECT i.scope,i.operation,i.shape_digest,e.outcome,e.feedback,count(*) AS count FROM interactions i ' - 'JOIN events e ON e.interaction=i.id WHERE e.phase=\'error\' ' - 'GROUP BY i.scope,i.operation,i.shape_digest,e.outcome,e.feedback ORDER BY count DESC,i.scope,i.operation,i.shape_digest,e.outcome,e.feedback LIMIT ?', (limit + 1,))] + 'JOIN events e ON e.interaction=i.id WHERE e.phase=\'error\' AND i.started >= ? ' + 'GROUP BY i.scope,i.operation,i.shape_digest,e.outcome,e.feedback ORDER BY count DESC,i.scope,i.operation,i.shape_digest,e.outcome,e.feedback LIMIT ?', (since, limit + 1))] failures_truncated = len(failures) > limit failures = failures[:limit] shapes = [dict(row) for row in db.execute( 'SELECT i.scope,i.operation,i.shape_digest,i.input_shape,count(*) AS starts,' 'sum(CASE WHEN e.phase=\'error\' THEN 1 ELSE 0 END) AS errors FROM interactions i ' - 'LEFT JOIN events e ON e.interaction=i.id WHERE i.method=\'tools/call\' ' + 'LEFT JOIN events e ON e.interaction=i.id WHERE i.method=\'tools/call\' AND i.started >= ? ' 'GROUP BY i.scope,i.operation,i.shape_digest,i.input_shape ' - 'ORDER BY starts DESC,i.scope,i.operation,i.shape_digest LIMIT ?', (limit + 1,))] + 'ORDER BY starts DESC,i.scope,i.operation,i.shape_digest LIMIT ?', (since, limit + 1))] shapes_truncated = len(shapes) > limit shapes = shapes[:limit] for shape in shapes: @@ -518,7 +1020,6 @@ def report(database: Path, *, limit: int = 100) -> dict: 'SELECT * FROM (SELECT * FROM sessions ORDER BY started DESC,id DESC LIMIT ?) ORDER BY started,id', (limit,))] for session in sessions: session['runtime'] = json.loads(session['runtime']) - session['catalog'] = json.loads(session['catalog']) # Chronology within a process only: these are observed attempts, not proof # of agent intent, a repair relation, or an acquired definition. pending = Counter() @@ -529,8 +1030,8 @@ def report(database: Path, *, limit: int = 100) -> dict: scanned = 0 for row in db.execute( 'SELECT * FROM (SELECT i.session,i.ordinal,i.scope,i.operation,i.discovery_operation,e.phase ' - 'FROM interactions i LEFT JOIN events e ON e.interaction=i.id ' - 'ORDER BY i.started DESC,i.id DESC LIMIT ?) ORDER BY session,ordinal', (MAX_SEQUENCE_SCAN,)): + 'FROM interactions i LEFT JOIN events e ON e.interaction=i.id WHERE i.started >= ? ' + 'ORDER BY i.started DESC,i.id DESC LIMIT ?) ORDER BY session,ordinal', (since, MAX_SEQUENCE_SCAN)): scanned += 1 scope = row['scope'] key = (row['session'], scope, row['operation']) @@ -551,20 +1052,26 @@ def report(database: Path, *, limit: int = 100) -> dict: 'preceding_errors_histogram': dict(sorted(errors.items())[:limit]), 'preceding_discoveries_histogram': dict(sorted(discovery.items())[:limit]), 'histograms_truncated': len(errors) > limit or len(discovery) > limit}) + # Each distinct catalog is stored once; compare them in order of first use. revisions = {} for session in sessions: - revisions.setdefault(session['runtime']['catalog_digest'], session['catalog']) + revisions.setdefault(session['runtime'].get('catalog_digest'), session['catalog']) + tools = {digest: json.loads(db.execute('SELECT tools FROM catalogs WHERE digest=?', (digest,)).fetchone()[0]) + for digest in set(revisions.values())} comparisons = [] digests = list(revisions) for before, after in zip(digests, digests[1:]): - left, right = revisions[before], revisions[after] + left, right = tools[revisions[before]], tools[revisions[after]] comparisons.append({'before': before, 'after': after, 'added': sorted(right.keys() - left.keys()), 'removed': sorted(left.keys() - right.keys()), 'changed': sorted(name for name in left.keys() & right.keys() if left[name] != right[name])}) - return {'schema_version': SCHEMA_VERSION, 'retained_starts': total, + return {'schema_version': SCHEMA_VERSION, 'since_days': since_days, + 'first_start': first, 'last_start': last, 'retained_starts': total, 'retained_terminals': terminals, 'unmatched_starts': total - terminals, + 'lost_rows': lost, 'pruned_interactions': pruned, + **_usage(db, since, limit), 'operations': operations, 'operations_truncated': operations_truncated, 'failures': failures, 'failures_truncated': failures_truncated, 'shapes': shapes, 'shapes_truncated': shapes_truncated, 'sessions': sessions, @@ -575,24 +1082,87 @@ def report(database: Path, *, limit: int = 100) -> dict: 'limits': {'group_rows': limit, 'sequence_scan_limit': MAX_SEQUENCE_SCAN, 'meaning': 'Retained observations only; unmatched or incomplete outcomes are unknown. ' 'End means response produced/delivered per scope, not domain completion. ' - 'Sequence denominator is end responses per session/scope/operation in the bounded scan. No cross-process ' - 'continuation or intent is inferred. Retention can remove prior attempts. ' + 'Sequence denominator is end responses per session/scope/operation in the bounded scan. ' + 'A thread is a hashed client thread id, or the server process when the client sent none. ' + 'Unaccepted facts are inferred from refused routes, not checked against a vocabulary. ' + 'Retention can remove prior attempts; lost_rows and pruned_interactions cover retained sessions. ' 'Bytes are serialized JSON/stdio bytes, never tokens or billing. ' - 'Redacted requests cannot be replayed; use independent qualification evidence.'}} + 'Recorded requests cannot be replayed; use independent qualification evidence.'}} finally: db.close() +def _stamp(seconds: float | None) -> str: + return datetime.fromtimestamp(seconds, timezone.utc).strftime('%Y-%m-%d %H:%M') if seconds else '-' + + +def _amount(value: float | None, unit: str = '') -> str: + if value is None: + return '-' + if unit == 'B': + return (f'{value} B' if value < 1000 else f'{value / 1000:.1f} kB' if value < 1_000_000 + else f'{value / 1_000_000:.1f} MB') + return f'{value:.1f}' if value < 10 else f'{value:.0f}' + + +def _share(part: int, whole: int) -> str: + return f'{part} of {whole} ({100 * part / whole:.1f}%)' if whole else '0 of 0' + + +def text_report(summary: dict) -> str: + """About a screenful for a person; the JSON form holds every row.""" + window = f'last {summary["since_days"]:g} days' if summary['since_days'] else 'all retained' + lines = [ + f'Standards Engine MCP observations, schema v{summary["schema_version"]} ({window})', + f'{_stamp(summary["first_start"])} to {_stamp(summary["last_start"])} UTC', + f'{summary["retained_starts"]} calls: {summary["unmatched_starts"]} without an outcome ' + f'(process ended mid-call), {summary["lost_rows"]} rows lost, ' + f'{summary["pruned_interactions"]} pruned by retention', + '', f'{"Client":<34}{"purpose":<13}{"interface":>9}{"sessions":>10}{"calls":>8}'] + lines += [f'{row["client"][:33]:<34}{row["purpose"] or "-":<13}{row["interface_version"] or "-":>9}' + f'{row["sessions"]:>10}{row["calls"]:>8}' for row in summary['clients'][:TEXT_ROWS]] + lines += ['', f'{"Operation":<22}{"calls":>7}{"rejected":>10}{"p50 ms":>9}{"p90 ms":>9}{"max ms":>9}' + f'{"p50 result":>12}{"max result":>12}'] + lines += [f'{row["operation"][:21]:<22}{row["calls"]:>7}{100 * row["rejection_rate"]:>9.1f}%' + f'{_amount(row["duration_p50_ms"]):>9}{_amount(row["duration_p90_ms"]):>9}' + f'{_amount(row["duration_max_ms"]):>9}{_amount(row["result_p50_bytes"], "B"):>12}' + f'{_amount(row["result_max_bytes"], "B"):>12}' for row in summary['usage'][:2 * TEXT_ROWS]] + lines += ['', 'Top rejections (count, operation, code, where, value sent)'] + lines += [f'{row["count"]:>5} {row["operation"]} {row["code"]} ' + f'{row["pointer"] or "-"}{" (" + row["keyword"] + ")" if row["keyword"] else ""} {row["value"][:70]}' + for row in summary['rejections'][:TEXT_ROWS]] or [' none'] + facts = summary['unaccepted_facts'] + lines += ['', 'Route facts the server refused and never accepted in this window', + ' names: ' + (', '.join(f'{row["name"][:40]} x{row["count"]}' for row in facts['names'][:TEXT_ROWS]) or 'none'), + ' values: ' + (', '.join(f'{row["fact"][:40]}={row["value"][:40]} x{row["count"]}' + for row in facts['values'][:TEXT_ROWS]) or 'none'), + '', 'Most-read targets (read, read_many and route content)', + ' ' + (', '.join(f'{row["target"]} x{row["count"]}' for row in summary['read_targets'][:TEXT_ROWS]) or 'none')] + repeats, routes = summary['repeat_reads'], summary['routes'] + lines += ['', f'Reads repeating a target within one thread: {_share(repeats["repeats"], repeats["reads"])}; ' + f'{repeats["threads_repeating"]} of {repeats["threads"]} reading threads repeated ' + f'(worst {100 * repeats["worst_thread_rate"]:.1f}%)', + f'Routes sent without a snapshot: {_share(routes["without_snapshot"], routes["calls"])}', + '', f'{"Tool-calling threads":<22}{"threads":>7}{"calls":>8} reads repeated'] + lines += [f'{row["origin"]:<22}{row["threads"]:>7}{row["calls"]:>8} {_share(row["repeats"], row["reads"])}' + for row in summary['threads']] + return '\n'.join(lines) + + def main() -> int: parser = argparse.ArgumentParser(description='Read-only operator MCP observation report; no agent tools.') - parser.add_argument('--database', type=Path, required=True) - parser.add_argument('--limit', type=int, default=100) + parser.add_argument('--database', type=Path, help='Defaults to the always-on recording location.') + parser.add_argument('--format', choices=('text', 'json'), default='text') + parser.add_argument('--since-days', type=float, help='Only calls started within this many days.') + parser.add_argument('--limit', type=int, default=100, help='Rows per section in the JSON form.') arguments = parser.parse_args() try: - print(json.dumps(report(arguments.database, limit=arguments.limit), sort_keys=True, indent=2)) - except (OSError, sqlite3.Error, StorageRejected, ValueError): + summary = report(arguments.database or default_database(), limit=arguments.limit, + since_days=arguments.since_days) + except (OSError, RuntimeError, sqlite3.Error, StorageRejected, ValueError): print('Observation report unavailable; check database access and schema.', file=sys.stderr) return 1 + print(json.dumps(summary, sort_keys=True, indent=2) if arguments.format == 'json' else text_report(summary)) return 0 diff --git a/tools/standards_engine/standards_engine/mcp.py b/tools/standards_engine/standards_engine/mcp.py index 5280fca6..6bfbbded 100644 --- a/tools/standards_engine/standards_engine/mcp.py +++ b/tools/standards_engine/standards_engine/mcp.py @@ -2,6 +2,9 @@ Only lifecycle, ping, and tools are supported. Requests execute serially; durable Engine handles, rather than transport sessions, carry domain state. +One server process has one Engine: it is opened by the first store-backed tool +call, serves every later call, and is closed with the server. Its store +connection is opened for each call and closed when the call ends. """ from __future__ import annotations @@ -10,24 +13,45 @@ from contextlib import redirect_stdout from copy import deepcopy import json +import os from pathlib import Path import sys import traceback from typing import Callable, TextIO from .tools import AgentToolFacade -from .compiled_cache import CompiledSnapshotCache +from .agent_navigation import ( + ROUTE_CONTENT_RESULT_BYTES, ROUTE_PAGE_BYTES, ROUTE_PAGE_MIN_BYTES, admit_route_page_bytes, +) from .runtime_identity import RuntimeIdentity from .contract_discovery import ContractDiscovery from .context_projection import Purpose from .mcp_catalog import OutputSchemaDelivery, tool_catalog from .interaction_observer import ( - DEFAULT_MAX_AGE_SECONDS, DEFAULT_MAX_BYTES, DEFAULT_MAX_CALLS, + DEFAULT_DEPLOYMENT, DEFAULT_MAX_AGE_SECONDS, DEFAULT_MAX_BYTES, DEFAULT_MAX_CALLS, InteractionRecorder, RecorderConfig, serialized_bytes, ) PROTOCOL_VERSION = "2025-11-25" +# Every application client receives this text at initialize; keep it short and plain. +APPLICATION_INSTRUCTIONS = ( + "This server returns the engineering standards that apply to the task you are doing. " + "Get them before you plan or change code, then follow them.\n" + "1. Call routing_facts once. It lists every fact name and its allowed values; use them exactly as written.\n" + "2. Call route with the facts that are true of your task and content={{}}. Leave out a fact you do not know. " + "Do not remove a true fact to make a call succeed.\n" + "3. reading_plan lists every module that applies. content.items holds the full text of this page. " + "While content.next is present, call route again with exactly those arguments.\n" + "4. Keep the returned snapshot and pass it in every later call. A module you already hold at that snapshot " + "has not changed; do not read it again.\n" + "Each module has a review_state: current (this exact text was approved for application use), " + "changed-since-review (edited after it was approved) or not-reviewed (never approved). " + "All three are delivered and all apply; the label only tells you how settled the wording is.\n" + "read and read_many fetch modules by ID; ask for two or three per call so your client can show the whole result. " + "describe_input gives exact argument shapes when your client abbreviates them.\n" + "Installed interface {interface}; purpose application." +) class ProtocolError(Exception): @@ -39,10 +63,12 @@ def __init__(self, code: int, message: str, data: dict | None = None) -> None: class MCPServer: def __init__(self, root: Path, *, purpose: Purpose | str, advanced: bool = False, + route_page_bytes: int | None = None, output_schemas: OutputSchemaDelivery | str = OutputSchemaDelivery.EAGER, observation: RecorderConfig | None = None) -> None: self.root = root.resolve() self._purpose = Purpose(purpose) + self._route_page_bytes = admit_route_page_bytes(route_page_bytes) self.advanced = advanced self.output_schemas = OutputSchemaDelivery(output_schemas) self._interface = AgentToolFacade.load_interface(self.root) @@ -56,7 +82,8 @@ def __init__(self, root: Path, *, purpose: Purpose | str, advanced: bool = False self._interface, purpose=self.purpose, operation_names=self.names, catalog_digest=self._runtime_identity.metadata()["catalog_digest"], ) - self._compiled_cache = CompiledSnapshotCache(self.root, self.purpose) + # Opened by the first store-backed tool call; see _invoke. + self._facade: AgentToolFacade | None = None self._observer = (InteractionRecorder(observation, self._runtime_identity.metadata(), self.tools) if observation is not None else None) self._closed = False @@ -68,16 +95,55 @@ def purpose(self) -> Purpose: return self._purpose def close(self) -> None: - """Close process-owned capture and cache; each tool call closes its domain store.""" - if self._observer is not None: - self._observer.close() - self._compiled_cache.close() - self._interface = None - self._runtime_identity = None - self._contract_discovery = None - self.tools.clear() - self.names.clear() - self._closed = True + """Close the process's Engine, with its cache, and its capture.""" + try: + self._close_engine() + finally: + if self._observer is not None: + self._observer.close() + self._interface = None + self._runtime_identity = None + self._contract_discovery = None + self.tools.clear() + self.names.clear() + self._closed = True + + def _close_engine(self) -> None: + facade, self._facade = self._facade, None + if facade is not None: + facade.close() + + def _invoke(self, name: str, arguments: dict) -> dict: + """Run one store-backed tool call on this process's Engine. + + The facade, its Engine and the compilation cache are opened by the + first call that needs them and serve every later call. The store + connection is not kept: each call opens one, running the admission a + new open of the store runs, and closes it when the call ends. Between + calls the process therefore holds no store connection, lock or open + store file, and every call observes the store exactly as when each + call opened its own Engine: another process's writes, a migration, a + changed schema, due maintenance, and a store file that was replaced, + removed or overwritten. A relocated root and a replaced or missing + store file close the Engine so that a new one is opened and audited. + An Engine that reports an unclassified failure is closed straight away. + """ + facade = self._facade + if facade is not None and not facade.readmit(): + self._close_engine() + facade = None + if facade is None: + facade = self._facade = AgentToolFacade.open_repository( + self.root, purpose=self.purpose, interface=self._interface, + route_page_bytes=self._route_page_bytes, + ) + value = getattr(facade, name)(arguments) + # Closing rolls back a transaction the operation did not end, as it + # always has. A raised failure closes the whole Engine instead. + facade.release() + if not facade.reusable: + self._close_engine() + return value def dispatch(self, message: object) -> dict | None: return self._handle(message) @@ -174,11 +240,12 @@ def _request(self, method: str, params: dict) -> dict: "capabilities": {"tools": {"listChanged": False}}, "serverInfo": {"name": "standards-engine", "version": self._runtime_identity.implementation_version}, "_meta": {"standards-engine/runtime": self._runtime_identity.metadata()}, - "instructions": f"Installed interface {self._interface.interface.interface_schema_version}; purpose {self.purpose.value}. Output schemas {self.output_schemas.value}. " + "instructions": APPLICATION_INSTRUCTIONS.format( + interface=self._interface.interface.interface_schema_version) + if self.purpose is Purpose.APPLICATION else + f"Installed interface {self._interface.interface.interface_schema_version}; purpose {self.purpose.value}. Output schemas {self.output_schemas.value}. " "Use describe_input for missing or abbreviated input shapes; retain its catalog-bound selections. " "Use describe_output only when an exact result contract is needed; ordinary results remain structured and server-validated. " + ( - "Use route with content={} to obtain applicable exact guidance; follow content.next for more. Reuse returned snapshots for consistent observations." - if self.purpose is Purpose.APPLICATION else "Use explicit routing facts and preserve opaque handles. Follow typed Engine outcomes and next_operations. Standards mutations belong to the Engine. Recovery-required continues through recover with the same context, never an apply retry." + ( " Native advanced operations use recover_application with readiness." @@ -210,15 +277,17 @@ def _request(self, method: str, params: dict) -> dict: value = self._runtime_identity.invoke(arguments) return self._tool_result(value) try: - # Opening per call matches the reference transport and avoids keeping - # store state alive across idle client sessions. No operation retries. with redirect_stdout(sys.stderr): - with AgentToolFacade.open_repository( - self.root, purpose=self.purpose, interface=self._interface, - compiled_cache=self._compiled_cache, - ) as facade: - value = getattr(facade, name)(arguments) - except Exception as error: + value = self._invoke(name, arguments) + except BaseException as error: + # The outcome is unknown and so is the Engine's state. Close it; the + # next call opens a new one. No operation retries. + try: + self._close_engine() + except Exception as failure: + print(f"Engine close failed: {type(failure).__name__}", file=sys.stderr) + if not isinstance(error, Exception): + raise if self.purpose is Purpose.APPLICATION: print( f"Application invocation failed: {type(error).__name__}", @@ -291,22 +360,38 @@ def main() -> int: action="store_true", help="Expose additional operations within the configured purpose.", ) + parser.add_argument( + "--route-page-bytes", type=int, + help=f"Application purpose only: byte budget of one route content page, measured on one JSON " + f"serialization of the result ({ROUTE_PAGE_MIN_BYTES} to {ROUTE_CONTENT_RESULT_BYTES}; default " + f"{ROUTE_PAGE_BYTES}). A page always holds at least one whole item.", + ) parser.add_argument( "--output-schemas", choices=[choice.value for choice in OutputSchemaDelivery], default=OutputSchemaDelivery.EAGER.value, help="Advertise complete output schemas (eager, default), or retrieve exact contracts through describe_output (on-demand).", ) parser.add_argument('--observe-database', type=Path, - help='Opt in to operator-only local SQLite observations in a trusted directory.') - parser.add_argument('--observe-deployment', help='Required nonsensitive deployment label when recording.') + help='Record operator-only observations in this SQLite file instead of the default location; its directory must exist.') + parser.add_argument('--observe-deployment', default=DEFAULT_DEPLOYMENT, + help='Nonsensitive deployment label stored with each recorded session.') + parser.add_argument('--no-observe', action='store_true', + help='Do not record this process. STANDARDS_ENGINE_OBSERVE=off does the same.') parser.add_argument('--observe-max-calls', type=int, default=DEFAULT_MAX_CALLS) parser.add_argument('--observe-max-age-seconds', type=int, default=DEFAULT_MAX_AGE_SECONDS) parser.add_argument('--observe-max-bytes', type=int, default=DEFAULT_MAX_BYTES) arguments = parser.parse_args() - if (arguments.observe_database is None) != (arguments.observe_deployment is None): - parser.error('--observe-database and --observe-deployment must be supplied together') + if arguments.route_page_bytes is not None: + if arguments.purpose != Purpose.APPLICATION.value: + parser.error("--route-page-bytes applies to the application purpose") + try: + admit_route_page_bytes(arguments.route_page_bytes) + except ValueError as error: + parser.error(str(error)) + # Recording is on for every server process. Only these two switches turn it + # off; in-process MCPServer construction records only when given a configuration. observation = None - if arguments.observe_database is not None: + if not arguments.no_observe and os.environ.get('STANDARDS_ENGINE_OBSERVE', '').strip().lower() != 'off': try: observation = RecorderConfig(arguments.observe_database, arguments.observe_deployment, arguments.observe_max_calls, arguments.observe_max_age_seconds, @@ -315,6 +400,7 @@ def main() -> int: parser.error(str(error)) serve( MCPServer(arguments.repo_root, purpose=arguments.purpose, advanced=arguments.advanced, + route_page_bytes=arguments.route_page_bytes, output_schemas=arguments.output_schemas, observation=observation), sys.stdin, sys.stdout, diff --git a/tools/standards_engine/standards_engine/mcp_catalog.py b/tools/standards_engine/standards_engine/mcp_catalog.py index 94c6db84..8cc4343d 100644 --- a/tools/standards_engine/standards_engine/mcp_catalog.py +++ b/tools/standards_engine/standards_engine/mcp_catalog.py @@ -100,8 +100,8 @@ "create_proposal": "Propose an atomic standards change with explicit domain intent and evidence against a snapshot.", "find_proposals": "Find durable proposals and their current revision handles.", "revise_proposal": "Append an atomic change to the exact expected proposal revision; stale revisions are rejected.", - "query_proposal": "Read, route, or traverse authoring content within an exact immutable proposal revision. Use preview_application to inspect its qualified application view.", - "preview_application": "Inspect an exact unpublished revision through the ordinary application qualification and filtering rules. Supply one read, route, or related request. Results and continuations stay bound to the draft; this operation neither publishes content nor approves review or exposure.", + "query_proposal": "Read, route, or traverse authoring content within an exact immutable proposal revision. Use preview_application to inspect its application view.", + "preview_application": "Inspect an exact unpublished revision as an application agent would receive it: every selected or named registered item is delivered with its review_state label (current, changed-since-review or not-reviewed). Supply one read, route, or related request. Results and continuations stay bound to the draft; this operation neither publishes content nor approves review or exposure.", "analyze_proposal": "Analyze an exact proposal revision and return unresolved consequences or complete analysis.", "review_proposal": "Accept complete current proposal analysis with explicit evidence-backed review decisions; return content-bound readiness. Requires user authorization for review.", "verify_proposal": "Verify the exact proposal candidate. Coverage audits require readiness. Verification does not supply review decisions or publish.", @@ -112,18 +112,19 @@ } +# Each application description opens with what the tool is for, in plain words. APPLICATION_DESCRIPTIONS = { - "describe_output": DESCRIPTIONS["describe_output"], - "relationship_groups": DESCRIPTIONS["relationship_groups"], - "describe_input": DESCRIPTIONS["describe_input"], - "runtime_info": DESCRIPTIONS["runtime_info"], - "read_many": "Read 1–32 selected reviewed items from one explicit snapshot in order. Each item supplies target and optional detail. The complete JSON result is limited to 2 MiB; an unavailable item rejects the whole request.", - "route": "Supply raw values in facts or one-field state markers for unknown/known-absent; omitted facts stay unknown. Types come from the qualified snapshot, not the request. Select applicable guidance from registered facts and a complete qualified dependency closure. Request content={} for selected exact guidance in this call: default 8, maximum 32 whole reads, 2 MiB total result. Follow content.next unchanged. Missing facts remain unresolved. Omit content for selection only; read_many accepts an explicit subset.", - "read": "Read a reviewed standard, example, or operational aid by identity. Full detail adds permitted relationships.", - "related": "Discover relationships among qualified guidance in one snapshot. Use relationship_groups for permitted IDs and meanings. Unknown groups return choices; an empty valid query remains successful.", - "routing_facts": "Read the reviewed vocabulary for routing a task. Supply known facts and retain unresolved conditions.", - "query": "Route, read, or traverse qualified guidance within the supplied snapshot.", - "inspect": "Inspect a permitted policy or relationship handle within its captured snapshot.", + "routing_facts": "Lists the facts you can state about a task: each fact's exact name, meaning, type and allowed values. Call it once, before your first route, and copy names and values exactly as listed. Omit snapshot to capture the current accepted standards; keep the returned snapshot and pass it to later calls.", + "route": "Returns the standards that apply to your task. Put the facts that are true of the task in facts, with names and values exactly as routing_facts lists them. Leave out a fact you do not know: it stays unknown and comes back in unresolved_questions. Do not remove a true fact to make a call succeed. For a fact you know is absent use {\"state\":\"known-absent\"}. Pass content={} to receive the text with the selection: reading_plan lists every selected module with its review_state, and content.items holds whole modules for this page. A page is sized for inline display (about 40 KB by default, at most content.limit items, default 8, maximum 32) and always holds at least one whole module. While content.next is present, call route again with exactly those arguments. Every selected module is delivered; review_state (current, changed-since-review or not-reviewed) says whether its text was approved for application use, not whether it applies. Omit snapshot on the first call and pass the returned snapshot afterwards. Omit content for the selection only.", + "read": "Returns the full text of one standard, example or operational aid by its ID, with its review_state. Use an ID exactly as a route, read or related result gave it; an unregistered ID is rejected, never guessed. detail=full adds the module's relationships. Pass the snapshot you already hold: a module you have read at that snapshot has not changed.", + "read_many": "Returns the full text of several modules by ID in one call, in the order asked, each with its review_state. Requires the snapshot returned by route or read. Each item gives target and optional detail. Ask for two or three modules per call so your client can show the whole result; the hard limits are 32 items and 2 MiB. An unregistered ID rejects the whole call and returns no items.", + "related": "Lists how one module relates to others, such as what it requires, specializes or affects. Name the groups to follow: relationship_groups lists the valid group IDs and the directions and transitive traversal each permits. An unknown group returns the valid choices. A valid query with no relationships is a normal empty result.", + "relationship_groups": "Lists the relationship group IDs that related accepts, with each group's meaning, permitted directions and whether transitive traversal is allowed. Pages hold 8 groups by default (maximum 32, 16 KiB); follow next exactly. Omit snapshot to capture the current accepted standards and reuse the returned snapshot with related. A listed group may have no relationships for a given module.", + "inspect": "Returns the detail behind a handle that an earlier result gave you: a policy handle returns that module in full, a relationship handle returns that relationship. Pass the handle unchanged.", + "query": "Advanced form of route, read and related: one native request against an explicit snapshot. Results carry the same review_state labels. Prefer route, read and related.", + "describe_input": "Shows the exact argument shape of a tool when your client abbreviates a field as unknown. Start with operation only. Read schema_json documents; $refs name selectable definitions. Select a referenced name with selector and expected_catalog from the result. Pages contain up to 16 whole records (default 8), 16 KiB result JSON; follow next unchanged for the complete selected closure. Reuse acquired shapes while catalog_digest matches. No standards state or permissions change.", + "describe_output": "Shows the exact result shape of a tool. Ordinary results are already structured, so you rarely need it. Start with operation; follow next for all records or select a referenced definition with expected_catalog. Combine root_schema_json with all records as $defs to validate a result. schema_digest binds the full output contract, not an approval.", + "runtime_info": "Reports which interface version, tool catalog and installation this running server has, without reading any standards. Supply expected_catalog to compare your client's catalog. Restart and reconnect after the server is replaced; refresh tools when only the client catalog differs.", } @@ -148,12 +149,15 @@ def tool_catalog( name = operation["id"] if not advanced and name not in FOCUSED_OPERATIONS: continue - description = APPLICATION_DESCRIPTIONS[name] if purpose is Purpose.APPLICATION else DESCRIPTIONS[name] + application = purpose is Purpose.APPLICATION + description = APPLICATION_DESCRIPTIONS[name] if application else DESCRIPTIONS[name] if name != "describe_input": - description = ( + hint = ( f'For abbreviated input fields, call describe_input(operation="{name}") ' - "and reuse the returned contract while its catalog matches. " + description + "and reuse the returned contract while its catalog matches." ) + # An application agent reads the tool's purpose first; the hint follows. + description = f"{description} {hint}" if application else f"{hint} {description}" if purpose is Purpose.AUTHORING and "agent" in operation.get("variants", {}): description += ( " Optional evidence maps request-local names to complete exact evidence references; " diff --git a/tools/standards_engine/standards_engine/tools.py b/tools/standards_engine/standards_engine/tools.py index ca40b574..eacef588 100644 --- a/tools/standards_engine/standards_engine/tools.py +++ b/tools/standards_engine/standards_engine/tools.py @@ -136,6 +136,7 @@ def open_repository( cls, root: Path, *, purpose: Purpose | str, interface: CompiledContracts | None = None, compiled_cache: CompiledSnapshotCache | None = None, + route_page_bytes: int | None = None, ) -> AgentToolFacade: repo_root = root.resolve() engine = StandardsEngine.open_repository( @@ -145,6 +146,7 @@ def open_repository( ), purpose=purpose, compiled_cache=compiled_cache, + route_page_bytes=route_page_bytes, ) try: return cls(engine, interface if interface is not None else _contracts(repo_root)) @@ -164,6 +166,22 @@ def load_interface(root: Path) -> CompiledContracts: def close(self) -> None: self._engine.close() + def release(self) -> None: + """Close the store connection after a call; the facade and engine stay.""" + self._engine.release() + + def readmit(self) -> bool: + """Open the store for another call; False means open a new facade. + + See `StandardsEngine.readmit`. Admission failures are raised. + """ + return self._engine.readmit() + + @property + def reusable(self) -> bool: + """False once the engine must be closed instead of serving another call.""" + return self._engine.reusable + def __enter__(self) -> AgentToolFacade: return self @@ -598,4 +616,9 @@ def _contracts(root: Path) -> CompiledContracts: schema = json.loads((root / INTERFACE_SCHEMA).read_text(encoding="utf-8")) with (root / INTERFACE_CONTRACT).open("rb") as source: interface = tomllib.load(source) - return compile_contracts(schema, interface) + # The generator validated the schema whose digest the generated contract + # records. Only a schema that differs from it is validated again here. + return compile_contracts( + schema, interface, + validated_schema_digest=generated_contract.VALIDATED_SCHEMA_DIGEST, + ) diff --git a/tools/standards_engine/tests/agent_efficiency_trace.py b/tools/standards_engine/tests/agent_efficiency_trace.py index 82135c23..7beb7135 100644 --- a/tools/standards_engine/tests/agent_efficiency_trace.py +++ b/tools/standards_engine/tests/agent_efficiency_trace.py @@ -1,21 +1,22 @@ -"""Measure cold MCP calls and exact outcomes in disposable repositories. +"""Measure MCP stdio calls and exact outcomes in disposable repositories. This controlled same-build comparison separates wire presentation from policy and state identity. Catalog bytes are comparable with an archived baseline catalog; request/result bytes are not model tokens or billing measurements. No publication -or model turn is performed. Run with PYTHONPATH=. and the selected Engine Python. +or model turn is performed. One server process answers each trace and is replaced +only where a result must not depend on the process that produced the first one. +Run with PYTHONPATH=. and the selected Engine Python. """ from __future__ import annotations import json -import os from pathlib import Path -import subprocess import sys import tempfile from tools.standards_engine.standards_engine import StandardsEngine from tools.standards_engine.standards_engine.mcp_catalog import tool_catalog +from tools.standards_engine.tests.stdio_server import StdioServer from tools.standards_engine.tests.test_analysis import _clone_tracked_worktree from tools.standards_engine.tests.test_agent_workflow import decisions from tools.standards_engine.tests.test_request_evidence import shared @@ -29,32 +30,19 @@ def encoded_bytes(value: object) -> int: return len(json.dumps(value).encode("utf-8")) -class ColdClient: +class TraceClient: """Only protocol transport and measurement; decisions remain fixture-owned.""" def __init__(self, root: Path, purpose: str): self.root, self.purpose = root, purpose self.calls: list[dict] = [] + self._server: StdioServer | None = None def call(self, name: str, arguments: dict, *, rejected: bool = False) -> dict: - messages = [ - {"jsonrpc": "2.0", "id": 1, "method": "initialize", "params": { - "protocolVersion": "2025-11-25", "capabilities": {}, - "clientInfo": {"name": "agent-efficiency-trace", "version": "1"}, - }}, - {"jsonrpc": "2.0", "method": "notifications/initialized"}, - {"jsonrpc": "2.0", "id": 2, "method": "tools/call", "params": { - "name": name, "arguments": arguments, - }}, - ] - response = subprocess.run( - [sys.executable, "-P", "-m", "tools.standards_engine.standards_engine.mcp", - "--repo-root", str(self.root), "--purpose", self.purpose], - input="".join(json.dumps(item) + "\n" for item in messages), - text=True, capture_output=True, check=True, env=os.environ.copy(), - ) - replies = [json.loads(line) for line in response.stdout.splitlines()] - selected = next(item for item in replies if item.get("id") == 2) + if self._server is None: + self._server = StdioServer(self.root, purpose=self.purpose, client="agent-efficiency-trace", + silent=False) + selected = self._server.call(name, arguments) if "error" in selected: raise AssertionError(selected) wire = selected["result"] @@ -65,6 +53,12 @@ def call(self, name: str, arguments: dict, *, rejected: bool = False) -> dict: "result_bytes": encoded_bytes(value)}) return value + def close(self) -> None: + """End the server process; a later call is answered by a new one.""" + if self._server is not None: + server, self._server = self._server, None + server.close() + def totals(calls: list[dict]) -> dict: return {"call_count": len(calls), "calls": calls, @@ -73,16 +67,21 @@ def totals(calls: list[dict]) -> dict: def route_trace(root: Path, snapshot: dict, purpose: str) -> dict: - client = ColdClient(root, purpose) - arguments = {"facts": {}, "snapshot": snapshot} - selected = client.call("route", arguments) - targets = list(dict.fromkeys(item["target"] for item in selected["reading_plan"] - if item["state"] == "selected")) - assert 1 <= len(targets) <= 32 - grouped = client.call("read_many", {"snapshot": snapshot, "items": [{"target": t} for t in targets]}) - split_calls = list(client.calls) - client.calls.clear() - composed = client.call("route", {**arguments, "content": {"limit": 32}}) + client = TraceClient(root, purpose) + try: + arguments = {"facts": {}, "snapshot": snapshot} + selected = client.call("route", arguments) + targets = list(dict.fromkeys(item["target"] for item in selected["reading_plan"] + if item["state"] == "selected")) + assert 1 <= len(targets) <= 32 + grouped = client.call("read_many", {"snapshot": snapshot, "items": [{"target": t} for t in targets]}) + split_calls = list(client.calls) + client.calls.clear() + # A new process composes the route: equality with the separate calls is not process memory. + client.close() + composed = client.call("route", {**arguments, "content": {"limit": 32}}) + finally: + client.close() assert composed["reading_plan"] == selected["reading_plan"] assert composed["unresolved_questions"] == selected["unresolved_questions"] assert composed["content"]["items"] == grouped["items"] @@ -94,27 +93,32 @@ def route_trace(root: Path, snapshot: dict, purpose: str) -> dict: def evidence_trace(root: Path) -> dict: - client = ColdClient(root, "authoring") - pending = client.call("propose", {"change_set": topic_change(root, "evidence-trace-native", 4)}) - arguments = {"context": pending["context"], - "submissions": [decision(root, item["obligation"]) for item in pending["work"]["items"]]} - client.calls.clear() - ordinary = client.call("resolve_many", arguments) - assert ordinary["status"] == "complete", ordinary - review_args = {"context": ordinary["context"], "decisions": decisions(root)} - ready = client.call("review", review_args) - assert ready["status"] == "ready", ready - inline_calls = list(client.calls) - client.calls.clear() - equivalent = client.call("resolve_many", shared(arguments)) - assert equivalent == ordinary - shared_ready = client.call("review", shared(review_args)) - assert shared_ready == ready - shared_calls = list(client.calls) - forgotten = shared(arguments) - del forgotten["evidence"] - client.call("resolve_many", forgotten, rejected=True) - reconstructed = client.call("workflow_status", {"context": ready["context"]}) + client = TraceClient(root, "authoring") + try: + pending = client.call("propose", {"change_set": topic_change(root, "evidence-trace-native", 4)}) + arguments = {"context": pending["context"], + "submissions": [decision(root, item["obligation"]) for item in pending["work"]["items"]]} + client.calls.clear() + ordinary = client.call("resolve_many", arguments) + assert ordinary["status"] == "complete", ordinary + review_args = {"context": ordinary["context"], "decisions": decisions(root)} + ready = client.call("review", review_args) + assert ready["status"] == "ready", ready + inline_calls = list(client.calls) + client.calls.clear() + equivalent = client.call("resolve_many", shared(arguments)) + assert equivalent == ordinary + shared_ready = client.call("review", shared(review_args)) + assert shared_ready == ready + shared_calls = list(client.calls) + forgotten = shared(arguments) + del forgotten["evidence"] + client.call("resolve_many", forgotten, rejected=True) + # Cold readback: a new process reconstructs the reviewed state from its context alone. + client.close() + reconstructed = client.call("workflow_status", {"context": ready["context"]}) + finally: + client.close() assert reconstructed["status"] == "ready" assert reconstructed["context"] == ready["context"] return {"schema_mode": "native", "inline": totals(inline_calls), "shared": totals(shared_calls), @@ -152,7 +156,7 @@ def measure() -> dict: "description_bytes": sum(len(t["description"].encode()) for t in catalog), "input_schema_bytes": sum(encoded_bytes(t["inputSchema"]) for t in catalog), "output_schema_bytes": sum(encoded_bytes(t["outputSchema"]) for t in catalog)}) - return {"python": sys.version, "transport": "cold-mcp-stdio", "model_turns": 0, + return {"python": sys.version, "transport": "mcp-stdio", "model_turns": 0, "comparison": "same-build, same-snapshot and exact immutable analysis/readiness", "routing": reports, "evidence": evidence_reports, "catalogs": catalogs} diff --git a/tools/standards_engine/tests/codex_discovery_client.py b/tools/standards_engine/tests/codex_discovery_client.py index 770bcdfa..d036d884 100644 --- a/tools/standards_engine/tests/codex_discovery_client.py +++ b/tools/standards_engine/tests/codex_discovery_client.py @@ -422,7 +422,7 @@ async def run(arguments) -> dict: # Run-owned fixture coordinates take precedence over operator surface choices. command.extend(['-c', 'analytics.enabled=false', '-c', f'mcp_servers.{server}.command={json.dumps(sys.executable)}', - '-c', f'mcp_servers.{server}.args={json.dumps(["-P", "-m", "tools.standards_engine.standards_engine.mcp", "--repo-root", str(fixture), "--purpose", "authoring", "--output-schemas", arguments.output_schemas])}', + '-c', f'mcp_servers.{server}.args={json.dumps(["-P", "-m", "tools.standards_engine.standards_engine.mcp", "--repo-root", str(fixture), "--purpose", "authoring", "--output-schemas", arguments.output_schemas, "--no-observe"])}', '-c', f'mcp_servers.{server}.env.PYTHONPATH={json.dumps(str(ROOT))}']) events = [] report = {'observer_version': OBSERVER_VERSION, 'status': 'unavailable', 'client_version': version, 'requested_model': arguments.model, diff --git a/tools/standards_engine/tests/codex_navigation_client.py b/tools/standards_engine/tests/codex_navigation_client.py index ab4419d8..db153307 100644 --- a/tools/standards_engine/tests/codex_navigation_client.py +++ b/tools/standards_engine/tests/codex_navigation_client.py @@ -26,6 +26,10 @@ async def main(server_name, output_schemas="eager"): "--stdio", "-c", "analytics.enabled=false", + # A scripted check is not agent behaviour: keep it out of the + # configured server's always-on interaction recording. + "-c", + f'mcp_servers.{server_name}.env.STANDARDS_ENGINE_OBSERVE="off"', stdin=asyncio.subprocess.PIPE, stdout=asyncio.subprocess.PIPE, stderr=log, diff --git a/tools/standards_engine/tests/mcp_policy_registration_client.py b/tools/standards_engine/tests/mcp_policy_registration_client.py index 89d18e7d..4002c155 100644 --- a/tools/standards_engine/tests/mcp_policy_registration_client.py +++ b/tools/standards_engine/tests/mcp_policy_registration_client.py @@ -66,7 +66,7 @@ def parameters(purpose="authoring"): return StdioServerParameters( command=engine_python, args=["-P", "-m", "tools.standards_engine.standards_engine.mcp", - "--purpose", purpose, "--repo-root", str(repo)], + "--purpose", purpose, "--repo-root", str(repo), "--no-observe"], env={**os.environ, "PYTHONPATH": str(ROOT)}, ) diff --git a/tools/standards_engine/tests/mcp_workflow_client.py b/tools/standards_engine/tests/mcp_workflow_client.py index c55530a8..72f0acf5 100644 --- a/tools/standards_engine/tests/mcp_workflow_client.py +++ b/tools/standards_engine/tests/mcp_workflow_client.py @@ -51,7 +51,7 @@ def parameters(interrupted=False, *, purpose="authoring"): ) return StdioServerParameters( command=engine_python, - args=["-P", *launch, "--purpose", purpose, "--repo-root", str(repo)], + args=["-P", *launch, "--purpose", purpose, "--repo-root", str(repo), "--no-observe"], env={**os.environ, "PYTHONPATH": str(ROOT)}, ) @@ -283,7 +283,7 @@ async def call(client, name, arguments, *, error=False): assert all(item["snapshot"] == visible["snapshot"] for item in grouped["items"]) assert "AUTHORING_SDK_MARKER_843015" not in json.dumps(grouped) hidden = await call(client, "read", {"target": "provenance.purpose-client"}, error=True) - assert hidden["code"] == "APPLICATION.CONTENT_UNAVAILABLE", hidden + assert hidden["code"] == "APPLICATION.UNKNOWN_TARGET", hidden return { "client": "official MCP Python SDK", diff --git a/tools/standards_engine/tests/parallel_unittest.py b/tools/standards_engine/tests/parallel_unittest.py new file mode 100644 index 00000000..6c98aa7c --- /dev/null +++ b/tools/standards_engine/tests/parallel_unittest.py @@ -0,0 +1,155 @@ +"""Run a unittest suite across cores, one `python -m unittest` process per test module. + +unittest still discovers and runs every test. This module only starts one +worker per test module, at most --jobs at a time, and adds up what they report. +It fails when a worker fails, and when the workers together ran a different +number of tests than one serial discovery finds, so no test can disappear. + + PYTHONPATH=. python3 -m tools.standards_engine.tests.parallel_unittest + +The Engine suite is the default; -s selects another suite's test directory. +""" +from __future__ import annotations + +import argparse +from concurrent.futures import ThreadPoolExecutor, as_completed +import json +import os +from pathlib import Path +import re +import subprocess +import sys +import time + +# Runs in a child interpreter started like `python -m unittest`, so discovery +# imports test modules exactly as a worker will and never into this process. +DISCOVER = r''' +import json, os, sys, unittest +modules = {} +class Loader(unittest.TestLoader): + def loadTestsFromModule(self, module, *args, **options): + tests = super().loadTestsFromModule(module, *args, **options) + name = os.path.basename(module.__file__) + modules[name] = modules.get(name, 0) + tests.countTestCases() + return tests +def cases(suite): + for item in suite: + if isinstance(item, unittest.TestSuite): + yield from cases(item) + else: + yield item +suite = Loader().discover(sys.argv[1], pattern=sys.argv[2], top_level_dir=sys.argv[3] or None) +for case in cases(suite): + # A module that cannot be imported is one failing test named after it. + if type(case).__name__ == '_FailedTest': + name = case._testMethodName.rsplit('.', 1)[-1] + '.py' + modules[name] = modules.get(name, 0) + 1 +print('DISCOVERED ' + json.dumps({'total': suite.countTestCases(), 'modules': modules})) +''' +RAN = re.compile(r'^Ran (\d+) tests? in ', re.MULTILINE) +DURATION = re.compile(r'^(\d+\.\d+)s\s+(\S.*)$') + + +def discover(arguments: argparse.Namespace) -> dict: + """Count the tests of every module with one serial discovery in a child interpreter.""" + child = subprocess.run( + [sys.executable, '-c', DISCOVER, arguments.start_directory, arguments.pattern, + arguments.top_level_directory or ''], + capture_output=True, text=True) + lines = [line for line in child.stdout.splitlines() if line.startswith('DISCOVERED ')] + if child.returncode != 0 or not lines: + raise SystemExit(f'Test discovery failed.\n{child.stdout}{child.stderr}') + return json.loads(lines[-1].removeprefix('DISCOVERED ')) + + +def run_module(arguments: argparse.Namespace, module: str) -> dict: + command = [sys.executable, '-m', 'unittest', 'discover', '-s', arguments.start_directory, '-p', module] + if arguments.top_level_directory: + command += ['-t', arguments.top_level_directory] + if arguments.durations is not None: + command += ['--durations', str(arguments.durations)] + if arguments.verbose: + command.append('-v') + started = time.monotonic() + worker = subprocess.run(command, stdout=subprocess.PIPE, stderr=subprocess.STDOUT, text=True, errors='replace') + ran = RAN.findall(worker.stdout) + return {'module': module, 'status': worker.returncode, 'output': worker.stdout, + 'ran': int(ran[-1]) if ran else 0, 'seconds': time.monotonic() - started} + + +def durations(output: str) -> list[tuple[float, str]]: + """The per-test times unittest printed under `Slowest test durations`.""" + rows, listing = [], False + for line in output.splitlines(): + if line == 'Slowest test durations': + listing = True + elif listing and (match := DURATION.match(line)): + rows.append((float(match[1]), match[2])) + elif listing and line.startswith('Ran '): + listing = False + return rows + + +def main(argv: list[str] | None = None) -> int: + parser = argparse.ArgumentParser(description=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter) + parser.add_argument('-s', '--start-directory', default=os.path.relpath(Path(__file__).resolve().parent), + help='Directory to discover tests in; default: the Engine tests beside this module.') + parser.add_argument('-p', '--pattern', default='test*.py') + parser.add_argument('-t', '--top-level-directory') + parser.add_argument('-j', '--jobs', type=int, + help='Worker processes at a time; default: the cores this process may use.') + parser.add_argument('--durations', type=int, metavar='N', + help='Show the N slowest tests of the whole suite (0 shows all); needs Python 3.12.') + parser.add_argument('-v', '--verbose', action='store_true', + help='Run workers with -v and show every worker\'s output, not only failures.') + arguments = parser.parse_args(argv) + if arguments.durations is not None and sys.version_info < (3, 12): + parser.error('--durations needs Python 3.12 or newer') + available = len(os.sched_getaffinity(0)) if hasattr(os, 'sched_getaffinity') else os.cpu_count() or 1 + jobs = arguments.jobs if arguments.jobs is not None else available + if jobs < 1: + parser.error('--jobs must be at least 1') + + started = time.monotonic() + discovered = discover(arguments) + modules = sorted(discovered['modules']) + if not discovered['total']: + print(f'No tests discovered in {arguments.start_directory}.') + return 1 + print(f'Running {discovered["total"]} tests from {len(modules)} modules in {arguments.start_directory}, ' + f'{min(jobs, len(modules))} at a time.', flush=True) + results = [] + with ThreadPoolExecutor(max_workers=jobs) as pool: + for future in as_completed([pool.submit(run_module, arguments, module) for module in modules]): + result = future.result() + results.append(result) + expected = discovered['modules'][result['module']] + if result['status'] == 0 and result['ran'] != expected: + result['status'] = f'ran {result["ran"]} of {expected} discovered tests' + passed = result['status'] == 0 + print(f'{"ok" if passed else "FAILED":6} {result["module"]}: {result["ran"]} tests in ' + f'{result["seconds"]:.1f}s', flush=True) + if arguments.verbose or not passed: + print(f'{"-" * 70}\n{result["output"].rstrip()}\n{"-" * 70}', flush=True) + + if arguments.durations is not None: + rows = sorted((row for result in results for row in durations(result['output'])), reverse=True) + print('\nSlowest test durations') + for seconds, name in rows[:arguments.durations or None]: + print(f'{seconds:.3f}s'.ljust(11) + name) + failed = sorted(result['module'] for result in results if result['status'] != 0) + ran = sum(result['ran'] for result in results) + print(f'\nRan {ran} tests in {time.monotonic() - started:.1f}s ({len(modules)} modules, ' + f'{min(jobs, len(modules))} at a time); serial discovery found {discovered["total"]}.') + if ran != discovered['total']: + print(f'FAILED: {discovered["total"] - ran} discovered tests did not run.') + return 1 + if failed: + print(f'FAILED (modules={len(failed)}): {", ".join(failed)}') + return 1 + print('OK') + return 0 + + +if __name__ == '__main__': + raise SystemExit(main()) diff --git a/tools/standards_engine/tests/stdio_server.py b/tools/standards_engine/tests/stdio_server.py new file mode 100644 index 00000000..55176f34 --- /dev/null +++ b/tools/standards_engine/tests/stdio_server.py @@ -0,0 +1,164 @@ +"""One real server process for as many calls as a test makes. + +The process is the production module, started the way an MCP client starts it. +Requests and responses are newline-delimited JSON-RPC on its pipes, so every +call still crosses the real transport; only the process start is not repeated. +Recording is always off: no launch here can reach a developer's database. +""" +from __future__ import annotations + +import json +import os +from pathlib import Path +import queue +import subprocess +import sys +import tempfile +import threading + +ROOT = Path(__file__).resolve().parents[3] +MODULE = 'tools.standards_engine.standards_engine.mcp' + + +class StdioServer: + """A started and initialized server; `close` ends it the way a client does.""" + + def __init__(self, root, *, purpose, options=(), client='test', cwd=None, silent=True, timeout=300): + self.silent = silent + self._timeout = timeout + self._identifier = 0 + # A file, not a pipe: a server that writes diagnostics can never block on it. + self._errors = tempfile.TemporaryFile() + try: + self._process = subprocess.Popen( + [sys.executable, '-P', '-m', MODULE, '--repo-root', str(root), '--purpose', purpose, + *options, '--no-observe'], + stdin=subprocess.PIPE, stdout=subprocess.PIPE, stderr=self._errors, text=True, cwd=cwd, + env={**os.environ, 'PYTHONPATH': str(ROOT)}) + except BaseException: + self._errors.close() + raise + self._lines = queue.Queue() + self._reader = threading.Thread(target=self._read, daemon=True) + self._reader.start() + try: + self.initialized = self.exchange('initialize', { + 'protocolVersion': '2025-11-25', 'capabilities': {}, + 'clientInfo': {'name': client, 'version': '1'}}) + self._send({'jsonrpc': '2.0', 'method': 'notifications/initialized'}) + except BaseException: + self._release() + raise + + def _read(self): + for line in self._process.stdout: + self._lines.put(line) + self._lines.put(None) + + def _send(self, message): + try: + self._process.stdin.write(json.dumps(message) + '\n') + self._process.stdin.flush() + except (BrokenPipeError, ValueError): + raise AssertionError(f'The server is not running: {self.stderr()}') from None + + def exchange(self, method, params=None): + """Send one request and return its JSON-RPC response.""" + self._identifier += 1 + self._send({'jsonrpc': '2.0', 'id': self._identifier, 'method': method, 'params': params or {}}) + try: + line = self._lines.get(timeout=self._timeout) + except queue.Empty: + self._stop() + raise AssertionError(f'No response to {method} within {self._timeout} seconds: {self.stderr()}') from None + if line is None: + self._stop() + raise AssertionError(f'The server exited before answering {method}: {self.stderr()}') + response = json.loads(line) + if response.get('id') != self._identifier: + raise AssertionError(f'Response {response.get("id")!r} does not answer request {self._identifier}.') + if self.silent and self.stderr(): + raise AssertionError(f'The server wrote to stderr during {method}: {self.stderr()}') + return response + + def call(self, name, arguments): + """Call one tool and return its JSON-RPC response.""" + return self.exchange('tools/call', {'name': name, 'arguments': arguments}) + + def stderr(self): + """Everything the process has written to stderr so far.""" + self._errors.seek(0) + return self._errors.read().decode(errors='replace') + + def _stop(self): + if self._process.poll() is None: + self._process.kill() + self._process.wait() + + def _release(self): + """Stop the process if it still runs and close every handle this object owns.""" + self._stop() + self._reader.join() + for stream in (self._process.stdin, self._process.stdout, self._errors): + try: + stream.close() + except BrokenPipeError: + pass + + def close(self): + """End input, require a clean exit, and return what the process wrote to stderr.""" + if self._errors.closed: + return '' + try: + try: + self._process.stdin.close() + except BrokenPipeError: + pass + try: + code = self._process.wait(timeout=self._timeout) + except subprocess.TimeoutExpired: + self._stop() + raise AssertionError(f'The server did not exit at end of input: {self.stderr()}') from None + errors = self.stderr() + finally: + self._release() + if code != 0: + raise AssertionError(f'The server exited with status {code}: {errors}') + if self.silent and errors: + raise AssertionError(f'The server wrote to stderr: {errors}') + return errors + + +class StdioServers: + """The servers of one test or one class: one process for each distinct launch. + + A launch is its repository, purpose and options. Register `close` as a + cleanup; it requires every process to have exited cleanly. + """ + + def __init__(self, *, client='test', cwd=None, silent=True): + self._settings = {'client': client, 'cwd': cwd, 'silent': silent} + self._servers = {} + + def server(self, root, purpose, *options): + """The running server for this launch, started on first use.""" + key = (str(root), purpose, options) + if key not in self._servers: + self._servers[key] = StdioServer(root, purpose=purpose, options=options, **self._settings) + return self._servers[key] + + def restart(self, root, purpose, *options): + """End this launch's process so that its next call starts a new one.""" + server = self._servers.pop((str(root), purpose, options), None) + if server is not None: + server.close() + + def close(self): + failures = [] + while self._servers: + try: + self._servers.popitem()[1].close() + except AssertionError as error: + failures.append(str(error)) + if failures: + raise AssertionError('\n'.join(failures)) diff --git a/tools/standards_engine/tests/test_agent_input_feedback.py b/tools/standards_engine/tests/test_agent_input_feedback.py index 91babebe..29717a88 100644 --- a/tools/standards_engine/tests/test_agent_input_feedback.py +++ b/tools/standards_engine/tests/test_agent_input_feedback.py @@ -10,7 +10,7 @@ from tools.standards_engine.standards_engine import AgentToolFacade, StandardsEngine from tools.standards_engine.standards_engine.tools import _contracts from tools.standards_engine.standards_engine.mcp import MCPServer -from tools.standards_engine.tests.test_mcp import initialize, request +from tools.standards_engine.tests.test_mcp import initialize, installation_root, request ROOT = Path(__file__).resolve().parents[3] @@ -76,8 +76,9 @@ def test_application_feedback_is_purpose_qualified_and_disabled_operations_stay_ self.interface.validate('ApplicationRejectedResult', result) def test_mcp_envelope_is_error_and_metadata_observers_use_safe_feedback(self): + root = installation_root(self) for purpose in ('authoring', 'application'): - server = MCPServer(ROOT, purpose=purpose) + server = MCPServer(root, purpose=purpose) self.addCleanup(server.close) initialize(server) for operation, arguments in (('runtime_info', {'expected_catalog': 'SECRET'}), diff --git a/tools/standards_engine/tests/test_agent_interaction_transport.py b/tools/standards_engine/tests/test_agent_interaction_transport.py index 03970523..91e0a2c9 100644 --- a/tools/standards_engine/tests/test_agent_interaction_transport.py +++ b/tools/standards_engine/tests/test_agent_interaction_transport.py @@ -1,17 +1,17 @@ """Cold stdio qualification of navigation and rejection feedback, without a model. -Every call replaces the process. The existing qualified-snapshot fixture keeps -production Git, standards and stores outside this transport test's write set. +Each test uses one server process per purpose and catalog delivery, and replaces +it where a continuation must be honoured by a process that did not issue it. The +existing qualified-snapshot fixture keeps production Git, standards and stores +outside this transport test's write set. """ from __future__ import annotations import json -import os -import subprocess -import sys import unittest from tools.standards_engine.tests import test_purpose_transport as fixture +from tools.standards_engine.tests.stdio_server import StdioServers from tools.standards_engine.tests.test_route_content import known_assertions @@ -26,38 +26,32 @@ def setUpClass(cls): def tearDownClass(cls): fixture.PurposeTransportTest.tearDownClass() + def setUp(self): + self.servers = StdioServers(client='interaction-fixture') + self.addCleanup(self.servers.close) + def call(self, purpose, operation, arguments, *, rejected=False, delivery="eager"): - messages = [ - {'jsonrpc': '2.0', 'id': 1, 'method': 'initialize', 'params': { - 'protocolVersion': '2025-11-25', 'capabilities': {}, - 'clientInfo': {'name': 'interaction-fixture', 'version': '1'}}}, - {'jsonrpc': '2.0', 'method': 'notifications/initialized'}, - {'jsonrpc': '2.0', 'id': 2, 'method': 'tools/call', - 'params': {'name': operation, 'arguments': arguments}}, - ] - process = subprocess.run( - [sys.executable, '-P', '-m', 'tools.standards_engine.standards_engine.mcp', - '--repo-root', str(self.root), '--purpose', purpose, - '--output-schemas', delivery], - env={**os.environ, 'PYTHONPATH': str(fixture.ROOT)}, text=True, - input=''.join(json.dumps(value) + '\n' for value in messages), - capture_output=True, timeout=90, - ) - self.assertEqual(process.returncode, 0, process.stderr) - self.assertEqual(process.stderr, '') - responses = {item['id']: item for item in map(json.loads, process.stdout.splitlines())} - self.assertNotIn('error', responses[2], responses[2]) - result = responses[2]['result'] + # One server process per purpose and catalog delivery serves every call of a test. + server = self.servers.server(self.root, purpose, '--output-schemas', delivery) + response = server.call(operation, arguments) + self.assertNotIn('error', response, response) + result = response['result'] self.assertEqual(result['isError'], rejected, result) self.assertEqual(json.loads(result['content'][0]['text']), result['structuredContent']) return result['structuredContent'] + def replace_server(self, purpose, delivery="eager"): + """End this purpose's server: its next call is answered by a new process.""" + self.servers.restart(self.root, purpose, '--output-schemas', delivery) + def test_cold_relationship_repair_and_pages_use_the_same_snapshot(self): for purpose in ('application', 'authoring'): with self.subTest(purpose=purpose): first = self.call(purpose, 'relationship_groups', {'snapshot': self.snapshot, 'limit': 1}) groups = list(first['items']) page = first + # Cold: a process that did not issue the continuations follows them. + self.replace_server(purpose) while 'next' in page: page = self.call(purpose, 'relationship_groups', page['next']) self.assertEqual(page['snapshot'], self.snapshot) @@ -86,6 +80,8 @@ def test_cold_compact_route_and_full_explanation_keep_uncertainty(self): 'content': {'limit': 1}}) self.assertEqual(len(route['unresolved_questions']), 6) self.assertEqual(route['status'], 'needs-facts') + # Cold: a process that did not route honours the page and explanation continuations. + self.replace_server(purpose) next_page = self.call(purpose, 'route', route['content']['next']) self.assertEqual(next_page['snapshot'], self.snapshot) self.assertEqual(next_page['unresolved_questions'], route['unresolved_questions']) @@ -103,6 +99,8 @@ def test_cold_invalid_proposal_has_usable_discovery_continuation(self): feedback = invalid['input_feedback'] self.assertEqual({item['instance_pointer'] for item in feedback['issues']}, {'/change_set/purpose', '/change_set/edits'}) + # Cold: a process that did not reject the proposal answers its discovery continuation. + self.replace_server('authoring') described = self.call('authoring', 'describe_input', feedback['describe_input']) self.assertEqual(described['root'], 'AgentProposeCall') self.assertEqual(described['operation'], 'propose') diff --git a/tools/standards_engine/tests/test_analysis.py b/tools/standards_engine/tests/test_analysis.py index 0eeaf032..0ae8a9e6 100644 --- a/tools/standards_engine/tests/test_analysis.py +++ b/tools/standards_engine/tests/test_analysis.py @@ -687,8 +687,39 @@ def apply_ready(readiness_id: str) -> ProposalApplication: } ) ) + # Apply advances this unchanged main checkout to its publication. + self.assertEqual(applied.checkout.status, "current") return engine._authoring.read_application(applied.application.id) + def assert_checkout_presents( + application: ProposalApplication, + present: tuple[str, ...], + absent: tuple[str, ...] = (), + ) -> None: + # Interface 47: HEAD, index and worktree all present the exact + # published candidate, and no other local difference appears. + self.assertEqual( + git_output(repository, ("rev-parse", "HEAD")).strip(), + application.candidate.oid.encode("ascii"), + ) + for path in present: + self.assertEqual( + (repository / path).read_bytes(), + engine._repository.read_file( + application.candidate, RepositoryPath.parse(path) + ), + path, + ) + for path in absent: + self.assertFalse((repository / path).exists(), path) + self.assertEqual( + git_output( + repository, + ("status", "--porcelain=v1", "--untracked-files=all"), + ), + b"", + ) + def assert_commit( application: ProposalApplication, revision: ProposalRevision, @@ -798,7 +829,10 @@ def assert_commit( impact_path: "100644", }, ) - self.assertFalse((repository / standard_path).exists()) + assert_checkout_presents( + create_application, + (standard_path, policy_path, impact_path), + ) facade.close() engine = StandardsEngine.open_repository( @@ -933,7 +967,11 @@ def assert_commit( ) self.assertIn(b"[[tombstone]]", retired_policy) self.assertNotIn(b"[[policy_unit]]", retired_policy) - self.assertFalse((repository / standard_path).exists()) + assert_checkout_presents( + retire_application, + (policy_path,), + absent=(standard_path, impact_path), + ) facade.close() engine = StandardsEngine.open_repository( diff --git a/tools/standards_engine/tests/test_authoring.py b/tools/standards_engine/tests/test_authoring.py index 5ae01550..1e04cfe8 100644 --- a/tools/standards_engine/tests/test_authoring.py +++ b/tools/standards_engine/tests/test_authoring.py @@ -27,7 +27,7 @@ from tools.standards_engine.standards_engine.logical_authoring import ( StandardsChangeSet, ) -from tools.repository_git.repository_git import RepositoryRevision +from tools.repository_git.repository_git import GitRepository, RepositoryRevision from tools.standards_engine.standards_engine.tools import _contracts from tools.standards_snapshots.standards_snapshots import ( AggregateRecord, @@ -136,8 +136,11 @@ def _authoring( ) -def _engine_with_stub_authoring(snapshots: SnapshotModule) -> StandardsEngine: - engine = StandardsEngine(object(), snapshots, purpose="authoring") # type: ignore[arg-type] +def _engine_with_stub_authoring(snapshots: SnapshotModule, root: Path) -> StandardsEngine: + # A real repository value rooted where these store-only fixtures keep no Git + # history: the Engine scopes its compilation cache to that root, and any + # Git access these tests did not intend fails instead of reading a checkout. + engine = StandardsEngine(GitRepository(root), snapshots, purpose="authoring") engine._authoring = _authoring(snapshots) return engine @@ -619,7 +622,7 @@ def test_create_and_find_are_durable_through_the_public_facade(self) -> None: snapshots = SnapshotModule.open(database) base = snapshots.create_snapshot(_capture()).snapshot with AgentToolFacade( - _engine_with_stub_authoring(snapshots), + _engine_with_stub_authoring(snapshots, repository), _contracts(REPOSITORY_ROOT), ) as facade: created = facade.create_proposal( @@ -677,7 +680,7 @@ def test_revise_is_durable_and_stale_writes_leave_no_partial_record(self) -> Non snapshots = SnapshotModule.open(database) base = snapshots.create_snapshot(_capture()).snapshot with AgentToolFacade( - _engine_with_stub_authoring(snapshots), + _engine_with_stub_authoring(snapshots, Path(temporary)), _contracts(REPOSITORY_ROOT), ) as facade: created = facade.create_proposal( @@ -690,7 +693,7 @@ def test_revise_is_durable_and_stale_writes_leave_no_partial_record(self) -> Non initial_revision = created["revision"] snapshots = SnapshotModule.open(database) - engine = _engine_with_stub_authoring(snapshots) + engine = _engine_with_stub_authoring(snapshots, Path(temporary)) def validate_revision(revision: object) -> None: change_sets = getattr(revision, "change_sets") @@ -870,7 +873,7 @@ def test_create_translates_invalid_change_set_unicode_to_a_typed_rejection( assert isinstance(purpose, dict) purpose["summary"] = "\ud800" with AgentToolFacade( - _engine_with_stub_authoring(snapshots), + _engine_with_stub_authoring(snapshots, Path(temporary)), _contracts(REPOSITORY_ROOT), ) as facade: rejected = facade.create_proposal( @@ -951,7 +954,7 @@ def test_discovery_rejects_the_old_revision_contract_as_unsupported(self) -> Non AggregateRecord(revision_id, "proposal-revision", payload, (base,)), ) with AgentToolFacade( - StandardsEngine(object(), snapshots, purpose="authoring"), # type: ignore[arg-type] + StandardsEngine(GitRepository(Path(temporary)), snapshots, purpose="authoring"), _contracts(REPOSITORY_ROOT), ) as facade: rejected = facade.find_proposals({"kind": "find-proposals"}) diff --git a/tools/standards_engine/tests/test_capture_handoff_transport.py b/tools/standards_engine/tests/test_capture_handoff_transport.py index afe05149..746c3b2f 100644 --- a/tools/standards_engine/tests/test_capture_handoff_transport.py +++ b/tools/standards_engine/tests/test_capture_handoff_transport.py @@ -12,6 +12,7 @@ import subprocess import sys import tempfile +import tomllib import unittest from tools.standards_engine.tests.test_analysis import _clone_tracked_worktree @@ -74,7 +75,9 @@ def call(method, params=None): try: initialized = call('initialize',{'protocolVersion':'2025-11-25','capabilities':{}, 'clientInfo':{'name':'capture-handoff-fixture','version':'1'}}) - self.assertEqual(initialized['_meta']['standards-engine/runtime']['interface_version'],48) + installed = tomllib.loads((self.root/'tools/standards_engine/contracts/a1-interface.toml').read_text()) + self.assertEqual(initialized['_meta']['standards-engine/runtime']['interface_version'], + installed['interface_schema_version']) process.stdin.write('{"jsonrpc":"2.0","method":"notifications/initialized"}\n') process.stdin.flush() def tool(name, arguments): diff --git a/tools/standards_engine/tests/test_consumer_publication.py b/tools/standards_engine/tests/test_consumer_publication.py index 43021335..e74f093a 100644 --- a/tools/standards_engine/tests/test_consumer_publication.py +++ b/tools/standards_engine/tests/test_consumer_publication.py @@ -1,50 +1,57 @@ """Proposal consumer publication through real MCP processes and Git/SQLite. -Every tool call reconnects a cold local stdio process. This tests the actual -wire boundary without requiring an optional SDK or the user's installed store. +Each test talks to one local stdio server process per purpose and replaces it +only where a claim is about a new process. This tests the actual wire boundary +without requiring an optional SDK or the user's installed store. """ from __future__ import annotations import json -import os from pathlib import Path import subprocess -import sys import tempfile +import tomllib import unittest -from tools.standards_engine.tests.test_agent_workflow import ROOT, decisions, evidence, prepare_repository +from tools.standards_engine.standards_engine.tools import INTERFACE_CONTRACT +from tools.standards_engine.tests.stdio_server import StdioServers +from tools.standards_engine.tests.test_agent_workflow import decisions, evidence, prepare_repository from tools.standards_engine.tests import test_proposal_consumers as fixtures from tools.standards_engine.tests.test_proposal_consumers import registration -class ConsumerPublicationTest(unittest.TestCase): +def installed_interface_version(root): + # The server announces the interface declared by the repository it serves. + # Read that declaration instead of repeating a number that each interface + # edition would otherwise leave stale here. + with (root / INTERFACE_CONTRACT).open('rb') as source: + return tomllib.load(source)['interface_schema_version'] + + +class PublicationWorkflowCase(unittest.TestCase): + """An isolated repository and its servers; subclasses choose how decisions are submitted.""" + + prepare = staticmethod(prepare_repository) + def setUp(self): self.temp = tempfile.TemporaryDirectory(prefix='consumer-publication-') self.addCleanup(self.temp.cleanup) self.root = Path(self.temp.name) / 'repository' - prepare_repository(self.root) + self.prepare(self.root) self.calls = [] + self.servers = StdioServers(client='consumer-publication-test') + self.addCleanup(self.servers.close) def rpc(self, method, params, purpose='authoring'): - messages=[ - {'jsonrpc':'2.0','id':1,'method':'initialize','params':{ - 'protocolVersion':'2025-11-25','capabilities':{}, - 'clientInfo':{'name':'consumer-publication-test','version':'1'}}}, - {'jsonrpc':'2.0','method':'notifications/initialized'}, - {'jsonrpc':'2.0','id':2,'method':method,'params':params}, - ] - process=subprocess.run( - [sys.executable,'-P','-m','tools.standards_engine.standards_engine.mcp', - '--repo-root',str(self.root),'--purpose',purpose,'--advanced'], - input=''.join(json.dumps(m)+'\n' for m in messages),text=True,capture_output=True, - env={**os.environ,'PYTHONPATH':str(ROOT)},timeout=180, - ) - self.assertEqual(process.returncode,0,process.stderr) - self.assertEqual(process.stderr,'') - responses={row['id']:row for row in map(json.loads,process.stdout.splitlines())} - self.assertIn('interface 47;',responses[1]['result']['instructions']) - return responses[2] + # One server process per purpose serves every call of a test. + server = self.servers.server(self.root, purpose, '--advanced') + self.assertIn(f'interface {installed_interface_version(self.root)};', + server.initialized['result']['instructions']) + return server.exchange(method, params) + + def restart(self, purpose='authoring'): + """Replace this purpose's server: its next call is answered by a new process.""" + self.servers.restart(self.root, purpose, '--advanced') def call(self,name,arguments,purpose='authoring',error=False): if name in {"propose", "revise", "analyze", "resolve_workflow", "workflow_status", "resume"}: @@ -62,6 +69,8 @@ def change(self,edits): 'rationale':'This isolated repository owns the synthetic review evidence.', 'evidence':[evidence(self.root)]},'edits':edits} + +class ConsumerPublicationTest(PublicationWorkflowCase): def complete(self,workflow): seen=set() while workflow.get('status')=='needs-action': @@ -115,12 +124,16 @@ def test_same_candidate_registration_preview_review_publication_and_cold_readbac self.assertEqual(preview['revision'],revision) self.assertNotIn('snapshot',preview);self.assertNotIn('handle',preview['policy']) self.assertNotIn('AUTHORING_PRIVATE_8159',json.dumps(preview)) - hidden=self.call('preview_application',{'revision':revision,'request':{'kind':'read','target':F.document}},error=True) - self.assertEqual(hidden['code'],'APPLICATION.CONTENT_UNAVAILABLE') + labelled=self.call('preview_application',{'revision':revision,'request':{'kind':'read','target':F.document}}) + self.assertEqual((labelled['kind'],labelled['review_state']),('candidate-application-read-result','not-reviewed')) + self.assertEqual(preview['review_state'],'current') + unknown=self.call('preview_application',{'revision':revision,'request':{'kind':'read','target':'provenance.consumer-test'}},error=True) + self.assertEqual(unknown['code'],'APPLICATION.UNKNOWN_TARGET') denied=self.rpc('tools/call',{'name':'preview_application','arguments':{'revision':revision,'request':{'kind':'read','target':F.owner}}},'application') self.assertIn('error',denied) # A fresh process reconstructs the draft after unrelated working-tree drift. (self.root/F.fixture_path).write_bytes(b'LOCAL_UNPUBLISHED_INPUT_DRIFT\n') + self.restart() rebuilt=self.call('preview_application',{'revision':revision,'request':{'kind':'read','target':F.owner,'detail':'full'}}) self.assertEqual(rebuilt,preview) (self.root/F.fixture_path).write_bytes(original[F.fixture_path]) @@ -139,6 +152,8 @@ def test_same_candidate_registration_preview_review_publication_and_cold_readbac self.assertEqual(published['outcome']['checkout']['status'],'current',published) self.assertEqual((self.root/F.doc_path).read_bytes(), subprocess.check_output(['git','show','main:'+F.doc_path],cwd=self.root)) + # Cold readback: the application process that reads starts after publication. + self.restart('application') exposed=self.call('read',{'target':F.owner,'detail':'full'},purpose='application') self.assertEqual(exposed['content'],preview['content']) self.assertEqual(exposed['scope'],preview['scope']) @@ -146,8 +161,12 @@ def test_same_candidate_registration_preview_review_publication_and_cold_readbac for path in (F.fixture_path,F.second_path): self.assertEqual(subprocess.check_output(['git','show','main:'+path],cwd=self.root),original[path]) self.assertIn(b'Apply the owned rule.',subprocess.check_output(['git','show','main:'+F.doc_path],cwd=self.root)) - self.call('read',{'target':'provenance.consumer-test'},purpose='application',error=True) - self.call('read',{'target':F.document},purpose='application',error=True) + self.assertEqual(exposed['review_state'],'current') + hidden=self.call('read',{'target':'provenance.consumer-test'},purpose='application',error=True) + self.assertEqual(hidden['code'],'APPLICATION.UNKNOWN_TARGET') + document=self.call('read',{'target':F.document},purpose='application') + self.assertEqual(document['review_state'],'not-reviewed') + self.assertIn('Apply the owned rule.',document['content']) self.assertEqual(self.call('preview_application',{'revision':revision,'request':{'kind':'read','target':F.owner,'detail':'full'}}),preview) self.assertNotEqual(subprocess.check_output(['git','rev-parse','main'],cwd=self.root),before) @@ -180,6 +199,8 @@ def test_failed_publication_observe_and_explicit_cold_completion(self): lock.unlink() local = self.root / "unpublished-local-note.txt" local.write_bytes(b"independent local data\n") + # Cold completion: a new process holds nothing from the failed apply or its observation. + self.restart() recovered = self.call("recover", {"context": ready["context"], "action": "complete-publication"}) self.assertEqual(recovered["status"], "applied", recovered) self.assertEqual(recovered["outcome"]["checkout"]["status"], "current", recovered) diff --git a/tools/standards_engine/tests/test_coverage_publication.py b/tools/standards_engine/tests/test_coverage_publication.py index bd2ddeba..104a9975 100644 --- a/tools/standards_engine/tests/test_coverage_publication.py +++ b/tools/standards_engine/tests/test_coverage_publication.py @@ -600,6 +600,7 @@ def test_review_verify_apply_recover_and_read_without_original_database(self): }, }, ) + # Separate process: a server started after publication reports the applied state. completed = subprocess.run( [ sys.executable, @@ -610,6 +611,7 @@ def test_review_verify_apply_recover_and_read_without_original_database(self): str(repository), "--purpose", "authoring", + "--no-observe", ], input="".join(json.dumps(message) + "\n" for message in messages), text=True, diff --git a/tools/standards_engine/tests/test_discovered_workflow.py b/tools/standards_engine/tests/test_discovered_workflow.py index 78503e1a..7d9ad2b3 100644 --- a/tools/standards_engine/tests/test_discovered_workflow.py +++ b/tools/standards_engine/tests/test_discovered_workflow.py @@ -4,7 +4,6 @@ opt-in Codex harness observes that separate boundary with model-authored calls. """ import json -import sys from pathlib import Path import subprocess import tempfile @@ -13,6 +12,7 @@ from jsonschema import Draft202012Validator from tools.standards_engine.standards_engine.mcp import MCPServer +from tools.standards_engine.tests.stdio_server import StdioServers from tools.standards_engine.tests.test_agent_workflow import decisions, reference_change from tools.standards_engine.tests.test_analysis import _clone_tracked_worktree from tools.standards_engine.tests.test_mcp import initialize, request @@ -32,6 +32,8 @@ def tearDownClass(cls): cls.temp.cleanup() def test_discovered_shapes_drive_all_five_authoring_calls_and_preserve_decisions(self): + stdio = StdioServers(client='output-workflow') + self.addCleanup(stdio.close) for delivery in ('eager', 'on-demand'): with self.subTest(delivery=delivery): server = MCPServer(self.root, purpose='authoring', output_schemas=delivery) @@ -44,20 +46,8 @@ def call(operation, arguments): validators[operation].validate(arguments) selected = request('tools/call', {'name': operation, 'arguments': arguments}) if delivery == 'on-demand': - # The compact catalog path crosses real stdio and replaces - # its process on every call; no connection cache is needed. - selected['id'] = 2 - messages = [request('initialize', {'protocolVersion': '2025-11-25', - 'capabilities': {}, 'clientInfo': {'name': 'output-workflow', 'version': '1'}}), - {'jsonrpc': '2.0', 'method': 'notifications/initialized'}, selected] - process = subprocess.run([sys.executable, '-m', - 'tools.standards_engine.standards_engine.mcp', '--repo-root', str(self.root), - '--purpose', 'authoring', '--output-schemas', delivery], - input=''.join(json.dumps(message) + '\n' for message in messages), - text=True, capture_output=True, check=True) - self.assertEqual(process.stderr, '') - reply = next(json.loads(line) for line in process.stdout.splitlines() - if json.loads(line).get('id') == 2) + # The compact catalog path crosses real stdio, in one server process. + reply = stdio.server(self.root, 'authoring', '--output-schemas', delivery).call(operation, arguments) self.assertNotIn('error', reply, reply) output = reply['result'] else: diff --git a/tools/standards_engine/tests/test_engine_lifetime.py b/tools/standards_engine/tests/test_engine_lifetime.py new file mode 100644 index 00000000..0dd5f2c8 --- /dev/null +++ b/tools/standards_engine/tests/test_engine_lifetime.py @@ -0,0 +1,563 @@ +"""One Engine for the life of a server process, one store connection for each call. + +A server opens its facade and Engine with its first store-backed tool call, +serves every later call with them and closes them when it closes. The store +connection is opened for each call, with the admission a new open runs, and +closed when the call ends: between calls the process holds no connection, lock +or open store file, and what another process did to the store is met by the +next call. An Engine is never used again after a failure nobody classified. + +Tests that claim something about another process start one. The fixture owns +its repository root, database and processes; no production store is accessed. +""" +from __future__ import annotations + +from contextlib import closing, redirect_stderr +from copy import deepcopy +import io +import json +import os +from pathlib import Path +import shutil +import sqlite3 +import subprocess +import sys +import tempfile +import threading +import time +import unittest +from unittest import mock + +from tools.standards_engine.standards_engine import AgentToolFacade, StandardsEngine +from tools.standards_engine.standards_engine import engine as engine_module +from tools.standards_engine.standards_engine.compiled_cache import CompiledSnapshotCache +from tools.standards_engine.standards_engine.mcp import MCPServer, serve +from tools.standards_engine.tests import test_purpose_transport as fixture +from tools.standards_engine.tests.stdio_server import StdioServer +from tools.standards_engine.tests.test_mcp import initialize, request +from tools.standards_engine.tests.test_route_content import known_assertions +from tools.standards_snapshots.standards_snapshots import SnapshotId, SnapshotModule +from tools.standards_snapshots.standards_snapshots import store as snapshot_store + +ROOT = Path(__file__).resolve().parents[3] +AUDIT_STATEMENTS = ['PRAGMA integrity_check', 'PRAGMA foreign_key_check'] + +# A separate interpreter, as another server or a CLI call is: it opens the +# store through the ordinary module path, commits one change and exits. +_OTHER_PROCESS = """ +import sys +from pathlib import Path +from tools.standards_snapshots.standards_snapshots import SnapshotId, SnapshotModule +action, path, identifier = sys.argv[1:4] +with SnapshotModule.open(Path(path)) as store: + snapshot = SnapshotId(identifier) + if action == 'quarantine': + store.delete_snapshot(snapshot) + elif action == 'restore': + store.undelete_snapshot(snapshot) + else: + print(store.create_snapshot(store.load_content(snapshot)).snapshot.value) +""" + + +class EngineLifetimeTest(unittest.TestCase): + @classmethod + def setUpClass(cls): + fixture.PurposeTransportTest.setUpClass() + cls.root = fixture.PurposeTransportTest.root + cls.snapshot = fixture.PurposeTransportTest.snapshot + cls.expected = fixture.PurposeTransportTest.expected + cls.path = cls.root / '.standards-engine/snapshots-v1.sqlite3' + + @classmethod + def tearDownClass(cls): + fixture.PurposeTransportTest.tearDownClass() + + def setUp(self): + self.opens, self.connections = [], [] + connect = self.untraced_connect = sqlite3.connect + + def traced_connect(database, *arguments, **options): + # Observe each store connection from before its first statement. + connection = connect(database, *arguments, **options) + if Path(database).resolve() == self.path.resolve(): + self.opens.append([]) + self.connections.append(connection) + connection.set_trace_callback(self.opens[-1].append) + return connection + + patcher = mock.patch.object(snapshot_store.sqlite3, 'connect', traced_connect) + patcher.start() + self.addCleanup(patcher.stop) + + def server(self, purpose='application'): + server = MCPServer(self.root, purpose=purpose) + self.addCleanup(server.close) + initialize(server) + return server + + def call(self, server, operation, arguments): + return server.dispatch(request('tools/call', {'name': operation, 'arguments': arguments}))['result'] + + def read(self, server, **arguments): + return self.call(server, 'read', {'snapshot': self.snapshot, 'target': 'core', **arguments}) + + def failed_call(self, server): + """One call that fails outside any typed outcome; return the private stderr.""" + stderr = io.StringIO() + with redirect_stderr(stderr): + failed = self.read(server) + self.assertTrue(failed['isError']) + self.assertNotIn('structuredContent', failed) + self.assertIn('Engine invocation failed', failed['content'][0]['text']) + return stderr.getvalue() + + def other_process(self, action, snapshot=None): + completed = subprocess.run( + [sys.executable, '-P', '-c', _OTHER_PROCESS, action, str(self.path), + (snapshot or self.snapshot)['id']], + env={**os.environ, 'PYTHONPATH': str(ROOT)}, text=True, capture_output=True, timeout=60) + self.assertEqual(completed.returncode, 0, completed.stderr) + return completed.stdout.strip() + + def assert_no_connection(self): + """Every store connection this process opened is closed and holds no lock.""" + for connection in self.connections: + with self.assertRaises(sqlite3.ProgrammingError): + connection.execute('SELECT 1') + # An exclusive transaction is granted only when no connection holds a lock. + with closing(self.untraced_connect(self.path, isolation_level=None, timeout=0)) as other: + other.execute('BEGIN EXCLUSIVE') + other.execute('ROLLBACK') + + def assert_closed(self, facade): + with self.assertRaises(sqlite3.ProgrammingError): + facade._engine._snapshots._store._connection.execute('SELECT 1') + with self.assertRaisesRegex(ValueError, 'closed'): + facade._engine._compiled_cache.require_scope(self.root, facade._engine.purpose) + + def test_several_calls_use_one_facade_and_engine_and_a_store_connection_each(self): + server = self.server() + self.assertIsNone(server._facade) + # Catalog and runtime observations need no Engine and open none. + for name in ('runtime_info', 'describe_input'): + self.call(server, name, {} if name == 'runtime_info' else {'operation': 'read'}) + self.assertIsNone(server._facade) + self.assertEqual(self.opens, []) + opened = AgentToolFacade.open_repository + with mock.patch.object(AgentToolFacade, 'open_repository', wraps=opened) as calls: + first = self.read(server) + facade, engine = server._facade, server._facade._engine + self.assertEqual(len(self.opens), 1) + self.assert_no_connection() + for count, (operation, arguments) in enumerate(( + ('read', {'snapshot': self.snapshot, 'target': 'core'}), + ('read_many', {'snapshot': self.snapshot, 'items': [{'target': 'core'}, {'target': 'router'}]}), + ('route', {'snapshot': self.snapshot, 'facts': known_assertions(), 'content': {'limit': 1}}), + ('relationship_groups', {'snapshot': self.snapshot, 'limit': 1}), + # Typed rejections are ordinary outcomes: the Engine stays. + ('read', {'snapshot': self.snapshot, 'target': 'not-registered'}), + ('read', {'extra': True}), + ), start=2): + self.call(server, operation, arguments) + self.assertIs(server._facade, facade) + self.assertIs(server._facade._engine, engine) + # Each call opened one store connection and closed it when it ended. + self.assertEqual(len(self.opens), count) + self.assert_no_connection() + self.assertEqual(first['structuredContent']['content'], self.expected) + self.assertEqual(calls.call_count, 1) + self.assertIs(calls.call_args.kwargs['interface'], server._interface) + # The server lends no cache: the Engine's own lives exactly as long as it does. + self.assertNotIn('compiled_cache', calls.call_args.kwargs) + self.assertTrue(engine._owns_compiled_cache) + self.assertEqual(engine._compiled_cache.statistics['entries'], 1) + + def test_every_call_answers_as_a_facade_opened_for_that_call_does(self): + cases = [ + ('read', {'snapshot': self.snapshot, 'target': 'core'}), + ('read', {'snapshot': self.snapshot, 'target': 'core', 'detail': 'full'}), + ('read_many', {'snapshot': self.snapshot, 'items': [{'target': 'core'}, {'target': 'router'}]}), + ('route', {'snapshot': self.snapshot, 'facts': known_assertions(), 'content': {'limit': 1}}), + ('relationship_groups', {'snapshot': self.snapshot, 'limit': 1}), + ('related', {'snapshot': self.snapshot, 'target': 'core', 'groups': ['standards-requires'], + 'direction': 'outgoing', 'transitive': False}), + ('related', {'snapshot': self.snapshot, 'target': 'core', 'groups': ['not-a-group'], + 'direction': 'outgoing', 'transitive': False}), + ('read', {'snapshot': self.snapshot, 'target': 'not-registered'}), + ('read', {'snapshot': {**self.snapshot, 'id': 'snapshot:v1:' + '0' * 8 + '-0000-4000-8000-' + '0' * 12}, + 'target': 'core'}), + ('read', {'extra': True}), + ('read', {'snapshot': self.snapshot, 'target': 'core'}), + ] + + for purpose in ('application', 'authoring'): + with self.subTest(purpose=purpose): + kept = self.server(purpose) + lent = CompiledSnapshotCache(self.root, purpose) + self.addCleanup(lent.close) + for operation, arguments in cases: + # What the transport did for every call before it kept its + # Engine: open a facade and store, lending the process's + # interface and cache, run the operation, and close. + with AgentToolFacade.open_repository( + self.root, purpose=purpose, interface=kept._interface, + compiled_cache=lent) as opened: + expected = getattr(opened, operation)(deepcopy(arguments)) + answer = self.call(kept, operation, arguments) + self.assertEqual(answer, kept._tool_result(deepcopy(expected)), (operation, arguments)) + self.assertEqual(json.loads(answer['content'][0]['text']), expected) + # A caller that alters its answer changes nothing a later call returns. + answer['structuredContent'].clear() + answer['content'].clear() + self.assertEqual(kept._facade._engine._compiled_cache.statistics['entries'], 1) + + def test_unexpected_exception_closes_the_engine_and_the_next_call_opens_another(self): + for purpose in ('application', 'authoring'): + with self.subTest(purpose=purpose): + del self.opens[:] + server = self.server(purpose) + first = self.read(server) + self.assertFalse(first['isError'], first) + failed_facade = server._facade + with (mock.patch.object(AgentToolFacade, 'read', side_effect=RuntimeError('private diagnostic')), + redirect_stderr(io.StringIO()) as stderr): + failed = self.read(server) + self.assertTrue(failed['isError']) + self.assertNotIn('structuredContent', failed) + self.assertNotIn('private diagnostic', json.dumps(failed)) + self.assertIn('RuntimeError', stderr.getvalue()) + self.assertIsNone(server._facade) + self.assert_closed(failed_facade) + again = self.read(server) + self.assertEqual(again['structuredContent'], first['structuredContent']) + self.assertIsNot(server._facade, failed_facade) + self.assertIsNot(server._facade._engine, failed_facade._engine) + # One connection for each of the three calls, none left open. + self.assertEqual(len(self.opens), 3) + self.assert_no_connection() + + def test_interruption_closes_the_engine_before_it_propagates(self): + server = self.server() + self.read(server) + interrupted = server._facade + with mock.patch.object(AgentToolFacade, 'read', side_effect=KeyboardInterrupt()): + with self.assertRaises(KeyboardInterrupt): + self.read(server) + self.assertIsNone(server._facade) + self.assert_closed(interrupted) + self.assertFalse(self.read(server)['isError']) + + def test_unclassified_failure_behind_an_application_rejection_also_closes_the_engine(self): + server = self.server() + first = self.read(server) + kept = server._facade + # A typed failure is an ordinary outcome with the same public code. + missing = {**self.snapshot, 'id': 'snapshot:v1:' + '0' * 8 + '-0000-4000-8000-' + '0' * 12} + typed = self.call(server, 'read', {'snapshot': missing, 'target': 'core'}) + self.assertEqual(typed['structuredContent']['code'], 'APPLICATION.INTERNAL_UNAVAILABLE') + self.assertIs(server._facade, kept) + self.assertTrue(kept.reusable) + with (mock.patch.object(StandardsEngine, '_compiled_snapshot', side_effect=RuntimeError('private diagnostic')), + self.assertLogs('tools.standards_engine.standards_engine.context_projection', 'ERROR') as logged): + swallowed = self.read(server) + # The application caller sees exactly the bounded rejection it always saw. + self.assertEqual(swallowed, {**typed, '_meta': swallowed['_meta']}) + self.assertNotIn('private diagnostic', json.dumps(swallowed) + ''.join(logged.output)) + self.assertFalse(kept.reusable) + self.assertIsNone(server._facade) + self.assert_closed(kept) + self.assertEqual(self.read(server)['structuredContent'], first['structuredContent']) + self.assertIsNot(server._facade, kept) + self.assert_no_connection() + + def test_transaction_an_operation_left_open_is_rolled_back_not_committed(self): + server = self.server() + first = self.read(server) + kept = server._facade + read = AgentToolFacade.read + + def read_and_leave_a_transaction(facade, arguments): + value = read(facade, arguments) + connection = facade._engine._snapshots._store._connection + connection.execute('BEGIN IMMEDIATE') + connection.execute('INSERT INTO purged_root_tombstones VALUES (?, ?)', ('left-open', 1)) + return value + + with mock.patch.object(AgentToolFacade, 'read', read_and_leave_a_transaction): + answered = self.read(server) + self.assertEqual(answered['structuredContent'], first['structuredContent']) + # Closing the call's connection ended the transaction without its + # write, as closing a store opened for one call always did. + self.assert_no_connection() + with closing(sqlite3.connect(self.path)) as observed: + self.assertIsNone(observed.execute( + "SELECT 1 FROM purged_root_tombstones WHERE snapshot_id = 'left-open'").fetchone()) + self.assertFalse(self.path.with_name(self.path.name + '-journal').exists()) + self.assertIs(server._facade, kept) + self.assertEqual(self.read(server)['structuredContent'], first['structuredContent']) + + def test_replaced_store_file_is_reopened_and_audited(self): + with snapshot_store._AUDITED_FILES_LOCK: + snapshot_store._AUDITED_FILES.clear() + server = self.server('authoring') + first = self.read(server) + self.assertFalse(first['isError'], first) + self.assertEqual(self.read(server), {**first, '_meta': first['_meta']}) + self.assertEqual(len(self.opens), 2) + self.assertNotIn('PRAGMA integrity_check', self.opens[1]) + original = server._facade + audited = (self.path.lstat().st_dev, self.path.lstat().st_ino) + self.assertTrue(snapshot_store._audit_recorded(audited)) + retained = self.path.with_name('retained-valid-store.sqlite3') + shutil.copyfile(self.path, retained) + try: + # A complete file moved into place has another inode: the Engine + # is opened anew, and that open audits the file. + replacement = self.path.with_name('replacement.sqlite3') + shutil.copyfile(self.path, replacement) + os.replace(replacement, self.path) + self.assertEqual(self.read(server)['structuredContent'], first['structuredContent']) + self.assertIsNot(server._facade, original) + self.assert_closed(original) + self.assertEqual(len(self.opens), 3) + self.assertEqual([statement for statement in self.opens[2] if statement in AUDIT_STATEMENTS], + AUDIT_STATEMENTS) + # The replaced file's inode number can go to a later replacement; + # the audit of the file that had it is no longer on record. + self.assertFalse(snapshot_store._audit_recorded(audited)) + # A damaged replacement is refused by that audit, at the open boundary. + shutil.copyfile(self.path, replacement) + with closing(sqlite3.connect(replacement, isolation_level=None)) as corruptor: + corruptor.execute("INSERT INTO content_files VALUES ('missing', 'a', X'', 0, 'digest')") + os.replace(replacement, self.path) + self.assertIn('SNAPSHOT_STORE.FOREIGN_KEY_FAILURE', self.failed_call(server)) + self.assertIsNone(server._facade) + self.assertIn('SNAPSHOT_STORE.FOREIGN_KEY_FAILURE', self.failed_call(server)) + # A removed store is created again, empty, as an open of a missing path does. + self.path.unlink() + missing = self.read(server) + self.assertEqual(missing['structuredContent']['code'], 'SNAPSHOT.UNAVAILABLE', missing) + self.assertTrue(self.path.is_file()) + with closing(sqlite3.connect(self.path)) as created: + self.assertEqual(created.execute('SELECT count(*) FROM snapshot_roots').fetchone(), (0,)) + finally: + os.replace(retained, self.path) + self.assertEqual(self.read(server)['structuredContent'], first['structuredContent']) + + def test_another_process_committed_writes_are_visible_to_the_next_call(self): + server = self.server('authoring') + first = self.read(server) + self.assertFalse(first['isError'], first) + kept = server._facade + self.other_process('quarantine') + try: + quarantined = self.read(server) + self.assertEqual(quarantined['structuredContent']['code'], 'SNAPSHOT.QUARANTINED', quarantined) + finally: + self.other_process('restore') + self.assertEqual(self.read(server)['structuredContent'], first['structuredContent']) + added = {**self.snapshot, 'id': self.other_process('copy')} + self.assertNotEqual(added, self.snapshot) + other = self.call(server, 'read', {'snapshot': added, 'target': 'core'}) + self.assertFalse(other['isError'], other) + self.assertEqual(other['structuredContent']['snapshot'], added) + self.assertEqual(other['structuredContent']['content'], first['structuredContent']['content']) + # Every observation was made by the one Engine this server opened. + self.assertIs(server._facade, kept) + + def test_another_process_schema_or_version_change_is_met_by_the_next_call(self): + server = self.server('authoring') + first = self.read(server) + for change, restore, code in ( + # A later Engine migrated the store in place; this one must stop using it. + ('PRAGMA user_version=3', 'PRAGMA user_version=2', 'SNAPSHOT_STORE.UNSUPPORTED_VERSION'), + ('CREATE TABLE unexpected (value TEXT)', 'DROP TABLE unexpected', 'SNAPSHOT_STORE.INVALID_SCHEMA'), + ): + with self.subTest(change=change): + self.assertIsNotNone(server._facade) + with closing(sqlite3.connect(self.path, isolation_level=None)) as other: + other.execute(change) + try: + self.assertIn(code, self.failed_call(server)) + self.assertIsNone(server._facade) + self.assertIn(code, self.failed_call(server)) + finally: + with closing(sqlite3.connect(self.path, isolation_level=None)) as other: + other.execute(restore) + self.assertEqual(self.read(server)['structuredContent'], first['structuredContent']) + + def test_due_maintenance_under_another_writer_fails_before_the_operation_as_at_open(self): + original = SnapshotId(self.snapshot['id']) + # A short busy budget for this server's connection; the outcome is the same. + with mock.patch.object(snapshot_store, 'BUSY_TIMEOUT_MS', 50): + server = self.server('authoring') + first = self.read(server) + kept = server._facade + with SnapshotModule.open(self.path) as source: + capture = source.load_content(original) + # Put only an additional root past its deadline, without a sleep. + with SnapshotModule.open(self.path, now=lambda: int(time.time()) - 10, + quarantine_seconds=1) as source: + expired = source.create_snapshot(capture).snapshot + source.delete_snapshot(expired) + with closing(sqlite3.connect(self.path, isolation_level=None)) as writer: + writer.execute('BEGIN IMMEDIATE') + try: + # Not a typed result of the operation: the same private + # boundary as a store open that meets the busy writer. + self.assertIn('SNAPSHOT_STORE.BUSY', self.failed_call(server)) + self.assertIsNone(server._facade) + self.assert_closed(kept) + self.assertIsNotNone(writer.execute( + 'SELECT 1 FROM snapshot_roots WHERE snapshot_id = ?', (str(expired),)).fetchone()) + finally: + writer.execute('ROLLBACK') + self.assertEqual(self.read(server)['structuredContent'], first['structuredContent']) + with closing(sqlite3.connect(self.path)) as observed: + self.assertIsNone(observed.execute( + 'SELECT 1 FROM snapshot_roots WHERE snapshot_id = ?', (str(expired),)).fetchone()) + self.assertIsNotNone(observed.execute( + 'SELECT 1 FROM purged_root_tombstones WHERE snapshot_id = ?', (str(expired),)).fetchone()) + + def test_closing_the_server_closes_the_engine_and_its_cache(self): + server = self.server() + self.read(server) + facade = server._facade + # The call's store connection is already closed; the Engine and cache are kept. + self.assert_no_connection() + self.assertEqual(facade._engine._compiled_cache.statistics['entries'], 1) + server.close() + self.assertIsNone(server._facade) + self.assert_closed(facade) + self.assertEqual(facade._engine._compiled_cache.statistics['entries'], 0) + self.assertEqual(server.dispatch(request('ping'))['error']['code'], -32000) + self.assertEqual(len(self.opens), 1) + # End of input closes it the same way. + served = MCPServer(self.root, purpose='application') + initialize(served) + self.read(served) + facade = served._facade + serve(served, io.StringIO(''), io.StringIO()) + self.assertIsNone(served._facade) + self.assert_closed(facade) + + @unittest.skipUnless(os.path.isdir('/proc/self/fd'), 'needs /proc to list another process\'s descriptors') + def test_idle_server_process_holds_no_descriptor_or_lock_on_the_store(self): + server = StdioServer(self.root, purpose='authoring', client='lifetime-fixture') + self.addCleanup(server.close) + store = str(self.path.resolve()) + descriptors = Path('/proc') / str(server._process.pid) / 'fd' + for arguments, rejected in ( + ({'snapshot': self.snapshot, 'target': 'core'}, False), + ({'snapshot': self.snapshot, 'target': 'not-registered'}, True), + ({'snapshot': self.snapshot, 'target': 'core'}, False), + ): + result = server.call('read', arguments)['result'] + self.assertEqual(result['isError'], rejected, result) + # The server process is alive and has answered. Nothing it has open + # is the store file, its rollback journal or a write-ahead log. + targets = [os.readlink(entry) for entry in descriptors.iterdir()] + self.assertTrue(targets) + self.assertEqual([target for target in targets if target.startswith(store)], []) + # An exclusive transaction is granted only when no other connection holds a lock. + with closing(sqlite3.connect(self.path, isolation_level=None, timeout=0)) as other: + other.execute('BEGIN EXCLUSIVE') + other.execute('INSERT INTO purged_root_tombstones VALUES (?, ?)', ('idle-lock-probe', 1)) + other.execute('ROLLBACK') + for suffix in ('-journal', '-wal', '-shm'): + self.assertFalse(self.path.with_name(self.path.name + suffix).exists()) + + def test_dispatch_from_another_thread_than_the_previous_call_works(self): + server = self.server('authoring') + first = self.read(server) + self.assertFalse(first['isError'], first) + kept = server._facade + answers, failures = [], [] + + def call(): + try: + answers.append(self.read(server)) + except BaseException as error: + failures.append(error) + + for _ in range(2): + worker = threading.Thread(target=call) + worker.start() + worker.join() + call() + self.assertEqual(failures, []) + self.assertEqual([answer['structuredContent'] for answer in answers], [first['structuredContent']] * 4) + self.assertIs(server._facade, kept) + self.assert_no_connection() + # A thread that made none of the calls can close the server. + closer = threading.Thread(target=server.close) + closer.start() + closer.join() + self.assertIsNone(server._facade) + self.assert_closed(kept) + + def test_engine_without_a_lent_cache_reuses_a_compiled_snapshot(self): + arguments = {'snapshot': self.snapshot, 'target': 'core'} + with AgentToolFacade.open_repository(self.root, purpose='authoring') as facade: + engine = facade._engine + cache = engine._compiled_cache + self.assertTrue(engine._owns_compiled_cache) + with ( + mock.patch.object(engine._snapshots, 'load_content', wraps=engine._snapshots.load_content) as load, + mock.patch.object(engine_module, 'compile_policy_impact', + wraps=engine_module.compile_policy_impact) as compile, + ): + first = facade.read(arguments) + second = facade.read(arguments) + self.assertEqual(first['kind'], 'compact-read-result', first) + self.assertEqual(first, second) + # Stored content is loaded and verified by each read; compilation runs once. + self.assertEqual(load.call_count, 2) + self.assertEqual(compile.call_count, 1) + self.assertEqual((cache.statistics['misses'], cache.statistics['hits']), (1, 1)) + self.assertEqual(cache.statistics['entries'], 1) + # The Engine closes the cache it owns. + self.assertEqual(cache.statistics['entries'], 0) + with self.assertRaisesRegex(ValueError, 'closed'): + cache.require_scope(self.root, 'authoring') + + def test_store_directory_link_pointed_elsewhere_selects_a_new_open(self): + with tempfile.TemporaryDirectory(prefix='engine-lifetime-link-') as temporary: + root = Path(temporary) / 'repository' + first, second = Path(temporary) / 'first', Path(temporary) / 'second' + for directory in (root, first, second): + directory.mkdir() + link = root / '.standards-engine' + link.symlink_to(first) + with StandardsEngine.open_repository(root, purpose='authoring') as engine: + self.assertTrue((first / 'snapshots-v1.sqlite3').is_file()) + self.assertTrue(engine.readmit()) + link.unlink() + link.symlink_to(second) + self.assertFalse(engine.readmit()) + self.assertFalse((second / 'snapshots-v1.sqlite3').exists()) + with StandardsEngine.open_repository(root, purpose='authoring'): + self.assertTrue((second / 'snapshots-v1.sqlite3').is_file()) + + def test_repository_root_moved_behind_a_link_selects_a_new_open(self): + with tempfile.TemporaryDirectory(prefix='engine-lifetime-root-') as temporary: + root, moved = Path(temporary) / 'repository', Path(temporary) / 'moved' + stores = Path(temporary) / 'stores' + root.mkdir() + stores.mkdir() + # The store directory is elsewhere, so only the root's own location changes. + (root / '.standards-engine').symlink_to(stores) + with StandardsEngine.open_repository(root, purpose='authoring') as engine: + self.assertEqual(engine._repository.root, root.resolve()) + self.assertTrue(engine.readmit()) + root.rename(moved) + root.symlink_to(moved) + self.assertFalse(engine.readmit()) + with StandardsEngine.open_repository(root, purpose='authoring') as engine: + self.assertEqual(engine._repository.root, moved.resolve()) + self.assertTrue(engine.readmit()) + + +if __name__ == '__main__': + unittest.main() diff --git a/tools/standards_engine/tests/test_evidence_maintenance.py b/tools/standards_engine/tests/test_evidence_maintenance.py index 852e7f67..db550993 100644 --- a/tools/standards_engine/tests/test_evidence_maintenance.py +++ b/tools/standards_engine/tests/test_evidence_maintenance.py @@ -260,6 +260,8 @@ def test_preview_and_overlap_preserve_working_tree_then_apply_retires(self): purpose="authoring", ) as engine: facade = AgentToolFacade(engine, _contracts(repository)) + # The manifest pins the tracked file list: track the fixture first. + git_output(repository, ("add", "--", obsolete)) refreshed = facade.verify_repository( {"kind": "verify-repository", "refresh_verification_inputs": True} ) @@ -270,7 +272,6 @@ def test_preview_and_overlap_preserve_working_tree_then_apply_retires(self): "add", "--", "evaluation/standards-effectiveness/generated/suite-inputs.json", - obsolete, ), ) git_output( diff --git a/tools/standards_engine/tests/test_immutable_work_reuse.py b/tools/standards_engine/tests/test_immutable_work_reuse.py index e8caaf76..138186a5 100644 --- a/tools/standards_engine/tests/test_immutable_work_reuse.py +++ b/tools/standards_engine/tests/test_immutable_work_reuse.py @@ -18,6 +18,7 @@ AggregateChild, CapturedContent, SnapshotError, SnapshotFile, SnapshotModule, ) from tools.standards_snapshots.standards_snapshots import module as snapshot_module +from tools.repository_git.repository_git import GitRepository from tools.standards_engine.standards_engine import AgentToolFacade, StandardsEngine from tools.standards_engine.standards_engine.authoring import ( AuthoringError, AuthoringModule, RevisionDecoding, @@ -314,7 +315,8 @@ def test_semantic_intent_and_exported_contract_maps_are_not_mutable_reuse_state( self.assertEqual(again.aggregate(), revision.aggregate()) def test_operation_exit_clears_decoded_material_on_success_and_failure(self): - engine = StandardsEngine(object(), self.snapshots, purpose="authoring") + # The store-only fixture has no Git history; the repository value is real. + engine = StandardsEngine(GitRepository(Path(self.temporary.name)), self.snapshots, purpose="authoring") for fail in (False, True): materials = ProposalMaterials(engine) try: @@ -387,9 +389,10 @@ def test_stdio_cold_restarts_and_warm_calls_preserve_results(self): ), 2): messages.append(request('tools/call',{'name':name,'arguments':args},identifier=ident)) results=[] + # Two processes: a restarted server returns what the first one did, warm and cold. for _ in range(2): process=subprocess.run( - [sys.executable,'-P','-m','tools.standards_engine.standards_engine.mcp','--repo-root',str(self.root),'--purpose','authoring','--output-schemas','on-demand'], + [sys.executable,'-P','-m','tools.standards_engine.standards_engine.mcp','--repo-root',str(self.root),'--purpose','authoring','--output-schemas','on-demand','--no-observe'], input=''.join(json.dumps(item)+'\n' for item in messages),text=True,capture_output=True,check=True, env={**os.environ,'PYTHONPATH':str(ROOT)},cwd=self.temporary.name, ) diff --git a/tools/standards_engine/tests/test_input_discovery.py b/tools/standards_engine/tests/test_input_discovery.py index 312de9a5..822e59f5 100644 --- a/tools/standards_engine/tests/test_input_discovery.py +++ b/tools/standards_engine/tests/test_input_discovery.py @@ -84,7 +84,14 @@ def test_flat_discovery_schema_and_early_guidance_cover_every_published_tool(sel self.assertTrue(tool['annotations']['readOnlyHint']) for item in server.tools: if item['name'] != 'describe_input': - self.assertIn(f'describe_input(operation="{item["name"]}")', item['description'][:250]) + hint = (f'For abbreviated input fields, call describe_input(operation="{item["name"]}") ' + 'and reuse the returned contract while its catalog matches.') + # Application descriptions open with the tool's purpose and end with the hint. + if purpose == 'application': + self.assertTrue(item['description'].endswith(' ' + hint), item['name']) + self.assertNotIn('describe_input(operation=', item['description'][:-len(hint)]) + else: + self.assertTrue(item['description'].startswith(hint + ' '), item['name']) def test_every_published_input_can_be_reconstructed_and_independently_validated(self): for purpose in ('application', 'authoring'): @@ -283,13 +290,14 @@ def cold(arguments): messages = [request('initialize', {'protocolVersion': '2025-11-25', 'capabilities': {}, 'clientInfo': {'name': 'discovery-fixture', 'version': '1'}}), {'jsonrpc': '2.0', 'method': 'notifications/initialized'}, request('tools/call', {'name': 'describe_input', 'arguments': arguments}, identifier=2)] - process = subprocess.run([sys.executable, '-P', '-m', 'tools.standards_engine.standards_engine.mcp', '--repo-root', str(root), '--purpose', 'authoring', '--advanced'], + process = subprocess.run([sys.executable, '-P', '-m', 'tools.standards_engine.standards_engine.mcp', '--repo-root', str(root), '--purpose', 'authoring', '--advanced', '--no-observe'], input=''.join(json.dumps(m)+'\n' for m in messages), capture_output=True, text=True, env=environment, timeout=60) self.assertEqual(process.returncode, 0, process.stderr) self.assertEqual(process.stderr, '') result = json.loads(process.stdout.splitlines()[-1])['result'] self.assertFalse(result['isError'], result) return result + # Two processes: the continuation is honoured by a server that did not issue it. first = cold({'operation': 'propose', 'limit': 1}) second = cold(first['structuredContent']['next']) self.assertNotEqual(first['_meta']['standards-engine/runtime']['instance_id'], second['_meta']['standards-engine/runtime']['instance_id']) diff --git a/tools/standards_engine/tests/test_interaction_observer.py b/tools/standards_engine/tests/test_interaction_observer.py index 01aa31b5..5e3edda2 100644 --- a/tools/standards_engine/tests/test_interaction_observer.py +++ b/tools/standards_engine/tests/test_interaction_observer.py @@ -1,4 +1,8 @@ -"""Synthetic operator evidence; never records a real agent/model session.""" +"""Synthetic operator evidence; never records a real agent/model session. + +Every recorder here writes to a temporary directory. Child processes get a +temporary HOME so the always-on default can never reach a developer's database. +""" from __future__ import annotations from contextlib import redirect_stderr @@ -6,24 +10,74 @@ import json import os from pathlib import Path +import re import sqlite3 +import stat import subprocess import sys import tempfile +import threading import time import unittest from unittest.mock import patch from tools.standards_engine.standards_engine.interaction_observer import ( - APPLICATION_ID, InputShape, InteractionRecorder, RecorderConfig, SCHEMA_VERSION, - report, + APPLICATION_ID, DEFAULT_DATABASE_NAME, InputShape, InteractionRecorder, RecorderConfig, + SCHEMA_VERSION, StorageRejected, TRUNCATED, default_database, report, text_report, ) from tools.standards_engine.standards_engine.mcp import MCPServer, serve from tools.standards_engine.standards_engine.tools import AgentToolFacade +from tools.standards_engine.tests import stdio_server from tools.standards_engine.tests.test_mcp import ROOT, initialize, request MODULE = 'tools.standards_engine.standards_engine.interaction_observer' MCP_MODULE = 'tools.standards_engine.standards_engine.mcp' +SNAPSHOT = {'kind': 'snapshot-handle', 'id': 'snapshot:v1:5e17e1a1-0000-4000-8000-000000000001', 'schema_version': 5} +ANALYSIS = {'kind': 'analysis-handle', 'id': 'analysis:sha256:' + 'ab' * 32, 'schema_version': 7} +# The request metadata Codex attaches to every tool call, with synthetic values. +CODEX_META = { + 'callId': 'exec-SENTINEL_CALL', 'threadId': 'SENTINEL_THREAD', 'sessionId': 'SENTINEL_SESSION', 'progressToken': 9, + 'x-codex-turn-metadata': { + 'session_id': 'SENTINEL_SESSION', 'thread_id': 'SENTINEL_THREAD', 'turn_id': 'SENTINEL_TURN', + 'model': 'SENTINEL_MODEL', 'thread_source': 'subagent', + 'workspaces': {'/SENTINEL/WORKSPACE': {'associated_remote_urls': {'origin': 'git@example.invalid:SENTINEL/REPO.git'}}}}, +} +V1_DDL = ( + 'CREATE TABLE sessions (id TEXT PRIMARY KEY, started REAL NOT NULL, runtime TEXT NOT NULL, deployment TEXT NOT NULL, catalog TEXT NOT NULL, pruned INTEGER NOT NULL DEFAULT 0)', + 'CREATE TABLE interactions (id TEXT PRIMARY KEY, session TEXT NOT NULL REFERENCES sessions(id), ordinal INTEGER NOT NULL, started REAL NOT NULL, method TEXT NOT NULL, operation TEXT NOT NULL, input_shape TEXT NOT NULL, shape_digest TEXT NOT NULL, discovery_operation TEXT, catalog_state TEXT NOT NULL, request_bytes INTEGER, scope TEXT NOT NULL, UNIQUE(session, ordinal))', + "CREATE TABLE events (interaction TEXT PRIMARY KEY REFERENCES interactions(id) ON DELETE CASCADE, phase TEXT NOT NULL CHECK(phase IN ('end','error','incomplete')), finished REAL NOT NULL, duration_ms REAL NOT NULL, response_bytes INTEGER, outcome TEXT NOT NULL, feedback TEXT NOT NULL)", + 'CREATE INDEX interaction_age ON interactions(started)', +) + + +def environment(home: Path, **extra: str) -> dict: + """A child environment whose default observation location is under `home`.""" + env = {name: value for name, value in os.environ.items() + if name not in ('XDG_DATA_HOME', 'STANDARDS_ENGINE_OBSERVE')} + return {**env, 'PYTHONPATH': str(ROOT), 'HOME': str(home), **extra} + + +def rejection(code, pointer=None, keyword='fact', **extra): + value = {'kind': 'rejected-result', 'code': code, 'outcome': 'invalid', 'message': 'SENTINEL_MESSAGE', + 'details': {'SENTINEL_DETAIL': 'SENTINEL_DETAIL'}, 'next_operations': [], **extra} + if pointer is not None: + value['input_feedback'] = {'issues': [{'instance_pointer': pointer, 'keyword': keyword, + 'message': 'SENTINEL_MESSAGE'}], 'truncated': False} + return value + + +def route_result(unresolved=('routing.topics',)): + return {'kind': 'compact-route-result', 'status': 'needs-facts' if unresolved else 'complete', 'snapshot': SNAPSHOT, + 'summary': 'SENTINEL_SUMMARY', + 'reading_plan': [{'target': 'core', 'state': 'selected'}, {'target': 'router', 'state': 'selected'}, + {'target': 'topic.security', 'state': 'conditional'}], + 'unresolved_questions': [{'fact': {'id': name, 'prompt': 'SENTINEL_PROMPT'}} for name in unresolved], + 'content': {'offset': 0, 'total': 2, 'items': [read_result('core')]}} + + +def read_result(target): + return {'kind': 'compact-read-result', 'snapshot': SNAPSHOT, 'content': 'SENTINEL_STANDARD_TEXT', + 'policy': {'handle': {'kind': 'snapshot-child-handle', 'child_kind': 'policy', 'child_id': target}}} class ObserverTests(unittest.TestCase): @@ -33,9 +87,9 @@ def setUp(self): self.database = Path(self.temporary.name) / 'observations.sqlite' self.diagnostics = io.StringIO() - def server(self, **options): + def server(self, *, advanced=False, **options): with redirect_stderr(self.diagnostics): - server = MCPServer(ROOT, purpose='authoring', + server = MCPServer(ROOT, purpose='authoring', advanced=advanced, observation=RecorderConfig(self.database, 'synthetic', **options)) self.addCleanup(server.close) return server @@ -45,15 +99,23 @@ def rows(self, sql): db.row_factory = sqlite3.Row return [dict(row) for row in db.execute(sql)] - def test_opt_in_does_not_change_catalog_or_results(self): + def call(self, server, name, arguments, value, meta=None): + """One tool call whose Engine result is `value`; no store is opened.""" + params = {'name': name, 'arguments': arguments, **({'_meta': meta} if meta else {})} + with patch.object(server, '_request', return_value=server._tool_result(value)): + return server.dispatch(request('tools/call', params)) + + def stored_bytes(self): + return b''.join(path.read_bytes() for path in self.database.parent.iterdir()) + + def test_recording_does_not_change_catalog_instructions_or_results(self): plain = MCPServer(ROOT, purpose='authoring') self.addCleanup(plain.close) observed = self.server() self.assertEqual(plain.tools, observed.tools) - for server in (plain, observed): - initialize(server) # A fixed process identity makes these full public responses comparable. observed._runtime_identity._instance = plain._runtime_identity._instance + self.assertEqual(initialize(plain), initialize(observed)) for message in (request('tools/list'), request('tools/call', {'name': 'runtime_info'}), request('tools/call', {'name': 'describe_input', 'arguments': {'operation': 'apply'}}), request('tools/call', {'name': 'runtime_info', 'arguments': {'secret': 'private'}}), @@ -68,6 +130,7 @@ def test_opt_in_does_not_change_catalog_or_results(self): self.assertEqual(result['sessions'][0]['runtime']['catalog_digest'], plain._runtime_identity.metadata()['catalog_digest']) self.assertNotIn('observer', json.dumps(observed.tools)) + self.assertEqual(self.diagnostics.getvalue(), '', 'a healthy recorder is silent') def test_shape_and_feedback_disclose_no_values_or_dynamic_keys(self): schema = {'type': 'object', 'properties': { @@ -85,18 +148,165 @@ def test_shape_and_feedback_disclose_no_values_or_dynamic_keys(self): self.assertNotIn(secret, encoded) self.assertEqual(shape.project(value)['fields']['body'], 'redacted') self.assertEqual(shape.project(value)['fields']['facts']['fields'], {}) - feedback = shape.feedback({'issues': [ + issues = {'issues': [ {'instance_pointer': '/facts/facts/body', 'keyword': 'type', 'message': 'CREDENTIAL'}, {'instance_pointer': '/items/8/selector', 'keyword': 'required'}, {'instance_pointer': '/body/token', 'keyword': 'CREDENTIAL'}, - ]}) - self.assertEqual(feedback, [{'pointer': '/facts/*/*', 'keyword': 'type'}, - {'pointer': '/items/*/selector', 'keyword': 'required'}, - {'pointer': '/body/*', 'keyword': 'other'}]) + {'instance_pointer': '/facts/routing.topics', 'keyword': 'fact'}, + {'instance_pointer': '/items/routing.topics', 'keyword': 'evidence_ref'}, + ]} + self.assertEqual(shape.feedback(issues), [ + {'pointer': '/facts/*/*', 'keyword': 'type'}, {'pointer': '/items/*/selector', 'keyword': 'required'}, + {'pointer': '/body/*', 'keyword': 'other'}, {'pointer': '/facts/*', 'keyword': 'fact'}, + {'pointer': '/items/*', 'keyword': 'evidence_ref'}]) + # A fact name the same call already recorded may locate its own rejection; + # the same text under any other map stays a wildcard. + named = shape.feedback(issues, frozenset({'routing.topics'})) + self.assertEqual([issue['pointer'] for issue in named][3:], ['/facts/routing.topics', '/items/*']) # Deep/large adversarial data is bounded without traversing unknown maps. projected = shape.project({'items': [{'selector': 'x' * 1_000_000}] * 100_000}) self.assertLess(len(json.dumps(projected)), 8192) + def test_navigation_values_results_sizes_and_task_identity_are_recorded(self): + server = self.server() + initialize(server) + facts = {'routing.activities': ['implementation', 'testing'], 'python': True, 'task': 'p' * 300} + items = [{'target': 'core'}, {'target': 'router', 'detail': 'full', 'include_routing': True, 'extra': 'DROPPED'}] + calls = ( + ('route', {'facts': facts, 'content': {'limit': 1}, 'detail': 'compact'}, route_result()), + ('read', {'snapshot': SNAPSHOT, 'target': 'core', 'detail': 'full', 'handle': {'kind': 'DROPPED'}, + 'request': {'kind': 'route', 'facts': {'DROPPED': 'DROPPED'}}, 'facts': {'DROPPED': True}}, + read_result('core')), + ('read_many', {'snapshot': SNAPSHOT, 'items': items}, + {'kind': 'read-many-result', 'snapshot': SNAPSHOT, 'items': [read_result('core'), read_result('router')]}), + ('related', {'snapshot': SNAPSHOT, 'target': 'core', 'groups': ['semantic'], 'direction': 'both', 'transitive': False}, + rejection('GRAPH.UNKNOWN_GROUP')), + ('query_proposal', {'revision': {'kind': 'proposal-revision-handle', 'id': 'proposal-revision:sha256:' + 'cd' * 32}, + 'request': {'kind': 'route', 'facts': {'nested.fact': {'type': 'string', 'state': 'known', 'value': 'nested-value'}}}}, + rejection('AGGREGATE.UNAVAILABLE')), + ) + for name, arguments, value in calls: + self.call(server, name, arguments, value, CODEX_META) + server.dispatch(request('tools/call', {'name': 'describe_input', 'arguments': { + 'operation': 'route', 'selector': 'RouteCall', 'limit': 2, 'expected_catalog': 'sha256:' + '0' * 64}})) + recorded = {row['operation']: row for row in self.rows( + 'SELECT i.*,e.outcome,e.result,e.result_bytes FROM interactions i JOIN events e ON e.interaction=i.id ' + "WHERE i.method='tools/call'")} + values = {name: json.loads(row['arguments']) for name, row in recorded.items()} + results = {name: json.loads(row['result']) for name, row in recorded.items()} + self.assertEqual(values['route'], {'detail': 'compact', 'content': {'limit': 1}, 'facts': { + 'routing.activities': ['implementation', 'testing'], 'python': True, 'task': 'p' * 200 + TRUNCATED}}) + self.assertEqual(results['route'], { + 'kind': 'compact-route-result', 'status': 'needs-facts', 'selected': ['core', 'router'], + 'unresolved': ['routing.topics'], 'content': {'offset': 0, 'total': 2, 'items': 1, 'targets': ['core']}}) + self.assertEqual(recorded['route']['outcome'], 'needs-facts') + reused = values['read']['snapshot'] + self.assertRegex(reused, '^[0-9a-f]{12}$') + self.assertEqual(values['read'], {'snapshot': reused, 'target': 'core', 'detail': 'full'}) + self.assertEqual(values['read_many'], {'snapshot': reused, 'items': [ + {'target': 'core'}, {'target': 'router', 'detail': 'full', 'include_routing': True}]}) + self.assertEqual(results['read_many'], {'kind': 'read-many-result', 'targets': ['core', 'router']}) + self.assertEqual(values['related'], {'snapshot': reused, 'target': 'core', 'groups': ['semantic'], + 'direction': 'both', 'transitive': False}) + self.assertEqual(results['related'], {'kind': 'rejected-result', 'code': 'GRAPH.UNKNOWN_GROUP', 'outcome': 'invalid'}) + self.assertEqual(values['query_proposal'], {'revision': {'kind': 'proposal-revision-handle'}, 'request': { + 'kind': 'route', 'facts': {'nested.fact': {'type': 'string', 'state': 'known', 'value': 'nested-value'}}}}) + self.assertEqual(values['describe_input'], {'operation': 'route', 'selector': 'RouteCall', 'limit': 2}) + self.assertEqual(recorded['describe_input']['catalog_state'], 'differs') + # Sizes: the arguments object alone and one serialization of structuredContent. + self.assertEqual(recorded['read']['arguments_bytes'], len(json.dumps(calls[1][1], separators=(',', ':')))) + self.assertEqual(recorded['read']['result_bytes'], len(json.dumps(read_result('core')))) + self.assertGreater(recorded['read']['request_bytes'], recorded['read']['arguments_bytes']) + # Task identity: one salted hash per client thread, never the id itself. + threads = {(row['thread'], row['origin']) for name, row in recorded.items() if name != 'describe_input'} + self.assertEqual(len(threads), 1) + thread, origin = threads.pop() + self.assertRegex(thread, '^[0-9a-f]{16}$') + self.assertEqual(origin, 'subagent') + self.assertEqual((recorded['describe_input']['thread'], recorded['describe_input']['origin']), (None, 'unknown')) + self.assertEqual(self.rows('SELECT client_name,client_version FROM sessions'), + [{'client_name': 'test', 'client_version': '1'}]) + stored = self.stored_bytes() + for private in (b'SENTINEL', b'5e17e1a1', b'cdcdcdcd', b'DROPPED'): + self.assertNotIn(private, stored) + # The salt belongs to the database: another process maps the thread to the same hash. + second = self.server() + self.call(second, 'read', {'target': 'core'}, read_result('core'), CODEX_META) + self.assertEqual({row['thread'] for row in self.rows('SELECT thread FROM interactions WHERE thread IS NOT NULL')}, {thread}) + + def test_authoring_prose_never_reaches_disk_while_route_facts_do(self): + server = self.server(advanced=True) + initialize(server) + prose = {name: f'SENTINEL_{name.upper()}' for name in ( + 'body', 'title', 'summary', 'rationale', 'intent', 'heading', 'condition', 'path', 'label', + 'evidence', 'applies', 'verification', 'description', 'provenance', 'value', 'tool')} + evidence = {'id': prose['evidence'], 'digest': 'sha256:' + 'ef' * 32, 'provider_contract': 'review-evidence', + 'provider_contract_version': '1'} + change_set = {'purpose': {'summary': prose['summary'], 'rationale': prose['rationale'], 'evidence': [{'evidence_ref': prose['label']}]}, 'edits': [ + {'kind': 'revise-policy-unit', 'policy': 'workflow.planning.written-plan-applicability', 'title': prose['title'], 'body': prose['body'], + 'semantics': {'kind': 'change', 'accepted_semantic_revision': 1, 'proposed_semantic_revision': 2, 'intent': prose['intent']}}, + {'kind': 'create-standard', 'requires': ['core'], 'specializes': [], 'standard': { + 'id': 'topic.recorded-identifier', 'title': prose['title'], 'body': prose['body'], 'level': 'SHOULD', 'role': 'topic', + 'applies_when': prose['applies'], 'does_not_apply_when': prose['applies'], 'verification': prose['verification']}, + 'policy_units': [{'id': 'topic.recorded-identifier.unit', 'heading_chain': [prose['heading']], 'intent': prose['intent'], + 'semantic_revision': 1, 'aliases': [], 'predecessors': [], 'successors': []}]}, + {'kind': 'put-policy-relationship', 'relationship': { + 'source_policy': 'core.application-guidance', 'consumer': 'prompts/planning.md', 'relation': 'prompt-projection', + 'evidence_owner': 'review:consumer', 'rationale': prose['rationale'], 'applicability': {'operator': 'always'}}}, + {'kind': 'register-consumer', 'consumer': 'consumer.recorded', 'artifact_kind': 'documentation', 'authority': 'projection', + 'path': prose['path']}, + {'kind': 'put-routing-rule', 'rationale': prose['rationale'], 'rule': { + 'id': 'rule.recorded', 'target': 'topic.security', 'condition': prose['condition'], + 'when': {'operator': 'equals', 'fact': 'routing.topics', 'value': prose['value']}}}, + # Prose placed in an identifier field is dropped by its shape. + {'kind': 'audit-policy-unit', 'policy': 'SENTINEL PROSE in an identifier field', 'rationale': prose['rationale']}, + ]} + child = {'kind': 'analysis-child-handle', 'analysis': ANALYSIS, 'child_kind': 'obligation', 'child_id': 'sha256:' + '12' * 32} + calls = ( + ('propose', {'snapshot': SNAPSHOT, 'detail': 'full', 'change_set': change_set, 'evidence': {prose['label']: evidence}}), + ('revise', {'context': ANALYSIS, 'change_set': change_set}), + ('review', {'context': ANALYSIS, 'decisions': [ + {'owner': 'consumer', 'decision': 'accept', 'rationale': prose['rationale'], 'evidence': [evidence]}]}), + ('resolve_workflow', {'context': ANALYSIS, 'submission': { + 'kind': 'coverage-attestation', 'claim': {'requirement': child, 'conclusion': 'complete', 'rationale': prose['rationale'], + 'auditor_provenance': prose['provenance'], 'evidence': [evidence], + 'explicit_exclusions': [evidence]}}}), + ('recover', {'context': ANALYSIS, 'action': 'observe'}), + ('maintain_evidence', {'kind': 'maintain-evidence', 'expected_revision': prose['value'], 'apply': False, 'evidence': [evidence], + 'plan': {'suite_descriptions': [{'suite': prose['label'], 'description': prose['description']}], + 'replacement_evidence_rationale': prose['rationale'], + 'consumer_registrations': [{'path': prose['path'], 'rationale': prose['rationale'], + 'artifact_kind': 'fixture', 'relation': 'fixture-projection'}]}}), + ) + for name, arguments in calls: + self.call(server, name, arguments, rejection('INTERFACE.INVALID_ARGUMENTS', '/change_set/purpose/' + prose['label'], 'minItems'), + CODEX_META) + server.dispatch(request('tools/call', {'name': prose['tool'], 'arguments': {'body': prose['body']}}, identifier=prose['value'])) + # Route facts are kept as sent, in the focused form and inside a preview request. + self.call(server, 'route', {'facts': {'OOV_NAME_python': True, 'task': 'OOV free text about a parser', + 'routing.activities': ['implementation', 'OOV_VALUE_testing']}}, + rejection('ROUTE.INPUT_INVALID', '/facts')) + self.call(server, 'preview_application', {'revision': {'kind': 'proposal-revision-handle', 'id': 'proposal-revision:sha256:' + '34' * 32}, + 'request': {'kind': 'route', 'facts': {'OOV_NESTED': {'type': 'string', 'state': 'known', 'value': 'OOV_NESTED_VALUE'}}}}, + rejection('ROUTE.INPUT_INVALID', '/request/facts')) + for closed in (False, True): + stored = self.stored_bytes() # The main file, and the write-ahead log while it exists. + for private in (b'SENTINEL', b'abababab', b'efefefef', b'12121212', b'34343434', b'5e17e1a1'): + self.assertNotIn(private, stored, (private, closed)) + for kept in (b'OOV_NAME_python', b'OOV free text about a parser', b'OOV_VALUE_testing', b'OOV_NESTED_VALUE', + b'workflow.planning.written-plan-applicability', b'topic.recorded-identifier.unit', + b'prompts/planning.md', b'consumer.recorded', b'revise-policy-unit', b'analysis-handle', + b'INTERFACE.INVALID_ARGUMENTS'): + self.assertIn(kept, stored, (kept, closed)) + server.close() + summary = report(self.database) + self.assertNotIn('SENTINEL', json.dumps(summary) + text_report(summary)) + propose = json.loads(self.rows("SELECT arguments FROM interactions WHERE operation='propose'")[0]['arguments']) + self.assertEqual(propose['change_set']['edits'][0], { + 'kind': 'revise-policy-unit', 'policy': 'workflow.planning.written-plan-applicability', 'semantics': {'kind': 'change'}}) + self.assertEqual(propose['change_set']['edits'][5], {'kind': 'audit-policy-unit'}) + self.assertEqual((propose['snapshot'], propose['detail']), ({'kind': 'snapshot-handle'}, 'full')) + def test_privacy_at_real_dispatch_and_disk_boundary(self): server = self.server() initialize(server) @@ -104,7 +314,8 @@ def test_privacy_at_real_dispatch_and_disk_boundary(self): server.dispatch(request('tools/call', {'name': 'runtime_info', 'arguments': { 'expected_catalog': secrets[0], secrets[1]: secrets[2]}}, identifier=secrets[0])) server.dispatch(request('tools/call', {'name': secrets[1], 'arguments': {'body': secrets[2]}})) - server.dispatch(request('initialize', {'clientInfo': {'name': secrets[0]}})) + # Only the first initialize names the client; other clientInfo members are never read. + server.dispatch(request('initialize', {'clientInfo': {'name': secrets[0], 'title': secrets[1]}})) server.close() for path in self.database.parent.iterdir(): contents = path.read_bytes() @@ -120,20 +331,24 @@ def test_privacy_at_real_dispatch_and_disk_boundary(self): def test_malformed_envelopes_and_parse_errors_do_not_disable_recorder(self): server = self.server() for value in (None, [], {}, {'method': 'ping'}, {'id': 1, 'method': [], 'jsonrpc': '2.0'}, - request('tools/call', {'name': []}), request('ping', [])): + request('tools/call', {'name': []}), request('ping', []), + request('tools/call', {'name': 'route', 'arguments': [], '_meta': []}), + request('tools/call', {'name': 'read_many', 'arguments': {'items': 'x', 'snapshot': []}, + '_meta': {'x-codex-turn-metadata': {'thread_id': [], 'thread_source': {}}}})): server.dispatch(value) output = io.StringIO() serve(server, io.StringIO('{BAD JSON\n'), output) self.assertEqual(json.loads(output.getvalue())['error']['code'], -32700) self.assertEqual(server._observer.health['state'], 'healthy') - self.assertEqual(report(self.database)['retained_starts'], 8) + self.assertEqual(server._observer.health['lost'], 0) + self.assertEqual(report(self.database)['retained_starts'], 10) self.assertIn('parse-error', {row['outcome'] for row in self.rows('SELECT outcome FROM events')}) def test_tool_exception_interruption_and_delivery_failure(self): server = self.server() initialize(server) with patch.object(AgentToolFacade, 'open_repository') as opened, redirect_stderr(io.StringIO()): - opened.return_value.__enter__.side_effect = RuntimeError('SENSITIVE_EXCEPTION') + opened.return_value.apply.side_effect = RuntimeError('SENSITIVE_EXCEPTION') response = server.dispatch(request('tools/call', {'name': 'apply', 'arguments': {}})) self.assertTrue(response['result']['isError']) with patch.object(server, '_request', side_effect=KeyboardInterrupt('SENSITIVE_INTERRUPT')): @@ -146,33 +361,89 @@ def broken(response): events = self.rows('SELECT phase,outcome,response_bytes FROM events') self.assertEqual([r['outcome'] for r in events], ['response', 'tool-exception', 'unknown', 'unknown']) self.assertEqual(sum(r['phase'] == 'incomplete' for r in events), 2) - self.assertNotIn('SENSITIVE_', self.database.read_bytes().decode(errors='ignore')) + self.assertNotIn(b'SENSITIVE_', self.stored_bytes()) - def test_unavailable_locked_and_failed_health_sink_preserve_responses(self): - unavailable = Path(self.temporary.name) / 'missing' / 'db' - with redirect_stderr(io.StringIO()): - server = MCPServer(ROOT, purpose='authoring', observation=RecorderConfig(unavailable, 'synthetic')) - self.addCleanup(server.close) - self.assertEqual(server.dispatch(request('ping'))['result'], {}) - self.assertEqual(server._observer.health['state'], 'degraded') + def test_locked_database_delays_rows_but_never_drops_or_slows_a_call(self): observed = self.server() with sqlite3.connect(self.database, isolation_level=None) as lock: lock.execute('BEGIN IMMEDIATE') before = time.monotonic() - response = observed.dispatch(request('ping')) + responses = [observed.dispatch(request('ping')) for _ in range(3)] elapsed = time.monotonic() - before + self.assertEqual(report(self.database)['retained_starts'], 0) lock.execute('ROLLBACK') - self.assertEqual(response['result'], {}) - self.assertEqual(observed._observer.health['reason'], 'storage-locked') - self.assertLess(elapsed, 1, '20ms SQLite busy policy must not wait indefinitely') + self.assertEqual([response['result'] for response in responses], [{}, {}, {}]) + self.assertLess(elapsed, 1, 'six lock waits of 20 ms must not delay three calls materially') + health = observed._observer.health + self.assertEqual((health['state'], health['reason'], health['backlog']), ('degraded', 'storage-locked', 6)) + # The next call delivers the whole backlog in order. + observed.dispatch(request('ping')) + self.assertEqual((health['state'], health['backlog'], health['lost']), ('healthy', 0, 0)) + self.assertEqual((health['recorded_starts'], health['recorded_terminals']), (4, 4)) + self.assertEqual([row['ordinal'] for row in self.rows('SELECT ordinal FROM interactions ORDER BY started')], [1, 2, 3, 4]) + # Orderly close waits longer for a writer than a call may. + lock = sqlite3.connect(self.database, isolation_level=None, check_same_thread=False) + lock.execute('BEGIN IMMEDIATE') + observed.dispatch(request('ping')) + self.assertEqual(health['backlog'], 2) + release = threading.Timer(0.3, lambda: (lock.execute('ROLLBACK'), lock.close())) + release.start() + observed.close() + release.join() + summary = report(self.database) + self.assertEqual((summary['retained_starts'], summary['retained_terminals'], summary['lost_rows']), (5, 5, 0)) + notes = [json.loads(line.split(' ', 2)[2]) for line in self.diagnostics.getvalue().splitlines()] + # One line per change of health, then the totals at close; nothing while healthy. + self.assertEqual([(note['state'], note['reason']) for note in notes], + [('degraded', 'storage-locked'), ('healthy', None), ('degraded', 'storage-locked'), + ('healthy', None), ('healthy', None)]) + self.assertEqual((notes[-1]['recorded_starts'], notes[-1]['recorded_terminals'], notes[-1]['lost']), (5, 5, 0)) + + def test_backlog_overflow_is_counted_and_the_count_is_persisted(self): + observed = self.server() + with patch(MODULE + '.MAX_BACKLOG', 4): + with sqlite3.connect(self.database, isolation_level=None) as lock: + lock.execute('BEGIN IMMEDIATE') + for _ in range(5): + observed.dispatch(request('ping')) + lock.execute('ROLLBACK') + self.assertEqual((observed._observer.health['backlog'], observed._observer.health['lost']), (4, 6)) + observed.dispatch(request('ping')) + # Calls 1-3 overflowed (6 rows); call 4 lost its start to the sixth call and + # so its terminal as well (2 rows). Calls 5 and 6 are complete. + health = observed._observer.health + self.assertEqual((health['state'], health['lost'], health['recorded_starts'], health['recorded_terminals']), + ('healthy', 8, 2, 2)) + summary = report(self.database) + self.assertEqual((summary['retained_starts'], summary['retained_terminals'], summary['lost_rows']), (2, 2, 8)) + self.assertIn('8 rows lost', text_report(summary)) + + def test_unavailable_storage_reconnects_later_and_reports_what_it_never_wrote(self): + unavailable = Path(self.temporary.name) / 'missing' / 'db' + with redirect_stderr(io.StringIO()): + server = MCPServer(ROOT, purpose='authoring', observation=RecorderConfig(unavailable, 'synthetic')) + self.addCleanup(server.close) + self.assertEqual(server.dispatch(request('ping'))['result'], {}) + health = server._observer.health + self.assertEqual((health['state'], health['reason'], health['backlog']), ('degraded', 'storage-unavailable', 2)) + self.assertFalse(unavailable.parent.exists(), 'an operator-supplied directory is never created') + unavailable.parent.mkdir() + self.assertEqual(server.dispatch(request('ping'))['result'], {}) + self.assertEqual((health['state'], health['recorded_starts'], health['recorded_terminals'], health['lost']), + ('healthy', 2, 2, 0)) + # A process that can never write says so on stderr at close, with its count. class BrokenDiagnostics: def write(self, value): raise OSError('private') def flush(self): raise OSError('private') - recorder = InteractionRecorder(RecorderConfig(unavailable, 'synthetic'), {}, [], diagnostics=BrokenDiagnostics()) - recorder.close() - self.assertEqual(recorder.health['state'], 'degraded') + for diagnostics in (self.diagnostics, BrokenDiagnostics()): + recorder = InteractionRecorder(RecorderConfig(Path(self.temporary.name) / 'absent' / 'db', 'synthetic'), + {'instance_id': 'never', 'catalog_digest': 'c'}, [], diagnostics=diagnostics) + recorder.finish(recorder.begin(request('ping'), request_bytes=1, scope='constructed'), {'result': {}}) + recorder.close() + self.assertEqual((recorder.health['state'], recorder.health['lost']), ('degraded', 2)) + self.assertIn('"lost":2', self.diagnostics.getvalue().splitlines()[-1]) def test_full_storage_after_domain_result_never_repeats_work(self): server = self.server() @@ -195,6 +466,25 @@ def domain(method, params): self.assertEqual(calls, ['ping']) self.assertEqual(server._observer.health['reason'], 'storage-full') self.assertEqual(report(self.database)['unmatched_starts'], 1) + # The terminal waited in the backlog; a later call reconnects and delivers it. + server.dispatch(request('ping')) + self.assertEqual(server._observer.health['state'], 'healthy') + self.assertEqual(report(self.database)['unmatched_starts'], 0) + + def test_byte_cap_evicts_the_oldest_calls_instead_of_refusing_new_ones(self): + recorder = self.server(max_bytes=1024 * 1024)._observer + message = request('tools/call', {'name': 'route', 'arguments': { + 'facts': {f'routing.fact-{index}': ['v' * 150] * 2 for index in range(8)}}}) + for _ in range(900): + recorder.finish(recorder.begin(message, request_bytes=1, scope='constructed'), {'result': {}}, response_bytes=1) + health = recorder.health + self.assertEqual((health['state'], health['lost'], health['recorded_starts']), ('healthy', 0, 900)) + self.assertGreater(health['pruned_interactions'], 0) + retained = self.rows('SELECT min(ordinal) AS oldest,max(ordinal) AS newest,count(*) AS count FROM interactions')[0] + self.assertEqual(retained['newest'], 900) + self.assertEqual(retained['count'], 900 - health['pruned_interactions']) + recorder.close() + self.assertLessEqual(self.database.stat().st_size, 1024 * 1024) def test_migration_reopen_unsupported_corrupt_and_spoofed(self): server = self.server() @@ -203,14 +493,17 @@ def test_migration_reopen_unsupported_corrupt_and_spoofed(self): with sqlite3.connect(self.database) as db: self.assertEqual(db.execute('PRAGMA user_version').fetchone()[0], SCHEMA_VERSION) self.assertEqual(db.execute('PRAGMA application_id').fetchone()[0], APPLICATION_ID) + self.assertEqual(db.execute('PRAGMA journal_mode').fetchone()[0], 'wal') + self.assertRegex(db.execute("SELECT value FROM meta WHERE key='salt'").fetchone()[0], '^[0-9a-f]{32}$') again = self.server() again.dispatch(request('ping')) again.close() self.assertEqual(report(self.database)['retained_starts'], 2) - for name, setup in ( - ('future', 'PRAGMA user_version=999'), - ('unrelated', 'CREATE TABLE business (secret TEXT)'), - ('spoofed', f'PRAGMA user_version=1; PRAGMA application_id={APPLICATION_ID}; CREATE TABLE sessions(id TEXT)'), + for name, setup, reason in ( + ('future', 'PRAGMA user_version=999', 'unsupported-database-schema'), + ('unrelated', 'CREATE TABLE business (secret TEXT)', 'unsupported-database-schema'), + ('spoofed', f'PRAGMA user_version={SCHEMA_VERSION}; PRAGMA application_id={APPLICATION_ID}; CREATE TABLE sessions(id TEXT)', + 'invalid-database-schema'), ): target = Path(self.temporary.name) / name with sqlite3.connect(target) as db: @@ -219,7 +512,7 @@ def test_migration_reopen_unsupported_corrupt_and_spoofed(self): before = target.read_bytes() with redirect_stderr(io.StringIO()): recorder = InteractionRecorder(RecorderConfig(target, 'synthetic'), {}, []) - self.assertEqual(recorder.health['state'], 'degraded') + self.assertEqual((recorder.health['state'], recorder.health['reason']), ('degraded', reason)) self.assertEqual(target.read_bytes(), before) corrupt = Path(self.temporary.name) / 'corrupt' corrupt.write_bytes(b'not sqlite sensitive synthetic') @@ -229,7 +522,25 @@ def test_migration_reopen_unsupported_corrupt_and_spoofed(self): self.assertEqual(recorder.health['state'], 'degraded') self.assertEqual(corrupt.read_bytes(), before) - def test_unsupported_journal_and_page_budget_never_publish_migration(self): + def test_schema_v1_database_is_refused_and_left_untouched(self): + with sqlite3.connect(self.database) as db: + db.executescript(';'.join(V1_DDL) + f';PRAGMA application_id={APPLICATION_ID};PRAGMA user_version=1;' + "INSERT INTO sessions VALUES('historical',1.0,'{}','codex-local','{}',0)") + self.database.chmod(0o600) + before = self.database.read_bytes() + server = self.server() + self.assertEqual(server.dispatch(request('ping'))['result'], {}) + health = server._observer.health + self.assertEqual((health['state'], health['reason'], health['recorded_starts']), + ('degraded', 'unsupported-database-schema', 0)) + server.close() + self.assertEqual(self.database.read_bytes(), before) + self.assertEqual(sorted(path.name for path in self.database.parent.iterdir()), [self.database.name]) + with self.assertRaises(StorageRejected): + report(self.database) + self.assertIn('unsupported-database-schema', self.diagnostics.getvalue()) + + def test_foreign_wal_store_and_page_budget_never_publish_migration(self): for name, pragma in (('wal', 'PRAGMA journal_mode=WAL'),): path = Path(self.temporary.name) / name with sqlite3.connect(path) as db: @@ -238,7 +549,7 @@ def test_unsupported_journal_and_page_budget_never_publish_migration(self): before = path.read_bytes() recorder = InteractionRecorder(RecorderConfig(path, 'synthetic', max_bytes=1024*1024), {}, [], diagnostics=io.StringIO()) - self.assertEqual(recorder.health['state'], 'degraded') + self.assertEqual((recorder.health['state'], recorder.health['reason']), ('degraded', 'nonpristine-database')) self.assertEqual(path.read_bytes(), before) with sqlite3.connect(path) as db: self.assertEqual(db.execute('PRAGMA user_version').fetchone()[0], 0) @@ -307,6 +618,24 @@ def test_private_regular_file_and_no_symlink_or_hardlink(self): self.assertEqual(recorder.health['reason'], 'unsafe-database-file') self.assertEqual(public.stat().st_mode & 0o777, 0o644) + def test_default_location_follows_xdg_and_is_created_private(self): + home = Path(self.temporary.name) / 'home' + with patch.dict(os.environ, {'HOME': str(home), 'XDG_DATA_HOME': ''}): + self.assertEqual(default_database(), home / '.local/share/standards-engine/observations' / DEFAULT_DATABASE_NAME) + with patch.dict(os.environ, {'XDG_DATA_HOME': 'relative/ignored'}): + self.assertEqual(default_database().parents[2], home / '.local/share') + with patch.dict(os.environ, {'XDG_DATA_HOME': str(home / 'xdg')}): + recorder = InteractionRecorder(RecorderConfig(), {'instance_id': 'default', 'catalog_digest': 'c'}, [], + diagnostics=self.diagnostics) + recorder.finish(recorder.begin(request('ping'), request_bytes=1, scope='constructed'), {'result': {}}) + recorder.close() + database = home / 'xdg/standards-engine/observations' / DEFAULT_DATABASE_NAME + self.assertEqual(default_database(), database) + self.assertEqual(recorder.health['recorded_terminals'], 1) + self.assertEqual(stat.S_IMODE(database.stat().st_mode), 0o600) + self.assertEqual(stat.S_IMODE(database.parent.stat().st_mode), 0o700) + self.assertEqual(self.diagnostics.getvalue(), '') + def test_count_age_and_session_retention_and_read_only_reports(self): # Every process-like recorder has its own session; old empty sessions must # disappear along with their interactions rather than accumulating forever. @@ -317,6 +646,7 @@ def test_count_age_and_session_retention_and_read_only_reports(self): summary = report(self.database, limit=1) self.assertEqual(summary['retained_starts'], 16) self.assertEqual(len(self.rows('SELECT id FROM sessions')), 16) + self.assertEqual(len(self.rows('SELECT digest FROM catalogs')), 1, 'one catalog row serves every session') self.assertTrue(summary['session_rows_truncated']) with sqlite3.connect(self.database) as db: db.execute('UPDATE interactions SET started=0') @@ -330,6 +660,8 @@ def test_count_age_and_session_retention_and_read_only_reports(self): for limit in (0, 1001): with self.assertRaises(ValueError): report(self.database, limit=limit) + with self.assertRaises(ValueError): + report(self.database, since_days=0) missing = Path(self.temporary.name) / 'absent.sqlite' with self.assertRaises(FileNotFoundError): report(missing) @@ -343,12 +675,13 @@ def test_retention_can_evict_inflight_evidence_without_disabling_a_live_process( second.dispatch(request('ping')) first._observer.finish(ticket, {'result': {}}, response_bytes=14) self.assertEqual(first._observer.health['state'], 'healthy') - self.assertEqual(first._observer.health['dropped_observations'], 1) + self.assertEqual(first._observer.health['lost'], 1) first.dispatch(request('ping')) self.assertEqual(first._observer.health['recorded_terminals'], 1) summary = report(self.database) self.assertEqual(summary['retained_starts'], 16) self.assertEqual(summary['retained_terminals'], 16) + self.assertEqual(summary['lost_rows'], 1) def test_observed_discovery_and_error_sequences_have_explicit_denominators(self): server = self.server() @@ -403,13 +736,69 @@ def test_report_scope_truncation_and_bounded_scan_are_explicit(self): self.assertTrue(bounded['sequence_scan_truncated']) self.assertIn('input_shape', summary['shapes'][0]) + def test_text_report_answers_the_interface_questions_in_a_screenful(self): + server = self.server() + initialize(server) + thread = {'x-codex-turn-metadata': {'thread_id': 'thread-a', 'thread_source': 'user'}} + self.call(server, 'route', {'facts': {}, 'content': {}}, route_result(('routing.activities', 'routing.topics')), thread) + self.call(server, 'route', {'snapshot': SNAPSHOT, 'facts': {'routing.activities': ['implementation']}}, route_result(), thread) + self.call(server, 'route', {'facts': {'python': True, 'task': 'write a parser test', 'routing.topics': ['security']}}, + rejection('ROUTE.INPUT_INVALID', '/facts'), thread) + for _ in range(2): + self.call(server, 'route', {'facts': {'routing.activities': ['implementation', 'testing']}}, + rejection('ROUTE.INPUT_INVALID', '/facts/routing.activities'), thread) + for target in ('core', 'core', 'router'): + self.call(server, 'read', {'snapshot': SNAPSHOT, 'target': target}, read_result(target), thread) + self.call(server, 'read', {'target': 'python-standards'}, rejection('NAVIGATION.UNKNOWN_POLICY')) + open_call = server._observer.begin(request('ping'), request_bytes=1, scope='constructed') + summary = report(self.database) + text = text_report(summary) + lines = text.splitlines() + self.assertLessEqual(len(lines), 50) + self.assertLessEqual(max(map(len, lines)), 130) + self.assertEqual(lines[2], '11 calls: 1 without an outcome (process ended mid-call), 0 rows lost, 0 pruned by retention') + self.assertRegex(text, r'test 1 +authoring +\d+ +1 +11') + usage = {row['operation']: row for row in summary['usage']} + self.assertEqual((usage['route']['calls'], usage['route']['rejected'], usage['route']['rejection_rate']), (5, 3, 0.6)) + self.assertGreaterEqual(usage['route']['duration_max_ms'], usage['route']['duration_p90_ms']) + self.assertGreaterEqual(usage['route']['duration_p90_ms'], usage['route']['duration_p50_ms']) + self.assertEqual(usage['read']['result_max_bytes'], + max(len(json.dumps(value)) for value in (read_result('router'), rejection('NAVIGATION.UNKNOWN_POLICY')))) + self.assertRegex(text, r'route +5 +60\.0% +[\d.]+ +[\d.]+ +[\d.]+ +[\d.]+ k?B +[\d.]+ k?B') + self.assertIn(' 2 route ROUTE.INPUT_INVALID /facts/routing.activities (fact) ["implementation","testing"]', lines) + self.assertIn(' 1 read NAVIGATION.UNKNOWN_POLICY - {"target":"python-standards"}', lines) + self.assertEqual(summary['unaccepted_facts'], { + 'names': [{'name': 'python', 'count': 1}, {'name': 'task', 'count': 1}], + 'values': [{'fact': 'routing.activities', 'value': 'testing', 'count': 2}]}) + self.assertIn(' names: python x1, task x1', lines) + self.assertIn(' values: routing.activities=testing x2', lines) + # Two route content pages delivered core; three reads returned core, core, router. + self.assertIn(' core x4, router x1', lines) + self.assertEqual(summary['repeat_reads'], {'reads': 5, 'repeats': 3, 'threads': 1, 'threads_repeating': 1, + 'worst_thread_rate': 0.6}) + self.assertIn('Routes sent without a snapshot: 4 of 5 (80.0%)', lines) + self.assertEqual(lines[-3:], ['Tool-calling threads threads calls reads repeated', + 'main 1 8 3 of 5 (60.0%)', + 'unknown 1 1 0 of 0']) + # The window filter drops older calls from every section. + with sqlite3.connect(self.database) as db: + db.execute("UPDATE interactions SET started=started-3*86400 WHERE operation='route'") + recent = report(self.database, since_days=1) + self.assertEqual(recent['retained_starts'], 6) + self.assertNotIn('route', {row['operation'] for row in recent['usage']}) + self.assertIn('(last 1 days)', text_report(recent)) + server._observer.finish(open_call, {'result': {}}) + def test_arbitrary_outputs_are_never_retained(self): server = self.server() initialize(server) secret = 'SYNTHETIC_OUTPUT_CREDENTIAL' - result = {'structuredContent': {'body': secret, 'outcome': secret, + result = {'structuredContent': {'body': secret, 'outcome': secret, 'kind': secret, 'code': secret, 'status': secret, + 'content': {'offset': secret, 'total': secret, 'items': [{'policy': {'id': secret + ' prose'}, 'content': secret}]}, + 'reading_plan': [{'target': secret + ' prose', 'state': 'selected'}], 'input_feedback': {'issues': [{'instance_pointer': '/' + secret, - 'keyword': secret, 'message': secret}]}}, 'isError': True} + 'keyword': secret, 'message': secret}]}}, 'isError': True, + 'content': [{'type': 'text', 'text': secret}]} with patch.object(server, '_request', return_value=result): response = server.dispatch(request('tools/call', {'name': 'runtime_info', 'arguments': {}})) self.assertEqual(response['result'], result) @@ -422,59 +811,144 @@ def test_unencodable_text_measurement_never_changes_stdio_behavior(self): server = self.server() if observed else MCPServer(ROOT, purpose='authoring') self.addCleanup(server.close) output = io.StringIO() - payload = '{"jsonrpc":"2.0","id":"\ud800","method":"ping"}\n' + payload = '{"jsonrpc":"2.0","id":"\ud800","method":"ping","params":{"_meta":{"threadId":"\ud800"}}}\n' serve(server, io.StringIO(payload), output) self.assertEqual(json.loads(output.getvalue())['result'], {}) + self.assertEqual(report(self.database)['retained_terminals'], 1) + def test_no_test_or_harness_launch_can_reach_the_default_database(self): + # Always-on recording must not follow the test suite into a developer's home. + # In-process MCPServer construction records only when given a configuration; + # every file that launches the server module as a process must disable + # recording or name a database explicitly. + launch = re.compile(r'''standards_engine\.mcp["']|standards_engine\.mcp import main''') + guards = ('--no-observe', '--observe-database', 'STANDARDS_ENGINE_OBSERVE') + sources = [path for folder in ('tools', 'evaluation', '.agents') for path in sorted((ROOT / folder).rglob('*.py'))] + launchers = [path for path in sources if launch.search(path.read_text())] + # Files that launch only through the shared server helper name no module + # and can pass no option that turns recording back on. + helper = Path(stdio_server.__file__).resolve() + delegating = [path for path in sources if 'tests.stdio_server import' in path.read_text()] + self.assertIn(helper, [path.resolve() for path in launchers]) + self.assertGreater(len(launchers) + len(delegating), 20) + for path in launchers: + self.assertTrue(any(guard in path.read_text() for guard in guards), path) + with patch.object(stdio_server.subprocess, 'Popen', side_effect=OSError('launch observed')) as launched: + with self.assertRaisesRegex(OSError, 'launch observed'): + stdio_server.StdioServer(ROOT, purpose='application', options=('--observe-database', str(self.database))) + self.assertEqual(launched.call_args.args[0][-1], '--no-observe', 'the helper disables recording on every launch') class ProcessTests(unittest.TestCase): + def setUp(self): + self.temporary = tempfile.TemporaryDirectory() + self.addCleanup(self.temporary.cleanup) + self.home = Path(self.temporary.name) / 'home' + self.home.mkdir() + self.database = Path(self.temporary.name) / 'observer.sqlite' + + def census(self): + with sqlite3.connect(self.database) as db: + self.assertEqual(db.execute('PRAGMA integrity_check').fetchone()[0], 'ok') + self.assertEqual(db.execute('PRAGMA foreign_key_check').fetchall(), []) + return (db.execute('SELECT count(*) FROM interactions').fetchone()[0], + db.execute('SELECT count(*) FROM events').fetchone()[0], + db.execute('SELECT count(*) FROM (SELECT 1 FROM interactions i JOIN events e ON e.interaction=i.id ' + 'GROUP BY i.session HAVING count(*)=22)').fetchone()[0], + db.execute('SELECT coalesce(sum(lost),0) FROM sessions').fetchone()[0]) + + def test_always_on_by_default_in_both_purposes_invisible_and_two_off_switches(self): + messages = [request('initialize', {'protocolVersion': '2025-11-25', 'capabilities': {}, + 'clientInfo': {'name': 'default-on-fixture', 'version': '7'}}), + {'jsonrpc': '2.0', 'method': 'notifications/initialized'}, request('tools/list', identifier=2), + request('tools/call', {'name': 'runtime_info', 'arguments': {}}, identifier=3)] + payload = ''.join(json.dumps(message) + '\n' for message in messages) + def run(purpose, *flags, **variables): + process = subprocess.run([sys.executable, '-m', MCP_MODULE, '--repo-root', str(ROOT), '--purpose', purpose, *flags], + cwd=ROOT, env=environment(self.home, **variables), input=payload, + capture_output=True, text=True, timeout=60) + self.assertEqual(process.returncode, 0, process.stderr) + self.assertEqual(process.stderr, '', 'recording health is silent unless something is wrong') + return re.sub('[0-9a-f]{8}(-[0-9a-f]{4}){3}-[0-9a-f]{12}', 'INSTANCE', process.stdout) + silent = [run('application', '--no-observe'), run('application', STANDARDS_ENGINE_OBSERVE='off'), + run('application', '--observe-database', str(self.database), STANDARDS_ENGINE_OBSERVE=' OFF ')] + self.assertEqual(list(self.home.iterdir()), [], 'both off switches leave no file or directory') + self.assertFalse(self.database.exists()) + observed = run('application') + self.assertEqual({observed}, set(silent), 'recording changes no protocol byte') + run('authoring') + default = self.home / '.local/share/standards-engine/observations' / DEFAULT_DATABASE_NAME + self.assertEqual(stat.S_IMODE(default.stat().st_mode), 0o600) + self.assertEqual(stat.S_IMODE(default.parent.stat().st_mode), 0o700) + summary = report(default) + self.assertEqual((summary['retained_starts'], summary['retained_terminals']), (6, 6)) + self.assertEqual([(row['client'], row['purpose'], row['sessions'], row['calls']) for row in summary['clients']], + [('default-on-fixture 7', 'application', 1, 3), ('default-on-fixture 7', 'authoring', 1, 3)]) + self.assertEqual({row['deployment'] for row in summary['sessions']}, {'local'}) + run('application', XDG_DATA_HOME=str(self.home / 'xdg'), STANDARDS_ENGINE_OBSERVE='on') + self.assertEqual(report(self.home / 'xdg/standards-engine/observations' / DEFAULT_DATABASE_NAME)['retained_starts'], 3) + run('application', '--observe-database', str(self.database), '--observe-deployment', 'explicit') + self.assertEqual(report(self.database)['sessions'][0]['deployment'], 'explicit') + self.assertEqual(report(default)['retained_starts'], 6) + def test_cold_stdio_restart_bytes_identity_and_operator_cli(self): - with tempfile.TemporaryDirectory() as temporary: - database = Path(temporary) / 'observer.sqlite' - messages = [request('initialize', {'protocolVersion': '2025-11-25', 'capabilities': {}, 'clientInfo': {}}), - {'jsonrpc': '2.0', 'method': 'notifications/initialized'}, request('tools/list'), - request('tools/call', {'name': 'describe_input', 'arguments': {'operation': 'runtime_info'}}), - request('tools/call', {'name': 'runtime_info', 'arguments': {'unexpected': 'SYNTHETIC_SECRET'}}), - request('tools/call', {'name': 'runtime_info', 'arguments': {}})] - payload = ''.join(json.dumps(message) + '\n' for message in messages) - command = [sys.executable, '-m', MCP_MODULE, '--repo-root', str(ROOT), '--purpose', 'authoring', - '--output-schemas', 'on-demand', '--observe-database', str(database), '--observe-deployment', 'cold-test'] - identities = [] - for _ in range(2): - process = subprocess.run(command, cwd=ROOT, input=payload, capture_output=True, text=True, timeout=30) - self.assertEqual(process.returncode, 0, process.stderr) - responses = [json.loads(line) for line in process.stdout.splitlines()] - identity = responses[0]['result']['_meta']['standards-engine/runtime'] - identities.append(identity) - with sqlite3.connect(database) as db: - row = db.execute('SELECT runtime FROM sessions WHERE id=?', (identity['instance_id'],)).fetchone() - self.assertEqual(json.loads(row[0]), identity) - counts = db.execute('SELECT sum(request_bytes) FROM interactions WHERE session=?', (identity['instance_id'],)).fetchone()[0] - notification_bytes = len((json.dumps(messages[1]) + '\n').encode()) - self.assertEqual(counts, len(payload.encode()) - notification_bytes) - output_bytes = db.execute('SELECT sum(e.response_bytes) FROM events e JOIN interactions i ' - 'ON i.id=e.interaction WHERE session=?', (identity['instance_id'],)).fetchone()[0] - self.assertEqual(output_bytes, len(process.stdout.encode())) - self.assertIn('"state":"healthy"', process.stderr) - self.assertNotEqual(identities[0]['instance_id'], identities[1]['instance_id']) - for key in ('implementation_digest', 'schema_digest', 'catalog_digest', 'interface_version'): - self.assertEqual(identities[0][key], identities[1][key]) - summary = report(database) - self.assertEqual(summary['retained_starts'], 10) - self.assertEqual(summary['retained_terminals'], 10) - self.assertEqual({row['scope'] for row in summary['operations']}, {'stdio-flushed'}) - before = database.read_bytes() - result = subprocess.run([sys.executable, '-m', MODULE, '--database', str(database), '--limit', '2'], - cwd=ROOT, capture_output=True, text=True, timeout=30) - self.assertEqual(result.returncode, 0, result.stderr) - self.assertEqual(json.loads(result.stdout)['retained_starts'], 10) - self.assertEqual(database.read_bytes(), before) + messages = [request('initialize', {'protocolVersion': '2025-11-25', 'capabilities': {}, 'clientInfo': {}}), + {'jsonrpc': '2.0', 'method': 'notifications/initialized'}, request('tools/list'), + request('tools/call', {'name': 'describe_input', 'arguments': {'operation': 'runtime_info'}}), + request('tools/call', {'name': 'runtime_info', 'arguments': {'unexpected': 'SYNTHETIC_SECRET'}}), + request('tools/call', {'name': 'runtime_info', 'arguments': {}})] + payload = ''.join(json.dumps(message) + '\n' for message in messages) + command = [sys.executable, '-m', MCP_MODULE, '--repo-root', str(ROOT), '--purpose', 'authoring', + '--output-schemas', 'on-demand', '--observe-database', str(self.database), '--observe-deployment', 'cold-test'] + identities = [] + for _ in range(2): + process = subprocess.run(command, cwd=ROOT, env=environment(self.home), input=payload, + capture_output=True, text=True, timeout=30) + self.assertEqual(process.returncode, 0, process.stderr) + self.assertEqual(process.stderr, '') + responses = [json.loads(line) for line in process.stdout.splitlines()] + identity = responses[0]['result']['_meta']['standards-engine/runtime'] + identities.append(identity) + with sqlite3.connect(self.database) as db: + row = db.execute('SELECT runtime FROM sessions WHERE id=?', (identity['instance_id'],)).fetchone() + self.assertEqual(json.loads(row[0]), identity) + counts = db.execute('SELECT sum(request_bytes) FROM interactions WHERE session=?', (identity['instance_id'],)).fetchone()[0] + notification_bytes = len((json.dumps(messages[1]) + '\n').encode()) + self.assertEqual(counts, len(payload.encode()) - notification_bytes) + output_bytes, result_bytes = db.execute( + 'SELECT sum(e.response_bytes),sum(e.result_bytes) FROM events e JOIN interactions i ' + 'ON i.id=e.interaction WHERE session=?', (identity['instance_id'],)).fetchone() + self.assertEqual(output_bytes, len(process.stdout.encode())) + self.assertEqual(result_bytes, sum(len(response['result']['content'][0]['text']) for response in responses[2:])) + self.assertLess(2 * result_bytes, output_bytes) + self.assertNotEqual(identities[0]['instance_id'], identities[1]['instance_id']) + for key in ('implementation_digest', 'schema_digest', 'catalog_digest', 'interface_version'): + self.assertEqual(identities[0][key], identities[1][key]) + summary = report(self.database) + self.assertEqual(summary['retained_starts'], 10) + self.assertEqual(summary['retained_terminals'], 10) + self.assertEqual({row['scope'] for row in summary['operations']}, {'stdio-flushed'}) + before = self.database.read_bytes() + cli = [sys.executable, '-m', MODULE, '--database', str(self.database)] + result = subprocess.run(cli + ['--format', 'json', '--limit', '2'], cwd=ROOT, env=environment(self.home), + capture_output=True, text=True, timeout=30) + self.assertEqual(result.returncode, 0, result.stderr) + self.assertEqual(json.loads(result.stdout)['retained_starts'], 10) + self.assertLess(len(result.stdout), 16_000, 'no per-session schema digests in the report') + result = subprocess.run(cli + ['--since-days', '1'], cwd=ROOT, env=environment(self.home), + capture_output=True, text=True, timeout=30) + self.assertEqual(result.returncode, 0, result.stderr) + self.assertIn('10 calls: 0 without an outcome', result.stdout) + self.assertRegex(result.stdout, r'runtime_info +4 +50\.0%') + self.assertNotIn('SYNTHETIC_SECRET', result.stdout) + self.assertEqual(self.database.read_bytes(), before) + # Without --database the report reads the always-on location, here an empty home. + result = subprocess.run(cli[:3], cwd=ROOT, env=environment(self.home), capture_output=True, text=True, timeout=30) + self.assertEqual((result.returncode, result.stdout), (1, '')) + self.assertEqual(list(self.home.iterdir()), []) def test_process_kill_leaves_unmatched_start_and_replacement_does_not_complete_it(self): - with tempfile.TemporaryDirectory() as temporary: - database = Path(temporary) / 'observer.sqlite' - script = ''' + script = ''' import sys, threading from pathlib import Path from tools.standards_engine.standards_engine.mcp import MCPServer, serve @@ -486,62 +960,119 @@ def blocked(method, params): server._request=blocked serve(server,sys.stdin,sys.stdout) ''' - process = subprocess.Popen([sys.executable, '-c', script, str(ROOT), str(database)], cwd=ROOT, - stdin=subprocess.PIPE, stdout=subprocess.PIPE, stderr=subprocess.PIPE, text=True) - try: - process.stdin.write(json.dumps(request('ping')) + '\n') - process.stdin.flush() - self.assertIn('healthy', process.stderr.readline()) - self.assertEqual(process.stderr.readline().strip(), 'entered-domain') + process = subprocess.Popen([sys.executable, '-c', script, str(ROOT), str(self.database)], cwd=ROOT, + env=environment(self.home), + stdin=subprocess.PIPE, stdout=subprocess.PIPE, stderr=subprocess.PIPE, text=True) + try: + process.stdin.write(json.dumps(request('ping')) + '\n') + process.stdin.flush() + self.assertEqual(process.stderr.readline().strip(), 'entered-domain') + process.kill() + process.communicate(timeout=10) + finally: + if process.poll() is None: process.kill() process.communicate(timeout=10) - finally: - if process.poll() is None: - process.kill() - process.communicate(timeout=10) - replacement = subprocess.run([sys.executable, '-m', MCP_MODULE, '--purpose', 'authoring', - '--observe-database', str(database), '--observe-deployment', 'replacement'], - cwd=ROOT, input=json.dumps(request('ping')) + '\n', - text=True, capture_output=True, timeout=30) - self.assertEqual(replacement.returncode, 0, replacement.stderr) - summary = report(database) - self.assertEqual(summary['retained_starts'], 2) - self.assertEqual(summary['retained_terminals'], 1) - self.assertEqual(summary['unmatched_starts'], 1) - - def test_concurrent_processes_and_first_open_never_overwrite_or_duplicate(self): - with tempfile.TemporaryDirectory() as temporary: - database = Path(temporary) / 'observer.sqlite' - command = [sys.executable, '-m', MCP_MODULE, '--purpose', 'authoring', - '--observe-database', str(database), '--observe-deployment', 'concurrent'] - workers = [subprocess.Popen(command, cwd=ROOT, stdin=subprocess.PIPE, stdout=subprocess.PIPE, - stderr=subprocess.PIPE, text=True) for _ in range(4)] - try: - outputs = [] - for worker in workers: - worker.stdin.write(''.join(json.dumps(request('ping', identifier=i)) + '\n' for i in range(5))) - worker.stdin.flush() - for worker in workers: - output, errors = worker.communicate(timeout=30) - self.assertEqual(worker.returncode, 0, errors) - self.assertEqual(len(output.splitlines()), 5) - outputs.append(errors) - finally: - for worker in workers: - if worker.poll() is None: - worker.kill() - worker.communicate(timeout=10) - # Contention may intentionally degrade a process after the 20ms budget. - # A failed terminal write may leave an unmatched begin; no duplicate or - # fabricated terminal is permitted. Domain replies still total 20. - summary = report(database) - self.assertGreater(summary['retained_starts'], 0) - self.assertLessEqual(summary['retained_starts'], 20) - self.assertLessEqual(summary['retained_terminals'], summary['retained_starts']) - with sqlite3.connect(database) as db: - self.assertEqual(db.execute('PRAGMA integrity_check').fetchone()[0], 'ok') - self.assertEqual(db.execute('PRAGMA foreign_key_check').fetchall(), []) - self.assertTrue(all('healthy' in output or 'degraded' in output for output in outputs)) + replacement = subprocess.run([sys.executable, '-m', MCP_MODULE, '--purpose', 'authoring', + '--observe-database', str(self.database), '--observe-deployment', 'replacement'], + cwd=ROOT, env=environment(self.home), input=json.dumps(request('ping')) + '\n', + text=True, capture_output=True, timeout=30) + self.assertEqual(replacement.returncode, 0, replacement.stderr) + summary = report(self.database) + self.assertEqual(summary['retained_starts'], 2) + self.assertEqual(summary['retained_terminals'], 1) + self.assertEqual(summary['unmatched_starts'], 1) + self.assertIn('2 calls: 1 without an outcome', text_report(summary)) + + def test_eight_recorders_creating_one_database_at_the_same_instant_lose_nothing(self): + script = ''' +import io, sys, time +from pathlib import Path +from tools.standards_engine.standards_engine.interaction_observer import InteractionRecorder, RecorderConfig +while time.time() < float(sys.argv[2]): + pass +recorder = InteractionRecorder(RecorderConfig(Path(sys.argv[1]), 'simultaneous'), {'instance_id': sys.argv[3], 'catalog_digest': 'c'}, + [{'name': 'runtime_info', 'inputSchema': {'type': 'object'}}], diagnostics=io.StringIO()) +calls = [('initialize', {}), ('tools/list', {})] + [('tools/call', {'name': 'runtime_info', 'arguments': {}})] * 20 +for identifier, (method, params) in enumerate(calls): + ticket = recorder.begin({'jsonrpc': '2.0', 'id': identifier, 'method': method, 'params': params}, request_bytes=1, scope='constructed') + recorder.finish(ticket, {'result': {}}, response_bytes=1) +recorder.close() +''' + for attempt in range(3): + self.database = Path(self.temporary.name) / f'simultaneous-{attempt}.sqlite' + instant = time.time() + 1.5 # After every interpreter has imported the Engine. + workers = [subprocess.Popen([sys.executable, '-c', script, str(self.database), str(instant), f'worker-{index}'], + cwd=ROOT, env=environment(self.home), stdout=subprocess.PIPE, stderr=subprocess.PIPE, text=True) + for index in range(8)] + for worker in workers: + output, errors = worker.communicate(timeout=60) + self.assertEqual(worker.returncode, 0, errors) + self.assertEqual(self.census(), (176, 176, 8, 0)) + + def servers(self, count=8): + command = [sys.executable, '-m', MCP_MODULE, '--repo-root', str(ROOT), '--purpose', 'application', + '--output-schemas', 'on-demand', '--observe-database', str(self.database)] + return [subprocess.Popen(command, cwd=ROOT, env=environment(self.home), stdin=subprocess.PIPE, + stdout=subprocess.PIPE, stderr=subprocess.PIPE, text=True) for _ in range(count)] + + def lines(self, *messages): + return ''.join(json.dumps(message) + '\n' for message in messages) + + def collect(self, workers, responses): + errors = [] + try: + for worker in workers: + output, error = worker.communicate(timeout=60) + self.assertEqual(worker.returncode, 0, error) + self.assertEqual(len(output.splitlines()), responses) + errors.append(error) + finally: + for worker in workers: + if worker.poll() is None: + worker.kill() + worker.communicate(timeout=10) + return errors + + def test_eight_server_processes_started_together_record_every_call(self): + opening = self.lines(request('initialize', {'protocolVersion': '2025-11-25', 'capabilities': {}, + 'clientInfo': {'name': 'fan-out', 'version': '1'}}), + {'jsonrpc': '2.0', 'method': 'notifications/initialized'}) + calls = self.lines(request('tools/list', identifier=2), + *(request('tools/call', {'name': 'runtime_info', 'arguments': {}}, identifier=3 + index) for index in range(20))) + # No database exists yet: all eight create it while starting. + workers = self.servers() + for worker in workers: + worker.stdin.write(opening + calls) + worker.stdin.flush() + self.collect(workers, 22) + self.assertEqual(self.census(), (176, 176, 8, 0)) + # Again while another connection holds the write lock for 500 ms. + workers = self.servers() + try: + for worker in workers: + worker.stdin.write(opening) + worker.stdin.flush() + for worker in workers: + self.assertIn('"result"', worker.stdout.readline()) + lock = sqlite3.connect(self.database, isolation_level=None) + lock.execute('BEGIN IMMEDIATE') + for worker in workers: + worker.stdin.write(calls) + worker.stdin.flush() + time.sleep(0.5) + self.assertEqual(self.census()[0], 184, 'nothing is written while the lock is held') + lock.execute('ROLLBACK') + lock.close() + finally: + errors = self.collect(workers, 21) + self.assertEqual(self.census(), (352, 352, 16, 0)) + locked = [error for error in errors if '"reason":"storage-locked"' in error] + self.assertTrue(locked, 'the lock must have forced at least one process to use its backlog') + for error in errors: + if error: + final = json.loads(error.splitlines()[-1].split(' ', 2)[2]) + self.assertEqual((final['state'], final['backlog'], final['lost']), ('healthy', 0, 0)) if __name__ == '__main__': diff --git a/tools/standards_engine/tests/test_mcp.py b/tools/standards_engine/tests/test_mcp.py index 6547ef9b..208f914e 100644 --- a/tools/standards_engine/tests/test_mcp.py +++ b/tools/standards_engine/tests/test_mcp.py @@ -6,8 +6,10 @@ import json import os from pathlib import Path +import shutil import subprocess import sys +import tempfile import unittest from unittest.mock import patch @@ -23,6 +25,22 @@ ROOT = Path(__file__).resolve().parents[3] +def installation_root(case): + """A temporary root holding only the installed interface. + + A tool call opens its store under the served root even when the call is then + rejected; serving this root keeps that store out of the repository under test. + """ + temporary = tempfile.TemporaryDirectory(prefix="engine-installation-") + case.addCleanup(temporary.cleanup) + for name in ("a1-interface.toml", "a1-contract.schema.json", "generated/agent-tools.json"): + relative = Path("tools/standards_engine/contracts") / name + target = Path(temporary.name) / relative + target.parent.mkdir(parents=True, exist_ok=True) + shutil.copyfile(ROOT / relative, target) + return Path(temporary.name) + + def request(method, params=None, identifier=1): return { "jsonrpc": "2.0", @@ -198,7 +216,7 @@ def test_default_guidance_uses_available_recovery_tools(self): patch.object(AgentToolFacade, "open_repository") as opened, redirect_stderr(io.StringIO()), ): - facade = opened.return_value.__enter__.return_value + facade = opened.return_value facade.apply.side_effect = RuntimeError("failure") response = server.dispatch( request( @@ -239,15 +257,16 @@ def test_lifecycle_and_protocol_errors_never_open_engine(self): def test_preserves_typed_outcomes_and_never_retries(self): server = MCPServer(ROOT, advanced=True, purpose="authoring") initialize(server) - for kind in ( - "pending-result", - "complete-result", - "rejected-result", - "application-recovery-required-result", - ): - value = {"kind": kind, "next_operations": ["recover_application"]} - with patch.object(AgentToolFacade, "open_repository") as opened: - facade = opened.return_value.__enter__.return_value + with patch.object(AgentToolFacade, "open_repository") as opened: + facade = opened.return_value + for kind in ( + "pending-result", + "complete-result", + "rejected-result", + "application-recovery-required-result", + ): + value = {"kind": kind, "next_operations": ["recover_application"]} + facade.apply_proposal.reset_mock() facade.apply_proposal.return_value = value response = server.dispatch( request( @@ -265,7 +284,14 @@ def test_preserves_typed_outcomes_and_never_retries(self): {"readiness": {"opaque": "identity"}} ) facade.recover_application.assert_not_called() - opened.return_value.__exit__.assert_called_once() + # Every typed outcome, a rejection included, leaves the one Engine + # open for the next call, with its store connection closed after + # each; the server closes the Engine when it closes. + opened.assert_called_once() + self.assertEqual(facade.release.call_count, 4) + facade.close.assert_not_called() + server.close() + facade.close.assert_called_once() def test_internal_failure_is_tool_error_without_retry(self): server = MCPServer(ROOT, advanced=True, purpose="authoring") @@ -274,7 +300,7 @@ def test_internal_failure_is_tool_error_without_retry(self): patch.object(AgentToolFacade, "open_repository") as opened, redirect_stderr(io.StringIO()), ): - facade = opened.return_value.__enter__.return_value + facade = opened.return_value facade.apply_proposal.side_effect = RuntimeError("private diagnostic") response = server.dispatch( request("tools/call", {"name": "apply_proposal"}) @@ -283,6 +309,11 @@ def test_internal_failure_is_tool_error_without_retry(self): self.assertNotIn("private diagnostic", json.dumps(response)) facade.apply_proposal.assert_called_once() facade.recover_application.assert_not_called() + # The Engine whose outcome is unknown is closed, not kept for the next call. + facade.close.assert_called_once() + server.dispatch(request("tools/call", {"name": "apply_proposal"})) + self.assertEqual(opened.call_count, 2) + self.assertEqual(facade.apply_proposal.call_count, 2) def test_application_failure_diagnostic_omits_private_exception(self): server = MCPServer(ROOT, purpose="application") @@ -292,7 +323,7 @@ def test_application_failure_diagnostic_omits_private_exception(self): patch.object(AgentToolFacade, "open_repository") as opened, redirect_stderr(stderr), ): - opened.return_value.__enter__.return_value.read.side_effect = RuntimeError("private diagnostic") + opened.return_value.read.side_effect = RuntimeError("private diagnostic") response = server.dispatch(request("tools/call", {"name": "read"}))["result"] self.assertTrue(response["isError"]) self.assertNotIn("private diagnostic", json.dumps(response) + stderr.getvalue()) @@ -303,10 +334,10 @@ def test_real_snapshot_read_and_validation_through_server(self): initialize(server) with StandardsEngine.open_repository(ROOT, durable=False, purpose="authoring") as engine: facade = AgentToolFacade(engine, _contracts(ROOT)) - # The context manager normally owns a durable store per request. - # Keep this test's in-memory store open across both calls. + # The server normally opens the durable store under its root. + # Serve this test's temporary store for all three calls instead. with patch.object(AgentToolFacade, "open_repository") as opened: - opened.return_value.__enter__.return_value = facade + opened.return_value = facade created = server.dispatch( request( "tools/call", @@ -386,6 +417,7 @@ def test_module_stdio_launch_from_unrelated_working_directory(self): {"jsonrpc": "2.0", "method": "notifications/initialized"}, request("tools/list", identifier=2), ] + # Separate process: the module starts as a client starts it, from an unrelated directory. result = subprocess.run( [ sys.executable, @@ -396,6 +428,7 @@ def test_module_stdio_launch_from_unrelated_working_directory(self): "authoring", "--repo-root", str(ROOT), + "--no-observe", ], input="".join(json.dumps(message) + "\n" for message in messages), text=True, diff --git a/tools/standards_engine/tests/test_navigation_indexes.py b/tools/standards_engine/tests/test_navigation_indexes.py index 7508828e..fe48b918 100644 --- a/tools/standards_engine/tests/test_navigation_indexes.py +++ b/tools/standards_engine/tests/test_navigation_indexes.py @@ -377,6 +377,7 @@ def test_fresh_mcp_process_exposes_snapshot_bound_navigation(self): identifier=2, ), ] + # Separate process: a server started elsewhere reads the index from the durable snapshot. process = subprocess.run( [ sys.executable, @@ -387,6 +388,7 @@ def test_fresh_mcp_process_exposes_snapshot_bound_navigation(self): "authoring", "--repo-root", str(self.root), + "--no-observe", ], input="".join(json.dumps(message) + "\n" for message in messages), text=True, diff --git a/tools/standards_engine/tests/test_nested_materials.py b/tools/standards_engine/tests/test_nested_materials.py index 2925dbdd..7d03ae0b 100644 --- a/tools/standards_engine/tests/test_nested_materials.py +++ b/tools/standards_engine/tests/test_nested_materials.py @@ -10,6 +10,7 @@ from tools.standards_analysis.standards_analysis import AnalysisExecutionContext from tools.standards_engine.standards_engine import AgentToolFacade, StandardsEngine from tools.standards_engine.standards_engine import _generated_contract as c +from tools.standards_engine.standards_engine.compiled_cache import CompiledSnapshotCache from tools.standards_engine.standards_engine.logical_authoring import StandardsChangeSet from tools.standards_engine.standards_engine import logical_authoring as logical from tools.standards_engine.standards_engine.operation_materials import ProposalMaterials @@ -66,12 +67,13 @@ def submission(self, proposed): } @contextmanager - def counts(self): + def counts(self, engine=None): + engine = engine or self.engine with ( - patch.object(self.engine._snapshots, "load_content", wraps=self.engine._snapshots.load_content) as load, - patch.object(self.engine, "_compiled_snapshot", wraps=self.engine._compiled_snapshot) as compiled, - patch.object(self.engine, "_proposal_projection", wraps=self.engine._proposal_projection) as project, - patch.object(self.engine, "_evaluate", wraps=self.engine._evaluate) as evaluate, + patch.object(engine._snapshots, "load_content", wraps=engine._snapshots.load_content) as load, + patch.object(engine, "_compiled_snapshot", wraps=engine._compiled_snapshot) as compiled, + patch.object(engine, "_proposal_projection", wraps=engine._proposal_projection) as project, + patch.object(engine, "_evaluate", wraps=engine._evaluate) as evaluate, ): yield load, compiled, project, evaluate @@ -90,25 +92,45 @@ def test_propose_shares_validation_and_analysis_material(self): self.assertEqual(self.facade.workflow_status({"detail": "full", "context": proposed["context"]}), proposed) def test_revise_compiles_only_old_and_new_projections(self): - proposed = self.propose() - self.assertIsNone(self.engine._compiled_cache) - with self.counts() as counts, patch.object( - logical, "_refresh_suite_input_projection", wraps=logical._refresh_suite_input_projection, - ) as refresh: - revised = self.facade.revise({"detail": "full", - "context": proposed["context"], "change_set": self.change(revision=True), - }) - self.assertEqual(revised["status"], "complete", revised) - self.assert_counts(counts, projections=2, evaluations=2) - # One preflight replay plus one suffix; not a second replay of edit one. - self.assertEqual(refresh.call_count, 2) - self.assertNotEqual(revised["revision"], proposed["revision"]) - self.assertEqual(self.facade.workflow_status({"detail": "full", "context": proposed["context"]})["status"], "stale") - target = self.change()["edits"][0]["standard"]["id"] - old = self.facade.query_proposal({"revision": proposed["revision"], "request": {"kind": "read", "target": target}}) - new = self.facade.query_proposal({"revision": revised["revision"], "request": {"kind": "read", "target": target}}) - self.assertNotIn("Revised fixture text.", old["content"]) - self.assertIn("Revised fixture text.", new["content"]) + # An Engine that retains nothing shows all the work a revision needs. + retaining_nothing = CompiledSnapshotCache(self.root, "authoring", max_entries=0) + self.addCleanup(retaining_nothing.close) + cold_engine = StandardsEngine.open_repository( + self.root, purpose="authoring", compiled_cache=retaining_nothing, + execution_context=AnalysisExecutionContext(LocalAlwaysAllowAuthorizer(self.root)), + ) + self.addCleanup(cold_engine.close) + cold = AgentToolFacade(cold_engine, _contracts(self.root)) + self.assertTrue(self.engine._owns_compiled_cache) + for facade, engine, suffix, replays in ( + # One preflight replay plus one suffix; not a second replay of edit one. + (cold, cold_engine, "-cold", 2), + # The Engine's own cache still holds the projection `propose` built, + # so the preflight replays nothing and only the suffix runs. + (self.facade, self.engine, "", 1), + ): + with self.subTest(replays=replays): + proposed = facade.propose({"detail": "full", + "snapshot": self.snapshot, "change_set": self.change(suffix), + }) + self.assertEqual(proposed["status"], "complete", proposed) + with self.counts(engine) as counts, patch.object( + logical, "_refresh_suite_input_projection", wraps=logical._refresh_suite_input_projection, + ) as refresh: + revised = facade.revise({"detail": "full", + "context": proposed["context"], "change_set": self.change(suffix, revision=True), + }) + self.assertEqual(revised["status"], "complete", revised) + self.assert_counts(counts, projections=2, evaluations=2) + self.assertEqual(refresh.call_count, replays) + self.assertNotEqual(revised["revision"], proposed["revision"]) + self.assertEqual(facade.workflow_status({"detail": "full", "context": proposed["context"]})["status"], "stale") + target = self.change(suffix)["edits"][0]["standard"]["id"] + old = facade.query_proposal({"revision": proposed["revision"], "request": {"kind": "read", "target": target}}) + new = facade.query_proposal({"revision": revised["revision"], "request": {"kind": "read", "target": target}}) + self.assertNotIn("Revised fixture text.", old["content"]) + self.assertIn("Revised fixture text.", new["content"]) + self.assertEqual(retaining_nothing.statistics["entries"], 0) def test_resolution_reuses_material_with_three_fresh_evaluations(self): proposed = self.propose(normative=True) diff --git a/tools/standards_engine/tests/test_numeric_boundary.py b/tools/standards_engine/tests/test_numeric_boundary.py index 202f7fa3..0aa6e654 100644 --- a/tools/standards_engine/tests/test_numeric_boundary.py +++ b/tools/standards_engine/tests/test_numeric_boundary.py @@ -3,19 +3,17 @@ from copy import deepcopy import json -import os from pathlib import Path import subprocess -import sys import tempfile import unittest from tools.standards_engine.standards_engine import AgentToolFacade, SnapshotHandle +from tools.standards_engine.tests.stdio_server import StdioServer from tools.standards_engine.tests.test_agent_workflow import evidence from tools.standards_engine.tests.test_analysis import _clone_tracked_worktree, _section_body from tools.standards_engine.tests.test_request_evidence import shared -ROOT = Path(__file__).resolve().parents[3] POLICY = 'workflow.planning.written-plan-applicability' @@ -101,22 +99,12 @@ def test_invalid_numeric_and_digest_requests_create_no_draft(self): self.assertEqual(self.main(), self.main_before) def cold_call(self, operation, arguments, rejected=False): - messages = [ - {'jsonrpc': '2.0', 'id': 1, 'method': 'initialize', 'params': { - 'protocolVersion': '2025-11-25', 'capabilities': {}, - 'clientInfo': {'name': 'boundary-regression', 'version': '1'}}}, - {'jsonrpc': '2.0', 'method': 'notifications/initialized'}, - {'jsonrpc': '2.0', 'id': 2, 'method': 'tools/call', - 'params': {'name': operation, 'arguments': arguments}}, - ] - result = subprocess.run([sys.executable, '-P', '-m', - 'tools.standards_engine.standards_engine.mcp', '--repo-root', str(self.root), - '--purpose', 'authoring', '--output-schemas', 'on-demand', '--advanced'], - input=''.join(json.dumps(m) + '\n' for m in messages), text=True, - capture_output=True, env={**os.environ, 'PYTHONPATH': str(ROOT)}, timeout=90) - self.assertEqual(result.returncode, 0, result.stderr) - self.assertEqual(result.stderr, '') - reply = json.loads(result.stdout.splitlines()[-1])['result'] + # One server process, started on first use, serves every call of a test. + if not hasattr(self, 'server'): + self.server = StdioServer(self.root, purpose='authoring', client='boundary-regression', + options=('--output-schemas', 'on-demand', '--advanced')) + self.addCleanup(self.server.close) + reply = self.server.call(operation, arguments)['result'] self.assertEqual(reply['isError'], rejected, reply) self.assertEqual(json.loads(reply['content'][0]['text']), reply['structuredContent']) return reply['structuredContent'] diff --git a/tools/standards_engine/tests/test_output_delivery.py b/tools/standards_engine/tests/test_output_delivery.py index 7a0cafd1..c467747c 100644 --- a/tools/standards_engine/tests/test_output_delivery.py +++ b/tools/standards_engine/tests/test_output_delivery.py @@ -213,11 +213,12 @@ def run(call): messages=[init,{'jsonrpc':'2.0','method':'notifications/initialized'},request('tools/list',identifier=2), request('tools/call',{'name':'describe_output','arguments':call},identifier=3)] process=subprocess.run([sys.executable,'-m','tools.standards_engine.standards_engine.mcp', - '--repo-root',str(ROOT),'--purpose','authoring','--output-schemas','on-demand'], + '--repo-root',str(ROOT),'--purpose','authoring','--output-schemas','on-demand','--no-observe'], input=''.join(json.dumps(x)+'\n' for x in messages),capture_output=True,text=True,cwd=ROOT,check=True) replies=[json.loads(x) for x in process.stdout.splitlines()] self.assertTrue(all('outputSchema' not in t for t in replies[1]['result']['tools'])) return replies[2]['result']['structuredContent'] + # Two processes: the continuation is honoured by a server that did not issue it. first=run({'operation':'review','limit':1}); second=run(first['next']) self.assertEqual(first['schema_digest'],second['schema_digest']) self.assertEqual(first['catalog_digest'],second['catalog_digest']) diff --git a/tools/standards_engine/tests/test_process_reuse.py b/tools/standards_engine/tests/test_process_reuse.py index b09716d7..7cc7744a 100644 --- a/tools/standards_engine/tests/test_process_reuse.py +++ b/tools/standards_engine/tests/test_process_reuse.py @@ -1,4 +1,4 @@ -"""Real per-call stores with bounded pure compilation and installed API reuse.""" +"""Real stores with bounded pure compilation and installed API reuse.""" from __future__ import annotations from copy import deepcopy @@ -15,6 +15,8 @@ import unittest from unittest.mock import patch +from jsonschema import Draft202012Validator + from tools.standards_contracts.standards_contracts import ContractError from tools.standards_engine.standards_engine import AgentToolFacade, StandardsEngine from tools.standards_engine.standards_engine import engine as engine_module @@ -26,7 +28,7 @@ from tools.standards_engine.tests.test_agent_workflow import ( prepare_repository, reference_change, ) -from tools.standards_engine.tests.test_mcp import initialize, request +from tools.standards_engine.tests.test_mcp import initialize, installation_root, request from tools.standards_snapshots.standards_snapshots import CapturedContent, SnapshotId ROOT = Path(__file__).resolve().parents[3] @@ -217,10 +219,11 @@ def test_real_stdio_restarts_read_the_same_retained_snapshot(self): request("tools/call", {"name": "read", "arguments": {"snapshot": self.original_snapshot, "target": "core"}}, identifier=3), ] observed = [] + # Two processes: a restarted server reads the retained snapshot exactly as the first did. for _ in range(2): completed = subprocess.run( [sys.executable, "-P", "-m", "tools.standards_engine.standards_engine.mcp", - "--repo-root", str(self.root), "--purpose", "authoring"], + "--repo-root", str(self.root), "--purpose", "authoring", "--no-observe"], input="".join(json.dumps(value) + "\n" for value in messages), text=True, capture_output=True, check=True, timeout=60, cwd=self.temporary.name, env={**os.environ, "PYTHONPATH": str(ROOT)}, @@ -294,8 +297,9 @@ def quarantine(request): class InstalledInterfaceReuseTest(unittest.TestCase): def test_one_interface_compile_per_server_and_fresh_call_validation(self): + root = installation_root(self) with patch.object(tool_module, "_contracts", wraps=tool_module._contracts) as compiled: - server = MCPServer(ROOT, purpose="authoring") + server = MCPServer(root, purpose="authoring") self.addCleanup(server.close) initialize(server) for _ in range(2): @@ -325,7 +329,12 @@ def test_catalog_and_runtime_share_the_installed_interface(self): def test_stream_eof_and_write_failure_release_process_resources(self): for failing in (False, True): - server = MCPServer(ROOT, purpose="authoring") + server = MCPServer(installation_root(self), purpose="authoring") + # The stream ends while the process holds its Engine and cache. + initialize(server) + rejected = server.dispatch(request("tools/call", {"name": "read", "arguments": {"extra": True}})) + self.assertTrue(rejected["result"]["isError"]) + engine = server._facade._engine if failing: class FailedOutput(io.StringIO): def write(self, value): @@ -335,11 +344,16 @@ def write(self, value): else: serve(server, io.StringIO(""), io.StringIO()) self.assertIsNone(server._interface) - self.assertEqual(server._compiled_cache.statistics["entries"], 0) + self.assertIsNone(server._facade) + with self.assertRaises(sqlite3.ProgrammingError): + engine._snapshots._store._connection.execute("SELECT 1") + with self.assertRaisesRegex(ValueError, "closed"): + engine._compiled_cache.require_scope(engine._repository.root, "authoring") + self.assertEqual(engine._compiled_cache.statistics["entries"], 0) self.assertEqual(server.dispatch(request("ping"))["error"]["code"], -32000) - def test_each_tool_call_opens_and_closes_its_own_facade(self): - server = MCPServer(ROOT, purpose="application") + def test_tool_calls_share_one_facade_opened_with_the_installed_interface(self): + server = MCPServer(installation_root(self), purpose="application") self.addCleanup(server.close) initialize(server) opened = AgentToolFacade.open_repository @@ -347,10 +361,11 @@ def test_each_tool_call_opens_and_closes_its_own_facade(self): for _ in range(2): value = server.dispatch(request("tools/call", {"name": "read", "arguments": {"extra": True}})) self.assertTrue(value["result"]["isError"]) - self.assertEqual(calls.call_count, 2) - for call in calls.call_args_list: - self.assertIs(call.kwargs["interface"], server._interface) - self.assertIs(call.kwargs["compiled_cache"], server._compiled_cache) + self.assertEqual(calls.call_count, 1) + self.assertIs(calls.call_args.kwargs["interface"], server._interface) + # No cache is lent: the process's one Engine keeps its own for its lifetime. + self.assertNotIn("compiled_cache", calls.call_args.kwargs) + self.assertTrue(server._facade._engine._owns_compiled_cache) def test_main_advancement_and_cold_historical_read_use_exact_captures(self): from tools.standards_verifier.standards_verifier import suite_input_projection_bytes @@ -388,23 +403,60 @@ def test_main_advancement_and_cold_historical_read_use_exact_captures(self): with AgentToolFacade.open_repository(root, purpose="authoring", interface=interface) as cold: self.assertEqual(cold.read({"snapshot": first["snapshot"], "target": "core"}), first) - def test_existing_publication_scenario_with_warm_purpose_isolated_caches(self): - # Reuse the unchanged assertions, not a second approximate workflow. - from tools.standards_engine.tests.test_supporting_workflow import SupportingWorkflowTest - case = SupportingWorkflowTest("test_coordinated_publication_and_provenance_only_revision") - SupportingWorkflowTest.setUpClass() - caches = [] - try: - for name, purpose in (("author", "authoring"), ("app", "application")): - getattr(case, name).close() - cache = CompiledSnapshotCache(case.root, purpose) - caches.append(cache) - setattr(SupportingWorkflowTest, name, AgentToolFacade.open_repository( - case.root, purpose=purpose, compiled_cache=cache, - )) - case.test_coordinated_publication_and_provenance_only_revision() - self.assertTrue(all(cache.statistics["hits"] > 0 for cache in caches)) - finally: - SupportingWorkflowTest.tearDownClass() - for cache in caches: - cache.close() + +class InstalledSchemaValidationTest(unittest.TestCase): + """Startup repeats metaschema validation only for a schema the generator did not validate.""" + + @staticmethod + def metaschema_checks(): + return patch.object( + Draft202012Validator, "check_schema", wraps=Draft202012Validator.check_schema + ) + + def contract_root(self, change=lambda schema: None): + # Interface loading reads these two files and nothing else. + temporary = tempfile.TemporaryDirectory(prefix="installed-schema-") + self.addCleanup(temporary.cleanup) + root = Path(temporary.name) + schema = json.loads((ROOT / tool_module.INTERFACE_SCHEMA).read_text(encoding="utf-8")) + change(schema) + for relative, text in ( + (tool_module.INTERFACE_SCHEMA, json.dumps(schema, indent=4)), + (tool_module.INTERFACE_CONTRACT, (ROOT / tool_module.INTERFACE_CONTRACT).read_text(encoding="utf-8")), + ): + (root / relative).parent.mkdir(parents=True, exist_ok=True) + (root / relative).write_text(text, encoding="utf-8") + return root + + def test_generated_schema_is_not_validated_again_at_server_start(self): + with self.metaschema_checks() as checked: + server = MCPServer(ROOT, purpose="authoring") + self.addCleanup(server.close) + self.assertEqual(initialize(server)["result"]["serverInfo"]["name"], "standards-engine") + # The recorded digest names the JSON value, so a reformatted copy is the same schema. + reformatted = AgentToolFacade.load_interface(self.contract_root()) + checked.assert_not_called() + self.assertEqual(reformatted.schema, server._interface.schema) + self.assertEqual(reformatted.reachable_definitions, server._interface.reachable_definitions) + + def test_schema_changed_since_generation_is_validated_at_startup(self): + def edited(schema): + schema["description"] += " Edited without regenerating." + root = self.contract_root(edited) + with self.metaschema_checks() as checked: + compiled = AgentToolFacade.load_interface(root) + self.assertEqual(checked.call_count, 1) + self.assertTrue(compiled.schema["description"].endswith(" Edited without regenerating.")) + + def test_invalid_schema_is_rejected_at_startup(self): + def invalid(schema): + schema["$defs"]["NonEmptyString"]["minLength"] = -1 + root = self.contract_root(invalid) + for name, start in ( + ("interface", lambda: AgentToolFacade.load_interface(root)), + ("server", lambda: MCPServer(root, purpose="authoring")), + ): + with self.subTest(start=name): + with self.assertRaises(ContractError) as caught: + start() + self.assertEqual(caught.exception.failure.code, "CONTRACT.INVALID_SCHEMA") diff --git a/tools/standards_engine/tests/test_proposal_consumers.py b/tools/standards_engine/tests/test_proposal_consumers.py index 8035adc2..8801e216 100644 --- a/tools/standards_engine/tests/test_proposal_consumers.py +++ b/tools/standards_engine/tests/test_proposal_consumers.py @@ -198,7 +198,7 @@ def test_existing_canonical_identity_and_artifact_alias_are_not_rebound(self): with self.subTest(identity=identity),self.assertRaises(AuthoringError): self.project([self.bound([registration(identity,self.fixture_path)])]) - def test_candidate_view_uses_same_qualification_without_published_handles(self): + def test_candidate_view_uses_same_delivery_and_labels_without_published_handles(self): from tools.standards_engine.standards_engine.context_projection import ApplicationView, preview_application from tools.standards_engine.standards_engine import _generated_contract as c result=self.project([self.bound(self.initial_edits())]) @@ -210,15 +210,28 @@ def test_candidate_view_uses_same_qualification_without_published_handles(self): self.assertEqual(value['content'],normal['content']) self.assertEqual(value['requires'],normal['requires']) self.assertEqual(value['kind'],'candidate-application-read-result') + self.assertEqual((value['review_state'],normal['review_state']),('current','current')) self.assertNotIn('snapshot',value);self.assertNotIn('handle',value['policy']) import json self.assertNotIn('AUTHORING_PRIVATE_8159',json.dumps(value)) self.assertNotIn('fixture.first',json.dumps(value)) - for target in [self.document,'provenance.consumer-test','fixture.first']: + def preview(target): call=c.PreviewApplicationCall.from_value({'revision':revision.as_contract(),'request':{'kind':'read','target':target}}) - denied=preview_application(None,result.compiled,call).as_contract() + return preview_application(None,result.compiled,call).as_contract() + # Registered documentation without an approval is delivered with its label. + document=preview(self.document) + self.assertEqual(document['kind'],'candidate-application-read-result') + self.assertEqual(document['review_state'],'not-reviewed') + self.assertEqual(document['content'],'# Correct Consumer Guidance\n\nApply the owned rule.\n') + self.assertEqual(document['review_state'],ApplicationView(result.compiled,snapshot).read(self.document).as_contract()['review_state']) + # Authoring provenance and unregistered consumers are not application material. + for target in ['provenance.consumer-test','fixture.first','topic.consumer-fixture.misspelt']: + denied=preview(target) self.assertEqual(denied['kind'],'candidate-application-rejected-result') + self.assertEqual((denied['code'],denied['outcome']),('APPLICATION.UNKNOWN_TARGET','invalid')) + self.assertIn('not registered',denied['message']) self.assertEqual(denied['revision'],revision.as_contract()) + self.assertNotIn('AUTHORING_PRIVATE_8159',json.dumps(denied)) class CandidateProjectionTests(unittest.TestCase): @@ -267,15 +280,53 @@ def test_related_result_uses_revision_bound_continuations(self): self.assertTrue(candidate['next_operations']) self.assertTrue(all(op['operation']=='preview_application' for op in candidate['next_operations'])) - def test_stale_exposure_is_rejected_without_partial_candidate_content(self): + def test_stale_exposure_is_labelled_in_delivered_candidate_content(self): files=dict(self.state.files) files['CORE-STANDARDS.md']+=b'\nUNAPPROVED_NEW_MATERIAL\n' compiled=self.fixture.compile_files(files) - for request in ({'kind':'read','target':'core'}, {'kind':'route','facts':{}}): - result=self.preview(request,compiled) - self.assertEqual(result['code'],'APPLICATION.CONTENT_UNAVAILABLE') - self.assertEqual(result['revision'],self.revision.as_contract()) - self.assertNotIn('content',result) + read=self.preview({'kind':'read','target':'core'},compiled) + self.assertEqual(read['kind'],'candidate-application-read-result') + self.assertEqual(read['review_state'],'changed-since-review') + self.assertIn('UNAPPROVED_NEW_MATERIAL',read['content']) + self.assertEqual(read['revision'],self.revision.as_contract()) + route=self.preview({'kind':'route','facts':{}},compiled) + self.assertEqual(route['kind'],'candidate-application-route-result') + labels={entry['target']:entry['review_state'] for entry in route['reading_plan']} + self.assertEqual(labels['core'],'changed-since-review') + self.assertEqual(labels['router'],'current') + + def test_preview_and_published_application_agree_on_labels_and_rejections(self): + import json + facts={'routing.'+key:{'type':'enum-set','state':'known','value':['implementation'] if key=='activities' else []} + for key in ('activities','workflow-profiles','applications','boundaries','languages','frameworks','topics','details')} + candidate=self.preview({'kind':'route','facts':facts}) + published=self.state.facade.query({'snapshot':self.state.snapshot,'request':{'kind':'route','facts':facts}}) + self.assertEqual(candidate['kind'],'candidate-application-route-result') + for field in ('status','reading_plan','unresolved_questions'): + self.assertEqual(candidate[field],published[field]) + labels={entry['target']:entry['review_state'] for entry in candidate['reading_plan']} + self.assertEqual(labels['workflow.implementation'],'not-reviewed') + self.assertEqual(labels['core'],'current') + for operation in candidate['next_operations']: + read=self.preview(operation['request']) + normal=self.state.facade.read({'snapshot':self.state.snapshot,'target':operation['request']['target']}) + for field in ('review_state','content','scope','requires','specializes'): + self.assertEqual(read[field],normal[field]) + self.assertEqual(read['review_state'],labels[operation['request']['target']]) + requests=[({'kind':'read','target':'does.not.exist'},'APPLICATION.UNKNOWN_TARGET'), + ({'kind':'related','target':'does.not.exist','groups':['semantic'],'direction':'outgoing','transitive':False},'APPLICATION.UNKNOWN_TARGET'), + ({'kind':'related','target':'core','groups':['plausible-but-invalid'],'direction':'outgoing','transitive':False},'APPLICATION.UNKNOWN_GROUP'), + ({'kind':'related','target':'core','groups':['policy-impact'],'direction':'outgoing','transitive':True},'APPLICATION.TRAVERSAL_NOT_PERMITTED')] + for request,code in requests: + with self.subTest(request=request): + rejected=self.preview(request) + normal=self.state.facade.query({'snapshot':self.state.snapshot,'request':request}) + self.assertEqual(rejected['kind'],'candidate-application-rejected-result') + for field in ('code','outcome','message'): + self.assertEqual(rejected[field],normal[field]) + self.assertEqual(rejected['code'],code) + self.assertEqual(rejected['revision'],self.revision.as_contract()) + self.assertNotIn('awaiting',json.dumps(rejected)) if __name__ == '__main__': diff --git a/tools/standards_engine/tests/test_proposal_reuse.py b/tools/standards_engine/tests/test_proposal_reuse.py index afa9cfa6..dcd98ba2 100644 --- a/tools/standards_engine/tests/test_proposal_reuse.py +++ b/tools/standards_engine/tests/test_proposal_reuse.py @@ -493,9 +493,10 @@ def test_two_fresh_stdio_servers_reproduce_same_historical_draft(self): args = {"revision": self.latest["revision"], "request": {"kind": "read", "target": self.target}} messages += [request("tools/call", {"name": "query_proposal", "arguments": args}, i) for i in (2, 3)] observed = [] + # Two processes: each fresh server reconstructs the same historical draft. for _ in range(2): process = subprocess.run( - [sys.executable, "-P", "-m", "tools.standards_engine.standards_engine.mcp", "--repo-root", str(self.root), "--purpose", "authoring"], + [sys.executable, "-P", "-m", "tools.standards_engine.standards_engine.mcp", "--repo-root", str(self.root), "--purpose", "authoring", "--no-observe"], input="".join(json.dumps(item) + "\n" for item in messages), text=True, capture_output=True, check=True, timeout=90, env={**os.environ, "PYTHONPATH": str(ROOT)}, cwd=self.temporary.name, diff --git a/tools/standards_engine/tests/test_purpose_projection.py b/tools/standards_engine/tests/test_purpose_projection.py index 1dbde1c7..e20adcf0 100644 --- a/tools/standards_engine/tests/test_purpose_projection.py +++ b/tools/standards_engine/tests/test_purpose_projection.py @@ -1,4 +1,4 @@ -"""Focused exposure evidence over captured content and the actual SQLite store.""" +"""Focused review-label evidence over captured content and the actual SQLite store.""" from __future__ import annotations from dataclasses import replace @@ -92,7 +92,8 @@ def test_read_has_exact_reviewed_content_and_explicit_permitted_fields(self): self.assertEqual(value["content"], self.files["CORE-STANDARDS.md"].decode()) self.assertIn(PUBLIC, value["content"]) self.assertNotIn(PRIVATE, json.dumps(value)) - self.assertEqual(set(value), {"kind", "purpose", "snapshot", "policy", "content", "scope", "requires", "specializes", "next_operations"} | ({"related"} if detail == "full" else set())) + self.assertEqual(set(value), {"kind", "purpose", "snapshot", "policy", "review_state", "content", "scope", "requires", "specializes", "next_operations"} | ({"related"} if detail == "full" else set())) + self.assertEqual(value["review_state"], "current") self.assertNotIn("provenance", value) def test_direct_hidden_read_and_privileged_request_are_bounded(self): @@ -144,17 +145,141 @@ def test_material_change_requires_new_exposure_but_rationale_change_does_not(sel self.assertEqual(reason.materials["core"].binding, self.compiled.materials["core"].binding) self.assertEqual(reason.supporting.exposure_state("core", reason.materials["core"].binding), "current") - def test_routing_retains_unknown_facts_and_blocks_missing_required_content(self): + def capture(self, files, label): + captured = self.engine._snapshots.create_snapshot(CapturedContent(label, ( + SnapshotFile(SnapshotPath.parse(path), value) for path, value in refresh(dict(files)).files))) + return self.engine._snapshot_handle(captured.snapshot) + + def implementation_facts(self): + facts = {"routing."+key: [] + for key in ("activities", "workflow-profiles", "applications", "boundaries", "languages", "frameworks", "topics", "details")} + facts["routing.activities"] = ["implementation"] + return facts + + def test_routing_retains_unknown_facts_and_delivers_unapproved_selected_content(self): unknown = self.facade.route({"snapshot": self.snapshot, "facts": {}}) self.assertEqual(unknown["status"], "needs-facts", unknown) self.assertTrue(unknown["unresolved_questions"]) - facts = {"routing."+key: [] - for key in ("activities", "workflow-profiles", "applications", "boundaries", "languages", "frameworks", "topics", "details")} - complete = self.facade.route({"snapshot": self.snapshot, "facts": facts}) + facts = self.implementation_facts() + complete = self.facade.route({"snapshot": self.snapshot, "facts": {**facts, "routing.activities": []}}) self.assertEqual(complete["status"], "complete", complete) - facts["routing.activities"] = ["implementation"] - blocked = self.facade.route({"snapshot": self.snapshot, "facts": facts}) - self.assertEqual(blocked["code"], "APPLICATION.CONTENT_UNAVAILABLE", blocked) + self.assertEqual({entry["review_state"] for entry in complete["reading_plan"]}, {"current"}) + selected = self.facade.route({"snapshot": self.snapshot, "facts": facts}) + self.assertEqual(selected["kind"], "application-route-result", selected) + self.assertEqual(selected["status"], "complete") + labels = {entry["target"]: entry["review_state"] for entry in selected["reading_plan"]} + self.assertGreater(len(labels), len(complete["reading_plan"])) + self.assertEqual(labels["core"], "current") + self.assertEqual(labels["workflow.implementation"], "not-reviewed") + self.assertEqual([hint["target"] for hint in selected["next_operations"]], + [entry["target"] for entry in selected["reading_plan"]]) + + def test_route_delivers_not_reviewed_and_changed_modules_with_correct_labels(self): + files = dict(self.files) + target = "workflow.implementation" + material = self.compiled.materials[target] + entries = [{"target": key, "binding": value.binding} for key, value in self.compiled.supporting.exposure.items()] + entries.append({"target": target, "binding": material.binding}) + files[APPLICATION_CONTENT] = ("schema_version = 1\nentries = " + _toml_inline(entries) + "\n").encode() + approved = self.facade.read({"snapshot": self.capture(files, "approved-fixture"), "target": target}) + self.assertEqual(approved["review_state"], "current", approved) + files[material.path] += b"\nEDITED_AFTER_APPROVAL_52871\n" + snapshot = self.capture(files, "changed-fixture") + facts = {**self.implementation_facts(), "routing.languages": ["rust"]} + arguments = {"snapshot": snapshot, "facts": facts, "content": {}} + plan, items = None, [] + while arguments is not None: + value = self.facade.route(arguments) + self.assertEqual(value["kind"], "application-route-result", value) + plan = value["reading_plan"] + items.extend(value["content"]["items"]) + arguments = value["content"].get("next") + labels = {entry["target"]: entry["review_state"] for entry in plan} + self.assertEqual(labels[target], "changed-since-review") + self.assertEqual(labels["core"], "current") + self.assertEqual(labels["profile.language.rust"], "not-reviewed") + self.assertEqual(set(labels.values()), {"current", "changed-since-review", "not-reviewed"}) + # Every selected module arrives, and each item repeats its plan label beside the text. + self.assertEqual([item["policy"]["id"] for item in items], list(labels)) + self.assertEqual({item["policy"]["id"]: item["review_state"] for item in items}, labels) + changed = next(item for item in items if item["policy"]["id"] == target) + self.assertIn("EDITED_AFTER_APPROVAL_52871", changed["content"]) + self.assertNotIn(PRIVATE, json.dumps(items)) + many = self.facade.read_many({"snapshot": snapshot, "items": [{"target": key} for key in labels]}) + self.assertEqual(many["items"], items) + unit = self.compiled.corpus.policy_unit_corpus.for_module(target)[0] + scoped = self.facade.read({"snapshot": snapshot, "target": unit.id}) + self.assertEqual(scoped["review_state"], "changed-since-review", scoped) + + def test_router_and_core_with_lapsed_or_absent_approval_still_route(self): + lapsed = dict(self.files) + lapsed["CORE-STANDARDS.md"] += b"\nCORE_EDITED_AFTER_APPROVAL_30417\n" + path = "evaluation/standards-effectiveness/router-projection.toml" + lapsed[path] = lapsed[path].replace(self.compiled.router.facts[0].prompt.encode(), + b"Describe the selected task activities.", 1) + absent = dict(self.files) + absent[APPLICATION_CONTENT] = b"schema_version = 1\nentries = []\n" + for files, expected in ((lapsed, "changed-since-review"), (absent, "not-reviewed")): + with self.subTest(expected=expected): + snapshot = self.capture(files, "lapsed-" + expected) + vocabulary = self.facade.routing_facts({"snapshot": snapshot}) + self.assertEqual(vocabulary["kind"], "application-routing-facts-result", vocabulary) + self.assertTrue(vocabulary["facts"]) + groups = self.facade.relationship_groups({"snapshot": snapshot}) + self.assertEqual(groups["kind"], "relationship-groups-result", groups) + routed = self.facade.route({"snapshot": snapshot, "facts": self.implementation_facts(), "content": {}}) + self.assertEqual(routed["kind"], "application-route-result", routed) + labels = {entry["target"]: entry["review_state"] for entry in routed["reading_plan"]} + self.assertEqual(labels["core"], expected) + self.assertEqual(labels["router"], expected) + self.assertEqual(routed["content"]["items"][0]["policy"]["id"], "core") + self.assertEqual(routed["content"]["items"][0]["review_state"], expected) + related = self.facade.related({"snapshot": snapshot, "target": "router", "groups": ["standards-requires"], + "direction": "outgoing", "transitive": False}) + self.assertEqual(related["kind"], "application-related-result", related) + self.assertEqual(self.facade.read({"snapshot": snapshot, "target": "router"})["review_state"], expected) + + def test_unknown_target_has_its_own_rejection_and_nothing_awaits_publication(self): + handle = self.read()["policy"]["handle"] + rejections = [ + self.facade.read({"snapshot": self.snapshot, "target": "core.misspelt"}), + self.facade.read({"snapshot": self.snapshot, "target": "provenance.fixture"}), + self.facade.related({"snapshot": self.snapshot, "target": "does.not.exist", "groups": ["semantic"], + "direction": "outgoing", "transitive": False}), + self.facade.read_many({"snapshot": self.snapshot, "items": [{"target": "core"}, {"target": "does.not.exist"}]}), + self.facade.inspect({"handle": {**handle, "child_id": "does.not.exist"}}), + self.facade.inspect({"handle": {**handle, "child_kind": "relationship", "child_id": "outgoing:does.not.exist"}}), + self.facade.inspect({"handle": {**handle, "child_kind": "relationship", "child_id": "sideways:core"}}), + ] + for value in rejections: + self.assertEqual(value["kind"], "application-rejected-result", value) + self.assertEqual((value["code"], value["outcome"]), ("APPLICATION.UNKNOWN_TARGET", "invalid"), value) + self.assertIn("not registered", value["message"]) + self.assertIn("returned by route, read or related", value["message"]) + self.assertNotIn(PRIVATE, json.dumps(value)) + forbidden = self.facade.related({"snapshot": self.snapshot, "target": "core", "groups": ["policy-impact"], + "direction": "outgoing", "transitive": True}) + self.assertEqual(forbidden["code"], "APPLICATION.TRAVERSAL_NOT_PERMITTED", forbidden) + self.assertIn("relationship_groups", forbidden["message"]) + definition = _contracts(ROOT).schema["$defs"]["ApplicationRejectedResult"] + self.assertNotIn("APPLICATION.CONTENT_UNAVAILABLE", definition["properties"]["code"]["enum"]) + self.assertNotIn("awaiting", json.dumps(rejections + [forbidden])) + + def test_application_graph_holds_all_registered_material_and_no_provenance(self): + view = ApplicationView(self.compiled, c.SnapshotHandle.from_value(self.snapshot)) + self.assertEqual(set(view.review), set(self.compiled.materials)) + self.assertIn("not-reviewed", view.review.values()) + self.assertLessEqual(set(self.compiled.materials) & set(self.compiled.graph.nodes), set(view.graph.nodes)) + self.assertEqual(set(view.graph.groups), {"standards-requires", "standards-specializes", + "standards-dependencies", "policy-impact", "semantic"}) + self.assertFalse([node for node in view.graph.nodes if node.startswith("provenance.")]) + hidden = set(view.graph.nodes) - set(self.compiled.materials) - {unit.id for unit in self.compiled.corpus.policy_units} + self.assertEqual(hidden, set()) + # An unapproved module is a relationship endpoint like any other. + related = self.facade.related({"snapshot": self.snapshot, "target": "workflow.implementation", + "groups": ["standards-requires"], "direction": "outgoing", "transitive": False}) + self.assertEqual(related["kind"], "application-related-result", related) + self.assertIn("core", [entry["target"] for entry in related["relationships"]]) def test_hidden_intermediate_cannot_bridge_a_permitted_traversal(self): from tools.graph_engine.graph_engine import ( @@ -216,6 +341,44 @@ def test_catalog_has_no_authoring_schema_closure(self): for hidden in ("rationale", "ChangePurpose", "DecisionProvenanceRecord", "ProposalRevisionHandle"): self.assertNotIn(hidden, serialized) + def test_application_descriptions_open_with_purpose_and_state_no_gate(self): + from tools.standards_engine.standards_engine.mcp_catalog import tool_catalog + interface = AgentToolFacade.load_interface(ROOT) + for delivery in ("eager", "on-demand"): + catalog = {tool["name"]: tool["description"] for tool in + tool_catalog(interface, purpose="application", advanced=True, output_schemas=delivery)} + for name, description in catalog.items(): + with self.subTest(delivery=delivery, name=name): + self.assertRegex(description, r"^(Returns|Lists|Shows|Reports|Advanced form) ") + for stale in ("awaiting", "unavailable item", "reviewed items", "qualified"): + self.assertNotIn(stale, description) + self.assertNotIn("2 MiB", catalog["route"]) + for phrase in ("content={}", "content.next", "review_state", "not-reviewed", "at least one whole module"): + self.assertIn(phrase, catalog["route"]) + self.assertIn("two or three modules per call", catalog["read_many"]) + authoring = {tool["name"]: tool["description"] for tool in tool_catalog(interface, purpose="authoring")} + self.assertIn("review_state", authoring["preview_application"]) + self.assertNotIn("qualification", authoring["preview_application"]) + + def test_application_skill_example_uses_the_registered_vocabulary_and_labels(self): + skill = (ROOT / ".agents/skills/coding-standards/SKILL.md").read_text() + self.assertTrue(skill.startswith("---\nname: coding-standards\ndescription: "), skill[:80]) + facts = {fact["id"]: fact["values"] for fact in self.compiled.router.fact_definitions()} + example = {"routing.activities": "implementation", "routing.languages": "rust", "routing.boundaries": "interop"} + for name, value in example.items(): + self.assertIn(value, facts[name]) + self.assertIn(f'"{name}": ["{value}"]', skill) + labels = _contracts(ROOT).schema["$defs"]["ApplicationReviewState"]["enum"] + self.assertEqual(labels, ["current", "changed-since-review", "not-reviewed"]) + for phrase in (*(f"`{label}`" for label in labels), "routing_facts", "content: {}", "content.next", + "snapshot", "read_many", "APPLICATION.UNKNOWN_TARGET"): + self.assertIn(phrase, skill) + routed = self.facade.route({"snapshot": self.snapshot, "content": {}, + "facts": {name: [value] for name, value in example.items()}}) + self.assertEqual(routed["kind"], "application-route-result", routed) + for entry in routed["reading_plan"]: + self.assertIn(entry["target"], skill) + def test_whole_module_discovers_references_owned_by_its_policy_units(self): from tools.graph_engine.graph_engine import ( diff --git a/tools/standards_engine/tests/test_purpose_transport.py b/tools/standards_engine/tests/test_purpose_transport.py index d96351ba..97a02e97 100644 --- a/tools/standards_engine/tests/test_purpose_transport.py +++ b/tools/standards_engine/tests/test_purpose_transport.py @@ -96,9 +96,10 @@ def request(identifier, method, params): request(4, "tools/call", {"name": "read", "arguments": {"snapshot": self.snapshot, "target": "provenance.fixture"}}), request(5, "tools/call", {"name": "apply", "arguments": {}}), ] + # One process: every byte this server writes is checked, so the whole session is captured. process = subprocess.run( [sys.executable, "-P", "-m", "tools.standards_engine.standards_engine.mcp", - "--repo-root", str(self.root), "--purpose", "application", "--advanced"], + "--repo-root", str(self.root), "--purpose", "application", "--advanced", "--no-observe"], input="".join(json.dumps(value) + "\n" for value in messages), text=True, capture_output=True, env={**os.environ, "PYTHONPATH": str(ROOT)}, timeout=120, ) @@ -112,7 +113,13 @@ def request(identifier, method, params): self.assertEqual(allowed["structuredContent"]["content"], self.expected) self.assertEqual(json.loads(allowed["content"][0]["text"]), allowed["structuredContent"]) self.assertTrue(values[4]["result"]["isError"]) - self.assertEqual(values[4]["result"]["structuredContent"]["code"], "APPLICATION.CONTENT_UNAVAILABLE") + self.assertEqual(values[4]["result"]["structuredContent"]["code"], "APPLICATION.UNKNOWN_TARGET") + self.assertEqual(allowed["structuredContent"]["review_state"], "current") + instructions = values[1]["result"]["instructions"] + for phrase in ("routing_facts", "content={}", "content.next", "snapshot", "review_state", + "current", "changed-since-review", "not-reviewed"): + self.assertIn(phrase, instructions) + self.assertNotIn("awaiting", instructions) self.assertIn("error", values[5]) diff --git a/tools/standards_engine/tests/test_read_many.py b/tools/standards_engine/tests/test_read_many.py index 2813135c..32da89cc 100644 --- a/tools/standards_engine/tests/test_read_many.py +++ b/tools/standards_engine/tests/test_read_many.py @@ -108,10 +108,20 @@ def test_empty_duplicate_oversized_missing_snapshot_and_privileged_requests_reje self.assertEqual(result["code"], "APPLICATION.INPUT_INVALID", result) self.assertNotIn("items", result) + def test_unapproved_items_are_delivered_in_order_with_their_labels(self): + items = [{"target": "workflow.implementation"}, {"target": "core"}, {"target": "profile.language.rust", "detail": "full"}] + result = self.call(items=items) + self.assertEqual(result["kind"], "application-read-many-result", result) + self.assertEqual([(item["policy"]["id"], item["review_state"]) for item in result["items"]], + [("workflow.implementation", "not-reviewed"), ("core", "current"), + ("profile.language.rust", "not-reviewed")]) + self.assertEqual(result["items"], [self.app.read({"snapshot": self.snapshot, **item}) for item in items]) + self.assertNotIn(fixture.PRIVATE, json.dumps(result)) + def test_unknown_or_private_item_rejects_whole_set_without_partial_data(self): for target in ("does.not.exist", "provenance.fixture"): result = self.call(items=[{"target": "core"}, {"target": target}]) - self.assertEqual(result["code"], "APPLICATION.CONTENT_UNAVAILABLE", result) + self.assertEqual(result["code"], "APPLICATION.UNKNOWN_TARGET", result) self.assertNotIn(fixture.PUBLIC, json.dumps(result)) self.assertNotIn(fixture.PRIVATE, json.dumps(result)) self.assertNotIn("items", result) @@ -208,7 +218,8 @@ def message(i, method, params): {"jsonrpc": "2.0", "method": "notifications/initialized"}, message(2, "tools/call", {"name": "read_many", "arguments": arguments}), message(3, "tools/call", {"name": "read_many", "arguments": {**arguments, "items": [{"target": "core"}, {"target": "provenance.fixture"}]}})] - command = [sys.executable, "-P", "-m", "tools.standards_engine.standards_engine.mcp", "--repo-root", str(self.root), "--purpose", "application"] + command = [sys.executable, "-P", "-m", "tools.standards_engine.standards_engine.mcp", "--repo-root", str(self.root), "--purpose", "application", "--no-observe"] + # Two processes: a second cold server returns the identical complete value. for _ in range(2): response = subprocess.run(command, input="".join(json.dumps(m) + "\n" for m in messages), text=True, capture_output=True, env=env, timeout=60) self.assertEqual(response.returncode, 0, response.stderr) diff --git a/tools/standards_engine/tests/test_registration_contract.py b/tools/standards_engine/tests/test_registration_contract.py index d67d7bd3..1e7af16d 100644 --- a/tools/standards_engine/tests/test_registration_contract.py +++ b/tools/standards_engine/tests/test_registration_contract.py @@ -127,7 +127,7 @@ def test_checked_in_contract_projections_are_current(self) -> None: self.assertEqual(generated_tools.read_text(), self.artifacts.agent_tools_json) self.assertEqual(self.artifacts.agent_tools["interface_schema_version"], self.interface["interface_schema_version"]) self.assertEqual(self.interface["request_contract_version"], 6) - self.assertEqual(self.interface["result_projection_version"], 8) + self.assertEqual(self.interface["result_projection_version"], 9) def test_authored_contract_examples_match_the_current_interface(self) -> None: examples = json.loads((CONTRACTS / "examples/a1-examples.json").read_text()) diff --git a/tools/standards_engine/tests/test_relationship_vocabulary.py b/tools/standards_engine/tests/test_relationship_vocabulary.py index 3df57250..595b1834 100644 --- a/tools/standards_engine/tests/test_relationship_vocabulary.py +++ b/tools/standards_engine/tests/test_relationship_vocabulary.py @@ -77,9 +77,25 @@ def test_unknown_query_offers_same_first_page_and_choices_repair_it(self): def test_hidden_target_is_not_a_way_to_read_private_application_groups(self): result = self.app.related({'snapshot': self.snapshot, 'target': 'provenance.fixture', 'groups': ['decision-provenance'], 'direction': 'outgoing', 'transitive': False}) - self.assertEqual(result['code'], 'APPLICATION.CONTENT_UNAVAILABLE') + self.assertEqual(result['code'], 'APPLICATION.UNKNOWN_TARGET') self.assertNotIn('relationship_groups', result) self.assertNotIn(fixture.PRIVATE, json.dumps(result)) + # A registered target still cannot select the authoring-only group. + result = self.app.related({'snapshot': self.snapshot, 'target': 'core', + 'groups': ['decision-provenance'], 'direction': 'outgoing', 'transitive': False}) + self.assertEqual(result['code'], 'APPLICATION.UNKNOWN_GROUP') + self.assertNotIn('decision-provenance', json.dumps(result['relationship_groups'])) + self.assertNotIn(fixture.PRIVATE, json.dumps(result)) + + def test_unpermitted_application_traversal_names_the_vocabulary(self): + group = next(item for item in self.page(self.app, limit=32)['items'] if not item['transitive']) + result = self.app.related({'snapshot': self.snapshot, 'target': 'core', 'groups': [group['id']], + 'direction': 'outgoing', 'transitive': True}) + self.assertEqual((result['code'], result['outcome']), ('APPLICATION.TRAVERSAL_NOT_PERMITTED', 'invalid')) + self.assertIn('relationship_groups', result['message']) + allowed = self.app.related({'snapshot': self.snapshot, 'target': 'core', 'groups': [group['id']], + 'direction': 'outgoing', 'transitive': False}) + self.assertEqual(allowed['kind'], 'application-related-result', allowed) def test_byte_bounds_whole_records_and_numeric_equivalence(self): for facade in (self.author, self.app): diff --git a/tools/standards_engine/tests/test_review_mcp.py b/tools/standards_engine/tests/test_review_mcp.py index 7ecca2f7..e0b3c261 100644 --- a/tools/standards_engine/tests/test_review_mcp.py +++ b/tools/standards_engine/tests/test_review_mcp.py @@ -1,78 +1,93 @@ -"""Cold MCP review batching with real candidate publication and recovery.""" +"""Compact review batching over real MCP stdio, up to the reviewed candidate. + +The full-detail, single-decision walkthroughs in test_consumer_publication own +publication, recovery and cold readback of a reviewed candidate. This module +owns only what differs before review: compact results, paged work and batches. +""" from __future__ import annotations from tools.standards_engine.tests import test_consumer_publication as fixture +from tools.standards_engine.tests import test_proposal_consumers as consumers from tools.standards_engine.tests.test_analysis import _clone_tracked_worktree -from tools.standards_engine.tests.test_agent_workflow import evidence +from tools.standards_engine.tests.test_agent_workflow import decisions, evidence -class BatchedPublicationTests(fixture.ConsumerPublicationTest): - def setUp(self): - # The predecessor walkthrough remains a single-decision/full-detail test; - # this subclass drives its same public workflows through compact batches. - import tempfile - from pathlib import Path - self.temp = tempfile.TemporaryDirectory(prefix='batched-publication-') - self.addCleanup(self.temp.cleanup) - self.root = Path(self.temp.name) / 'repository' - _clone_tracked_worktree(self.root) - self.calls = [] - self.batch_count = 0 +class BatchedPublicationTests(fixture.PublicationWorkflowCase): + prepare = staticmethod(_clone_tracked_worktree) def call(self, name, arguments, purpose='authoring', error=False): if name in {'propose', 'revise', 'analyze', 'resolve_workflow', 'resolve_many', 'workflow_status', 'resume'}: arguments = {**arguments, 'detail': 'compact'} return super().call(name, arguments, purpose, error) - def complete(self, workflow): - seen = set() - while workflow.get('status') == 'needs-action': - identity = workflow['context']['id'] - self.assertNotIn(identity, seen); seen.add(identity) - self.assertEqual(workflow['outcome']['kind'], 'workflow-analysis-summary') - self.assertEqual(workflow['outcome']['pending_facts'], 0) - # Mutations provide the first page. A resumed lightweight status - # deliberately requires one initial read, then uses the same paging. - page = workflow.get('work') - if page is None: - page = self.call('workflow_details', { - 'analysis': workflow['context'], 'section': 'pending_obligations', - }) - self.assertEqual(page['kind'], 'workflow-details-result', page) - else: - self.assertEqual(page['kind'], 'workflow-work-page', page) + def paged_work(self, workflow, limit): + """Read all pending work of a compact result through explicit detail pages.""" + request = {'analysis': workflow['context'], 'section': 'pending_obligations', 'limit': limit} + work, pages = [], 0 + while True: + page = self.call('workflow_details', request) + self.assertEqual(page['kind'], 'workflow-details-result', page) self.assertEqual(page['section'], 'pending_obligations') - total = page['total'] - work = list(page['items']) - if 'next' in page: - request = {'analysis': workflow['context'], **page['next']} - while True: - page = self.call('workflow_details', request) - work.extend(page['items']) - if 'next' not in page: - break - request = page['next'] - self.assertEqual(len(work), total) - self.assertTrue(work) - submissions = [] - for item in work: - obligation = item['obligation'] - kind = obligation['permitted_submissions'][0] - if kind == 'coverage-attestation': - submission = {'kind':kind,'claim':{ - 'requirement':item['work'], 'conclusion':'complete', - 'evidence':[evidence(self.root)], 'explicit_exclusions':[], - 'rationale':'The fixture owns and reviewed the complete declared consumer horizon.', - 'auditor_provenance':'Isolated MCP batch test, not a real content audit.'}} - else: - self.assertIn(kind, {'consumer-disposition', 'impact-disposition'}) - submission = {'kind':kind, 'obligation':item['work'], - 'result':'reviewed-no-change' if kind=='consumer-disposition' else 'confirmed', - 'fingerprint':obligation['fingerprint'], 'evidence':[evidence(self.root)], - 'rationale':'Explicit review of this isolated consumer or scope.'} - submissions.append(submission) - workflow = self.call('resolve_many', {'context':workflow['context'], 'submissions':submissions}) - self.batch_count += 1 - self.assertEqual(workflow['status'], 'complete', workflow) - self.assertGreater(self.batch_count, 0) - return workflow + self.assertLessEqual(len(page['items']), limit) + work.extend(page['items']) + pages += 1 + if 'next' not in page: + break + request = page['next'] + self.assertEqual(len(work), page['total']) + self.assertGreater(pages, 1, 'the limit must force at least one continuation') + return work + + def submissions(self, work): + submitted = [] + for item in work: + obligation = item['obligation'] + kind = obligation['permitted_submissions'][0] + if kind == 'coverage-attestation': + submission = {'kind':kind,'claim':{ + 'requirement':item['work'], 'conclusion':'complete', + 'evidence':[evidence(self.root)], 'explicit_exclusions':[], + 'rationale':'The fixture owns and reviewed the complete declared consumer horizon.', + 'auditor_provenance':'Isolated MCP batch test, not a real content audit.'}} + else: + self.assertIn(kind, {'consumer-disposition', 'impact-disposition'}) + submission = {'kind':kind, 'obligation':item['work'], + 'result':'reviewed-no-change' if kind=='consumer-disposition' else 'confirmed', + 'fingerprint':obligation['fingerprint'], 'evidence':[evidence(self.root)], + 'rationale':'Explicit review of this isolated consumer or scope.'} + submitted.append(submission) + return submitted + + def test_compact_results_paged_work_and_batches_complete_a_reviewable_workflow(self): + F = consumers.ConsumerCompilerTests + proposed = self.call('propose', {'change_set': self.change(F().initial_edits())}) + self.assertEqual(proposed['status'], 'needs-action', proposed) + self.assertEqual(proposed['outcome']['kind'], 'workflow-analysis-summary') + self.assertEqual(proposed['outcome']['pending_facts'], 0) + # A mutation supplies the first page of its work with the compact summary. + inline = proposed['work'] + self.assertEqual((inline['kind'], inline['section']), ('workflow-work-page', 'pending_obligations'), inline) + self.assertGreater(inline['total'], 3) + partial = self.call('resolve_many', {'context': proposed['context'], + 'submissions': self.submissions(inline['items'][:2])}) + self.assertEqual(partial['status'], 'needs-action', partial) + self.assertEqual(partial['work']['kind'], 'workflow-work-page', partial) + self.assertEqual(partial['work']['total'], inline['total'] - 2) + # A rejected compact revision leaves the workflow where the batch left it. + self.call('revise', {'context': partial['context'], 'change_set': self.change([ + consumers.registration('fixture.duplicate-consumer-path', F.fixture_path)])}, error=True) + # A resumed lightweight status deliberately carries no work: the client + # reads it once, in pages, and each continuation is used exactly as issued. + status = self.call('workflow_status', {'context': partial['context']}) + self.assertEqual((status['status'], status['revision']), ('needs-action', proposed['revision'])) + self.assertEqual(status['outcome']['kind'], 'workflow-analysis-summary') + self.assertNotIn('work', status) + work = self.paged_work(status, limit=2) + self.assertEqual(work[:len(partial['work']['items'])], partial['work']['items']) + complete = self.call('resolve_many', {'context': status['context'], 'submissions': self.submissions(work)}) + self.assertEqual(complete['status'], 'complete', complete) + self.assertEqual(complete['outcome']['kind'], 'workflow-analysis-summary') + self.assertNotIn('work', complete) + self.assertEqual(self.calls.count('resolve_many'), 2) + ready = self.call('review', {'context': complete['context'], 'decisions': decisions(self.root)}) + self.assertEqual(ready['status'], 'ready', ready) diff --git a/tools/standards_engine/tests/test_route_content.py b/tools/standards_engine/tests/test_route_content.py index 12571987..7cd8b789 100644 --- a/tools/standards_engine/tests/test_route_content.py +++ b/tools/standards_engine/tests/test_route_content.py @@ -1,15 +1,20 @@ -"""Routed exact content across qualification, paging and lifecycle boundaries.""" +"""Routed exact content across review labels, paging and lifecycle boundaries.""" from __future__ import annotations from copy import deepcopy import json +import os from pathlib import Path +import subprocess +import sys import unittest from unittest.mock import patch from tools.standards_engine.standards_engine import AgentToolFacade, StandardsEngine from tools.standards_engine.standards_engine import agent_navigation +from tools.standards_engine.standards_engine.mcp import MCPServer from tools.standards_engine.standards_engine.tools import _contracts +from tools.standards_engine.tests.test_mcp import initialize, request from tools.standards_engine.tests import test_purpose_projection as fixture from tools.standards_snapshots.standards_snapshots import SnapshotId @@ -87,35 +92,84 @@ def test_one_verified_input_and_no_capture_for_each_composed_call(self): self.assertEqual(compiled.call_count, 1) self.assertEqual(load.call_count, 1) - def test_unqualified_later_target_blocks_even_a_one_item_application_page(self): + def test_unapproved_later_target_is_delivered_with_its_label_on_its_own_page(self): facts = known_assertions() facts['routing.activities'] = ['implementation'] value = self.route(self.app, facts=facts, content={'limit': 1}) - self.assertEqual(value['code'], 'APPLICATION.CONTENT_UNAVAILABLE') - self.assertNotIn('content', value) - self.assertNotIn(fixture.PRIVATE, json.dumps(value)) + self.assertEqual(value['kind'], 'application-route-result', value) + labels = {entry['target']: entry['review_state'] for entry in value['reading_plan']} + self.assertEqual(labels['workflow.implementation'], 'not-reviewed') + items = list(value['content']['items']) + while 'next' in value['content']: + value = self.app.route(value['content']['next']) + items.extend(value['content']['items']) + self.assertEqual({item['policy']['id']: item['review_state'] for item in items}, labels) + self.assertEqual(items, [self.app.read({'snapshot': self.snapshot, 'target': target}) for target in labels]) + self.assertNotIn(fixture.PRIVATE, json.dumps(items)) def test_exact_byte_limit_partial_pages_and_oversized_record(self): for facade in (self.author, self.app): + application = facade is self.app + + def budget(size): + # Authoring pages keep the transport bound; application pages use the host budget. + return (patch.object(facade._engine, '_route_page_bytes', size) if application + else patch.object(agent_navigation, 'ROUTE_CONTENT_RESULT_BYTES', size)) + first = self.route(facade, content={'limit': 1}) full = self.route(facade, content={'limit': 2}) full_bytes = len(json.dumps(full).encode('utf-8')) - with patch.object(agent_navigation, 'ROUTE_CONTENT_RESULT_BYTES', full_bytes): + with budget(full_bytes): self.assertEqual(self.route(facade, content={'limit': 2}), full) first_bytes = len(json.dumps(first).encode('utf-8')) self.assertLess(first_bytes, full_bytes) - with patch.object(agent_navigation, 'ROUTE_CONTENT_RESULT_BYTES', first_bytes): + with budget(first_bytes): partial = self.route(facade, content={'limit': 2}) self.assertEqual(partial['content']['items'], first['content']['items']) self.assertEqual(partial['content']['next']['content']['offset'], 1) self.assertLessEqual(len(json.dumps(partial).encode('utf-8')), first_bytes) + with budget(1): + oversized = self.route(facade) + if application: + # One whole item is returned alone rather than rejected or clipped. + self.assertEqual(oversized['content']['items'], first['content']['items']) + self.assertEqual(oversized['content']['next']['content'], {'offset': 1, 'limit': 8}) + with budget(1): + last = self.app.route(oversized['content']['next']) + self.assertEqual(first['content']['items'] + last['content']['items'], full['content']['items']) + self.assertNotIn('next', last['content']) with patch.object(agent_navigation, 'ROUTE_CONTENT_RESULT_BYTES', 1): rejected = self.route(facade) self.assertEqual(rejected['outcome'], 'unsupported') self.assertNotIn('content', rejected) + if not application: + self.assertEqual(oversized, rejected) # The explicit non-composed operation remains available. self.assertIn('reading_plan', facade.route({'snapshot': self.snapshot, 'facts': known_assertions()})) + def test_application_page_budget_default_and_host_configuration(self): + self.assertEqual(agent_navigation.ROUTE_PAGE_BYTES, 40 * 1024) + self.assertEqual(self.app._engine.route_page_bytes, agent_navigation.ROUTE_PAGE_BYTES) + # The default holds both fixture items; each returned page stays within it. + default = self.route(self.app) + self.assertEqual(len(default['content']['items']), 2) + self.assertLessEqual(len(json.dumps(default).encode('utf-8')), agent_navigation.ROUTE_PAGE_BYTES) + first = self.route(self.app, content={'limit': 1}) + configured = len(json.dumps(first).encode('utf-8')) + self.assertGreaterEqual(configured, agent_navigation.ROUTE_PAGE_MIN_BYTES) + with StandardsEngine.open_repository( + ROOT, purpose='application', store_path=fixture.PurposeProjectionTest.store_path, + route_page_bytes=configured) as engine: + self.assertEqual(engine.route_page_bytes, configured) + page = self.route(AgentToolFacade(engine, _contracts(ROOT))) + self.assertEqual(page, {**first, 'content': {**first['content'], 'next': { + **first['content']['next'], 'content': {'offset': 1, 'limit': 8}}}}) + # The same budget never shortens an authoring page. + with StandardsEngine.open_repository( + ROOT, purpose='authoring', store_path=fixture.PurposeProjectionTest.store_path, + route_page_bytes=agent_navigation.ROUTE_PAGE_MIN_BYTES) as engine: + self.assertEqual(self.route(AgentToolFacade(engine, _contracts(ROOT))), self.route(self.author)) + def test_schema_whole_numbers_normalize_before_slicing(self): for facade in (self.author, self.app): for offset in (0, 1): @@ -184,3 +238,51 @@ def read(*args, **kwargs): value = self.route(self.author) self.assertEqual(value['code'], 'FIXTURE.READ_UNAVAILABLE') self.assertNotIn('content', value) + + +class RoutePageBudgetOptionTest(unittest.TestCase): + def test_budget_range_is_closed_and_whole(self): + admit = agent_navigation.admit_route_page_bytes + self.assertEqual(admit(None), agent_navigation.ROUTE_PAGE_BYTES) + for value in (agent_navigation.ROUTE_PAGE_MIN_BYTES, 50_000, agent_navigation.ROUTE_CONTENT_RESULT_BYTES): + self.assertEqual(admit(value), value) + for value in (0, -1, agent_navigation.ROUTE_PAGE_MIN_BYTES - 1, + agent_navigation.ROUTE_CONTENT_RESULT_BYTES + 1, True, 40960.0, '40960'): + with self.subTest(value=value), self.assertRaises(ValueError): + admit(value) + with self.assertRaises(ValueError): + MCPServer(ROOT, purpose='application', route_page_bytes=1) + + def test_server_passes_its_budget_to_every_call(self): + for configured in (None, 50_000): + server = MCPServer(ROOT, purpose='application', route_page_bytes=configured) + self.addCleanup(server.close) + initialize(server) + with patch.object(AgentToolFacade, 'open_repository') as opened: + opened.return_value.route.return_value = {'kind': 'fixture'} + # The Engine opened with the budget is the one every call uses. + for _ in range(2): + server.dispatch(request('tools/call', {'name': 'route', 'arguments': {'facts': {}}})) + opened.assert_called_once() + self.assertEqual(opened.return_value.route.call_count, 2) + self.assertEqual(opened.call_args.kwargs['route_page_bytes'], + configured or agent_navigation.ROUTE_PAGE_BYTES) + + def test_launch_option_is_validated_before_serving(self): + # One process per launch: each start accepts or refuses its own options. + def launch(*arguments): + return subprocess.run( + [sys.executable, '-P', '-m', 'tools.standards_engine.standards_engine.mcp', '--no-observe', + '--repo-root', str(ROOT), *arguments], + input='', text=True, capture_output=True, env={**os.environ, 'PYTHONPATH': str(ROOT)}, timeout=90) + accepted = launch('--purpose', 'application', '--route-page-bytes', '50000') + self.assertEqual((accepted.returncode, accepted.stdout, accepted.stderr), (0, '', '')) + for purpose, value, reason in (('application', '100', 'from 8192 to 2097152'), + ('application', '9999999', 'from 8192 to 2097152'), + ('application', 'large', 'invalid int value'), + ('authoring', '50000', 'applies to the application purpose')): + with self.subTest(purpose=purpose, value=value): + refused = launch('--purpose', purpose, '--route-page-bytes', value) + self.assertEqual(refused.returncode, 2) + self.assertEqual(refused.stdout, '') + self.assertIn(reason, refused.stderr) diff --git a/tools/standards_engine/tests/test_routing_fact_transport.py b/tools/standards_engine/tests/test_routing_fact_transport.py index b46acb04..ef8b75e3 100644 --- a/tools/standards_engine/tests/test_routing_fact_transport.py +++ b/tools/standards_engine/tests/test_routing_fact_transport.py @@ -1,14 +1,11 @@ -"""Snapshot-bound focused assertions, qualification and real cold stdio responses.""" +"""Snapshot-bound focused assertions, review labels and real stdio responses from another process.""" from __future__ import annotations from copy import deepcopy from dataclasses import replace import json -import os from pathlib import Path import shutil -import subprocess -import sys import tempfile import tomllib import unittest @@ -19,6 +16,7 @@ from tools.standards_engine.standards_engine import routing_inputs from tools.standards_engine.standards_engine.logical_authoring import _toml_inline from tools.standards_engine.tests import test_purpose_projection as fixture +from tools.standards_engine.tests.stdio_server import StdioServers from tools.standards_engine.tests.test_routing_fact_inputs import SPECS from tools.standards_metadata.standards_metadata import APPLICATION_CONTENT from tools.standards_snapshots.standards_snapshots import CapturedContent, SnapshotFile, SnapshotPath, SnapshotId @@ -82,19 +80,15 @@ def tearDownClass(cls): def route(self, purpose, facts, *, snapshot='boolean', **rest): return self.facades[purpose].route({'snapshot':self.snapshots[snapshot], 'facts':facts, **rest}) + def setUp(self): + self.servers = StdioServers(client='fact-input-test', cwd=ROOT) + self.addCleanup(self.servers.close) + def cold(self, purpose, operation, args, *, error=False): - messages=[{'jsonrpc':'2.0','id':1,'method':'initialize','params':{ - 'protocolVersion':'2025-11-25','capabilities':{},'clientInfo':{'name':'fact-input-test','version':'1'}}}, - {'jsonrpc':'2.0','method':'notifications/initialized'}, - {'jsonrpc':'2.0','id':2,'method':'tools/call','params':{'name':operation,'arguments':args}}] - proc=subprocess.run([sys.executable,'-P','-m','tools.standards_engine.standards_engine.mcp', - '--repo-root',str(self.root),'--purpose',purpose,'--output-schemas','on-demand'], - cwd=ROOT,env={**os.environ,'PYTHONPATH':str(ROOT)},input=''.join(json.dumps(m)+'\n' for m in messages), - capture_output=True,text=True,check=True) - self.assertEqual(proc.stderr,'') - rows={m['id']:m for m in map(json.loads,proc.stdout.splitlines())} - self.assertNotIn('error',rows[2],rows[2]) - response=rows[2]['result'] + # One server process per purpose serves a test; it never shares the facades' process. + reply=self.servers.server(self.root,purpose,'--output-schemas','on-demand').call(operation,args) + self.assertNotIn('error',reply,reply) + response=reply['result'] self.assertEqual(response['isError'],error,response) value=response['structuredContent'] self.assertEqual(value,json.loads(response['content'][0]['text'])) @@ -115,11 +109,21 @@ def test_type_resolution_uses_the_selected_durable_snapshot_not_ambient_files(se invalid=self.route(purpose,{'probe':['x']}) self.assertEqual(invalid['input_feedback']['issues'][0]['message'],'boolean fact value is invalid') - def test_qualification_precedes_vocabulary_interpretation(self): - with patch.object(routing_inputs,'bind_facts',side_effect=AssertionError('private vocabulary')): - result=self.route('application',{'PRIVATE_FIELD':'PRIVATE_VALUE'},snapshot='unqualified') - self.assertEqual(result['code'],'APPLICATION.CONTENT_UNAVAILABLE') - self.assertNotIn('input_feedback',result) + def test_unapproved_router_vocabulary_is_interpreted_and_its_route_labelled(self): + app=self.facades['application'] + approved=self.route('application',{'probe':True},content={'limit':1}) + routed=self.route('application',{'probe':True},snapshot='unqualified',content={'limit':1}) + self.assertEqual(routed['kind'],'application-route-result',routed) + self.assertEqual({entry['review_state'] for entry in approved['reading_plan']},{'current'}) + self.assertEqual(routed['reading_plan'],[{**entry,'review_state':'not-reviewed'} for entry in approved['reading_plan']]) + self.assertEqual(routed['content']['items'][0]['review_state'],'not-reviewed') + self.assertEqual(routed['content']['items'][0]['content'],approved['content']['items'][0]['content']) + self.assertEqual(app.routing_facts({'snapshot':self.snapshots['unqualified']})['facts'], + app.routing_facts({'snapshot':self.snapshots['boolean']})['facts']) + # A wrong fact name is ordinary invalid input, not a publication state. + result=self.route('application',{'PRIVATE_FIELD':'PRIVATE_VALUE'},snapshot='unqualified') + self.assertEqual(result['code'],'APPLICATION.INPUT_INVALID') + self.assertIn('input_feedback',result) self.assertNotIn('PRIVATE',json.dumps(result)) def test_single_bind_and_verified_load_per_focused_content_call(self): @@ -210,7 +214,7 @@ def test_input_discovery_and_output_schema_contain_only_the_new_focused_shape(se self.assertIn('RoutingFactAssertion',records) self.assertNotIn('FactValue',records) self.assertNotIn('FactSet',records) - self.assertEqual(page['interface_version'],48) + self.assertEqual(page['interface_version'],self.interface.interface.interface_schema_version) def test_schema_digest_guard_and_final_lifecycle_checks_still_apply(self): author=self.engines['authoring'] diff --git a/tools/standards_engine/tests/test_runtime_identity.py b/tools/standards_engine/tests/test_runtime_identity.py index ae5bdd72..ec7fc667 100644 --- a/tools/standards_engine/tests/test_runtime_identity.py +++ b/tools/standards_engine/tests/test_runtime_identity.py @@ -32,7 +32,8 @@ def test_catalog_and_response_metadata_bind_one_running_process(self): for result in (initial, catalog, response): self.assertEqual(result['_meta']['standards-engine/runtime']['instance_id'], value['instance_id']) self.assertEqual(result['_meta']['standards-engine/runtime']['catalog_digest'], value['catalog_digest']) - self.assertEqual(value['interface_version'], 48) + self.assertEqual(value['interface_version'], + AgentToolFacade.load_interface(ROOT).interface.interface_schema_version) self.assertEqual(value['installation_state'], 'current') self.assertEqual(value['action'], 'reuse') self.assertFalse(initial['capabilities']['tools']['listChanged']) @@ -99,8 +100,9 @@ def test_actual_mcp_and_cli_observe_without_a_git_repository(self): {'jsonrpc': '2.0', 'method': 'notifications/initialized'}, request('tools/call', {'name': 'runtime_info', 'arguments': {}}, identifier=2)] environment = {**os.environ, 'PYTHONPATH': str(ROOT)} + # Separate processes: a server and the CLI are different instances of one installation. mcp = subprocess.run([sys.executable, '-P', '-m', 'tools.standards_engine.standards_engine.mcp', - '--repo-root', str(root), '--purpose', 'application', '--advanced'], + '--repo-root', str(root), '--purpose', 'application', '--advanced', '--no-observe'], input=''.join(json.dumps(item)+'\n' for item in messages), text=True, capture_output=True, env=environment, timeout=60) self.assertEqual(mcp.returncode, 0, mcp.stderr) diff --git a/tools/standards_engine/tests/test_schema_presentation.py b/tools/standards_engine/tests/test_schema_presentation.py index f3d96f87..18b3e614 100644 --- a/tools/standards_engine/tests/test_schema_presentation.py +++ b/tools/standards_engine/tests/test_schema_presentation.py @@ -83,7 +83,7 @@ def test_runtime_catalog_identity_tracks_output_delivery_without_store_access(se for server in servers: initialize(server) value = server.dispatch(request('tools/call', {'name': 'runtime_info', 'arguments': {}}))['result']['structuredContent'] - self.assertEqual(value['interface_version'], 48) + self.assertEqual(value['interface_version'], self.interface.interface.interface_schema_version) digests.append(value['catalog_digest']) self.assertNotEqual(*digests) other = servers[1].dispatch(request('tools/call', {'name': 'runtime_info', 'arguments': {'expected_catalog': digests[0]}}))['result']['structuredContent'] @@ -115,7 +115,7 @@ def test_retired_cli_flags_reject_without_creating_paths(self): with tempfile.TemporaryDirectory() as temporary: root = Path(temporary) / 'untouched' commands = ( - ('tools.standards_engine.standards_engine.mcp', ['--repo-root', str(root), '--purpose', 'authoring']), + ('tools.standards_engine.standards_engine.mcp', ['--repo-root', str(root), '--purpose', 'authoring', '--no-observe']), ('tools.standards_engine.tests.catalog_inventory', ['--repo-root', str(root)]), ('tools.standards_engine.tests.codex_navigation_client', []), ('tools.standards_engine.tests.codex_discovery_client', ['--model', 'fixture', '--surface', 'fixture', '--evidence-dir', str(root)]), @@ -124,6 +124,7 @@ def test_retired_cli_flags_reject_without_creating_paths(self): for value in ('native', 'compatibility'): for flags in (['--schema-mode', value], ['--schema-mode=' + value]): with self.subTest(module=module, flags=flags): + # One process per launch: each start refuses the retired flag itself. process = subprocess.run([sys.executable, '-m', module, *args, *flags], cwd=ROOT, env={**os.environ, 'PYTHONPATH': str(ROOT)}, input='', text=True, capture_output=True) diff --git a/tools/standards_engine/tests/test_stdio_server.py b/tools/standards_engine/tests/test_stdio_server.py new file mode 100644 index 00000000..e290c939 --- /dev/null +++ b/tools/standards_engine/tests/test_stdio_server.py @@ -0,0 +1,67 @@ +"""The shared server helper still fails a test for everything the per-call launches did.""" +from __future__ import annotations + +import unittest + +from tools.standards_engine.tests.stdio_server import StdioServer, StdioServers +from tools.standards_engine.tests.test_mcp import ROOT, installation_root + + +def instance(server): + return server.initialized['result']['_meta']['standards-engine/runtime']['instance_id'] + + +class StdioServerTest(unittest.TestCase): + def test_one_process_answers_every_call_and_exits_cleanly(self): + server = StdioServer(installation_root(self), purpose='application', client='helper-test') + self.addCleanup(server.close) + self.assertEqual(server.exchange('ping')['result'], {}) + results = [server.call('runtime_info', {})['result'] for _ in range(2)] + self.assertEqual([result['structuredContent']['instance_id'] for result in results], [instance(server)] * 2) + self.assertEqual(server.close(), '') + self.assertEqual(server._process.returncode, 0) + self.assertEqual(server.close(), '', 'closing again is harmless') + + def test_stderr_fails_the_call_that_caused_it_unless_the_test_expects_it(self): + root = installation_root(self) + store = root / '.standards-engine/snapshots-v1.sqlite3' + store.parent.mkdir() + store.write_bytes(b'not a database') + server = StdioServer(root, purpose='authoring') + with self.assertRaisesRegex(AssertionError, 'wrote to stderr during tools/call'): + server.call('read', {'target': 'core'}) + with self.assertRaisesRegex(AssertionError, 'wrote to stderr'): + server.close() + expected = StdioServer(root, purpose='authoring', silent=False) + self.assertTrue(expected.call('read', {'target': 'core'})['result']['isError']) + self.assertIn('Traceback', expected.close()) + + def test_a_process_that_ends_early_fails_with_its_diagnostics(self): + with self.assertRaisesRegex(AssertionError, "exited before answering initialize: (?s:.*)invalid choice: 'neither'"): + StdioServer(ROOT, purpose='neither') + server = StdioServer(installation_root(self), purpose='application') + server._process.kill() + server._process.wait() + with self.assertRaises(AssertionError): + server.exchange('ping') + with self.assertRaisesRegex(AssertionError, 'exited with status'): + server.close() + + def test_one_process_per_launch_until_restart_and_close_ends_them_all(self): + root = installation_root(self) + servers = StdioServers(client='helper-test') + self.addCleanup(servers.close) + first = servers.server(root, 'application') + self.assertIs(servers.server(root, 'application'), first) + other = servers.server(root, 'application', '--output-schemas', 'on-demand') + self.assertNotEqual(instance(other), instance(first)) + servers.restart(root, 'application') + self.assertEqual(first._process.returncode, 0) + replacement = servers.server(root, 'application') + self.assertNotEqual(instance(replacement), instance(first)) + servers.close() + self.assertEqual([server._process.returncode for server in (other, replacement)], [0, 0]) + + +if __name__ == '__main__': + unittest.main() diff --git a/tools/standards_engine/tests/test_storage_lifecycle_transport.py b/tools/standards_engine/tests/test_storage_lifecycle_transport.py index a9b5eb47..063df430 100644 --- a/tools/standards_engine/tests/test_storage_lifecycle_transport.py +++ b/tools/standards_engine/tests/test_storage_lifecycle_transport.py @@ -1,25 +1,36 @@ """Cold MCP reads coexist with a reserved writer only when no purge is due. +One server process audits its store once, on its first call; a newly started +process audits again and still rejects a corrupt store. Each test therefore +starts a new server process exactly where its claim is about a cold start. + The fixture owns its database, evidence and processes. Publication, authorization and interpreter timing are not simulated; no production store is accessed. """ from __future__ import annotations -import json import os +import re +import shutil import sqlite3 -import subprocess -import sys import time import unittest from contextlib import closing +from pathlib import Path +from unittest import mock +from tools.standards_engine.standards_engine.mcp import MCPServer from tools.standards_engine.tests import test_agent_interaction_transport as transport +from tools.standards_engine.tests.stdio_server import StdioServer, StdioServers +from tools.standards_engine.tests.test_mcp import initialize, request from tools.standards_engine.tests.test_route_content import known_assertions from tools.standards_snapshots.standards_snapshots import ( AggregateChild, AggregateRecord, AggregateRoot, ChildHandle, SnapshotError, SnapshotId, SnapshotModule, ) +from tools.standards_snapshots.standards_snapshots import store as snapshot_store + +AUDIT_STATEMENTS = ('PRAGMA integrity_check', 'PRAGMA foreign_key_check') class StorageLifecycleTransportTest(unittest.TestCase): @@ -34,11 +45,89 @@ def setUpClass(cls): def tearDownClass(cls): transport.fixture.PurposeTransportTest.tearDownClass() + def setUp(self): + self.servers = StdioServers(client='interaction-fixture') + self.addCleanup(self.servers.close) + def call(self, purpose, operation, arguments, *, rejected=False): return transport.AgentInteractionTransportTest.call( self, purpose, operation, arguments, rejected=rejected, delivery='on-demand', ) + def cold_open_failure(self): + """Run one cold authoring read whose store open fails; return its private stderr.""" + # Open-time failure retains the existing MCP private-stderr + # boundary (no structured result), not an invented tool outcome. + server = StdioServer(self.root, purpose='authoring', options=('--output-schemas', 'on-demand'), + client='storage-open-fixture', silent=False) + try: + failed = server.call('read', {'snapshot': self.snapshot, 'target': 'core'})['result'] + finally: + errors = server.close() + self.assertTrue(failed['isError']) + self.assertNotIn('structuredContent', failed) + self.assertIn('Engine invocation failed', failed['content'][0]['text']) + return errors + + def test_one_server_process_audits_its_store_once_across_calls(self): + # The fixture built this store inside the test process. Discard that + # record so the server below starts as a newly launched process does. + with snapshot_store._AUDITED_FILES_LOCK: + snapshot_store._AUDITED_FILES.clear() + opens = [] + connect = sqlite3.connect + + def traced_connect(database, *arguments, **options): + connection = connect(database, *arguments, **options) + if Path(database).resolve() == self.path.resolve(): + opens.append([]) + connection.set_trace_callback(opens[-1].append) + return connection + + server = MCPServer(self.root, purpose='application') + self.addCleanup(server.close) + initialize(server) + arguments = {'snapshot': self.snapshot, 'target': 'core'} + with mock.patch.object(snapshot_store.sqlite3, 'connect', traced_connect): + results = [ + server.dispatch(request('tools/call', {'name': 'read', 'arguments': arguments}, + identifier))['result'] + for identifier in (2, 3, 4) + ] + for result in results: + self.assertFalse(result['isError'], result) + self.assertEqual(result['structuredContent']['content'], + transport.fixture.PurposeTransportTest.expected) + # Every call still opens and closes its own store connection. + self.assertEqual(len(opens), 3) + self.assertEqual([[statement for statement in statements if statement in AUDIT_STATEMENTS] + for statements in opens], [list(AUDIT_STATEMENTS), [], []]) + for statements in opens: + self.assertIn('PRAGMA application_id', statements) + self.assertIn('PRAGMA user_version', statements) + self.assertTrue(any('FROM sqlite_schema' in statement for statement in statements)) + # A later call runs the statements of the first except its audit. Only + # the clock reading bound into the maintenance probe differs between calls. + opens = [[re.sub(r'purge_deadline <= \d+', 'purge_deadline <= :now', statement) + for statement in statements] for statements in opens] + self.assertEqual([statement for statement in opens[0] if statement not in AUDIT_STATEMENTS], + opens[1]) + self.assertEqual(opens[1], opens[2]) + self.assertTrue(any('purge_deadline <= :now' in statement for statement in opens[1])) + + def test_cold_server_process_rejects_a_corrupt_store_on_its_first_call(self): + retained = self.path.with_name('retained-valid-store.sqlite3') + shutil.copyfile(self.path, retained) + try: + with closing(sqlite3.connect(self.path, isolation_level=None)) as corruptor: + corruptor.execute( + "INSERT INTO content_files VALUES ('missing', 'a', X'', 0, 'digest')") + self.assertIn('SNAPSHOT_STORE.FOREIGN_KEY_FAILURE', self.cold_open_failure()) + finally: + os.replace(retained, self.path) + recovered = self.call('authoring', 'read', {'snapshot': self.snapshot, 'target': 'core'}) + self.assertEqual(recovered['content'], transport.fixture.PurposeTransportTest.expected) + def test_cold_agent_observations_match_while_another_process_holds_writer(self): cases = [ ('read', {'snapshot': self.snapshot, 'target': 'core'}), @@ -55,6 +144,8 @@ def test_cold_agent_observations_match_while_another_process_holds_writer(self): writer.execute('INSERT INTO purged_root_tombstones VALUES (?, ?)', ('uncommitted-test', 1)) try: for purpose in ('application', 'authoring'): + # Cold: a process started under the held writer audits and opens the store. + self.servers.restart(self.root, purpose, '--output-schemas', 'on-demand') for operation, arguments in cases: with self.subTest(purpose=purpose, operation=operation): self.assertEqual(self.call(purpose, operation, arguments), @@ -82,31 +173,7 @@ def test_cold_due_maintenance_keeps_busy_then_expires_all_dependents_atomically( with closing(sqlite3.connect(self.path, isolation_level=None)) as writer: writer.execute('BEGIN IMMEDIATE') try: - # Open-time failure retains the existing MCP private-stderr - # boundary (no structured result), not an invented tool outcome. - messages = [ - {'jsonrpc': '2.0', 'id': 1, 'method': 'initialize', 'params': { - 'protocolVersion': '2025-11-25', 'capabilities': {}, - 'clientInfo': {'name': 'storage-busy-fixture', 'version': '1'}}}, - {'jsonrpc': '2.0', 'method': 'notifications/initialized'}, - {'jsonrpc': '2.0', 'id': 2, 'method': 'tools/call', 'params': { - 'name': 'read', 'arguments': {'snapshot': self.snapshot, 'target': 'core'}}}, - ] - process = subprocess.run( - [sys.executable, '-P', '-m', 'tools.standards_engine.standards_engine.mcp', - '--repo-root', str(self.root), '--purpose', 'authoring', - '--output-schemas', 'on-demand'], - env={**os.environ, 'PYTHONPATH': str(transport.fixture.ROOT)}, - input=''.join(json.dumps(message) + '\n' for message in messages), - text=True, capture_output=True, timeout=90, - ) - self.assertEqual(process.returncode, 0, process.stderr) - self.assertIn('SNAPSHOT_STORE.BUSY', process.stderr) - failed = next(json.loads(line)['result'] for line in process.stdout.splitlines() - if json.loads(line).get('id') == 2) - self.assertTrue(failed['isError']) - self.assertNotIn('structuredContent', failed) - self.assertIn('Engine invocation failed', failed['content'][0]['text']) + self.assertIn('SNAPSHOT_STORE.BUSY', self.cold_open_failure()) self.assertIsNotNone(writer.execute( 'SELECT 1 FROM snapshot_roots WHERE snapshot_id = ?', (str(expired),) ).fetchone()) diff --git a/tools/standards_engine/tests/test_supporting_workflow.py b/tools/standards_engine/tests/test_supporting_workflow.py index 581ecbf5..622f452d 100644 --- a/tools/standards_engine/tests/test_supporting_workflow.py +++ b/tools/standards_engine/tests/test_supporting_workflow.py @@ -1,4 +1,8 @@ -"""Real proposal, review, publication and readback in an isolated Git repository.""" +"""Real proposal, review, publication and readback in an isolated Git repository. + +Both facades use the per-purpose compiled cache that a server process owns, so +this one run also proves that warm reuse never changes a result. +""" from __future__ import annotations import json @@ -8,6 +12,7 @@ import unittest from tools.standards_engine.standards_engine import AgentToolFacade +from tools.standards_engine.standards_engine.compiled_cache import CompiledSnapshotCache from tools.standards_engine.tests.test_agent_workflow import prepare_repository, evidence, decisions from tools.standards_metadata.standards_metadata import load_canonical_standards_corpus @@ -39,12 +44,16 @@ def setUpClass(cls): # of which implementation branch supplied the test code. if subprocess.check_output(["git", "branch", "--show-current"], cwd=cls.root).decode().strip() != "main": subprocess.run(["git", "branch", "-m", "main"], cwd=cls.root, check=True) - cls.author = AgentToolFacade.open_repository(cls.root, purpose="authoring") - cls.app = AgentToolFacade.open_repository(cls.root, purpose="application") + cls.caches = {purpose: CompiledSnapshotCache(cls.root, purpose) for purpose in ("authoring", "application")} + cls.author = AgentToolFacade.open_repository(cls.root, purpose="authoring", compiled_cache=cls.caches["authoring"]) + cls.app = AgentToolFacade.open_repository(cls.root, purpose="application", compiled_cache=cls.caches["application"]) @classmethod def tearDownClass(cls): - cls.author.close(); cls.app.close(); cls.temporary.cleanup() + cls.author.close(); cls.app.close() + for cache in cls.caches.values(): + cache.close() + cls.temporary.cleanup() def change(self, edits): return {"purpose": {"summary": "Exercise purpose-separated content publication", @@ -113,9 +122,11 @@ def test_coordinated_publication_and_provenance_only_revision(self): # accepted corpus, and publish it without an application approval. unexposed = self.author.read({"snapshot": published_snapshot, "target": UNEXPOSED, "detail": "full"}) self.assertIn(PUBLIC, unexposed["content"], unexposed) - empty = self.app.read({"snapshot": published_snapshot, "target": UNEXPOSED}) - self.assertEqual(empty["code"], "APPLICATION.CONTENT_UNAVAILABLE", empty) - self.assertEqual(self.app.read({"snapshot": published_snapshot, "target": REFERENCE})["kind"], "application-read-result") + labelled = self.app.read({"snapshot": published_snapshot, "target": UNEXPOSED}) + self.assertEqual((labelled["kind"], labelled["review_state"]), ("application-read-result", "not-reviewed"), labelled) + self.assertEqual(labelled["content"], unexposed["content"]) + self.assertEqual(first["review_state"], "current") + self.assertEqual(self.app.read({"snapshot": published_snapshot, "target": REFERENCE})["review_state"], "current") for aid in aids: exposed = self.app.read({"snapshot": published_snapshot, "target": aid["canonical_id"]}) self.assertEqual(exposed["kind"], "application-read-result", exposed) @@ -140,4 +151,6 @@ def test_coordinated_publication_and_provenance_only_revision(self): self.assertEqual(current["record"]["rationale"], PRIVATE + "_REVISED") self.assertNotEqual(current["authority"], old_snapshot) self.assertEqual(self.app.read({"snapshot": current["authority"], "target": RULE})["content"], first["content"]) - self.assertEqual(self.app.read({"snapshot": current["authority"], "target": REASON})["kind"], "application-rejected-result") + self.assertEqual(self.app.read({"snapshot": current["authority"], "target": REASON})["code"], "APPLICATION.UNKNOWN_TARGET") + # Every result above came through a warm cache that only its own purpose can use. + self.assertTrue(all(cache.statistics["hits"] > 0 for cache in self.caches.values())) diff --git a/tools/standards_engine/tests/test_typed_routing_workflow.py b/tools/standards_engine/tests/test_typed_routing_workflow.py index 44a12cc9..1ce25eee 100644 --- a/tools/standards_engine/tests/test_typed_routing_workflow.py +++ b/tools/standards_engine/tests/test_typed_routing_workflow.py @@ -1,20 +1,18 @@ -"""Real unpublished routing workflows use typed edits across replacement processes.""" +"""Real unpublished routing workflows use typed edits over stdio and survive a replacement process.""" from __future__ import annotations from copy import deepcopy import json -import os from pathlib import Path import subprocess -import sys import tempfile import tomllib import unittest from tools.standards_engine.standards_engine import AgentToolFacade +from tools.standards_engine.tests.stdio_server import StdioServers from tools.standards_engine.tests.test_analysis import _clone_tracked_worktree from tools.standards_engine.tests.test_agent_workflow import decisions, evidence -from tools.standards_engine.tests.test_mcp import request from tools.standards_engine.tests.test_request_evidence import shared ROOT = Path(__file__).resolve().parents[3] @@ -30,17 +28,13 @@ def setUpClass(cls): cls.main = subprocess.check_output(['git','-C',str(cls.root),'rev-parse','main']) cls.router = tomllib.loads((cls.root/'evaluation/standards-effectiveness/router-projection.toml').read_text()) + def setUp(self): + self.servers = StdioServers(client='typed-routing-test', cwd=ROOT) + self.addCleanup(self.servers.close) + def call(self, operation, arguments, delivery='on-demand', *, error=False): - messages = [request('initialize', {'protocolVersion':'2025-11-25','capabilities':{}, - 'clientInfo':{'name':'typed-routing-test','version':'1'}}), - {'jsonrpc':'2.0','method':'notifications/initialized'}, - request('tools/call', {'name':operation,'arguments':arguments}, 2)] - run = subprocess.run([sys.executable,'-P','-m','tools.standards_engine.standards_engine.mcp', - '--repo-root',str(self.root),'--purpose','authoring','--output-schemas',delivery], - input=''.join(json.dumps(v)+'\n' for v in messages),text=True,capture_output=True,check=True, - cwd=ROOT,env={**os.environ,'PYTHONPATH':str(ROOT)}) - self.assertEqual(run.stderr, '') - reply = next(json.loads(line) for line in run.stdout.splitlines() if json.loads(line).get('id')==2) + # One server process per catalog delivery serves every call of a test. + reply = self.servers.server(self.root, 'authoring', '--output-schemas', delivery).call(operation, arguments) self.assertNotIn('error', reply, reply) result = reply['result'] self.assertEqual(result['isError'], error, result) @@ -104,6 +98,8 @@ def test_all_four_edits_replay_through_readiness_with_shared_evidence(self): self.assertEqual(ready['status'],'ready',ready) self.assertEqual(self.call('review',review,delivery),ready) self.assertEqual(self.call('review',{'context':complete['context'],'decisions':decisions(self.root)},delivery),ready) + # A replacement process reads both revisions exactly as the first left them. + self.servers.restart(self.root, 'authoring', '--output-schemas', delivery) read = self.call('query_proposal',{'revision':ready['revision'],'request':{'kind':'read','target':'router'}},delivery) self.assertNotIn(rule['condition'],read['content']) self.assertNotEqual(read['content'],preview['content']) diff --git a/tools/standards_engine/tests/test_verification_inputs.py b/tools/standards_engine/tests/test_verification_inputs.py new file mode 100644 index 00000000..d3cc683a --- /dev/null +++ b/tools/standards_engine/tests/test_verification_inputs.py @@ -0,0 +1,65 @@ +from __future__ import annotations + +import subprocess +import tempfile +import unittest +from pathlib import Path + +from tools.standards_analysis.standards_analysis import AnalysisExecutionContext +from tools.standards_engine.standards_engine import AgentToolFacade, StandardsEngine +from tools.standards_engine.standards_engine.tools import ( + LocalAlwaysAllowAuthorizer, + _contracts, +) +from tools.standards_engine.tests.test_analysis import _clone_tracked_worktree + + +class VerificationInputFreshnessTest(unittest.TestCase): + """The Engine checkpoint and its refresh agree about a stale manifest.""" + + def test_read_only_checkpoint_rejects_a_stale_manifest_and_refresh_repairs_it( + self, + ) -> None: + with tempfile.TemporaryDirectory() as temporary: + repository = Path(temporary) / "repository" + _clone_tracked_worktree(repository) + # No check reads this file; only the pinned list of tracked files changes. + added = repository / "docs" / "added-without-a-refresh.md" + added.write_text("A file tracked after the manifest was generated.\n") + subprocess.run( + ("git", "-C", str(repository), "add", "--", str(added)), check=True + ) + with StandardsEngine.open_repository( + repository, + store_path=Path(temporary) / "engine.sqlite3", + execution_context=AnalysisExecutionContext( + LocalAlwaysAllowAuthorizer(repository) + ), + purpose="authoring", + ) as engine: + facade = AgentToolFacade(engine, _contracts(repository)) + + def verify(refresh: bool) -> dict[str, object]: + result = facade.verify_repository( + { + "kind": "verify-repository", + "refresh_verification_inputs": refresh, + } + ) + self.assertEqual(result["kind"], "verify-repository-result", result) + return result["verification"] + + stale = verify(False) + self.assertFalse(stale["passed"]) + self.assertEqual( + [item["code"] for item in stale["failures"]], + ["SUITE_INPUT.STALE_MANIFEST"], + ) + self.assertGreater(stale["suites"], 0) + + # The refresh verifies what it wrote, manifest included. + self.assertTrue(verify(True)["passed"]) + + +if __name__ == "__main__": + unittest.main() diff --git a/tools/standards_engine/tests/test_workflow_presentation.py b/tools/standards_engine/tests/test_workflow_presentation.py index 3636bc84..ceecd67d 100644 --- a/tools/standards_engine/tests/test_workflow_presentation.py +++ b/tools/standards_engine/tests/test_workflow_presentation.py @@ -310,7 +310,7 @@ def call(arguments): root = Path(__file__).resolve().parents[3] run = subprocess.run( [sys.executable, "-P", "-m", "tools.standards_engine.standards_engine.mcp", - "--repo-root", str(self.root), "--purpose", "authoring"], + "--repo-root", str(self.root), "--purpose", "authoring", "--no-observe"], input="".join(json.dumps(item) + "\n" for item in messages), text=True, capture_output=True, env={**os.environ, "PYTHONPATH": str(root)}, check=True, @@ -319,6 +319,7 @@ def call(arguments): wire = json.loads(run.stdout.splitlines()[-1])["result"] self.assertEqual(json.loads(wire["content"][0]["text"]), wire["structuredContent"]) return wire["structuredContent"] + # Two processes: the retry request is honoured by a server that did not issue it. rejected = call({"analysis": result["context"], "section": "dispositions"}) self.assertEqual(rejected["code"], "WORKFLOW.RESULT_LIMIT") page = call(rejected["next_operations"][0]["request"]) diff --git a/tools/standards_engine/tests/workflow_interaction_trace.py b/tools/standards_engine/tests/workflow_interaction_trace.py index 1de38251..17312721 100644 --- a/tools/standards_engine/tests/workflow_interaction_trace.py +++ b/tools/standards_engine/tests/workflow_interaction_trace.py @@ -1,4 +1,4 @@ -"""Measure an explicit decision workflow through cold MCP calls, without a model. +"""Measure an explicit decision workflow through one MCP stdio server, without a model. Run with the repository's selected Python and PYTHONPATH=. from either the baseline or candidate checkout. --mode selects the corresponding public client @@ -9,12 +9,11 @@ import argparse import json -import os from pathlib import Path -import subprocess import sys import tempfile +from tools.standards_engine.tests.stdio_server import StdioServer from tools.standards_engine.tests.test_analysis import _clone_tracked_worktree from tools.standards_engine.tests.test_review_workflow_ux import decision, topic_change @@ -25,25 +24,10 @@ def measure(mode: str) -> dict[str, object]: root = Path(temporary) / "repository" _clone_tracked_worktree(root) + server = StdioServer(root, purpose="authoring", client="workflow-interaction-trace", silent=False) + def call(name: str, arguments: dict) -> dict: - messages = [ - {"jsonrpc": "2.0", "id": 1, "method": "initialize", "params": { - "protocolVersion": "2025-11-25", "capabilities": {}, - "clientInfo": {"name": "workflow-interaction-trace", "version": "1"}, - }}, - {"jsonrpc": "2.0", "method": "notifications/initialized"}, - {"jsonrpc": "2.0", "id": 2, "method": "tools/call", "params": { - "name": name, "arguments": arguments, - }}, - ] - completed = subprocess.run( - [sys.executable, "-P", "-m", "tools.standards_engine.standards_engine.mcp", - "--repo-root", str(root), "--purpose", "authoring"], - input="".join(json.dumps(item) + "\n" for item in messages), - text=True, capture_output=True, check=True, env=os.environ.copy(), - ) - responses = [json.loads(line) for line in completed.stdout.splitlines()] - selected = next(item for item in responses if item.get("id") == 2) + selected = server.call(name, arguments) if "error" in selected: raise AssertionError(selected) wire = selected["result"] @@ -57,28 +41,31 @@ def call(name: str, arguments: dict) -> dict: }) return value - result = call("propose", {"change_set": topic_change(root, "interaction-trace", 4)}) - for remaining in (2, 0): - if result["status"] != "needs-action": - raise AssertionError(result) - if mode == "explicit-pages": - page = call("workflow_details", { - "analysis": result["context"], "section": "pending_obligations", + try: + result = call("propose", {"change_set": topic_change(root, "interaction-trace", 4)}) + for remaining in (2, 0): + if result["status"] != "needs-action": + raise AssertionError(result) + if mode == "explicit-pages": + page = call("workflow_details", { + "analysis": result["context"], "section": "pending_obligations", + }) + else: + page = result["work"] + if page["kind"] != "workflow-work-page": + raise AssertionError(page) + result = call("resolve_many", { + "context": result["context"], + "submissions": [decision(root, item["obligation"]) for item in page["items"][:2]], }) - else: - page = result["work"] - if page["kind"] != "workflow-work-page": - raise AssertionError(page) - result = call("resolve_many", { - "context": result["context"], - "submissions": [decision(root, item["obligation"]) for item in page["items"][:2]], - }) - if result["outcome"]["required_obligations"] != remaining: - raise AssertionError(result) + if result["outcome"]["required_obligations"] != remaining: + raise AssertionError(result) + finally: + server.close() if result["status"] != "complete" or {item["operation"] for item in result["next_operations"]} != {"review", "revise"}: raise AssertionError(result) return { - "mode": mode, "python": sys.version.split()[0], "transport": "cold-mcp-stdio", + "mode": mode, "python": sys.version.split()[0], "transport": "mcp-stdio", "scenario": "four explicit impact decisions in two batches; stop before review/publication", "calls": calls, "call_count": len(calls), "argument_bytes": sum(item["argument_bytes"] for item in calls), diff --git a/tools/standards_metadata/standards_metadata/__init__.py b/tools/standards_metadata/standards_metadata/__init__.py index f3af9dae..9a081177 100644 --- a/tools/standards_metadata/standards_metadata/__init__.py +++ b/tools/standards_metadata/standards_metadata/__init__.py @@ -4,6 +4,7 @@ from .corpus import load_canonical_standards_corpus from .loader import ( CANONICAL_MODULE_CORPUS, + canonical_module_corpus_members, load_canonical_module_corpus, load_module_metadata, validate_module_metadata, @@ -78,6 +79,7 @@ "SuiteInputManifest", "SuiteInputUse", "UnmappedModuleProjection", + "canonical_module_corpus_members", "load_canonical_standards_corpus", "load_canonical_module_corpus", "load_policy_unit_corpus", diff --git a/tools/standards_metadata/standards_metadata/loader.py b/tools/standards_metadata/standards_metadata/loader.py index e89b51bd..eec69a09 100644 --- a/tools/standards_metadata/standards_metadata/loader.py +++ b/tools/standards_metadata/standards_metadata/loader.py @@ -518,10 +518,11 @@ def _members(raw: Any, manifest_path: str) -> tuple[str, ...]: return members -def load_canonical_module_corpus( +def canonical_module_corpus_members( source: ContentSourceInput, manifest_path: str = CANONICAL_MODULE_CORPUS, -) -> CanonicalModuleCorpus: +) -> tuple[str, ...]: + """Return the declared corpus membership without reading any member.""" selected_source = content_source(source) raw = _load_toml(selected_source, manifest_path) required = {"schema_version", "members"} @@ -546,7 +547,15 @@ def load_canonical_module_corpus( observed=str(raw["schema_version"]), ) ) - members = _members(raw["members"], manifest_path) + return _members(raw["members"], manifest_path) + + +def load_canonical_module_corpus( + source: ContentSourceInput, + manifest_path: str = CANONICAL_MODULE_CORPUS, +) -> CanonicalModuleCorpus: + selected_source = content_source(source) + members = canonical_module_corpus_members(selected_source, manifest_path) validation = validate_module_metadata(selected_source, members) if validation.failures: raise MetadataError(validation.failures[0]) diff --git a/tools/standards_metadata/tests/test_metadata.py b/tools/standards_metadata/tests/test_metadata.py index 624e2d00..6918c98a 100644 --- a/tools/standards_metadata/tests/test_metadata.py +++ b/tools/standards_metadata/tests/test_metadata.py @@ -11,6 +11,7 @@ FrozenContentSource, MetadataError, RecordingContentSource, + canonical_module_corpus_members, load_canonical_standards_corpus, load_canonical_module_corpus, load_module_metadata, @@ -102,6 +103,16 @@ def test_loads_immutable_corpus_and_resolves_id_and_path(self) -> None: ) self.assertIsNone(corpus.resolve("unknown")) + def test_membership_is_read_without_reading_any_member(self) -> None: + self.write_manifest(("absent.md", "also-absent.md")) + source = RecordingContentSource(DirectoryContentSource(self.root)) + + members = canonical_module_corpus_members(source, "corpus.toml") + + self.assertEqual(members, ("absent.md", "also-absent.md")) + self.assertEqual(source.requested_paths, ("corpus.toml",)) + self.assertEqual(self.error_code(), "INPUT.UNAVAILABLE") + def test_manifest_schema_and_member_paths_are_strict(self) -> None: cases = ( ("schema_version = 2", ("module.md",), "CONFIG.SCHEMA_VERSION"), diff --git a/tools/standards_snapshots/README.md b/tools/standards_snapshots/README.md index a1809843..d8d18b23 100644 --- a/tools/standards_snapshots/README.md +++ b/tools/standards_snapshots/README.md @@ -47,24 +47,62 @@ still performs maintenance, reloads actual content and runs the existing per-fil checks. The reuse owner receives that complete capture and the Snapshot-owned codec; its contract requires the identical computed content ID, not a cached caller claim. Snapshot compares it with the currently loaded stored ID on every call. Omission -keeps standalone behavior cold. The Engine uses its existing scoped, bounded process +keeps standalone behavior cold. The Engine uses its scoped, bounded compilation cache; roots, lifecycle, authority and response values are never identity-cache data. No identity domain, store format or persisted representation changes. ## Admission and maintenance work -Each open of an existing current-schema database authenticates the application, -exact schema, and complete SQLite integrity/foreign-key state **before** persistent -configuration. Configuration is followed by the existing exact schema check. The -same full audit is not repeated for a store admitted at the current schema version. -This is a point-in-time audit on every open, not cached proof that the database can -never change. Selected content and aggregate reads retain their ordinary checks. +Each open of an existing current-schema database authenticates the application +and exact schema **before** persistent configuration. Configuration is followed by +the existing exact schema check. Those checks run on every open. -New initialization keeps its final integrity audit and owned-file cleanup on failure. +The complete SQLite integrity/foreign-key audit runs once per process for each +store file. A process's first open of a file audits it before persistent +configuration. Later opens of the same file by that process omit only this audit. +The process remembers a passed audit in memory, by the file's device and inode, and +only after that open succeeded; nothing is persisted. A new process audits again, +and so does a file moved into place under a different inode. To audit a store +again, open it from a new process. `maintain` purges expired roots; it does not run +this audit. + +The audit is a point-in-time observation, not proof that the database stays valid. +Damage that appears after a process's audit is not reported by that process's later +opens. A file deleted and then recreated outside this package can receive the +audited file's inode number, and that process does not audit it; replace a store by +renaming a complete file into place, or restart the process. Selected content and +aggregate reads retain their ordinary checks on every call. + +New initialization keeps its final integrity audit and owned-file cleanup on failure; +that audit is the creating process's audit of the new file. A store admitted as v1 keeps the pre-configuration audit, transaction-guarded -pre/post-migration audits, and final destination audit. The final audit also applies +pre/post-migration audits, and final destination audit, even when the process +audited the same file earlier. The final audit also applies when another opener finishes migration before this opener prepares the schema. -No integrity policy, SQLite profile, supported migration or stored format changes. +No SQLite profile, supported migration or stored format changes. + +An owner may keep a module between uses without keeping its connection; an MCP +server process does. It calls `release` after each use and `readmit` before the +next. `release` closes the connection: the module then holds no connection, no +SQLite lock and no open file, and a transaction the use did not end is rolled +back. `readmit` first compares the path with the file the module opened. If the +path names another file, no file, or something that is not a regular file, +`readmit` opens nothing, returns false and drops the audit record of the file it +had opened; the owner closes the module and opens the path again, and that open +admits, audits, creates or refuses what is there as any open does. If the path +still names the opened file, `readmit` opens a new connection and runs the +statements a later open of that file runs, in the same order: application, +version and exact schema, the required profile, the schema again, a version 1 +migration with every one of its audits, and then the maintenance probe with any +due purge. A failure is raised with the code that open raises and leaves no +connection open. Only the audit the process has recorded for the file is +omitted, as a later open omits it. + +The file is recognised by its device and inode, as the audit record is. Dropping +the record of a file that was seen to be replaced means a later file that +receives its inode number is audited. A file deleted and recreated between two +uses can still receive the same inode number and is then taken for the audited +file, which is the limit described above. Maintenance remains synchronous at the same module call sites. It first performs a short-lived existence read for quarantined roots whose deadline is at or before the diff --git a/tools/standards_snapshots/standards_snapshots/module.py b/tools/standards_snapshots/standards_snapshots/module.py index 87b007cf..fef63547 100644 --- a/tools/standards_snapshots/standards_snapshots/module.py +++ b/tools/standards_snapshots/standards_snapshots/module.py @@ -93,6 +93,32 @@ def open( def close(self) -> None: self._store.close() + def release(self) -> None: + """Close the store connection until `readmit` opens the next one. + + Between uses the module then holds no connection, lock or open file. A + transaction a use did not end is rolled back. + """ + self._store.release() + + def readmit(self) -> bool: + """Open the store for another use, as opening its path again would. + + False means the store path now names another file or none, and the + owner must close this module and open the path again. Otherwise the + store runs its admission on a new connection and due maintenance runs, + exactly as `open` does. A failure of either is raised and leaves no + connection open. + """ + if not self._store.readmit(): + return False + try: + self.maintain() + except Exception: + self._store.release() + raise + return True + def __enter__(self) -> SnapshotModule: return self diff --git a/tools/standards_snapshots/standards_snapshots/store.py b/tools/standards_snapshots/standards_snapshots/store.py index 9b42f2ac..337530b4 100644 --- a/tools/standards_snapshots/standards_snapshots/store.py +++ b/tools/standards_snapshots/standards_snapshots/store.py @@ -5,6 +5,7 @@ import os import sqlite3 import stat +import threading from collections.abc import Iterator from contextlib import closing, contextmanager from functools import lru_cache @@ -35,6 +36,31 @@ USER_VERSION = 2 BUSY_TIMEOUT_MS = 5_000 +# Device and inode of every store file whose complete SQLite integrity and +# foreign-key audit has passed in this process. A later open of the same file +# keeps every other admission check and omits only that audit pair. The record +# is never persisted: each new process audits again, and a file put in place +# under a different inode has no record. It is a point-in-time observation of +# one file, not proof that another process has left the file unchanged. A store +# drops the record of the file it opened when it finds the path naming another. +_AUDITED_FILES: set[tuple[int, int]] = set() +_AUDITED_FILES_LOCK = threading.Lock() + + +def _audit_recorded(identity: tuple[int, int]) -> bool: + with _AUDITED_FILES_LOCK: + return identity in _AUDITED_FILES + + +def _record_audit(identity: tuple[int, int]) -> None: + with _AUDITED_FILES_LOCK: + _AUDITED_FILES.add(identity) + + +def _forget_audit(identity: tuple[int, int]) -> None: + with _AUDITED_FILES_LOCK: + _AUDITED_FILES.discard(identity) + def _root_reference(value: object, description: str) -> None: if type(value) is not str or not value: @@ -274,6 +300,7 @@ def __init__(self, path: Path) -> None: "SNAPSHOT_STORE.UNSUPPORTED_PATH", "SQLite path must be one regular non-symlink file", ) + identity = (observed.st_dev, observed.st_ino) else: path.parent.mkdir(mode=0o700, parents=True, exist_ok=True) flags = os.O_WRONLY | os.O_CREAT | os.O_EXCL @@ -281,30 +308,29 @@ def __init__(self, path: Path) -> None: try: descriptor = os.open(path, flags, 0o600) observed = os.fstat(descriptor) - created_identity = (observed.st_dev, observed.st_ino) + identity = created_identity = (observed.st_dev, observed.st_ino) os.close(descriptor) except OSError as error: raise unavailable("SNAPSHOT_STORE.UNAVAILABLE", str(error)) from error connection: sqlite3.Connection | None = None try: - connection = sqlite3.connect( - path, isolation_level=None, timeout=BUSY_TIMEOUT_MS / 1000 - ) + connection = self._connect() self._connection = connection - self._connection.enable_load_extension(False) + self._connected = True + # SQLite has opened whichever file the path named at that moment. + # An audit is reused, and afterwards recorded, only for a path that + # still names the file observed before the connection was made. + same_file = self._path_identity() == identity if existed: - admitted_version = self._verify_existing_authority() - self._configure() - self._prepare_existing_schema() - # Current stores were fully audited before configuration. A v1 - # admission still needs the final destination audit, including - # when another opener completed migration in the meantime. - if admitted_version != USER_VERSION: - self._verify_integrity() + self._admit_existing(audited=same_file and _audit_recorded(identity)) else: self._configure() self._initialize_schema() self._verify_integrity() + if same_file: + _record_audit(identity) + # The file this store opened, when that is known. + self._identity = identity if same_file else None except Exception as error: self._cleanup_failed_open(connection, created_identity) if isinstance(error, SnapshotError): @@ -316,7 +342,91 @@ def __init__(self, path: Path) -> None: raise def close(self) -> None: - self._connection.close() + self.release() + + def release(self) -> None: + """Close the connection; `readmit` opens the next one. + + An owner that keeps this store between uses calls this after each use, + so that between uses the store holds no connection, no lock and no open + file. A transaction the use did not end is rolled back, never committed. + Releasing a released store does nothing. + """ + if self._connected: + self._connected = False + self._connection.close() + + def readmit(self) -> bool: + """Open a connection for another use, as a new open of the path would. + + An owner that keeps the store between uses calls this before each use. + False means the path no longer names the regular file this store + opened: nothing is opened, and the owner closes this store and opens + the path again, which decides what is there now and audits a file this + process has not audited. Otherwise a new connection replaces the + previous one and runs every check an open of this existing file runs, + failing as that open would: application, version and exact schema, the + required profile, and a version 1 migration with its audits. Only the + complete audit this process recorded for the file is not repeated. A + failed readmission leaves no connection open. + """ + identity = self._identity + if identity is None: + return False + if self._path_identity() != identity: + # The path names another file or none. The number of the inode this + # store opened can be given to a later file, which must be audited, + # not taken for the audited one. + _forget_audit(identity) + return False + self.release() + try: + self._connection = self._connect() + self._connected = True + if self._path_identity() != identity: + # Replaced between the two observations: SQLite opened another file. + self.release() + _forget_audit(identity) + return False + self._admit_existing(audited=_audit_recorded(identity)) + except Exception as error: + self.release() + if isinstance(error, SnapshotError): + raise + if isinstance(error, sqlite3.DatabaseError): + raise invalid("SNAPSHOT_STORE.INVALID_DATABASE", str(error)) from error + raise + _record_audit(identity) + return True + + def _connect(self) -> sqlite3.Connection: + connection = sqlite3.connect( + self.path, isolation_level=None, timeout=BUSY_TIMEOUT_MS / 1000 + ) + try: + connection.enable_load_extension(False) + except BaseException: + connection.close() + raise + return connection + + def _admit_existing(self, *, audited: bool) -> None: + admitted_version = self._verify_existing_authority(audited=audited) + self._configure() + self._prepare_existing_schema() + # Current stores were fully audited before configuration, in this + # admission or an earlier one in this process. A v1 admission still + # needs the final destination audit, including when another opener + # completed migration in the meantime. + if admitted_version != USER_VERSION: + self._verify_integrity() + + def _path_identity(self) -> tuple[int, int] | None: + try: + observed = self.path.lstat() + except OSError: + return None + return (observed.st_dev, observed.st_ino) def _cleanup_failed_open( self, @@ -1047,8 +1157,12 @@ def _prepare_existing_schema(self) -> None: self._migrate_version_one() self._verify_schema() - def _verify_existing_authority(self) -> int: - """Authenticate before configuration and return the admitted schema version.""" + def _verify_existing_authority(self, *, audited: bool) -> int: + """Authenticate before configuration and return the admitted schema version. + + ``audited`` reports that this process already completed the full audit + of this exact current-schema file. It never shortens a v1 admission. + """ application_id = self._connection.execute("PRAGMA application_id").fetchone()[0] user_version = self._connection.execute("PRAGMA user_version").fetchone()[0] if application_id != APPLICATION_ID: @@ -1071,7 +1185,8 @@ def _verify_existing_authority(self) -> int: f"expected schema version 1 or {USER_VERSION}, observed {user_version}", ) self._verify_schema() - self._verify_integrity() + if not audited: + self._verify_integrity() return user_version def _migrate_version_one(self) -> None: diff --git a/tools/standards_snapshots/tests/test_storage_lifecycle.py b/tools/standards_snapshots/tests/test_storage_lifecycle.py index 66afbafd..f9689de5 100644 --- a/tools/standards_snapshots/tests/test_storage_lifecycle.py +++ b/tools/standards_snapshots/tests/test_storage_lifecycle.py @@ -2,26 +2,72 @@ No-work observations must not request a writer. A positive probe is only a hint: transactions still select the current due set and own all deletion effects. + +One process runs the complete integrity/foreign-key audit of a store file once. +Later opens of that file keep the application, version and exact schema checks. + +An owner that keeps a store between uses releases it after each use and +readmits it before the next. A released store holds no connection. Readmission +opens a new one, runs the statements of a later open, and reports a path that +no longer names the opened file so that the owner opens it again. """ from __future__ import annotations +import os +import shutil import sqlite3 +import subprocess +import sys import tempfile import unittest from contextlib import closing from pathlib import Path from typing import Callable +from unittest import mock from tools.standards_snapshots.standards_snapshots import ( AggregateChild, AggregateRecord, AggregateRoot, ChildHandle, FindAggregateRootsRequest, FindSnapshotsRequest, SnapshotError, SnapshotModule, ) +from tools.standards_snapshots.standards_snapshots import store as store_module from tools.standards_snapshots.standards_snapshots.store import SQLiteSnapshotStore from tools.standards_snapshots.tests.test_module import capture from tools.standards_snapshots.tests.test_store import ( - _populated_version_one_store, _version_one_rows, + _downgrade_to_version_one, _populated_version_one_store, _version_one_rows, ) +ROOT = Path(__file__).resolve().parents[3] + +# A separate interpreter has no audit record. It reports the admission outcome +# of the ordinary module open path for one existing store file. +_COLD_OPEN = """ +import sys +from pathlib import Path +from tools.standards_snapshots.standards_snapshots import SnapshotError, SnapshotModule +try: + SnapshotModule.open(Path(sys.argv[1])).close() +except SnapshotError as error: + print(error.failure.code) +else: + print('admitted') +""" + + +def _begin_as_new_process() -> None: + """Discard this process's audit record, as a newly started process has none.""" + with store_module._AUDITED_FILES_LOCK: + store_module._AUDITED_FILES.clear() + + +def _file_identity(path: Path) -> tuple[int, int]: + observed = path.lstat() + return observed.st_dev, observed.st_ino + + +def _violate_foreign_key(path: Path) -> None: + with closing(sqlite3.connect(path, isolation_level=None)) as corruptor: + corruptor.execute("INSERT INTO content_files VALUES ('missing', 'a', X'', 0, 'digest')") + class _ObservedAdmissionStore(SQLiteSnapshotStore): """Record proof phases while running the unchanged real proof implementations.""" @@ -74,6 +120,25 @@ def setUp(self): self.addCleanup(directory.cleanup) self.path = Path(directory.name) / 'snapshots.sqlite3' self.now = 2_000_000_000 + # Audit expectations must not depend on stores opened by earlier tests, + # whose removed files can lend their inode numbers to these fixtures. + _begin_as_new_process() + + def events(self, path=None): + opened = _ObservedAdmissionStore(path or self.path) + try: + return opened.admission_events + finally: + opened.close() + + def cold_open(self, path=None): + completed = subprocess.run( + [sys.executable, '-P', '-c', _COLD_OPEN, str(path or self.path)], + env={**os.environ, 'PYTHONPATH': str(ROOT)}, + text=True, capture_output=True, timeout=60, + ) + self.assertEqual(completed.returncode, 0, completed.stderr) + return completed.stdout.strip() def module(self): module = SnapshotModule.open(self.path, now=lambda: self.now, quarantine_seconds=10) @@ -311,22 +376,110 @@ def test_probe_sql_error_retains_typed_failure_without_transaction(self): self.assertNotIn('BEGIN IMMEDIATE', statements) self.assertFalse(module._store._connection.in_transaction) - def test_new_and_current_admission_have_one_full_integrity_audit(self): - created = _ObservedAdmissionStore(self.path) - try: - self.assertEqual(created.admission_events, [('configure', 0, False), ('integrity', 2, False)]) - finally: - created.close() + def test_new_and_current_admission_have_one_full_integrity_audit_per_process(self): + # The creating process audits its new file, and does not audit it again. + self.assertEqual(self.events(), [('configure', 0, False), ('integrity', 2, False)]) for _ in range(2): - opened = _ObservedAdmissionStore(self.path) - try: - self.assertEqual(opened.admission_events, [('integrity', 2, False), ('configure', 2, False)]) - finally: - opened.close() + self.assertEqual(self.events(), [('configure', 2, False)]) + # A new process audits the existing file once, before configuration. + _begin_as_new_process() + self.assertEqual(self.events(), [('integrity', 2, False), ('configure', 2, False)]) + for _ in range(2): + self.assertEqual(self.events(), [('configure', 2, False)]) + + def test_two_module_opens_in_one_process_audit_the_file_once(self): + with SnapshotModule.open(self.path, now=lambda: self.now) as initial: + snapshot = initial.create_snapshot(capture()).snapshot + _begin_as_new_process() + opens = [] + connect = sqlite3.connect + + def traced_connect(database, *arguments, **options): + # Observe each store connection from before its first statement. + connection = connect(database, *arguments, **options) + if Path(database).resolve() == self.path.resolve(): + opens.append([]) + connection.set_trace_callback(opens[-1].append) + return connection + + with mock.patch.object(store_module.sqlite3, 'connect', traced_connect): + for _ in range(2): + with SnapshotModule.open(self.path, now=lambda: self.now) as reopened: + self.assertEqual(reopened.load_content(snapshot), capture()) + first, second = opens + audit = ['PRAGMA integrity_check', 'PRAGMA foreign_key_check'] + self.assertEqual([statement for statement in first if statement in audit], audit) + # The later open omits exactly that pair and repeats every other statement. + self.assertEqual([statement for statement in first if statement not in audit], second) + self.assertIn('PRAGMA application_id', second) + self.assertIn('PRAGMA user_version', second) + self.assertTrue(any('FROM sqlite_schema' in statement for statement in second), second) + + def test_replaced_file_is_audited_again(self): + self.assertEqual(self.events(), [('configure', 0, False), ('integrity', 2, False)]) + self.assertEqual(self.events(), [('configure', 2, False)]) + audited = _file_identity(self.path) + # The replacement exists beside the audited file, so it has another inode. + replacement = self.path.with_name('replacement.sqlite3') + shutil.copyfile(self.path, replacement) + self.assertNotEqual(_file_identity(replacement), audited) + os.replace(replacement, self.path) + self.assertEqual(self.events(), [('integrity', 2, False), ('configure', 2, False)]) + self.assertEqual(self.events(), [('configure', 2, False)]) + + def test_corrupt_replacement_of_an_audited_file_is_rejected(self): + SQLiteSnapshotStore(self.path).close() + SQLiteSnapshotStore(self.path).close() + replacement = self.path.with_name('replacement.sqlite3') + shutil.copyfile(self.path, replacement) + _violate_foreign_key(replacement) + os.replace(replacement, self.path) + self.assert_code('SNAPSHOT_STORE.FOREIGN_KEY_FAILURE', lambda: SQLiteSnapshotStore(self.path)) + # A rejected file gains no audit record: the next open audits it again. + self.assert_code('SNAPSHOT_STORE.FOREIGN_KEY_FAILURE', lambda: SQLiteSnapshotStore(self.path)) + self.assertTrue(self.path.is_file()) + + def test_later_opens_keep_application_version_and_schema_checks(self): + for change, code in ( + ('PRAGMA application_id=1', 'SNAPSHOT_STORE.INVALID_APPLICATION'), + ('PRAGMA user_version=3', 'SNAPSHOT_STORE.UNSUPPORTED_VERSION'), + ('PRAGMA user_version=0', 'SNAPSHOT_STORE.INVALID_VERSION'), + ('CREATE TABLE unexpected (value TEXT)', 'SNAPSHOT_STORE.INVALID_SCHEMA'), + ('DROP TRIGGER child_index_no_update', 'SNAPSHOT_STORE.INVALID_SCHEMA'), + ): + with self.subTest(change=change), tempfile.TemporaryDirectory() as temporary: + path = Path(temporary) / 'snapshots.sqlite3' + SQLiteSnapshotStore(path).close() + self.assertEqual(self.events(path), [('configure', 2, False)]) + with closing(sqlite3.connect(path, isolation_level=None)) as changer: + changer.execute(change) + # Same file, already audited by this process: only the audit is omitted. + self.assert_code(code, lambda: _ObservedAdmissionStore(path)) + self.assertTrue(path.is_file()) + + def test_new_process_rejects_corruption_in_a_file_audited_elsewhere(self): + for corruption, code in (('foreign-key', 'SNAPSHOT_STORE.FOREIGN_KEY_FAILURE'), + ('check', 'SNAPSHOT_STORE.INTEGRITY_FAILURE')): + with self.subTest(corruption=corruption), tempfile.TemporaryDirectory() as temporary: + path = Path(temporary) / 'snapshots.sqlite3' + # This process audits the file; that record stays in this process. + SQLiteSnapshotStore(path).close() + self.assertEqual(self.cold_open(path), 'admitted') + with closing(sqlite3.connect(path, isolation_level=None)) as corruptor: + if corruption == 'foreign-key': + corruptor.execute("INSERT INTO content_files VALUES ('missing', 'a', X'', 0, 'digest')") + else: + corruptor.execute('PRAGMA ignore_check_constraints=ON') + corruptor.execute("INSERT INTO content_sets VALUES ('bad', 0)") + self.assertEqual(self.cold_open(path), code) + self.assertTrue(path.is_file()) def test_version_one_keeps_preconfiguration_guarded_and_final_audits(self): _, record = _populated_version_one_store(self.path) before = _version_one_rows(self.path) + # Building the fixture audited this same file as a current store. That + # record must not shorten any audit of its version-one admission. + self.assertTrue(store_module._audit_recorded(_file_identity(self.path))) opened = _ObservedAdmissionStore(self.path) try: self.assertEqual(opened.admission_events, [ @@ -338,6 +491,18 @@ def test_version_one_keeps_preconfiguration_guarded_and_final_audits(self): opened.close() self.assertEqual(_version_one_rows(self.path), before) + def test_version_one_migration_in_a_new_process_keeps_every_audit(self): + _populated_version_one_store(self.path) + before = _version_one_rows(self.path) + _begin_as_new_process() + self.assertEqual(self.events(), [ + ('integrity', 1, False), ('configure', 1, False), + ('integrity', 1, True), ('integrity', 2, True), ('integrity', 2, False), + ]) + self.assertEqual(_version_one_rows(self.path), before) + # The final destination audit is this process's audit of the migrated file. + self.assertEqual(self.events(), [('configure', 2, False)]) + def test_other_opener_migration_keeps_destination_audit(self): _populated_version_one_store(self.path) before = _version_one_rows(self.path) @@ -404,6 +569,8 @@ def test_current_corruption_is_rejected_before_persistent_configuration(self): else: corruptor.execute('PRAGMA ignore_check_constraints=ON') corruptor.execute("INSERT INTO content_sets VALUES ('bad', 0)") + # The first open by a process is the one that audits. + _begin_as_new_process() self.assert_code(code, lambda: _ObservedAdmissionStore(path)) self.assertTrue(path.is_file()) with closing(sqlite3.connect(path)) as observed: @@ -435,6 +602,248 @@ def _initialize_schema(inner): with self.assertRaises(sqlite3.ProgrammingError): connections[0].execute('SELECT 1') + def test_readmission_runs_the_statements_of_a_later_open(self): + with SnapshotModule.open(self.path, now=lambda: self.now) as initial: + snapshot = initial.create_snapshot(capture()).snapshot + opens = [] + connect = sqlite3.connect + + def traced_connect(database, *arguments, **options): + connection = connect(database, *arguments, **options) + opens.append([]) + connection.set_trace_callback(opens[-1].append) + return connection + + with mock.patch.object(store_module.sqlite3, 'connect', traced_connect): + kept = SnapshotModule.open(self.path, now=lambda: self.now) + self.addCleanup(kept.close) + kept.release() + SnapshotModule.open(self.path, now=lambda: self.now).close() + opened, later = opens + self.assertEqual(opened, later) + self.assertNotIn('PRAGMA integrity_check', later) + for _ in range(2): + self.assertTrue(kept.readmit()) + # A new connection: admission and the maintenance probe, statement for statement. + self.assertEqual(opens[-1], later) + self.assertEqual(kept.load_content(snapshot), capture()) + kept.release() + self.assertEqual(len(opens), 4) + # A process without an audit record audits on readmission, as on open. + _begin_as_new_process() + self.assertTrue(kept.readmit()) + self.assertEqual([statement for statement in opens[-1] if statement not in later], + ['PRAGMA integrity_check', 'PRAGMA foreign_key_check']) + self.assertTrue(store_module._audit_recorded(_file_identity(self.path))) + + def test_released_store_holds_no_connection_and_readmission_opens_a_new_one(self): + module = self.module() + snapshot, head, root = self.seed(module) + uses = ( + lambda: module.load_content(snapshot), + lambda: module.find_snapshots(FindSnapshotsRequest(limit=10)), + lambda: module.inspect_child(ChildHandle(head.aggregate_id, 'requirement', 'one')), + lambda: module.create_snapshot(capture(b'another')), + lambda: self.assert_code('AGGREGATE.UNAVAILABLE', lambda: module.load_aggregate('missing')), + lambda: module.delete_snapshot(snapshot), + lambda: module.undelete_snapshot(snapshot), + ) + seen = [] + for use in uses: + use() + connection = module._store._connection + self.assertFalse(any(connection is earlier for earlier in seen)) + seen.append(connection) + module.release() + self.assert_released(module) + # Releasing a released store does nothing. + module.release() + self.assertTrue(module.readmit()) + # Readmission without a release also replaces the connection. + connection = module._store._connection + self.assertTrue(module.readmit()) + self.assertIsNot(module._store._connection, connection) + with self.assertRaises(sqlite3.ProgrammingError): + connection.execute('SELECT 1') + self.assertEqual(module.load_aggregate_root(root.aggregate_id), root) + # Closing a released store does nothing either. + module.release() + module.close() + self.assert_released(module) + + def test_release_rolls_back_a_transaction_the_use_did_not_end(self): + module = self.module() + module._store._connection.execute('BEGIN IMMEDIATE') + module._store._connection.execute( + 'INSERT INTO purged_root_tombstones VALUES (?, ?)', ('left-open', 1)) + module.release() + observed = self.connection() + self.assertIsNone(observed.execute( + "SELECT 1 FROM purged_root_tombstones WHERE snapshot_id = 'left-open'").fetchone()) + self.assertFalse(self.path.with_name(self.path.name + '-journal').exists()) + self.assertTrue(module.readmit()) + self.assertEqual(module._store.counts()['purged_root_tombstones'], 0) + + def test_readmission_reads_a_file_overwritten_in_place_as_a_new_open_does(self): + # Two stores with the same history but different content. Their change + # counters, page counts and schema cookies are equal, which is all that + # SQLite compares before trusting the pages a connection has read. A + # store that kept its connection would go on answering from the old ones. + first, second = self.path, self.path.with_name('second.sqlite3') + snapshots = {} + for path, content in ((first, b'first lineage'), (second, b'other lineage')): + with SnapshotModule.open(path, now=lambda: self.now) as module: + snapshots[path] = module.create_snapshot(capture(content)).snapshot + self.assertEqual(first.read_bytes()[24:44], second.read_bytes()[24:44]) + self.assertEqual(first.stat().st_size, second.stat().st_size) + kept = SnapshotModule.open(first, now=lambda: self.now) + self.addCleanup(kept.close) + self.assertEqual(kept.load_content(snapshots[first]), capture(b'first lineage')) + kept.release() + identity = _file_identity(first) + shutil.copyfile(second, first) + self.assertEqual(_file_identity(first), identity) + self.assertTrue(kept.readmit()) + # Exactly what a new open of the path reads: nothing of the old content. + self.assert_code('SNAPSHOT.UNAVAILABLE', lambda: kept.load_content(snapshots[first])) + self.assertEqual(kept.load_content(snapshots[second]), capture(b'other lineage')) + + def test_readmission_reports_a_path_that_names_another_file_or_none(self): + def replaced(path): + replacement = path.with_name('replacement.sqlite3') + shutil.copyfile(path, replacement) + os.replace(replacement, path) + + def moved_behind_a_link(path): + target = path.with_name('moved.sqlite3') + os.replace(path, target) + path.symlink_to(target) + + for change, reopened in ((replaced, 'admitted'), (Path.unlink, 'admitted'), + (moved_behind_a_link, 'SNAPSHOT_STORE.UNSUPPORTED_PATH')): + with self.subTest(change=change.__name__), tempfile.TemporaryDirectory() as temporary: + path = Path(temporary) / 'snapshots.sqlite3' + with SnapshotModule.open(path, now=lambda: self.now) as kept: + kept.create_snapshot(capture()) + kept.release() + self.assertTrue(kept.readmit()) + kept.release() + opened = _file_identity(path) + self.assertTrue(store_module._audit_recorded(opened)) + change(path) + # Nothing is opened: what is at the path now is for a new open to decide. + connect = sqlite3.connect + with mock.patch.object(store_module.sqlite3, 'connect', wraps=connect) as connections: + self.assertFalse(kept.readmit()) + self.assertFalse(kept.readmit()) + connections.assert_not_called() + # A file that is given the opened file's inode number later + # has no audit record. + self.assertFalse(store_module._audit_recorded(opened)) + # The owner's new open is what admits, creates or refuses the path. + if reopened == 'admitted': + SnapshotModule.open(path, now=lambda: self.now).close() + else: + self.assert_code(reopened, lambda: SnapshotModule.open(path)) + + def assert_released(self, module): + with self.assertRaises(sqlite3.ProgrammingError): + module._store._connection.execute('SELECT 1') + # An exclusive transaction needs every other connection to hold no lock. + with closing(sqlite3.connect(module._store.path, isolation_level=None, timeout=0)) as other: + other.execute('BEGIN EXCLUSIVE') + other.execute('ROLLBACK') + + def test_readmission_keeps_application_version_and_schema_checks(self): + for change, code in ( + ('PRAGMA application_id=1', 'SNAPSHOT_STORE.INVALID_APPLICATION'), + ('PRAGMA user_version=3', 'SNAPSHOT_STORE.UNSUPPORTED_VERSION'), + ('PRAGMA user_version=0', 'SNAPSHOT_STORE.INVALID_VERSION'), + ('CREATE TABLE unexpected (value TEXT)', 'SNAPSHOT_STORE.INVALID_SCHEMA'), + ('DROP TRIGGER child_index_no_update', 'SNAPSHOT_STORE.INVALID_SCHEMA'), + ): + with self.subTest(change=change), tempfile.TemporaryDirectory() as temporary: + path = Path(temporary) / 'snapshots.sqlite3' + with SnapshotModule.open(path, now=lambda: self.now) as kept: + kept.release() + self.assertTrue(kept.readmit()) + kept.release() + with closing(sqlite3.connect(path, isolation_level=None)) as changer: + changer.execute(change) + # The code a new open of this file reports. + self.assert_code(code, kept.readmit) + self.assert_code(code, lambda: SQLiteSnapshotStore(path)) + # A refused readmission leaves no connection behind. + self.assert_released(kept) + + def test_readmission_restores_the_required_profile_as_an_open_does(self): + kept = self.module() + kept.release() + with closing(sqlite3.connect(self.path, isolation_level=None)) as changer: + self.assertEqual(changer.execute('PRAGMA journal_mode=WAL').fetchone(), ('wal',)) + self.assertTrue(kept.readmit()) + with closing(sqlite3.connect(self.path)) as observed: + self.assertEqual(observed.execute('PRAGMA journal_mode').fetchone(), ('delete',)) + kept.create_snapshot(capture()) + self.assertFalse(self.path.with_name(self.path.name + '-wal').exists()) + + def test_readmission_migrates_a_version_one_file_with_every_audit(self): + _, record = _populated_version_one_store(self.path) + kept = _ObservedAdmissionStore(self.path) + self.addCleanup(kept.close) + self.assertEqual(kept.load_aggregate(record.aggregate_id), record) + kept.release() + # Another process returns the same file to version one between uses. + _downgrade_to_version_one(self.path) + before = _version_one_rows(self.path) + del kept.admission_events[:] + self.assertTrue(kept.readmit()) + self.assertEqual(kept.admission_events, [ + ('integrity', 1, False), ('configure', 1, False), + ('integrity', 1, True), ('integrity', 2, True), ('integrity', 2, False), + ]) + self.assertEqual(_version_one_rows(self.path), before) + self.assertEqual(kept.load_aggregate(record.aggregate_id), record) + kept.release() + del kept.admission_events[:] + self.assertTrue(kept.readmit()) + self.assertEqual(kept.admission_events, [('configure', 2, False)]) + + def test_readmission_audits_and_rejects_a_file_without_an_audit_record(self): + kept = SQLiteSnapshotStore(self.path) + self.addCleanup(kept.close) + kept.release() + _violate_foreign_key(self.path) + # The record of this process's audit stands: damage after it is not looked for. + self.assertTrue(kept.readmit()) + kept.release() + _begin_as_new_process() + self.assert_code('SNAPSHOT_STORE.FOREIGN_KEY_FAILURE', kept.readmit) + self.assertFalse(store_module._audit_recorded(_file_identity(self.path))) + # A refused readmission leaves no connection behind. + with self.assertRaises(sqlite3.ProgrammingError): + kept._connection.execute('SELECT 1') + + def test_readmission_runs_due_maintenance_and_keeps_its_busy_failure(self): + module = self.module() + snapshot, head, root = self.seed(module) + module.delete_snapshot(snapshot) + module.release() + self.now += 10 + writer = self.connection() + writer.execute('BEGIN IMMEDIATE') + try: + self.assert_code('SNAPSHOT_STORE.BUSY', module.readmit) + # The failed readmission left no connection behind. + with self.assertRaises(sqlite3.ProgrammingError): + module._store._connection.execute('SELECT 1') + self.assertIsNotNone(writer.execute( + 'SELECT 1 FROM snapshot_roots WHERE snapshot_id = ?', (str(snapshot),)).fetchone()) + finally: + writer.execute('ROLLBACK') + self.assertTrue(module.readmit()) + self.assert_code('SNAPSHOT.EXPIRED', lambda: module.snapshot(snapshot)) + self.assert_code('AGGREGATE.UNAVAILABLE', lambda: module.load_aggregate(head.aggregate_id)) if __name__ == '__main__': unittest.main() diff --git a/tools/standards_verifier/README.md b/tools/standards_verifier/README.md index 5329b37d..e8acf42a 100644 --- a/tools/standards_verifier/README.md +++ b/tools/standards_verifier/README.md @@ -7,18 +7,26 @@ inputs. Python dependencies come from ```bash printf '%s\n' '{"kind":"verify-repository","refresh_verification_inputs":false}' | - PYTHONPATH=. python3 -P .agents/skills/standards-engine/scripts/invoke.py verify_repository + PYTHONPATH=. python3 -P .agents/skills/standards-engine/scripts/invoke.py \ + --purpose authoring verify_repository ``` Inspect `verification.passed` and its diagnostics. Set `refresh_verification_inputs` to `true` after changing declared inputs. The Engine owns that generated update. Neither operation certifies policy completeness. +The checkpoint fails with `SUITE_INPUT.STALE_MANIFEST` when +`evaluation/standards-effectiveness/generated/suite-inputs.json` is not exactly +what the current inputs compile to. The manifest pins every declared input and +the list of tracked files, which is read from the Git index. Adding, removing or +renaming any tracked file therefore needs a refresh: stage the change, then run +the command above with `refresh_verification_inputs` set to `true`. + ## What the checkpoint checks | Check kind | Actual observation | | --- | --- | -| `metadata_graph` | Metadata acceptance or rejection for a corpus or fixture | +| `metadata_graph` | Metadata acceptance for every canonical module, or expected acceptance and rejection for fixtures | | `metadata_route` | Routing results for declared task facts | | `markdown_targets` | Required navigation destinations, independent of link wording | | `markdown_links` | Declared links and destinations | @@ -28,6 +36,19 @@ owns that generated update. Neither operation certifies policy completeness. | `contract_projection` | Generated Interface agrees with canonical contract | | `python_package_contract` | Declared Python package boundaries | +A `metadata_graph` check with `corpus` names the canonical corpus manifest and +validates every module that manifest declares. The `canonical-corpus-metadata` +suite holds the one such check, so a new module is covered when the manifest +gains it, without a suite edit. + +A `metadata_route` check sends each scenario row through the Router projection. +A fact column is named by its Router fact ID and holds a comma-separated value +list, `none`, or `unknown`; a fact without a column does not apply to the +scenario. The check compares what the Router selects with each expected-selection +column, and compares the selected modules and their `Requires` closure with the +route table. A table with no scenario fails. A routing or `Requires` change that +alters a scenario's outcome needs its tables updated in the same change. + The complete checkpoint evaluates all registered declarative suites in dependency order. It does **not** execute the Python unit-test suites, assess prose quality, or prove that downstream code follows a standard. The graph cannot discover @@ -42,6 +63,13 @@ PYTHONPATH=.:tools/standards_verifier python3 -m unittest discover -s tools/stan PYTHONPATH=. python3 -m unittest discover -s tools/standards_engine/tests ``` +The Engine suite is long. This runs the same tests with one unittest process per test +module across all cores (`--jobs N` limits them) and fails if any test goes missing: + +```bash +PYTHONPATH=. python3 -m tools.standards_engine.tests.parallel_unittest --durations 10 +``` + These tests exercise execution, navigation, authoring, publication, and failure handling. Use the locked environment for both commands. The low-level diagnostic CLI remains `tools/standards_verifier/verify.py` with `--complete`, `--suite`, diff --git a/tools/standards_verifier/standards_verifier/checks/metadata.py b/tools/standards_verifier/standards_verifier/checks/metadata.py index 1e120f3e..f3b9da01 100644 --- a/tools/standards_verifier/standards_verifier/checks/metadata.py +++ b/tools/standards_verifier/standards_verifier/checks/metadata.py @@ -4,7 +4,10 @@ from typing import Any from tools.standards_metadata.standards_metadata import ( + ContentSourceInput, + MetadataError, MetadataFailure, + canonical_module_corpus_members, validate_module_metadata, ) @@ -21,19 +24,41 @@ class MetadataCase: @dataclass(frozen=True, slots=True) class MetadataGraphCheck: + """Validate module metadata for one of three explicit selections. + + ``corpus`` names a canonical corpus manifest and validates every member it + declares, so a module added to the corpus is covered without editing the + suite. ``paths`` validates one listed set. ``cases`` compares listed sets + with the diagnostics each is expected to produce. + """ + id: str paths: tuple[str, ...] | None cases: tuple[MetadataCase, ...] | None + corpus: str | None = None def authority_inputs( self, context: CheckInputContext ) -> tuple[CheckAuthorityInput, ...]: + if self.corpus is not None: + members = _corpus_members( + context.inputs, self.corpus, context.suite_id, self.id + ) + return ( + *present_inputs("canonical-module-corpus", self.corpus), + *present_inputs("metadata", *members), + ) paths = self.paths or tuple( path for case in self.cases or () for path in case.paths ) return present_inputs("metadata", *paths) def run(self, context: CheckContext) -> list[Diagnostic]: + if self.corpus is not None: + members = _corpus_members( + context.repo_root, self.corpus, context.suite_id, self.id + ) + return _validate_graph(context, self.id, members) if self.paths is not None: return _validate_graph(context, self.id, self.paths) @@ -78,6 +103,31 @@ def _diagnostic( ) +def _corpus_members( + source: ContentSourceInput, + corpus: str, + suite: str, + check: str, +) -> tuple[str, ...]: + try: + return canonical_module_corpus_members(source, corpus) + except MetadataError as error: + failure = error.failure + raise EngineError( + Diagnostic( + failure.code, + failure.outcome, + failure.message, + suite=suite, + check=check, + path=failure.path, + field=failure.field, + expected=failure.expected, + observed=failure.observed, + ) + ) from error + + def _validate_graph( context: CheckContext, check: str, @@ -120,7 +170,7 @@ def parse_metadata_graph_check( raw: dict[str, Any], suite_id: str, ) -> MetadataGraphCheck: - allowed = {"id", "type", "paths", "cases"} + allowed = {"id", "type", "paths", "cases", "corpus"} unknown = set(raw) - allowed if unknown: raise EngineError( @@ -144,16 +194,31 @@ def parse_metadata_graph_check( ) has_paths = "paths" in raw has_cases = "cases" in raw - if has_paths == has_cases: + has_corpus = "corpus" in raw + if has_paths + has_cases + has_corpus != 1: raise EngineError( Diagnostic( "CONFIG.METADATA_MODE", "invalid", - "metadata graph requires exactly one of paths or cases", + "metadata graph requires exactly one of corpus, paths, or cases", suite=suite_id, check=check_id, ) ) + if has_corpus: + corpus = raw["corpus"] + if not isinstance(corpus, str) or not corpus: + raise EngineError( + Diagnostic( + "CONFIG.METADATA_CORPUS", + "invalid", + "corpus must name a canonical corpus manifest path", + suite=suite_id, + check=check_id, + field="corpus", + ) + ) + return MetadataGraphCheck(check_id, None, None, corpus) if has_paths: return MetadataGraphCheck( check_id, diff --git a/tools/standards_verifier/standards_verifier/checks/metadata_route.py b/tools/standards_verifier/standards_verifier/checks/metadata_route.py index 01a5d117..e1129ffe 100644 --- a/tools/standards_verifier/standards_verifier/checks/metadata_route.py +++ b/tools/standards_verifier/standards_verifier/checks/metadata_route.py @@ -1,14 +1,32 @@ +"""Route declared task scenarios through the Router and compare the outcome. + +Each scenario row states task facts in the Router's own vocabulary. The check +binds them, asks the Router projection what it selects, and compares that with +the row's expected selections and with the reviewed route table. Nothing in a +row is compared with another column of the same table. +""" from __future__ import annotations from dataclasses import dataclass from typing import Any +from tools.standards_analysis.standards_analysis import ( + ROUTER_PROJECTION, + AnalysisError, + RouteDecision, + RouterProjection, + load_router_projection, +) +from tools.standards_applicability.standards_applicability import ( + ApplicabilityError, + FactSet, +) from tools.standards_metadata.standards_metadata import ( MetadataError, load_canonical_module_corpus, ) -from ..diagnostics import Diagnostic, EngineError +from ..diagnostics import OUTCOMES, Diagnostic, EngineError from tools.standards_graph.standards_graph import ( METADATA_REQUIRES, metadata_dependency_registry, @@ -18,6 +36,11 @@ EXPECTATIONS_HEADER = ("case", "direct_modules", "requires_closure") +CASE_COLUMN = "case" +# A fact cell is a comma-separated value list or one of these two words. +NO_VALUES = "none" +UNKNOWN_VALUE = "unknown" +SET_FACT_TYPES = frozenset({"enum-set", "string-set"}) @dataclass(frozen=True, slots=True) @@ -33,11 +56,11 @@ class MetadataRouteCheck: id: str path: str header: tuple[str, ...] + facts: tuple[str, ...] expectations_path: str route_column: str resolved: str unresolved: str - base_modules: tuple[str, ...] selections: tuple[RouteSelection, ...] def authority_inputs( @@ -47,6 +70,7 @@ def authority_inputs( return ( *present_inputs("routing-cases", self.path), *present_inputs("routing-expectations", self.expectations_path), + *present_inputs("router-projection", ROUTER_PROJECTION), *present_inputs("canonical-module-corpus", corpus.path), *present_inputs("canonical-module", *corpus.members), ) @@ -59,6 +83,17 @@ def run(self, context: CheckContext) -> list[Diagnostic]: suite=context.suite_id, check=self.id, ) + if not rows: + raise EngineError( + Diagnostic( + "ROUTING.NO_SCENARIOS", + "invalid", + "routing decision table declares no scenario", + suite=context.suite_id, + check=self.id, + path=self.path, + ) + ) expectations = read_table_rows( context.repo_root, self.expectations_path, @@ -68,7 +103,7 @@ def run(self, context: CheckContext) -> list[Diagnostic]: ) indexed = self._expectations(context, expectations) diagnostics: list[Diagnostic] = [] - cases = [row["case"] for row in rows] + cases = [row[CASE_COLUMN] for row in rows] if len(set(cases)) != len(cases): raise EngineError( Diagnostic( @@ -94,56 +129,19 @@ def run(self, context: CheckContext) -> list[Diagnostic]: try: corpus = load_canonical_module_corpus(context.repo_root) - except MetadataError as error: - failure = error.failure - raise EngineError( - Diagnostic( - failure.code, - failure.outcome, - failure.message, - suite=context.suite_id, - check=self.id, - path=failure.path, - row=failure.row, - field=failure.field, - expected=failure.expected, - observed=failure.observed, - ) - ) from error - known_modules = {module.module_id for module in corpus.modules} + router = load_router_projection(context.repo_root, corpus) + except (MetadataError, AnalysisError) as error: + raise self._authority_error(context, error.failure) from error + self._require_router_vocabulary(context, router) graph = metadata_dependency_registry(context.repo_root, corpus.modules) for row_number, row in enumerate(rows, start=2): - case = row["case"] - expected_direct, expected_closure = indexed[case] - route = row[self.route_column] - if route == self.unresolved: - selected_values = {row[item.column] for item in self.selections} - if selected_values != {self.unresolved}: - diagnostics.append( - self._diagnostic( - context, - "ASSERT.ROUTING_UNRESOLVED_SELECTION", - "an unresolved route cannot contain resolved topic selections", - row=row_number, - field=case, - observed=",".join(sorted(selected_values)), - ) - ) - if (expected_direct, expected_closure) != ( - (self.unresolved,), - (self.unresolved,), - ): - diagnostics.append( - self._diagnostic( - context, - "ASSERT.ROUTING_UNRESOLVED_EXPECTATION", - "an unresolved route must use unresolved expectations", - row=row_number, - field=case, - ) - ) - continue - if route != self.resolved: + case = row[CASE_COLUMN] + decision = router.decide(self._bind(context, router, row, row_number)) + observed_route = ( + self.unresolved if decision.unresolved_facts else self.resolved + ) + expected_route = row[self.route_column] + if expected_route not in {self.resolved, self.unresolved}: diagnostics.append( self._diagnostic( context, @@ -151,46 +149,44 @@ def run(self, context: CheckContext) -> list[Diagnostic]: "route state is neither resolved nor unresolved", row=row_number, field=self.route_column, - observed=route, + observed=expected_route, ) ) continue - - direct = set(self.base_modules) - invalid_selection = False - for selection in self.selections: - value = row[selection.column] - if value == selection.selected: - direct.add(selection.module) - elif value != selection.excluded: - diagnostics.append( - self._diagnostic( - context, - "ASSERT.ROUTING_INCOMPLETE", - "a resolved route contains an unresolved or unknown selection", - row=row_number, - field=selection.column, - observed=value, - ) - ) - invalid_selection = True - if invalid_selection: - continue - unknown = direct - known_modules - if unknown: + diagnostics.extend( + self._selection_diagnostics(context, decision, row, row_number) + ) + if observed_route != expected_route: diagnostics.append( self._diagnostic( context, - "ASSERT.ROUTING_UNKNOWN_MODULE", - "selected route module is not canonical", + "ASSERT.ROUTING_RESOLUTION", + "the Router's resolution does not match the scenario", row=row_number, field=case, - observed=sorted(unknown)[0], + expected=expected_route, + observed=",".join((observed_route, *decision.unresolved_facts)), ) ) continue - observed_direct = tuple(sorted(direct)) + expected_direct, expected_closure = indexed[case] + if observed_route == self.unresolved: + if (expected_direct, expected_closure) != ( + (self.unresolved,), + (self.unresolved,), + ): + diagnostics.append( + self._diagnostic( + context, + "ASSERT.ROUTING_UNRESOLVED_EXPECTATION", + "an unresolved route must use unresolved expectations", + row=row_number, + field=case, + ) + ) + continue + observed_direct = tuple(sorted(decision.selected)) observed_closure = graph.dependency_order( METADATA_REQUIRES, selected=observed_direct, @@ -200,7 +196,7 @@ def run(self, context: CheckContext) -> list[Diagnostic]: self._diagnostic( context, "ASSERT.ROUTING_DIRECT_MODULES", - "direct route modules do not match reviewed expectations", + "modules the Router selects do not match reviewed expectations", row=row_number, field=case, expected=",".join(expected_direct), @@ -221,6 +217,165 @@ def run(self, context: CheckContext) -> list[Diagnostic]: ) return diagnostics + def _require_router_vocabulary( + self, context: CheckContext, router: RouterProjection + ) -> None: + """Reject a table written in names the Router does not declare.""" + for fact_id in self.facts: + definition = router.fact_schema.resolve(fact_id) + if definition is None or definition.id != fact_id: + raise self._vocabulary_error( + context, + "ROUTING.UNKNOWN_FACT", + "invalid", + "scenario column is not a fact the Router declares", + fact_id, + ) + if definition.type not in SET_FACT_TYPES: + raise self._vocabulary_error( + context, + "ROUTING.FACT_TYPE", + "unsupported", + "scenario columns support set-valued Router facts only", + fact_id, + ) + if {NO_VALUES, UNKNOWN_VALUE} & set(definition.values): + raise self._vocabulary_error( + context, + "ROUTING.FACT_TOKEN_COLLISION", + "unsupported", + "a Router fact value collides with a scenario cell keyword", + fact_id, + ) + routable = {*router.base_modules, *(rule.target for rule in router.rules)} + for selection in self.selections: + if selection.module not in routable: + raise self._vocabulary_error( + context, + "ROUTING.UNROUTED_MODULE", + "invalid", + "expected selection names a module the Router never selects", + selection.module, + ) + + def _bind( + self, + context: CheckContext, + router: RouterProjection, + row: dict[str, str], + row_number: int, + ) -> FactSet: + """Bind one scenario; a fact without a column does not apply to it.""" + values: dict[str, object] = {} + for definition in router.facts: + if definition.id not in self.facts: + values[definition.id] = {"type": definition.type, "state": "known-absent"} + continue + cell = row[definition.id] + if cell == UNKNOWN_VALUE: + values[definition.id] = {"type": definition.type, "state": "unknown"} + else: + values[definition.id] = { + "type": definition.type, + "state": "known", + "value": [] if cell == NO_VALUES else cell.split(","), + } + try: + return router.fact_schema.bind(values) + except ApplicabilityError as error: + failure = error.failure + raise EngineError( + Diagnostic( + "ROUTING.FACT_VALUE", + "invalid", + f"scenario fact cell is not a Router value: {failure.message}", + suite=context.suite_id, + check=self.id, + path=self.path, + row=row_number, + field=failure.field, + observed=row.get(failure.field or "", failure.observed), + ) + ) from error + + def _selection_diagnostics( + self, + context: CheckContext, + decision: RouteDecision, + row: dict[str, str], + row_number: int, + ) -> list[Diagnostic]: + diagnostics = [] + unresolved_targets = set(decision.unresolved_targets) + for selection in self.selections: + expected = row[selection.column] + if selection.module in decision.selected: + observed = selection.selected + elif selection.module in unresolved_targets: + observed = self.unresolved + else: + observed = selection.excluded + if expected not in {selection.selected, selection.excluded, self.unresolved}: + diagnostics.append( + self._diagnostic( + context, + "ASSERT.ROUTING_SELECTION_VALUE", + "expected selection is not a declared selection value", + row=row_number, + field=selection.column, + observed=expected, + ) + ) + elif expected != observed: + diagnostics.append( + self._diagnostic( + context, + "ASSERT.ROUTING_SELECTION", + "the Router's selection does not match the scenario", + row=row_number, + field=f"{row[CASE_COLUMN]}.{selection.column}", + expected=expected, + observed=observed, + ) + ) + return diagnostics + + def _vocabulary_error( + self, + context: CheckContext, + code: str, + outcome: str, + message: str, + observed: str, + ) -> EngineError: + return EngineError( + Diagnostic( + code, + outcome, + message, + suite=context.suite_id, + check=self.id, + path=self.path, + observed=observed, + ) + ) + + def _authority_error(self, context: CheckContext, failure: Any) -> EngineError: + return EngineError( + Diagnostic( + failure.code, + failure.outcome if failure.outcome in OUTCOMES else "invalid", + failure.message, + suite=context.suite_id, + check=self.id, + path=failure.path, + row=getattr(failure, "row", None), + field=failure.field, + expected=getattr(failure, "expected", None), + observed=failure.observed, + ) + ) + def _expectations( self, context: CheckContext, @@ -323,11 +478,11 @@ def parse_metadata_route_check(raw: dict[str, Any], suite: str) -> MetadataRoute "type", "path", "header", + "facts", "expectations_path", "route_column", "resolved", "unresolved", - "base_modules", "selections", } unknown = set(raw) - allowed @@ -373,17 +528,7 @@ def parse_metadata_route_check(raw: dict[str, Any], suite: str) -> MetadataRoute ) strings[field] = value header = _strings(raw.get("header"), "header", suite, check) - if "case" not in header or strings["route_column"] not in header: - raise EngineError( - Diagnostic( - "CONFIG.ROUTING_HEADER", - "invalid", - "routing header must contain case and route columns", - suite=suite, - check=check, - ) - ) - base_modules = _strings(raw.get("base_modules"), "base_modules", suite, check) + facts = _strings(raw.get("facts"), "facts", suite, check) raw_selections = raw.get("selections") if not isinstance(raw_selections, list) or not raw_selections: raise EngineError( @@ -422,17 +567,6 @@ def parse_metadata_route_check(raw: dict[str, Any], suite: str) -> MetadataRoute check=check, ) ) - if item["column"] not in header: - raise EngineError( - Diagnostic( - "CONFIG.ROUTING_HEADER", - "invalid", - "routing selection column is absent from the header", - suite=suite, - check=check, - field=item["column"], - ) - ) selections.append( RouteSelection( item["column"], @@ -441,24 +575,44 @@ def parse_metadata_route_check(raw: dict[str, Any], suite: str) -> MetadataRoute item["module"], ) ) - if len({item.column for item in selections}) != len(selections): + # Every column has exactly one role, so no column can go unread. + roles = ( + CASE_COLUMN, + *facts, + *(item.column for item in selections), + strings["route_column"], + ) + if len(set(roles)) != len(roles): raise EngineError( Diagnostic( "CONFIG.ROUTING_SELECTIONS", "invalid", - "routing selection columns must be unique", + "case, fact, selection, and route columns must be distinct", + suite=suite, + check=check, + ) + ) + if set(roles) != set(header): + stray = sorted(set(header) ^ set(roles))[0] + raise EngineError( + Diagnostic( + "CONFIG.ROUTING_HEADER", + "invalid", + "routing header must be exactly case, the fact columns, the " + "selection columns, and the route column", suite=suite, check=check, + field=stray, ) ) return MetadataRouteCheck( check, strings["path"], header, + facts, strings["expectations_path"], strings["route_column"], strings["resolved"], strings["unresolved"], - base_modules, tuple(selections), ) diff --git a/tools/standards_verifier/standards_verifier/cli.py b/tools/standards_verifier/standards_verifier/cli.py index 0fdc2265..b120a38a 100644 --- a/tools/standards_verifier/standards_verifier/cli.py +++ b/tools/standards_verifier/standards_verifier/cli.py @@ -5,9 +5,10 @@ from pathlib import Path from typing import Sequence -from .diagnostics import Diagnostic, EngineError +from .diagnostics import EXIT_CODE_BY_OUTCOME, Diagnostic, EngineError from .engine import Verifier from .model import CompleteVerificationResult, SuiteResult +from .suite_inputs import DEFAULT_REGISTRY, suite_input_projection_diagnostic def _parser(default_repo_root: Path) -> argparse.ArgumentParser: @@ -15,7 +16,7 @@ def _parser(default_repo_root: Path) -> argparse.ArgumentParser: parser.add_argument("--repo-root", type=Path, default=default_repo_root) parser.add_argument( "--registry", - default="evaluation/standards-effectiveness/suite-registry.toml", + default=DEFAULT_REGISTRY, help="repository-relative suite registry path", ) selection = parser.add_mutually_exclusive_group() @@ -24,7 +25,8 @@ def _parser(default_repo_root: Path) -> argparse.ArgumentParser: parser.add_argument( "--complete", action="store_true", - help="run the complete registered Python suite catalog", + help="run the complete registered Python suite catalog and require a " + "current suite-input manifest", ) parser.add_argument("--list", action="store_true", help="list registered suite IDs") parser.add_argument("--format", choices=("text", "json"), default="text") @@ -46,9 +48,10 @@ def _render_text(results: list[SuiteResult]) -> str: return "\n".join(lines) -def _render_json(results: list[SuiteResult]) -> str: +def _render_json(results: list[SuiteResult], error: Diagnostic | None = None) -> str: return json.dumps( { + **({} if error is None else {"error": error.as_dict()}), "results": [result.as_dict() for result in results], "summary": { "selected": len(results), @@ -70,14 +73,25 @@ def _render_error(diagnostic: Diagnostic, output_format: str) -> str: def run_complete_verification( repo_root: Path, - registry: str = "evaluation/standards-effectiveness/suite-registry.toml", + registry: str = DEFAULT_REGISTRY, ) -> CompleteVerificationResult: + """Run every registered suite, then require the manifest that pins them.""" try: results = tuple(Verifier(repo_root, registry).run(None)) - suite_exit = max((result.exit_code for result in results), default=0) - return CompleteVerificationResult(results, None, suite_exit) except EngineError as error: return CompleteVerificationResult((), error.diagnostic, error.exit_code) + suite_exit = max((result.exit_code for result in results), default=0) + # The manifest pins the canonical registry; another registry has none. + manifest = ( + suite_input_projection_diagnostic(repo_root) + if registry == DEFAULT_REGISTRY + else None + ) + if manifest is None: + return CompleteVerificationResult(results, None, suite_exit) + return CompleteVerificationResult( + results, manifest, max(suite_exit, EXIT_CODE_BY_OUTCOME[manifest.outcome]) + ) def main(argv: Sequence[str] | None = None, *, default_repo_root: Path) -> int: @@ -96,8 +110,8 @@ def main(argv: Sequence[str] | None = None, *, default_repo_root: Path) -> int: if args.format == "json": print( _render_error(complete.diagnostic, args.format) - if complete.diagnostic is not None - else _render_json(list(complete.results)) + if complete.diagnostic is not None and not complete.results + else _render_json(list(complete.results), complete.diagnostic) ) else: if complete.results: diff --git a/tools/standards_verifier/standards_verifier/suite_inputs.py b/tools/standards_verifier/standards_verifier/suite_inputs.py index f1115e74..ba4f70e4 100644 --- a/tools/standards_verifier/standards_verifier/suite_inputs.py +++ b/tools/standards_verifier/standards_verifier/suite_inputs.py @@ -4,6 +4,7 @@ from pathlib import Path from typing import Sequence +from tools.repository_git.repository_git import GitRepositoryError from tools.standards_identity.standards_identity import ( IdentityArray, IdentityObject, @@ -11,6 +12,7 @@ ) from tools.standards_metadata.standards_metadata import ( FrozenContentSource, + MetadataError, SUITE_INPUT_CONTRACT, SUITE_INPUT_SCHEMA_VERSION, RepositoryIndexObservation, @@ -32,6 +34,13 @@ DEFAULT_PROJECTION = "evaluation/standards-effectiveness/generated/suite-inputs.json" CONTRACT = SUITE_INPUT_CONTRACT SCHEMA_VERSION = SUITE_INPUT_SCHEMA_VERSION +# The Engine owns the generated manifest; this is its refresh operation. +REFRESH_COMMAND = ( + "printf '%s\\n' '{\"kind\":\"verify-repository\"," + "\"refresh_verification_inputs\":true}' | PYTHONPATH=. python3 -P " + ".agents/skills/standards-engine/scripts/invoke.py --purpose authoring " + "verify_repository" +) def repository_index_digest(paths: Sequence[str]) -> str: @@ -183,6 +192,37 @@ def check_suite_input_projection( return 0 +def suite_input_projection_diagnostic(root: Path) -> Diagnostic | None: + """Explain why the committed manifest is not exact, or return ``None``. + + The comparison is byte-exact against a fresh compilation, so it also + notices a changed repository file list, which per-file digests do not. + """ + try: + expected = suite_input_projection_bytes(root) + except EngineError as error: + return error.diagnostic + except (GitRepositoryError, MetadataError) as error: + return Diagnostic( + "SUITE_INPUT.MANIFEST_UNAVAILABLE", + "unavailable", + f"suite-input manifest could not be recompiled: {error}", + path=DEFAULT_PROJECTION, + ) + path = root / DEFAULT_PROJECTION + if path.is_file() and path.read_bytes() == expected: + return None + return Diagnostic( + "SUITE_INPUT.STALE_MANIFEST", + "invalid", + "the suite-input manifest does not match the verification inputs or " + "the repository file list. The file list is read from the Git index, " + "so stage added and removed files, then regenerate the manifest with: " + f"{REFRESH_COMMAND}", + path=DEFAULT_PROJECTION, + ) + + def write_suite_input_projection(root: Path) -> int: path = root / DEFAULT_PROJECTION path.parent.mkdir(parents=True, exist_ok=True) diff --git a/tools/standards_verifier/tests/test_metadata.py b/tools/standards_verifier/tests/test_metadata.py index d20ee084..f42b45db 100644 --- a/tools/standards_verifier/tests/test_metadata.py +++ b/tools/standards_verifier/tests/test_metadata.py @@ -11,10 +11,15 @@ ENGINE_ROOT = Path(__file__).resolve().parents[1] sys.path.insert(0, str(ENGINE_ROOT)) -from tools.standards_metadata.standards_metadata import load_module_metadata +from tools.standards_metadata.standards_metadata import ( + CANONICAL_MODULE_CORPUS, + load_module_metadata, +) +from standards_verifier.config import extend_catalog, load_registry_catalog from standards_verifier.diagnostics import EngineError from standards_verifier.engine import Verifier +from standards_verifier.suite_inputs import compile_suite_input_projection from tools.standards_graph.standards_graph import ( METADATA_DEPENDENCIES, metadata_dependency_registry, @@ -430,6 +435,144 @@ def test_config_requires_exactly_one_mode(self) -> None: with self.assertRaisesRegex(EngineError, "exactly one"): Verifier(self.root, "registry.toml").run() + def write_corpus_suite(self, members: tuple[str, ...], extra: str = "") -> None: + encoded = ", ".join(json.dumps(member) for member in members) + self.write("corpus.toml", f"schema_version = 1\nmembers = [{encoded}]\n") + self.write( + "suite.toml", + f""" + schema_version = 1 + id = "metadata" + owner = "metadata.schema" + description = "Whole corpus metadata" + + [[checks]] + id = "corpus" + type = "metadata_graph" + corpus = "corpus.toml" + {extra} + """, + ) + self.write_registry() + + def corpus_result(self): + return Verifier(self.root, "registry.toml").run(("metadata",))[0] + + def test_corpus_mode_validates_every_declared_member(self) -> None: + self.write_module("core.md", module_id="core", role="core") + self.write_module("workflow.md", module_id="workflow.test", requires=("core",)) + self.write_corpus_suite(("core.md", "workflow.md")) + + result = self.corpus_result() + + self.assertEqual((result.status, result.check_count), ("passed", 1)) + + def test_corpus_mode_covers_a_new_member_without_a_suite_edit(self) -> None: + self.write_module("core.md", module_id="core", role="core") + self.write_corpus_suite(("core.md",)) + suite = (self.root / "suite.toml").read_bytes() + self.assertEqual(self.corpus_result().status, "passed") + + self.write_module("added.md", module_id="added", raw={"Level": "`MANDATORY`"}) + self.write("corpus.toml", 'schema_version = 1\nmembers = ["core.md", "added.md"]\n') + + result = self.corpus_result() + + self.assertEqual((self.root / "suite.toml").read_bytes(), suite) + self.assertEqual(result.status, "failed") + self.assertEqual( + [(item.code, item.path) for item in result.diagnostics], + [("METADATA.LEVEL", "added.md")], + ) + + def test_corpus_mode_reports_every_member_failure(self) -> None: + self.write_module("core.md", module_id="core", role="core") + self.write_module("level.md", module_id="level", raw={"Level": "`MANDATORY`"}) + self.write_module("owner.md", module_id="owner", owner="elsewhere.md") + self.write_corpus_suite(("core.md", "level.md", "owner.md")) + + self.assertEqual( + sorted((item.code, item.path) for item in self.corpus_result().diagnostics), + [("METADATA.CANONICAL_OWNER", "owner.md"), ("METADATA.LEVEL", "level.md")], + ) + + def test_corpus_mode_rejects_a_relation_that_leaves_the_corpus(self) -> None: + self.write_module("core.md", module_id="core", role="core") + self.write_module("workflow.md", module_id="workflow.test", requires=("absent",)) + self.write_corpus_suite(("core.md", "workflow.md")) + + self.assertEqual( + [(item.code, item.path, item.observed) for item in self.corpus_result().diagnostics], + [("METADATA.UNRESOLVED_TARGET", "workflow.md", "absent")], + ) + + def test_corpus_mode_rejects_an_unreadable_or_empty_manifest(self) -> None: + self.write_module("core.md", module_id="core", role="core") + self.write_corpus_suite(("core.md",)) + self.write("corpus.toml", "schema_version = 1\nmembers = []\n") + self.assertEqual( + [item.code for item in self.corpus_result().diagnostics], + ["CONFIG.CANONICAL_CORPUS_MEMBERS"], + ) + + (self.root / "corpus.toml").unlink() + self.assertEqual( + [item.code for item in self.corpus_result().diagnostics], + ["INPUT.UNAVAILABLE"], + ) + + def test_corpus_mode_declares_the_manifest_and_every_member_as_inputs(self) -> None: + self.write_module("core.md", module_id="core", role="core") + self.write_module("workflow.md", module_id="workflow.test", requires=("core",)) + self.write_corpus_suite(("core.md", "workflow.md")) + + projection = compile_suite_input_projection(self.root, "registry.toml") + + self.assertEqual( + { + item["path"]: [use["role"] for use in item["uses"]] + for item in projection["files"] + }, + { + "core.md": ["metadata"], + "corpus.toml": ["canonical-module-corpus"], + "workflow.md": ["metadata"], + }, + ) + + def test_corpus_mode_excludes_the_other_modes_and_requires_a_path(self) -> None: + self.write_module("core.md", module_id="core", role="core") + self.write_corpus_suite(("core.md",), extra='paths = ["core.md"]') + with self.assertRaisesRegex(EngineError, "exactly one"): + Verifier(self.root, "registry.toml").run() + + self.write( + "suite.toml", + (self.root / "suite.toml") + .read_text(encoding="utf-8") + .replace('corpus = "corpus.toml"', 'corpus = ""') + .replace('paths = ["core.md"]', ""), + ) + with self.assertRaises(EngineError) as caught: + Verifier(self.root, "registry.toml").run() + self.assertEqual(caught.exception.diagnostic.code, "CONFIG.METADATA_CORPUS") + + def test_repository_asserts_the_whole_canonical_corpus_exactly_once(self) -> None: + repository = Path(__file__).resolve().parents[3] + catalog = load_registry_catalog( + repository, "evaluation/standards-effectiveness/suite-registry.toml" + ) + catalog = extend_catalog(repository, catalog, catalog.suite_ids) + + whole_corpus = [ + (suite.id, check.id) + for suite in catalog.suites + for check in suite.checks + if getattr(check, "corpus", None) == CANONICAL_MODULE_CORPUS + ] + + self.assertEqual(whole_corpus, [("canonical-corpus-metadata", "canonical-corpus")]) + if __name__ == "__main__": unittest.main() diff --git a/tools/standards_verifier/tests/test_metadata_route.py b/tools/standards_verifier/tests/test_metadata_route.py index e0f88afe..dc2b6f3b 100644 --- a/tools/standards_verifier/tests/test_metadata_route.py +++ b/tools/standards_verifier/tests/test_metadata_route.py @@ -1,6 +1,5 @@ from __future__ import annotations -import csv import sys import tempfile import textwrap @@ -11,74 +10,114 @@ ENGINE_ROOT = Path(__file__).resolve().parents[1] sys.path.insert(0, str(ENGINE_ROOT)) +from standards_verifier.diagnostics import EngineError from standards_verifier.engine import Verifier +from standards_verifier.suite_inputs import compile_suite_input_projection + + +ROUTER_PROJECTION = "evaluation/standards-effectiveness/router-projection.toml" +DECISIONS_HEADER = ("case", "routing.activities", "routing.topics", "architecture", "route") +DECISIONS = ( + ("local", "implementation,verification", "none", "exclude", "route"), + ("shared", "implementation,verification", "architecture", "select", "route"), + ("unknown", "implementation,verification", "unknown", "unresolved", "unresolved"), +) +ROUTES = ( + ( + "local", + "router,workflow.implementation,workflow.verification", + "core,router,workflow.implementation,workflow.verification", + ), + ( + "shared", + "router,topic.architecture,workflow.implementation,workflow.verification", + "core,router,workflow.implementation,workflow.verification," + "topic.contracts,topic.architecture", + ), + ("unknown", "unresolved", "unresolved"), +) +FACT = """ +[[facts]] +id = "{id}" +semantic_revision = 1 +type = "{type}" +nullable = false +values = [{values}] +aliases = [] +meaning = "Fixture fact." +context_kind = "task-route" +answer_contract = "fact-value.v1" +evidence_contract = "evidence-reference.v1" +authorization_capability = "standards.analyze" +prompt = "Fixture prompt?" +""" +SUITE = """ +schema_version = 1 +id = "routing" +owner = "test.routing" +description = "Metadata route fixture" + +[[checks]] +id = "routes" +type = "metadata_route" +path = "decisions.tsv" +header = [{header}] +facts = [{facts}] +expectations_path = "routes.tsv" +route_column = "route" +resolved = "route" +unresolved = "unresolved" +{extra} +[[checks.selections]] +column = "architecture" +selected = "select" +excluded = "exclude" +module = "{module}" +""" + + +def quoted(values: tuple[str, ...]) -> str: + return ", ".join(f'"{value}"' for value in values) class MetadataRouteTest(unittest.TestCase): + """Scenarios are routed by the Router projection, not by the table itself.""" + def setUp(self) -> None: self.temp_dir = tempfile.TemporaryDirectory() self.root = Path(self.temp_dir.name) self.write_module("core.md", "core", role="core") + self.write_module( + "STANDARDS-ROUTER.md", + "router", + requires=("core",), + body=""" + | Condition | Select | + | --- | --- | + | Code changes | [Implementation](implementation.md) | + | A claim is checked | [Verification](verification.md) | + | Contracts change | [Contracts](contracts.md) | + | Authority moves | [Architecture](architecture.md) | + """, + ) self.write_module("implementation.md", "workflow.implementation", requires=("core",)) self.write_module("verification.md", "workflow.verification", requires=("core",)) self.write_module( - "contracts.md", - "topic.contracts", - requires=("core", "workflow.verification"), + "contracts.md", "topic.contracts", requires=("core", "workflow.verification") ) self.write_module( - "architecture.md", - "topic.architecture", - requires=("core", "topic.contracts"), + "architecture.md", "topic.architecture", requires=("core", "topic.contracts") ) self.write( "evaluation/standards-effectiveness/canonical-module-corpus.toml", "schema_version = 1\n" - 'members = ["core.md", "implementation.md", "verification.md", ' - '"contracts.md", "architecture.md"]\n', - ) - self.write( - "decisions.tsv", - "case\tarchitecture\troute\n" - "local\texclude\troute\n" - "shared\tselect\troute\n" - "unknown\tunresolved\tunresolved\n", - ) - self.write( - "routes.tsv", - "case\tdirect_modules\trequires_closure\n" - "local\tworkflow.implementation,workflow.verification\t" - "core,workflow.implementation,workflow.verification\n" - "shared\ttopic.architecture,workflow.implementation," - "workflow.verification\tcore,workflow.implementation," - "workflow.verification,topic.contracts,topic.architecture\n" - "unknown\tunresolved\tunresolved\n", - ) - self.write( - "suite.toml", - """ - schema_version = 1 - id = "routing" - owner = "test.routing" - description = "Metadata route fixture" - - [[checks]] - id = "routes" - type = "metadata_route" - path = "decisions.tsv" - header = ["case", "architecture", "route"] - expectations_path = "routes.tsv" - route_column = "route" - resolved = "route" - unresolved = "unresolved" - base_modules = ["workflow.implementation", "workflow.verification"] - [[checks.selections]] - column = "architecture" - selected = "select" - excluded = "exclude" - module = "topic.architecture" - """, + 'members = ["core.md", "STANDARDS-ROUTER.md", "implementation.md", ' + '"verification.md", "contracts.md", "architecture.md"]\n', ) + self.write_router() + self.write_table("decisions.tsv", DECISIONS_HEADER, DECISIONS) + self.write_table("routes.tsv", ("case", "direct_modules", "requires_closure"), ROUTES) + self.write_suite() self.write( "registry.toml", "schema_version = 1\n\n" @@ -96,6 +135,70 @@ def write(self, path: str, content: str) -> None: target.parent.mkdir(parents=True, exist_ok=True) target.write_text(textwrap.dedent(content).lstrip(), encoding="utf-8") + def write_table( + self, path: str, header: tuple[str, ...], rows: tuple[tuple[str, ...], ...] + ) -> None: + self.write(path, "".join("\t".join(row) + "\n" for row in (header, *rows))) + + def write_suite( + self, + *, + header: tuple[str, ...] = DECISIONS_HEADER, + facts: tuple[str, ...] = ("routing.activities", "routing.topics"), + module: str = "topic.architecture", + extra: str = "", + ) -> None: + self.write( + "suite.toml", + SUITE.format( + header=quoted(header), facts=quoted(facts), module=module, extra=extra + ), + ) + + def write_router( + self, + *, + architecture: str = "architecture", + topics: tuple[str, ...] = ("architecture", "contracts"), + ) -> None: + """A four-rule Router; contracts is also reachable through a detail fact.""" + facts = "".join( + FACT.format(id=fact, type=kind, values=quoted(values)) + for fact, kind, values in ( + ("routing.activities", "enum-set", ("implementation", "verification")), + ("routing.topics", "enum-set", topics), + ("routing.details", "enum-set", ("topic.contracts",)), + ("routing.reviewed", "boolean", ()), + ) + ) + self.write( + ROUTER_PROJECTION, + 'schema_version = 2\nid = "router.fixture"\nowner = "router"\n' + 'source = "STANDARDS-ROUTER.md"\nbase_modules = ["router"]\n' + + facts + + f""" +[[rules]] +id = "route.workflow.implementation" +target = "workflow.implementation" +when = {{ fact = "routing.activities", operator = "contains", value = "implementation" }} + +[[rules]] +id = "route.workflow.verification" +target = "workflow.verification" +when = {{ fact = "routing.activities", operator = "contains", value = "verification" }} + +[[rules]] +id = "route.topic.architecture" +target = "topic.architecture" +when = {{ fact = "routing.topics", operator = "contains", value = "{architecture}" }} + +[[rules]] +id = "route.topic.contracts" +target = "topic.contracts" +when = {{ operator = "any", expressions = [{{ fact = "routing.topics", operator = "contains", value = "contracts" }}, {{ fact = "routing.details", operator = "contains", value = "topic.contracts" }}] }} +""", + ) + @staticmethod def relation(values: tuple[str, ...]) -> str: return "`none`" if not values else ", ".join(f"`{value}`" for value in values) @@ -107,86 +210,237 @@ def write_module( *, role: str = "workflow", requires: tuple[str, ...] = (), + body: str = "", ) -> None: - level = "MUST" - self.write( - path, - f""" + metadata = f""" # Module **Standards metadata** - ID: `{module_id}` - Role: `{role}` - - Level: `{level}` + - Level: `MUST` - Applies when: The fixture applies. - Does not apply when: The fixture does not apply. - Requires: {self.relation(requires)} - Specializes: `none` - Verification: Focused route evidence. - Canonical owner: `{path}` - """, - ) + """ + self.write(path, textwrap.dedent(metadata).lstrip() + textwrap.dedent(body)) def result(self): return Verifier(self.root, "registry.toml").run(("routing",))[0] - def mutate_route(self, case: str, field: str, value: str) -> None: - with (self.root / "routes.tsv").open("r", encoding="utf-8", newline="") as handle: - rows = list(csv.reader(handle, delimiter="\t")) - column = rows[0].index(field) - for row in rows[1:]: - if row[0] == case: - row[column] = value - with (self.root / "routes.tsv").open("w", encoding="utf-8", newline="") as handle: - csv.writer(handle, delimiter="\t", lineterminator="\n").writerows(rows) - - def test_exact_direct_modules_and_graph_closure_pass(self) -> None: - self.assertEqual(self.result().status, "passed") + def codes(self) -> list[str]: + return [item.code for item in self.result().diagnostics] + + def replace(self, path: str, old: str, new: str) -> None: + target = self.root / path + content = target.read_text(encoding="utf-8") + self.assertEqual(content.count(old), 1, old) + target.write_text(content.replace(old, new), encoding="utf-8") + + def test_scenarios_the_router_agrees_with_pass(self) -> None: + result = self.result() - def test_direct_module_mutation_fails(self) -> None: - self.mutate_route( - "shared", - "direct_modules", - "workflow.implementation,workflow.verification", + self.assertEqual((result.status, result.diagnostics), ("passed", [])) + + def test_a_changed_router_rule_fails_the_scenarios_it_decides(self) -> None: + self.write_router(architecture="contracts") + + diagnostics = self.result().diagnostics + + self.assertEqual( + [(item.code, item.field, item.expected, item.observed) for item in diagnostics], + [ + ("ASSERT.ROUTING_SELECTION", "shared.architecture", "select", "exclude"), + ( + "ASSERT.ROUTING_DIRECT_MODULES", + "shared", + "router,topic.architecture,workflow.implementation,workflow.verification", + "router,workflow.implementation,workflow.verification", + ), + ( + "ASSERT.ROUTING_REQUIRES_CLOSURE", + "shared", + "core,router,workflow.implementation,workflow.verification," + "topic.contracts,topic.architecture", + "core,router,workflow.implementation,workflow.verification", + ), + ], + ) + + def test_scenario_facts_decide_the_route(self) -> None: + self.replace("decisions.tsv", "\tarchitecture\tselect", "\tnone\tselect") + + self.assertEqual( + self.codes(), + [ + "ASSERT.ROUTING_SELECTION", + "ASSERT.ROUTING_DIRECT_MODULES", + "ASSERT.ROUTING_REQUIRES_CLOSURE", + ], ) - self.assertIn( - "ASSERT.ROUTING_DIRECT_MODULES", - [item.code for item in self.result().diagnostics], + + def test_a_table_without_scenarios_fails(self) -> None: + self.write_table("decisions.tsv", DECISIONS_HEADER, ()) + self.write_table("routes.tsv", ("case", "direct_modules", "requires_closure"), ()) + + result = self.result() + + self.assertEqual(result.status, "failed") + self.assertEqual(self.codes(), ["ROUTING.NO_SCENARIOS"]) + + def test_a_column_the_router_does_not_declare_fails(self) -> None: + header = ("case", "routing.activities", "module_boundary", "architecture", "route") + self.write_table("decisions.tsv", header, DECISIONS) + self.write_suite(header=header, facts=("routing.activities", "module_boundary")) + + diagnostics = self.result().diagnostics + + self.assertEqual( + [(item.code, item.observed) for item in diagnostics], + [("ROUTING.UNKNOWN_FACT", "module_boundary")], ) - def test_requires_closure_mutation_fails(self) -> None: - self.mutate_route( - "shared", - "requires_closure", - "core,workflow.implementation,workflow.verification", + def test_a_value_the_router_does_not_declare_fails(self) -> None: + self.replace("decisions.tsv", "\tarchitecture\tselect", "\tboundary\tselect") + + diagnostics = self.result().diagnostics + + self.assertEqual( + [(item.code, item.row, item.field, item.observed) for item in diagnostics], + [("ROUTING.FACT_VALUE", 3, "routing.topics", "boundary")], ) - self.assertIn( - "ASSERT.ROUTING_REQUIRES_CLOSURE", - [item.code for item in self.result().diagnostics], + + def test_an_unknown_fact_is_unresolved_rather_than_excluded(self) -> None: + self.replace("decisions.tsv", "unknown\tunresolved\tunresolved", "unknown\texclude\troute") + + diagnostics = self.result().diagnostics + + self.assertEqual( + [(item.code, item.expected, item.observed) for item in diagnostics], + [ + ("ASSERT.ROUTING_SELECTION", "exclude", "unresolved"), + ("ASSERT.ROUTING_RESOLUTION", "route", "unresolved,routing.topics"), + ], ) - def test_unresolved_route_cannot_claim_resolved_selection(self) -> None: - path = self.root / "decisions.tsv" - path.write_text( - path.read_text(encoding="utf-8").replace( - "unknown\tunresolved", "unknown\tselect" - ), - encoding="utf-8", + def test_an_unresolved_route_has_no_reviewed_module_list(self) -> None: + self.replace("routes.tsv", "unknown\tunresolved\tunresolved", "unknown\trouter\tcore,router") + + self.assertEqual(self.codes(), ["ASSERT.ROUTING_UNRESOLVED_EXPECTATION"]) + + def test_a_fact_without_a_column_does_not_apply_to_the_scenario(self) -> None: + # Neither routing.details nor the scalar routing.reviewed has a column: + # the contracts rule that reads routing.details is decided, not unresolved. + self.assertEqual(self.result().status, "passed") + + header = (*DECISIONS_HEADER[:3], "routing.details", *DECISIONS_HEADER[3:]) + rows = tuple((*row[:3], "unknown", *row[3:]) for row in DECISIONS) + self.write_table("decisions.tsv", header, rows) + self.write_suite( + header=header, + facts=("routing.activities", "routing.topics", "routing.details"), ) - self.assertIn( - "ASSERT.ROUTING_UNRESOLVED_SELECTION", - [item.code for item in self.result().diagnostics], + + self.assertEqual( + [(item.code, item.field) for item in self.result().diagnostics], + [("ASSERT.ROUTING_RESOLUTION", "local"), ("ASSERT.ROUTING_RESOLUTION", "shared")], ) + def test_reviewed_direct_modules_must_match_the_router(self) -> None: + self.replace( + "routes.tsv", + "shared\trouter,topic.architecture,", + "shared\trouter,", + ) + + self.assertEqual(self.codes(), ["ASSERT.ROUTING_DIRECT_MODULES"]) + + def test_reviewed_requires_closure_must_match_the_graph(self) -> None: + self.replace("routes.tsv", ",topic.contracts,topic.architecture", ",topic.architecture") + + self.assertEqual(self.codes(), ["ASSERT.ROUTING_REQUIRES_CLOSURE"]) + def test_expectation_case_coverage_is_exact(self) -> None: - path = self.root / "routes.tsv" - lines = path.read_text(encoding="utf-8").splitlines() - path.write_text("\n".join(lines[:-1]) + "\n", encoding="utf-8") - self.assertIn( - "ASSERT.ROUTING_CASE_COVERAGE", - [item.code for item in self.result().diagnostics], + self.write_table( + "routes.tsv", ("case", "direct_modules", "requires_closure"), ROUTES[:-1] + ) + + self.assertEqual(self.codes(), ["ASSERT.ROUTING_CASE_COVERAGE"]) + + def test_expected_selection_must_name_a_module_the_router_can_select(self) -> None: + self.write_suite(module="core") + + diagnostics = self.result().diagnostics + + self.assertEqual( + [(item.code, item.observed) for item in diagnostics], + [("ROUTING.UNROUTED_MODULE", "core")], + ) + + def test_scenario_columns_support_set_valued_facts_without_keyword_collisions(self) -> None: + header = (*DECISIONS_HEADER[:3], "routing.details", *DECISIONS_HEADER[3:]) + rows = tuple((*row[:3], "none", *row[3:]) for row in DECISIONS) + self.write_table("decisions.tsv", header, rows) + self.write_suite( + header=header, + facts=("routing.activities", "routing.topics", "routing.details"), ) + self.assertEqual(self.result().status, "passed") + + self.write_router(topics=("architecture", "contracts", "none")) + self.assertEqual(self.codes(), ["ROUTING.FACT_TOKEN_COLLISION"]) + + self.write_router() + scalar = (*DECISIONS_HEADER[:3], "routing.reviewed", *DECISIONS_HEADER[3:]) + self.write_table("decisions.tsv", scalar, rows) + self.write_suite( + header=scalar, + facts=("routing.activities", "routing.topics", "routing.reviewed"), + ) + result = self.result() + self.assertEqual(self.codes(), ["ROUTING.FACT_TYPE"]) + self.assertEqual(result.exit_code, 4) + + def test_every_column_has_a_role_and_the_router_supplies_the_base(self) -> None: + for change, code, field in ( + ({"header": (*DECISIONS_HEADER, "notes")}, "CONFIG.ROUTING_HEADER", "notes"), + ({"facts": ("routing.activities",)}, "CONFIG.ROUTING_HEADER", "routing.topics"), + ({"facts": ("routing.activities", "routing.topics", "architecture")}, + "CONFIG.ROUTING_SELECTIONS", None), + ({"extra": 'base_modules = ["router"]'}, "CONFIG.UNKNOWN_FIELD", "base_modules"), + ): + with self.subTest(change=change): + self.write_suite(**change) + with self.assertRaises(EngineError) as caught: + Verifier(self.root, "registry.toml").run() + diagnostic = caught.exception.diagnostic + self.assertEqual((diagnostic.code, diagnostic.field), (code, field)) + + def test_an_invalid_router_projection_fails_the_check(self) -> None: + self.replace(ROUTER_PROJECTION, 'base_modules = ["router"]', 'base_modules = ["absent"]') + + diagnostics = self.result().diagnostics + + self.assertEqual( + [(item.code, item.path) for item in diagnostics], + [("ROUTER_PROJECTION.INVALID", ROUTER_PROJECTION)], + ) + + def test_router_projection_and_corpus_are_declared_inputs(self) -> None: + projection = compile_suite_input_projection(self.root, "registry.toml") + roles = { + item["path"]: [use["role"] for use in item["uses"]] + for item in projection["files"] + } + + self.assertEqual(roles[ROUTER_PROJECTION], ["router-projection"]) + self.assertEqual(roles["STANDARDS-ROUTER.md"], ["canonical-module"]) + self.assertEqual(roles["decisions.tsv"], ["routing-cases"]) + self.assertEqual(roles["routes.tsv"], ["routing-expectations"]) if __name__ == "__main__": diff --git a/tools/standards_verifier/tests/test_suite_inputs.py b/tools/standards_verifier/tests/test_suite_inputs.py index 5d041793..fa47d21f 100644 --- a/tools/standards_verifier/tests/test_suite_inputs.py +++ b/tools/standards_verifier/tests/test_suite_inputs.py @@ -1,6 +1,9 @@ from __future__ import annotations +import contextlib +import io import json +import shutil import subprocess import tempfile import textwrap @@ -16,9 +19,13 @@ absent_inputs, ) +from standards_verifier.cli import main, run_complete_verification from standards_verifier.diagnostics import EngineError from standards_verifier.suite_inputs import ( CONTRACT, + DEFAULT_PROJECTION, + DEFAULT_REGISTRY, + REFRESH_COMMAND, check_suite_input_projection, compile_suite_input_projection, write_suite_input_projection, @@ -45,7 +52,9 @@ def inputs(context): ), ) - return SimpleNamespace(id=raw["id"], authority_inputs=inputs) + return SimpleNamespace( + id=raw["id"], authority_inputs=inputs, run=lambda context: [] + ) adapter = patch( "standards_verifier.config.parse_check", side_effect=parse_fixture @@ -273,6 +282,95 @@ def test_written_projection_rejects_transitive_input_mutation(self) -> None: self.assertEqual(check_suite_input_projection(self.root), 2) + def complete(self, *arguments: str) -> tuple[int, str]: + output = io.StringIO() + with contextlib.redirect_stdout(output): + status = main( + ["--repo-root", str(self.root), "--complete", *arguments], + default_repo_root=self.root, + ) + return status, output.getvalue() + + def test_complete_passes_with_the_current_manifest(self) -> None: + write_suite_input_projection(self.root) + + status, output = self.complete() + + self.assertEqual(status, 0) + self.assertEqual( + output, "PASS fixture (3 checks)\nSUMMARY selected=1 passed=1 failed=0 blocked=0\n" + ) + + def test_complete_fails_on_a_file_added_without_regenerating_the_manifest(self) -> None: + write_suite_input_projection(self.root) + self.write("tracked-later.md", "a file no check reads\n") + subprocess.run(("git", "add", "tracked-later.md"), cwd=self.root, check=True) + + status, output = self.complete() + + self.assertEqual(status, 2) + self.assertIn("PASS fixture (3 checks)", output) + self.assertIn(f"SUITE_INPUT.STALE_MANIFEST [invalid] (path={DEFAULT_PROJECTION})", output) + self.assertIn(REFRESH_COMMAND, output) + self.assertIn("--purpose authoring verify_repository", REFRESH_COMMAND) + + write_suite_input_projection(self.root) + self.assertEqual(self.complete()[0], 0) + + def test_complete_fails_on_a_changed_input_or_a_missing_manifest(self) -> None: + self.assertEqual(self.complete()[0], 2) + + write_suite_input_projection(self.root) + self.write("present.md", "present changed\n") + self.assertEqual(self.complete()[0], 2) + + def test_complete_json_reports_the_stale_manifest_beside_the_suite_results(self) -> None: + status, output = self.complete("--format", "json") + + payload = json.loads(output) + self.assertEqual(status, 2) + self.assertEqual(payload["error"]["code"], "SUITE_INPUT.STALE_MANIFEST") + self.assertEqual([item["status"] for item in payload["results"]], ["passed"]) + self.assertEqual(payload["summary"]["passed"], 1) + + def test_complete_result_carries_the_stale_manifest_to_engine_callers(self) -> None: + stale = run_complete_verification(self.root) + self.assertEqual(stale.exit_code, 2) + self.assertEqual(stale.diagnostic.code, "SUITE_INPUT.STALE_MANIFEST") + self.assertEqual([item.status for item in stale.results], ["passed"]) + + write_suite_input_projection(self.root) + current = run_complete_verification(self.root) + self.assertEqual((current.exit_code, current.diagnostic), (0, None)) + + def test_complete_reports_a_manifest_that_cannot_be_recompiled(self) -> None: + write_suite_input_projection(self.root) + (self.root / "present.md").unlink() + + result = run_complete_verification(self.root) + + self.assertEqual(result.exit_code, 3) + self.assertEqual(result.diagnostic.code, "INPUT.UNAVAILABLE") + + def test_complete_reports_an_index_that_cannot_be_read(self) -> None: + write_suite_input_projection(self.root) + shutil.rmtree(self.root / ".git") + (self.root / ".git").write_text("gitdir: absent\n", encoding="utf-8") + + result = run_complete_verification(self.root) + + self.assertEqual(result.exit_code, 3) + self.assertEqual(result.diagnostic.code, "SUITE_INPUT.MANIFEST_UNAVAILABLE") + self.assertEqual(result.diagnostic.path, DEFAULT_PROJECTION) + + def test_complete_over_another_registry_has_no_manifest_to_require(self) -> None: + shutil.copy2(self.root / DEFAULT_REGISTRY, self.root / "other-registry.toml") + + status, output = self.complete("--registry", "other-registry.toml") + + self.assertEqual(status, 0) + self.assertNotIn("SUITE_INPUT", output) + def test_written_projection_is_canonical_json(self) -> None: write_suite_input_projection(self.root) path = (