Command Palette

Search for a command to run...

UnylyUnyly
Весь каталог

Aurora Agent

БесплатноНе проверен

Context engineering, with receipts. AURORA Agent compiles a typed query into the smallest decision-sufficient context and issues a machine-checkable Context Cer

GitHubEmbed

Описание

Context engineering, with receipts. AURORA Agent compiles a typed query into the smallest decision-sufficient context and issues a machine-checkable Context Certificate for every omission. 259-tool local MCP server, Rust.

README

Query-compiled inference for executable biology.

Context engineering, with receipts.

An MCP server and CLI built on the FIBER decision-context compiler: a typed decision query is compiled into the smallest decision-sufficient evidence region, delivered with a Context Certificate stating exactly what was omitted.

CI Release License MCP registry

Implementation of the AURORA BioPRISM / OncoWorld / FIBER blueprint (v0.6, 935 registered spec modules). A Rust workspace whose central idea is that context assembly is a compiler pass: instead of retrieval plus summarisation plus vibes-based compaction, a typed decision query is compiled into the smallest decision-sufficient evidence region, delivered as a Decision Section, and accompanied by a Context Certificate that states exactly what was omitted and whether the omission could have changed the decision.

Compile the smallest decision-sufficient evidence region. Never traverse the whole knowledge structure by default.

What the measurements actually say

The reference world ships 761 facts, 750 of them exploratory distractors that all consume the same protected cohort_id hub. FIBER compiles the query down to 11 facts (1.45% of the world) and the deterministic oracle still returns the correct verdict with all four leakage witnesses.

It is not alone in doing so. Under equal tuning, a 5-hop incidence walk and a BM25 retriever at k=11 select exactly the same eleven facts. The distribution's own compare_baselines.py measures the graph baseline only at depth 7 and unbounded — the two settings where it returns everything — and reports a 69× advantage that vanishes under equal tuning. That is a strawman comparison, and correcting it is what 43.38 and 43.41 require.

So the reference world cannot tell these methods apart. crates/worldgen makes the structure a parameter and builds one that can — distractors attached near the target instead of at a hub leaf, decisive facts behind a relay chain, and distractor tags camouflaged to tokenise into the protected vocabulary:

Strategy Facts Sound? Closure Admissible
full-context 762 yes 100% yes
graph-5-hop 750 no 0% no
graph-7-hop 750 no 0% no
graph-11-hop 761 yes 100% yes
lexical-top-11 (BM25) 11 yes 91% no
fiber 11 yes 100% yes

Three distinct failure modes appear. The graph walk has no usable depth: 5–10 pull in 98% of the world and still miss every decisive witness; 11 is the first sound setting and by then it has taken everything. BM25 reaches the right verdict from a 91% protected closure — right by luck, having dropped a protected fact that happened not to matter, and raising k to 50 never recovers it. FIBER is the only admissible strategy: right verdict and full closure, at 11 facts.

That last failure is why the harness ranks on admissibility rather than verdict alone — ranking on verdict would have crowned the strategy that violated the mandatory closure and got away with it.

This does not show FIBER wins generally: the discriminating world was built to expose these modes, just as the reference world was built to expose hub expansion. The full structural family sweep has now been run — 36 cells over attachment x relay depth x tag style x distractor count — and the two formerly missing baselines are in the panel. The sweep's headline is a negative result for FIBER: a plain backward walk over the directed factor edges, closure first, is admissible in all 36 cells at exactly FIBER's fact count, so on this family admissibility and cost cannot distinguish the compiler from that walk; the fixed-basis embedding retriever, by contrast, fails every camouflaged cell at the tight budget. Full analysis: docs/FINDINGS.md. How much of the blueprint the workspace actually covers, and which sections have nothing standing in for them: docs/COVERAGE.md. The crate layout and the blueprint path: docs/ARCHITECTURE.md.

Autonomous agent process boundary

The Python SDK includes a secret-safe operator entry point for the autonomous brain:

cd python
python -m prism_sdk catalogue
python -m prism_sdk evidence-plan --domain science
python -m prism_sdk provider-status --provider openai

For keyless local development, the same boundary supports an explicit credentialless fixture: python -m prism_sdk provider-status --provider local and run --provider local --model local-model use the runtime's bounded in-memory transport; no key or network provider is contacted. For actual local-model inference without an OpenAI key, use the first-class Ollama preset: python -m prism_sdk provider-status --provider ollama (default endpoint http://127.0.0.1:11434/v1), then run with --provider ollama --model <installed-model> and --approve-provider-call. The Ollama path is explicit, credentialless, OpenAI-compatible, and loopback-by-default; it fails closed when the local server is unavailable rather than falling back to a synthetic response. For a grounded research pass, LocalNeurosurgicalAgent.grounded_real_data_research() / grounded_public_literature_research() (Python) or groundedRealDataResearch() / groundedPublicLiteratureResearch() (TypeScript) composes a bounded real-data or six-specialty PubMed context, an explicitly approved credentialless local-model call, and the matching authoritative draft-claim audit. It accepts Ollama or another caller-registered local provider, returns context/bundle digests and structured claims, and remains grounded_for_human_review; a provider outage fails closed and never produces synthetic evidence. Before the authoritative draft audit, the bridge requires every model citation to be present in the exact bounded context it received; unseen-but-valid snapshot records are rejected rather than treated as grounded. Set tool_loop=True (Python) or toolLoop: true (TypeScript) to expose bounded, read-only, credentialless snapshot tools to the local model: row search, a ClinicalTrials.gov trial-landscape view (neurosurgery_real_data_trial_landscape_view), and a cBioPortal/GDC molecular-coverage view (neurosurgery_real_data_molecular_coverage_view). Calls are capped by explicit turn and call budgets, recorded as a sanitized tool_trace, and their returned citation identities are added to the closure check; the final audit widens only to the same source facets, never to a network or patient-data tool. The trial and molecular views, plus the comparative neurosurgery_real_data_cohort_landscape_view, return descriptive aggregates plus exact rows for citation, not eligibility, efficacy, safety, treatment, or patient inference. A third review-queue view (neurosurgery_real_data_review_queue_view) exposes only explicit missing-link, abstract, date, or sample-count obligations for qualified human review; its bounded task rows are citation closed and never treated as clinical findings. The loop also exposes neurosurgery_real_data_reconciliation_view, which returns the canonical PMID/normalized-DOI crosswalk ledger (missing or shared identifiers, counts, and exact metadata rows) for human review. It never repairs or merges identifiers, fetches a source, or treats an identifier relationship as biological or clinical evidence; returned rows are citation-closed. It also exposes neurosurgery_real_data_research_brief_view, a deterministic glioma topic-lane extractor covering integrated molecular identity, genomics, imaging, pathology, trials, outcomes, tumor microenvironment, and treatment-effect metadata. Topic membership is lexical and reviewer-facing—not relevance, evidence quality, biology, or clinical advice—and each returned record is citation-closed to the supplied real snapshot. The public-literature tool loop also exposes neurosurgery_public_literature_review_queue_view, which projects the real PubMed snapshot's missing DOI/abstract/MeSH/publication-type and duplicate- identifier obligations into citation-closed reviewer tasks. It is specialty-scoped, read-only, and never treats missing metadata as negative evidence. It also exposes neurosurgery_public_literature_integrity_view, which returns bounded PubMed source-completeness and identifier-hygiene counts, review reasons, and exact metadata issues for the caller's fixed lane. Issues remain citation-closed reviewer work; they are never evidence rankings, negative findings, or clinical conclusions. The glioma loop also exposes neurosurgery_real_data_evidence_graph_view, a bounded traversal of explicit study/profile/PMID crosswalks. Graph edges are identifier/provenance metadata—not causal or biological links—and every returned node is added to the citation closure set. It also exposes neurosurgery_real_data_evidence_acquisition_view, which turns the validated snapshot and the fixed glioma request into a bounded next-evidence worklist. The worklist carries only local replay queries, source-linked metadata references, match counts, and explicit reviewer obligations; it never fetches a source, opens a patient asset, or authorizes a clinical action. The public-literature loop exposes the parallel neurosurgery_public_literature_evidence_acquisition_view for a fixed specialty lane. It compiles the checked-in PubMed snapshot into the same bounded, reviewer-owned local worklist while keeping PMID references and the human_review_required boundary explicit; it never treats a planned query as proof that evidence exists. The glioma loop also exposes neurosurgery_real_data_coverage_view, a digest-bound inventory of source, record-kind, temporal, assay, and explicit linkage coverage plus bounded gaps. It preserves caller scope and omissions, but never converts coverage into a quality score or clinical claim. Both loops also expose neurosurgery_specialty_evidence_map_view, which projects the fixed lane's identity, spatial, functional, and temporal coverage states, missingness counters, and reviewer questions. It returns planning metadata only (never observation values or clinical inference), is provider-free/read-only, and rejects reports that drift from the caller's specialty lane. When the caller supplies an explicit UTC freshness clock, the loops also expose a freshness view (neurosurgery_real_data_freshness_view or neurosurgery_public_literature_freshness_view) that returns bounded source-age states and digest metadata. No host clock, fetch, quality inference, or synthetic fallback is used. The function accepts structured real-data facets (record kind, trial status/phase/study type and date bounds, molecular/genomic selectors, linked publication/MeSH selectors, and source IDs) or PubMed facets (publication type, MeSH term, and date bounds). A model may add a narrower facet or change lexical text, but cannot override a caller facet or increase its result limit; the specialty lane is never model-selectable. The lexical field is optional for facet-only searches; when omitted it uses the current bounded question (or caller text) as the selector. Tool results retain bounded source metadata such as trial status/phase/study type, molecular and genomic datatype labels, publication/MeSH labels, aggregate enrollment/sample counts, and abstract excerpts when present; recognized related_records edges preserve the source crosswalk, while patient-level values are never projected. The glioma tool loop also offers a digest-bound identifier-reconciliation view for canonical PMID/normalized-DOI missing/shared rows; it is metadata-only human-review work and never repairs, merges, fetches, or clinically interprets identifiers. The operator commands expose the same mode with --tool-loop, --max-tool-turns 1..8, and --max-tool-calls 1..32; persisted traces retain only search-text digests and structured facets. For these grounded helpers, an HTTP provider must resolve to loopback (localhost, 127.0.0.1, or ::1); remote credentialless gateways are rejected before any evidence tool or network call. The bounded groundedRealDataResearchLoop() / groundedPublicLiteratureResearchLoop() helpers extend this into a finite autonomous fan-out: each pass re-renders the source context, audits its claims, and turns only model-reported unknowns into deduplicated metadata queries. The returned pass ledger, pending queries, termination reason, and loop digest are caller-owned and remain held for human review. The real-data loop also accepts the same structured registry, molecular, genomic, and PubMed facets as neurosurgery_real_data_query; the normalized facet set is retained in the ledger and bound into its loop digest, so a restart cannot silently switch evidence slices. When a caller supplies an explicit lexical text facet, it is used for the first pass; subsequent unknown-derived passes replace only that lexical selector while preserving every structured facet, so autonomous follow-up work changes the searched slice without widening its source boundary. Each persisted pass also carries a canonical digest of its claim payload; resume rejects missing or altered claims before another local-model call. The public-literature loop also accepts structured public_literature_query facets (specialty, publication type, MeSH term, inclusive date bounds, and limit); follow-up passes change only the lexical text selector, and the complete facet set is retained and resume-fenced. Pass a prior ledger as resume_from (Python) or resumeFrom (TypeScript) with a larger total pass budget to continue pending queries after a process restart; schema, provider/model, source bundle, and loop digest are revalidated before another local-model call. The provider-free capability router now maps the complete neurosurgical tool surface into both biomedical and neuroscience profiles: sanitized FHIR/DICOM imports, evidence programs and autonomous review waves, trial landscapes, molecular coverage, and the public-literature refresh/link/integrity queue, workbench, and portfolio tools. Natural-language routing remains lexical and abstaining; it only selects a reviewed capability and never authorizes a provider, patient-file access, clinical action, or external effect. grounded_research_portfolio() / groundedResearchPortfolio() coordinates both planes in one source-separated digest: real glioma population evidence and specialty PubMed evidence retain independent loop/audit identities while their counts and pending work are aggregated for review. When both snapshots are supplied, the portfolio also runs the existing provider-free neurosurgery_literature_link_audit automatically. Its bounded exact PMID/normalized-DOI links, unmatched identifiers, and metadata mismatches remain a separate reviewer artifact and never imply cohort overlap, causality, or clinical applicability. The portfolio and grounded-autopilot CLI also accept an optional real, de-identified case_asset_manifest plus bounded query. The authoritative manifest projection contributes only asset-kind coverage, digests, and reviewer obligations; asset bytes, identifiers, and clinical values never enter the local-model context. The attachment is specialty-bound and remains a separate case-provenance plane from population and PMID evidence. The Python process boundary now exposes the same workflow as aurora-agent grounded-portfolio: it reads bounded, checked-in non-synthetic snapshots, runs Ollama on loopback (or an explicit in-memory fixture), and atomically persists a digest-bound answer/claim ledger. --resume only continues a store whose question, provider/model, source selection, and child loop digests verify; no API-key argument or prompt exists on this command, and it remains research-only and human-review gated. When current public evidence is needed, add --refresh-real-data and/or --refresh-public-literature together with --approve-network. The refreshers use only the allow-listed credentialless public endpoints, validate each candidate snapshot, and atomically replace the selected files before the first model call. Refresh cannot be combined with --resume because changing a source digest would invalidate the persisted loop; receipts are returned in source_refresh and the run remains human-review gated. The same receipt is retained in the digest-bound output store and replayed on --resume without re-fetching sources. Use --real-data-query-file query.json (also supported by grounded-autopilot) to apply a bounded JSON facet object to the glioma plane; the selected facet set is retained and resume-fenced. Use --public-literature-query-file query.json with either command to apply publication-type, MeSH, date-range, specialty, and limit facets to the PubMed plane; that slice is also retained and resume-fenced. For free-text routing, aurora-agent grounded-autopilot first runs the provider-free six-specialty intake, stops with needs_evidence when the routed snapshot is absent, and only then invokes the approved local model. Glioma requires the real glioma snapshot; the other specialties require the PubMed snapshot. The envelope preserves source-plane separation and an explicit human-review hold; it never falls back to synthetic evidence or emits clinical advice. Its --intake-output is an atomic, digest-bound restart checkpoint: --resume rechecks the question, route, source paths, provider/model, and bounded controls (only a larger pass budget is allowed), then hands verified child ledgers back to the worker. Checkpoints retain caller-owned research claims only—never keys, patient data, or hidden model state. To refresh that PubMed plane on any supported platform, use the credentialless NCBI boundary: aurora-agent refresh-public-literature --approve-network. It retrieves six bounded specialty lanes, computes the Rust-compatible source and bundle digests, validates synthetic_data=false, and atomically replaces the snapshot only after every lane is linked and hash-checked. No API key, provider, patient data, or synthetic fallback is accepted. The grounded commands can perform that refresh inline with --refresh-public-literature --approve-network (and, for glioma, add --refresh-real-data). Inline refresh is opt-in, refuses --resume, and returns source digests and retrieval metadata in source_refresh so the model never runs against an unreported corpus. For the complete glioma population plane, aurora-agent refresh-real-glioma --approve-network retrieves only aggregate metadata from ClinicalTrials.gov, NCI GDC, cBioPortal, NCI PDQ, and PubMed. It validates the Rust-compatible source hashes and required registry/genomic/portal/ guideline planes, then atomically installs a last-known-good snapshot; no patient rows, assay values, imaging, credentials, or synthetic fallback are fetched or retained. The real-data context also serializes each bounded reviewer obligation (task ID, source identity, and rationale), so an autonomous worker cannot mistake an unresolved metadata queue for a clean corpus.

Resumable evidence-backed provider calls in both SDKs now capture authoritative request, wire, credential, provider configuration, and transport identities before awaited caller callbacks. Observers and rehydrators receive detached projections; credential/provider graph checks repeat after callbacks and after the caller-owned dispatch transaction. That transaction must durably commit the private idempotency receipt with the provider_in_flight checkpoint before any transport call, and the graph is checked again before terminal settlement. This is a guarded same-process boundary, not an exactly-once claim: deployments still own authenticated durable receipt storage, provider-side idempotency, and uncertain-outcome reconciliation.

The Rust workspace also ships a dedicated, provider-neutral neurosurgical research agent in bioprism-neurosurgery. It routes de-identified glioma, cranial-base, craniofacial, encephalocele, spina-bifida and Chiari requests through deterministic read-only tools, emits explicit evidence gaps and a reproducible request digest, and always holds the result for human review. Each response carries a specialty-specific research profile covering identity, anatomy, time, evidence questions, confounders, and reviewer roles. It uses no OpenAI API or credential; see docs/NEUROSURGICAL_AGENT.md. A synthetic fixture exists only for offline contract tests; it is not used by the real-data path. The neurosurgery_evidence_audit tool adds per-specialty intake coverage for measured, unmeasured, uninterpretable, conflicting, and missing-provenance observation classes before the route executes. The neurosurgery_specialty_evidence_map tool expands that audit into four explicit dimensions for each lane—identity, spatial/anatomic, functional/intervention, and longitudinal context—so glioma, cranial-base, craniosynostosis, encephalocele, spina-bifida, and Chiari review cannot hide which domain inputs are absent, uninterpretable, conflicting, or provenance-incomplete. It is available through the Rust CLI (--specialty-evidence-map), MCP, Python specialty_evidence_map(), and TypeScript specialtyEvidenceMap(); it inventories supplied metadata only and never interprets imaging, pathology, genomics, or operative text. The map self-validates its digest and canonical source rows; mission audits rebuild typed glioma maps against the exact request and supplied snapshots before handoff. The neurosurgery_evidence_synthesis tool is the cross-plane handoff: it composes the redacted case audit with caller evidence, the validated real glioma population snapshot, and/or the validated six-specialty PubMed snapshot. Each plane stays separate, exact source identifiers and URIs remain inspectable, optional freshness reports are attached to the supplied bundle digests, and cross-bundle PMID correspondences are reported only as links (never as cohort or patient claims). Reference/query bounds, truncation, missing snapshots, and incomplete case coverage become explicit review items. The Rust CLI (--evidence-synthesis), Python evidence_synthesis(), TypeScript evidenceSynthesis(), and MCP expose the same no-key, network-free, read-only contract; raw case labels and values are never echoed. The same report is now included automatically by mission helpers: one-bundle missions expose the corresponding evidence plane, while dual glioma missions expose both planes and exact links in a single digest-bound handoff. Persisted synthesis reports self-validate their plane separation, lane counts, freshness bindings, asset/disposition projections, and provider boundary; mission audits also replay the report against the exact request and supplied snapshots so a structurally valid report cannot be rebound silently. The neurosurgery_research_plan tool turns those explicit gaps into a bounded, source-linked caller handoff. It can query only a supplied local real-glioma or six-specialty PubMed snapshot, attaches stable source IDs/URIs for reviewer inspection, and keeps population/citation context separate from patient observations. It never fetches, invokes a model, writes state, or emits diagnosis, prognosis, treatment, triage, or procedural instructions; every plan remains held for human review. Rust, MCP, Python, TypeScript, and the offline CLI expose the same digest-bound contract with task/reference bounds. Every persisted plan now carries a plan_digest and validates its task/source projections; mission audits replay the recorded bounds and local queries against the exact request and snapshot before handoff. The neurosurgery_research_brief tool adds a deterministic, source-linked reconnaissance pass over the same validated snapshots: it groups exact lexical matches into specialty topic lanes, returns stable record IDs/URIs, preserves abstract availability and truncation, reports cross-topic overlap and explicit unknowns, and emits reviewer prompts. It does not rank evidence, summarize unsupported claims, call a model, or turn population literature into patient evidence; human_review_required remains true. The Rust CLI (--research-brief), Python research_brief(), and TypeScript researchBrief() facades are parity surfaces for this report. Persisted briefs expose validate_integrity() and validate_for_inputs(...); mission audits replay the brief against the exact request and source snapshot, including topic counts, truncation, and source-link projections. The standalone neurosurgery_evidence_graph projection is likewise digest- and topology-checked; its validate_for_inputs(...) replay confirms every emitted node/edge came from the exact local glioma snapshot and persisted bounds. The shared neurosurgery_evidence_audit now carries an audit_digest and exact request replay guard; downstream evidence programs and research plans therefore inherit a tamper-evident intake coverage primitive for measured, unmeasured, uninterpretable, and conflicting states. The neurosurgery_evidence_acquisition tool is the next autonomous worker wave: it turns the same explicit missing/uninterpretable/conflicting/provenance gaps into a bounded dual-plane worklist, querying only caller-supplied validated real-glioma and/or PubMed snapshots. Each step carries a source tag, trigger, deterministic digest, local match/truncation status, fallback-to-specialty-scan flag, and replayable references; missing sources remain explicit obligations. Rust, MCP, Python evidence_acquisition(), TypeScript evidenceAcquisition(), and the offline CLI expose this provider-free surface. The lifecycle variants (evidence_acquisition_start, bounded evidence_acquisition_advance, and evidence_acquisition_finish, with matching Python and TypeScript methods) let a caller persist and resume a digest-bound checkpoint; changed request, query, or snapshot bytes are refused before replay. It never fetches, needs an API key, opens asset bytes, or promotes a population/citation match to a case finding, and human_review_required remains true. scripts/run_neurosurgical_acquisition_worker.ps1 drives the caller-owned checkpoint loop locally and writes no credentials or clinical state. It accepts -CaseAssetManifestPath plus the optional -CaseAssetManifestQueryPath and -CaseAssetReviewDispositionPath, so the same worker can carry a real de-identified multimodal review projection and its persisted reviewer state through every wave. When a real de-identified case_asset_manifest is supplied, the acquisition report also carries the manifest report digest and bounded asset review items (missing source, digest, timestamp, uninterpretable, conflicting, or requested-class obligations). Start/advance/finish re-bind that digest on every replay, so a local worker cannot silently drop multimodal provenance while replaying population or citation queries. The offline CLI accepts the same projection with --case-asset-manifest <path> and --case-asset-manifest-query <path> alongside --research-plan --autonomous-acquisition; Python and TypeScript expose matching optional arguments on each lifecycle method. For real glioma research, use the provenance-bound public snapshot in data/neurosurgery/glioma_public_snapshot.json and refresh it (without a provider key) with scripts/refresh_glioma_public_data.ps1. The checked-in data/neurosurgery/glioma_extended_snapshot.json adds the real NCI GDC TCGA-LGG project (516 aggregate cases) alongside TCGA-GBM (617); it is generated by the same script with -GdcProjectIds @("TCGA-GBM","TCGA-LGG"). The baseline remains unchanged for replay compatibility, while callers can opt into the broader glioma population bundle and its distinct source digest. The checked-in extended bundle also uses the broader real PubMed query (glioma OR glioblastoma OR diffuse midline glioma OR oligodendroglioma OR astrocytoma) AND (molecular OR genomic OR IDH OR MGMT OR methylation) under the stable pubmed_glioma_molecular source ID, so lower-grade and histomolecular terminology is not silently excluded from the citation plane. Each extended GDC project also carries aggregate file/data-type facets (for example somatic mutation, aligned-read, slide-image, transcript-fusion, and methylation availability) without exposing files, samples, or assay values. For an end-to-end candidate workflow, scripts/run_glioma_refresh_review.ps1 validates the baseline, refreshes a separate candidate from public endpoints, runs the core refresh audit, and writes a report without replacing the baseline; promotion remains an explicit reviewer action. It accepts the same -GdcProjectIds, -PubMedTerm, and -PubMedSourceId scope controls as the low-level refresh script, so the candidate audit can cover the wider real-glioma population without silently changing the baseline. The refresh script defaults to a bounded 20-record PubMed window and accepts -PubMedLimit 1..50 for an explicit corpus size. -PubMedTerm and -PubMedSourceId widen the real citation lane without losing query/source provenance; replacement of an existing snapshot is atomic and cleans its temporary backup after promotion. Source IDs are stable across retrieval dates; timestamps and content hashes carry freshness and change information without turning every refresh into a remove-and-add event. The neurosurgery_real_data_refresh_audit tool is the restart-safe reconciliation layer for that workflow: give it two independently validated snapshots and it composes structural diff, coverage, freshness (when requested), review-queue obligations, and the research brief into one digest-bound report. It preserves stable source/record identity, emits explicit refresh-review reasons, and never accepts, merges, fetches, ranks, or writes a candidate snapshot. The Rust CLI (--real-data-refresh-audit), Python real_data_refresh_audit(), and TypeScript realDataRefreshAudit() facades expose the same provider-free contract; human review remains required. For long-running work, the neurosurgery_session MCP tool provides digest-bound start/advance/ finish checkpoints so a caller can resume one read-only specialty tool at a time without hidden server state. Checkpoints also bind the canonical specialty route, session identity, event status, and terminal hold, so identity or route mutations fail closed before a resumed tool runs. Every terminal AgentResponse now carries a response_digest over its complete route, tool trace, evidence-gap projection, and nested provenance summaries. Rust callers can invoke validate_integrity() for persisted-envelope checks and validate_for_request(...) for exact request replay; session finish rejects a response that fails either structural envelope gate. Mission envelopes now also carry the same bounded evidence_acquisition plan, so a single provider-free mission exposes the specialty route, source-linked research plan, real-data/literature packet, and resumable acquisition worklist together without merging evidence planes. They also carry an evidence_program: six protocol-defined review tracks per lane (for example glioma histomolecular identity, imaging phenotype, surgery/function, response endpoints, microenvironment, and trial design) are projected onto exact IDs in the attached real snapshots. neurosurgery_evidence_program and the Python evidence_program() / TypeScript evidenceProgram() facades expose the same agenda directly. Track matches are transparent lexical retrieval observations with bounded references, required observation classes, and specialist reviewer roles. Each track also carries metadata-only observation coverage copied from the typed intake audit (measured, unmeasured, uninterpretable, or conflicting), missing classes, and provenance gaps; this is a worklist signal, never a sufficiency score. Empty and truncated tracks remain unknown. The program is read-only, provider-free, network-free, synthetic-data-free, and human-review gated—it does not rank evidence, make a glioma classification, or emit treatment or operative guidance. When a persisted case_asset_review_disposition ledger is supplied with the manifest, its digest and pending/resolved counts are carried into both the evidence program and acquisition plan; stale or tampered reviewer state is refused. When a real de-identified case_asset_manifest is supplied, each track also joins its required observation classes to digest-only imaging, pathology, molecular, operative, functional, developmental, longitudinal, or anatomical coverage. observed, present_not_observed, and missing states make the next export/review obligation actionable without reading asset bytes; the optional asset_coverage_complete flag is inventory metadata, not clinical sufficiency. Tracks also emit a deterministic review_worklist for observation/provenance gaps and unresolved asset classes, giving a local worker explicit next metadata checks without inventing findings. Evidence-program reports self-validate their canonical tracks, coverage/count invariants, source references, freshness bindings, and digest; mission audits replay them against the exact request and supplied snapshots before handoff. Persisted case-asset projections expose validate_integrity() and validate_for_request(...) guards; synthesis, evidence-program, and acquisition joins refuse a tampered or request-mismatched report before it can enter a digest-bound handoff. This protects restart/review workflows without pretending that an upstream asset digest proves the asset's clinical truth. The offline CLI exposes the same pass with --evidence-program, --real-glioma <snapshot> and/or --public-literature <snapshot>; add --evidence-program-query <query.json> to bound lane, track, reference, abstract, or freshness controls. data/neurosurgery/evidence_program_query.json is an all-six-lane query template for the checked-in PubMed snapshot. Mission envelopes also include a final mission_audit receipt. It verifies specialty/status identity, request digests, real/public snapshot digests, required report-plane presence, the case-asset-to-synthesis and case-asset-to-evidence-program bindings, and the provider-free human-review boundary. integrity_ok is an assembly/provenance invariant only; it is not a clinical readiness or evidence-quality score. Persisted mission envelopes now have a single replay gate: Rust NeurosurgicalMissionResult::validate_integrity() checks the terminal response/session chain and all nested receipts without inputs, while validate_for_inputs(...) rebuilds the mission audit against the exact request and caller-owned snapshots. Changed request or snapshot bytes fail closed before a worker can reuse the packet. The MCP neurosurgery_mission tool accepts operation: "validate"; Python validate_mission(), TypeScript validateMission(), and the offline CLI --validate-mission <mission.json> expose the same no-key, read-only replay check. When a mission carries a DICOM or FHIR receipt, exact replay additionally requires the original sanitized metadata export (--mission-case-dicom or --mission-case-fhir on the CLI, or the matching case-import object on the MCP validation call); otherwise validation fails closed rather than treating receipt-shape integrity as source replay. The neurosurgery_catalogue MCP tool exposes all specialty profiles and read-only tool specs before execution, while neurosurgery_real_data_query searches the validated public bundle by stable record text, cBioPortal molecular-profile modality, trial status, exact registry phase or study-type facets, inclusive registry update-date bounds, exact GDC genomic_data_type file facets, case-insensitive PubMed publication_type/mesh_term indexing facets, inclusive PubMed publication_date_from/publication_date_to bounds, record-kind/source facet, or explicit relationship facet, including PMID/title/DOI/abstract/MeSH matches from the PubMed lane. These indexing facets narrow literature metadata but do not act as study-quality scores. Genomic-project hits additionally expose aggregate GDC file/data-type facets when present, keeping modality availability source-linked without returning files, samples, or molecular values. PubMed hits carry bounded source-text excerpts and indexing tags for reviewer inspection. Clinical trial hits also preserve optional ClinicalTrials.gov study type, aggregate enrollment target, intervention names, phases, and last-update date; portal-study hits preserve optional public sample counts; PubMed hits preserve publication dates. Partial PubMed chronology (year-only or month-only source dates) remains missing rather than being padded with an invented day. Missing upstream fields remain absent rather than guessed. Hits also carry explicit study↔profile/publication relationships so a caller can traverse the evidence graph without inferring links from prose. Molecular-profile rows describe available assay modalities only; they never expose mutation, expression, or patient-level values. Responses also include deterministic counts of profile modalities and explicit relationships so a reviewer can see assay coverage and cross-source connectivity before inspecting source-linked metadata. PubMed hits are metadata-only and require reviewer verification before substantive use; the Rust summary also exposes a PMID crosswalk to flag unmatched portal citations without inferring cohort identity. The Python SDK exposes the same provider-free lifecycle through LocalNeurosurgicalAgent, including bounded session iteration, catalogue discovery, and public record queries for UI or worker integrations. Persisted real-data and PubMed query results now expose validate_integrity() plus exact validate_for_inputs(...) replay; mission audits invoke those gates so a changed query, hit list, or count projection cannot be smuggled into a persisted mission. neurosurgery_real_data_trial_landscape adds a digest-bound, provider-free ClinicalTrials.gov metadata reconnaissance over the same validated snapshot: bounded status, multi-label phase, study-design, intervention, update-date, source, missingness, and truncation projections. It never ranks trials or infers eligibility, efficacy, safety, outcomes, or patient-level meaning; multi-phase rows are counted explicitly rather than collapsed into a misleading trial total. neurosurgery_real_data_molecular_coverage adds the complementary cBioPortal availability ledger: exact alteration-type/datatype facets, per-study profile counts, analysis-visible and patient-level metadata flags, description coverage, explicit missing alteration/datatype counts, aggregate GDC project file/data-type facets, and explicit row/study/facet truncation or missing-facet reasons. It inventories only public assay metadata already in the snapshot—no mutation/expression values or sample identifiers—and is digest-bound, replayable, provider-free, network-free, and human-review gated. The canonical evidence packet includes this ledger automatically alongside the trial and comparative cohort landscapes. neurosurgery_real_data_cohort_landscape adds the comparative genomic-project view used by the autonomous loop and is included automatically in newly generated evidence packets and missions. It compares the source-linked TCGA/GDC projects already present in the validated bundle, reporting aggregate released-case inventory and per-project file/data-type availability with explicit truncation and missing-metadata reasons. The view is read-only, provider-free, and metadata-only: rows are citation surfaces, counts are descriptive planning context, and it never opens files, exposes samples or molecular values, merges cohorts, or makes a clinical claim. For natural-language entry, neurosurgery_intake_plan (and the Python intake_plan() / TypeScript intakePlan() facades) performs deterministic lexical routing into the six closed specialty routes. It returns bounded candidates, abstains on weak or ambiguous wording, and lists caller-supplied evidence snapshot classes, reviewer roles, and next research actions. The question is represented in the returned plan only by a SHA-256 digest; scores are routing units, not probabilities or clinical risk, and an explicit specialty is only a research-routing override. This makes free-text intake useful without adding a model provider, credential, network, patient-file, diagnosis, or procedure capability. The closed vocabulary includes specialist subtopics rather than only disease names: glioma histomolecular markers and treatment-effect terms; petroclival/cavernous-sinus and cranial-nerve topics; craniosynostosis suture and syndromic terms; encephalocele variants and CSF rhinorrhea; spinal dysraphism, tethering, and neurogenic-bladder terms; and Chiari measurements, cine-MRI, and CSF-flow terms. These are routing labels only and never become inferred findings. neurosurgery_intake_mission (and intake_mission() / intakeMission()) composes that planner with a guarded research-only mission: ambiguous questions return a digest-only abstention, selected glioma routes require the validated real glioma snapshot (with PubMed as optional supplement), and the other specialties require the validated PubMed snapshot. Executed results contain no raw question or request payload and remain provider-free, network-free, read-only, and held for human review. Callers may optionally include a de-identified case_request with observations, provenance, and evidence. It is validated before any bundle query and carried into the guarded route, so a real case can be reviewed without the old empty-case fallback; the case payload is never echoed in the intake envelope. If omitted, the mission still runs the route but exposes the resulting observation gaps for human follow-up. An optional case_asset_manifest plus case_asset_manifest_query carries real, de-identified multimodal asset metadata into the nested mission. The manifest is digest-bound, requires explicit asset states, and never opens bytes; use the same pair with the Rust CLI's --intake-mission. The intake mission also accepts case_dicom_import and case_fhir_import directly (Python intake_mission(..., case_dicom_import=..., case_fhir_import=...), TypeScript intakeMission(..., caseDicomImport, caseFhirImport), MCP fields, or CLI --intake-case-dicom/--intake-case-fhir). These imports take the same independently validated, digest-only route and may be combined with each other, but not with a second asset manifest. An already persisted case_asset_review_disposition ledger can be supplied in the same intake mission call (Python case_asset_review_disposition=..., TypeScript caseAssetReviewDisposition, or the MCP field). Its report digest and reviewer counts are validated before evidence handoff and rebound into synthesis, evidence programming, acquisition, and the final audit; it never changes the manifest or creates a clinical conclusion. If a real case is exported through FHIR, neurosurgery_case_fhir_import (Rust NeurosurgicalAgent::case_fhir_import, Python case_fhir_import(), TypeScript caseFhirImport(), or CLI --case-fhir-import <import.json>) projects a caller-sanitized FHIR Bundle into that same digest-only asset boundary. The import requires deidentified: true, synthetic_data: false, bounded resourceType/id metadata, and an explicit asset-kind/status/ provenance hint; it rejects identifiers, patient references, narratives, codes, measurements, and raw text. The Bundle is never echoed or interpreted, unclassified resources become reviewer tasks, and the report can be replayed against the exact request, Bundle, and hints without an API key or network. If the imaging archive exports standard DICOM JSON, neurosurgery_case_dicom_import (Rust NeurosurgicalAgent::case_dicom_import, Python case_dicom_import(), TypeScript caseDicomImport(), or CLI --case-dicom-import <import.json>) projects only bounded series-level metadata such as modality, body region, study/series/SOP UID digests, dates, descriptions, and series number. It accepts one dataset or an array (up to 512 datasets and 4 MiB of metadata), refuses patient-identifying tags and PixelData, ignores unknown/private tags, never opens DICOM bytes, and never interprets an image. Missing SeriesInstanceUID, acquisition dates, modality, body region, and object-byte SHA-256 digests become explicit review obligations; the digest-bound report is replayable, non-synthetic, provider-free, network-free, and human-review gated. For a single end-to-end handoff, neurosurgery_case_dicom_evidence_workflow (Rust NeurosurgicalAgent::case_dicom_evidence_workflow, Python case_dicom_evidence_workflow(), TypeScript caseDicomEvidenceWorkflow(), or CLI --case-dicom-evidence-workflow) composes that real metadata projection with validated real glioma/PubMed records, evidence synthesis, the six-track review program, and a resumable local acquisition checkpoint. Every nested report is bound to the same request and DICOM manifest digest; the output remains provider-free, network-free, read-only, non-synthetic, and held for human review. The repeatable PowerShell wrapper scripts/run_neurosurgical_dicom_evidence_workflow.ps1 validates inputs, runs the offline CLI, and writes a caller-selected report without promoting data or retaining credentials. For a mission-level glioma dossier, pass the same DICOM import as case_dicom_import to neurosurgery_mission (Python run_research_mission(..., case_dicom_import=...), TypeScript runResearchMission(..., caseDicomImport), or CLI --mission-case-dicom <import.json> together with --mission --real-glioma). The mission carries the DICOM receipt and verifies that its manifest digest is rebound through synthesis, evidence programming, and acquisition; this convenience lane is real-glioma-only and can be composed with a sanitized FHIR import for a multimodal digest-only manifest, but not with a second asset manifest or disposition. For a repeatable local run of that mission-level lane, use scripts/run_neurosurgical_mission_with_dicom.ps1; it validates the DICOM/manifest/synthesis bindings and refuses a nonzero mission audit before writing the report. The same mission envelope accepts a sanitized FHIR metadata import as case_fhir_import (Python run_research_mission(..., case_fhir_import=...), TypeScript runResearchMission(..., caseFhirImport), or CLI --mission-case-fhir <import.json>). It works with a real glioma bundle, a cross-specialty PubMed bundle, or both; the FHIR receipt's digest-only manifest is rebound through the same synthesis, evidence-program, acquisition, and mission-audit planes. FHIR resources and clinical values are never returned or interpreted. FHIR and DICOM imports may be supplied together; their independently validated digest-only projections are unioned into one multimodal manifest while both child receipts remain visible. A separate asset manifest or disposition ledger cannot be mixed into an import-backed mission. Intake missions and portfolios also accept an optional caller-clocked freshness policy inline or via the CLI --intake-freshness <query.json> flag. Resulting real/PubMed freshness reports are digest-bound; omission means freshness is unclaimed and the server never consults its own clock. When it executes, only the planner's matched closed-vocabulary terms become bounded local real-data/PubMed filters; the original free text is never echoed into those reports. An explicit specialty-only hint uses that lane's canonical corpus term (for example glioblastoma for glioma) when no lexical terms were matched. The same intake orchestration is available without MCP: pipe a flat JSON intake query to bioprism-neurosurgery --intake-mission or --intake-portfolio and pass the checked-in --real-glioma and/or --public-literature snapshots. These CLI modes perform the same validation, provenance checks, and human-review hold with no provider, API key, or network. For a repeatable worker that refreshes both public bundles into non-promoted candidates, audits their drift, and then runs the portfolio against the validated candidates, use scripts/run_neurosurgical_intake_portfolio.ps1. It emits one machine-readable worker envelope and never promotes a candidate snapshot. Supply -FreshnessQueryPath to bind a caller-owned source-age clock, or -CaseAssetManifestPath plus the optional -CaseAssetManifestQueryPath to carry real, de-identified multimodal provenance into a selected-lane portfolio. A persisted case_asset_review_disposition ledger can accompany that manifest and is replayed into the nested mission's synthesis/acquisition audit; all-six-lane portfolios refuse both the manifest and its ledger. The PowerShell worker accepts the same ledger through -CaseAssetReviewDispositionPath. For cross-specialty reconnaissance, neurosurgery_intake_portfolio (and intake_portfolio() / intakePortfolio()) fans those filters across one selected lane or an explicit all-six-lane portfolio. Each lane remains independent and source-linked; an all-lane portfolio requires both the PubMed snapshot and the real glioma snapshot because glioma is part of the requested scope. A selected-lane portfolio can carry the metadata-only case-asset manifest pair; an all-lane portfolio refuses a single-specialty asset attachment, including its reviewer ledger. A selected-lane call may carry case_asset_review_disposition= through the nested mission. The worker verifies the selected lane's nested evidence-synthesis asset digest and coverage counts before emitting its envelope. Use neurosurgery_evidence_graph (or evidence_graph() / evidenceGraph()) when a reviewer needs the explicit, bounded study/profile/PMID crosswalk: it returns source URIs, root traversal, component/isolate counts, omissions, and a digest without inferring biology, causality, or clinical action. A complementary neurosurgery_real_data_coverage report audits the same real snapshot by source, record kind, trial-update/publication-date axis, assay modality, abstract availability, and explicit study/profile/PMID linkage gaps. It preserves missing dates, exposes retrieval metadata, and binds a coverage digest; it does not score freshness or evidence quality, merge cohorts, or make clinical claims. Coverage reports expose validate_integrity() and validate_for_inputs(...); mission audits use the exact replay check before a local worker can consume the coverage plane. neurosurgery_real_data_reconciliation is the companion cross-source identifier ledger. It replays one validated snapshot and reports only exact PMID/normalized-DOI findings: portal PMIDs missing from the local literature window, PMIDs shared by multiple portal studies, and DOIs shared by multiple literature rows. Counts remain visible when findings are truncated, identifiers are never merged or repaired, and any finding sets requires_review; this is metadata review work, not a biological, clinical, or evidence-quality conclusion. It is available as RealGliomaBundle::reconcile, LocalNeurosurgicalAgent.real_data_reconciliation(), and realDataReconciliation() with no provider, network, or API key. Real-data missions also attach a bounded real_data_trial_landscape inventory over the ClinicalTrials.gov rows and a real_data_molecular_coverage inventory over cBioPortal assay/profile metadata. Both are digest-bound to the same validated snapshot, preserve truncation and missing metadata as review obligations, and never rank trials, infer eligibility, expose patient-level assay calls, or make efficacy, safety, diagnostic, prognostic, or treatment claims. neurosurgery_real_data_freshness is the explicit age posture companion: provide a caller-owned UTC as_of timestamp and max_age_days policy to classify each source as current, stale, or future_dated. A future-dated source forces requires_review; age is never treated as evidence quality, applicability, or clinical relevance. The report is digest-bound, read-only, provider-free, and available for the cross-specialty PubMed snapshot as neurosurgery_public_literature_freshness. Freshness reports expose validate_integrity() and exact replay methods for real-glioma and cross-specialty snapshots; mission audits refuse a stale or future-dated posture that has drifted from its caller-supplied clock or source bundle. Real-data missions include the ordered, source-linked research_plan, coverage audit, bounded real_data_trial_landscape and real_data_molecular_coverage inventories, metadata review queue, bounded evidence packet, explicit evidence graph, digest-bound real_data_autonomous_workflow, and real_data_reasoning_context automatically alongside any optional bounded record query and the resumable human-review workflow. The plan and queue turn explicit intake gaps into caller-owned next-review tasks; the packet/context are source-addressable input for a caller-owned local model or reviewer. Neither is a model invocation or clinical conclusion. Public-literature missions carry the corresponding bounded PMID evidence packet and automatically run the lane-scoped public_literature_integrity_audit before packet/brief/context handoff. Missing DOI, abstract, publication-type, and MeSH metadata plus duplicate identifiers remain explicit review obligations; they are never treated as negative evidence. The same mission envelope carries a bounded public_literature_review_queue with stable source-linked reviewer tasks so real metadata gaps become actionable review work without a provider key or clinical interpretation. That queue exposes validate_integrity() and validate_for_inputs(...), keeping persisted task rows tied to the exact integrity audit and public snapshot. The companion neurosurgery_public_literature_workbench joins each selected lane's closed specialty profile (identity, spatial, temporal, evidence-question, confounder, and reviewer-role axes) to exact snapshot coverage, abstract availability, metadata gaps, and integrity-review counts. It is navigation metadata rather than a readiness or quality score: lanes are never ranked, missing fields are never imputed, and no diagnosis, prognosis, treatment, triage, or procedural action is emitted. Use --public-literature-workbench <public> with a JSON query on stdin, Python public_literature_workbench(), or TypeScript publicLiteratureWorkbench(); public-literature missions attach the request-specialty workbench automatically. The integrity audit, workbench, matrix, and portfolio reports expose digest/exact-replay checks; persisted multi-lane review state must be replayed against the same public snapshot before use.

The neurosurgery_public_literature_portfolio pass composes that workbench into one bounded multi-lane handoff: every selected specialty receives an exact lexical query result, its profile and coverage lane, and a stable reviewer queue (all six lanes by default). It uses only the validated real PubMed snapshot and preserves explicit hit, review-item, omission, and truncation counts. The portfolio is provider-free (provider: none, network: false, synthetic_data: false), does not rank evidence or infer a clinical conclusion, and never fetches URLs, opens credentials, or writes durable state. Use --public-literature-portfolio <public> with JSON on stdin, Python public_literature_portfolio(), or TypeScript publicLiteraturePortfolio().

Observations may also carry caller-supplied UTC observed_at values and de-identified timepoint labels. The neurosurgery_evidence_audit response (and --temporal-audit CLI mode) now includes a digest-bound temporal_alignment report with ordered timestamps, same-time observations, undated records, required specialty classes without dates, and caller-order inversions. This is an explicit longitudinal metadata audit—not a progression, response, prognosis, diagnosis, or treatment model; dates are never inferred from free text. For refresh monitoring, neurosurgery_real_data_diff compares two validated snapshots and exposes added, removed, or changed public records plus source-metadata changes by stable identifier; it never copies abstracts, scores freshness, merges cohorts, or makes a clinical claim. Diff reports expose validate_integrity() and validate_for_inputs(...) so refresh decisions can be replayed against the exact before/after snapshots. The composed refresh audit applies the same nested integrity and exact-replay checks across the diff, coverage, freshness, review queue, and research brief planes. neurosurgery_real_data_review_queue then derives a bounded, digest-addressed human-review queue from explicit snapshot gaps (missing crosswalks, unlinked citations, absent/clipped abstracts, unknown registry dates, or unknown sample counts) without imputing values or assigning clinical urgency. neurosurgery_real_data_review_disposition applies caller-owned reviewed, unresolved, or not_applicable state to emitted queue tasks, verifies the queue digest, and preserves omitted or undecided obligations as pending; it never edits source facts or produces a clinical conclusion. neurosurgery_real_data_evidence_packet composes the validated summary, coverage, explicit crosswalk, bounded source-linked query hits, canonical ClinicalTrials.gov trial landscape, and review queue into one packet digest for a local model or human reviewer; nested omissions and unknowns remain visible. The packet also carries the canonical cBioPortal molecular-availability ledger (per-study profile/modalities, explicit description gaps, and boundedness) so a local worker can see what assay metadata is actually present before reasoning. Both real-glioma and cross-specialty literature packets accept an optional freshness query with an explicit UTC as_of and return the digest-bound current/stale/future-dated source posture when requested; omitting it never invents a clock or claims that the snapshot is fresh. The real-glioma packet also carries a canonical PMID/normalized-DOI reconciliation ledger; missing or shared identifiers remain explicit provenance-review obligations before a local model can rely on the crosswalk. neurosurgery_real_data_reasoning_context renders that packet into a deterministic, bounded local-model context with digest-bound headers, source-addressable record blocks, optional untrusted abstract excerpts, and explicit character/query omissions. It never invokes a model or turns source text into a clinical conclusion. The context envelope exposes validate_integrity() and validate_for_inputs(...) as well; a worker must verify the persisted context against the exact snapshot before handing it to a local model or reviewer. Mission construction binds its context query to the same record and freshness scope used by the evidence packet. The packet itself exposes validate_integrity() and validate_for_inputs(...); nested coverage, graph, query, trial-landscape, molecular-coverage, reconciliation, queue, and freshness projections must retain one bundle digest and exact persisted bounds before a local worker can consume the handoff. The packet schema is bioprism-neurosurgery-real-data-evidence-packet/0.4; older /0.1, /0.2, and /0.3 artifacts must be regenerated because the canonical trial, molecular, and identifier reconciliation ledgers are now part of the digest-bound handoff. The cross-specialty PubMed packet and reasoning context expose the same integrity and exact-replay methods, so non-glioma lanes receive identical stale/tamper protection before local-model or reviewer handoff. The six-lane literature matrix, workbench, and portfolio reports are likewise digest-checked and replayable against the supplied snapshot; a multi-lane handoff cannot silently drift from its per-lane query, review queue, or specialty profile. neurosurgery_real_data_autonomous_workflow composes the same packet into a deterministic, restart-safe provenance → completeness → context review wave. It emits only source-addressable metadata tasks (including explicit freshness-policy checks, stale-source refresh actions, and bounded-projection expansion holds when a caller supplies an age clock or small result limits), accepts a persisted human disposition report to resume work, keeps truncation and unresolved items visible, and ends at a human-synthesis gate. If max_actions caps the workflow queue itself, the same hold remains active so omitted context actions or the human-signoff gate cannot be mistaken for a complete handoff; autonomous means orchestration, not clinical prioritization or approval. Persisted waves expose validate_integrity() and validate_for_inputs(...), verifying packet binding, action dependency closure, bounded truncation, open-obligation counts, and exact snapshot replay before another worker resumes them. neurosurgery_specialty_evidence_map adds a lane-specific identity/spatial/functional/temporal coverage map for glioma, cranial base, craniosynostosis, encephalocele, spina bifida, and Chiari. It turns the generic route into an explicit specialist inventory while retaining source IDs, timestamp coverage, conflicts, and uncollected dimensions; it never interprets observation values. neurosurgery_real_data_draft_audit is the companion local-model boundary: it requires every caller-owned draft claim to cite a record emitted by that packet, blocks patient-case and clinical- action posture, and labels accepted rows grounded_for_human_review without pretending to fact-check or clinically interpret claim text. A separate six-specialty PubMed snapshot at data/neurosurgery/neurosurgical_public_literature_snapshot.json covers glioma, cranial base, craniosynostosis, encephalocele, spina bifida, and Chiari. Refresh it with scripts/refresh_neurosurgical_public_literature.ps1, validate it locally, and pass it to planWithPublicLiterature/plan_with_public_literature or the neurosurgery_public_literature_query MCP tool. The route attaches only the requested specialty lane as unverified citation metadata and still ends at human review; it never converts abstracts into patient findings or clinical actions. The checked-in snapshot has 145 source-hashed records and 138 abstracts across the six lanes. Each PubMed lane uses a stable source ID across refreshes, keeping retrieval time and content change auditable without manufacturing a new source identity on every run. Python and TypeScript expose ReviewedPubMedRetrievalAdapter for a live, explicitly approved acquisition of 1--6 fixed lanes. Its pure preflight binds the lane/query set, parser surface, and transport configuration; execution permits exactly one PubMed ESearch → ESummary → EFetch sequence per lane and enforces the resulting request ceiling plus per-response, aggregate-byte, tree, record, and bundle bounds. EFetch accepts and strips only the allow-listed external NLM DTD declaration before parsing and projection; entity declarations, alternate doctypes, and malformed XML fail closed. The durable receipt retains source IDs, digests, and counts but excludes query strings and article content. Deployments can supply their separately registered NCBI tool and developer email only as a pair; both are placed on every request while durable artifacts retain only a configured flag and integrity digest. The one-lane create_reviewed_pubmed_autonomous_evidence_registration() / createReviewedPubMedAutonomousEvidenceRegistration() helpers connect a reviewed single-lane plan to the generic evidence runtime's acquire/project callbacks, validate the transient bundle and receipt, and project only digest metadata without widening the approved source plan. This is the first reviewed live-retrieval adapter, not general web research or evidence validation; broader sources, shared coordination, uncertain-call reconciliation, evidence-quality enforcement, and independent claim-integrity review remain deployment work. For a safe before/after refresh, use scripts/run_neurosurgical_public_literature_refresh_review.ps1: it validates the baseline, creates a separate candidate, runs the cross-specialty refresh audit, and leaves promotion to an explicit human reviewer. neurosurgery_literature_link_audit bridges the real glioma literature index to a selected public-literature lane using exact PMID and normalized DOI identifiers only. It makes the 12 known glioma overlaps, unmatched bounded windows, metadata field drift, and identifier conflicts explicit; it does not infer cohort identity, evidence quality, biology, or clinical meaning. Use --literature-link-audit <real> <public>, Python literature_link_audit(), or TypeScript literatureLinkAudit() for this provider-free, read-only human-review handoff. neurosurgery_public_literature_integrity_audit is the pre-synthesis corpus gate: it audits selected lanes for missing DOI/abstract/publication-type/MeSH metadata and duplicate normalized DOIs, returning source-addressable issue rows and explicit truncation. Use --public-literature-integrity-audit <public>, Python public_literature_integrity_audit(), or TypeScript publicLiteratureIntegrityAudit(); it reports completeness obligations only and never silently repairs, merges, scores, or clinically interprets records. neurosurgery_public_literature_workbench provides the lane-complete reviewer navigation view over the same validated snapshot, preserving per-lane profiles, source IDs, record/abstract counts, and bounded integrity obligations. It is deterministic and provider-free (provider: none, network: false, synthetic_data: false) and does not turn coverage into a clinical score. Each lane also reports non-exclusive metadata-derived design strata (human-indexed, animal/preclinical, in-vitro/cell-line, review/synthesis, imaging/diagnostic, surgical/procedural, developmental/genetic, outcome/follow-up, and interventional) with exact PMIDs. Overlap and unclassified rows are review obligations, never evidence-quality grades or clinical conclusions. For restart-safe cross-specialty refresh review, neurosurgery_public_literature_refresh_audit compares two independently validated snapshots and composes a bounded source/PMID diff, the six-lane coverage matrix, and optional caller-owned freshness posture. It reports changed field names and stable/added/removed identities without copying abstract text, and never fetches, merges, accepts, or promotes the candidate. Use the Rust CLI flag --public-literature-refresh-audit <before> <after>, Python public_literature_refresh_audit(), or TypeScript publicLiteratureRefreshAudit(); the report is provider-free (provider: none, network: false) and remains a human-review handoff. The neurosurgery_public_literature_evidence_packet and neurosurgery_public_literature_draft_audit MCP tools (also available as public_literature_evidence_packet() / publicLiteratureEvidencePacket() and public_literature_draft_audit() / publicLiteratureDraftAudit()) make that corpus a bounded local-model handoff: packet records are emitted with PMID/source links, and every accepted draft claim must cite one of those emitted PMIDs. The result is only a structural grounded_for_human_review posture; it is not abstract fact-checking, study-quality assessment, or a clinical conclusion, and it requires no OpenAI key. neurosurgery_public_literature_reasoning_context (also public_literature_reasoning_context() / publicLiteratureReasoningContext()) renders that packet into bounded, source-addressable context for a caller-owned local model. Abstract excerpts remain explicitly untrusted, citation/character omissions are reported, and no provider, network, API key, or clinical interpretation is involved. Public-literature missions include the same public_literature_reasoning_context envelope automatically. neurosurgery_public_literature_matrix adds a lane-complete reconnaissance pass: one bounded query can fan out across selected specialties (or all six), while each lane keeps its own packet, PMID identities, empty/truncation state, and digest. It reports corpus shape only; it does not merge cohorts or infer cross-specialty biology. Both SDKs also expose the typed glioma panel vocabulary, so assay provenance and explicit missingness can be submitted without inventing a diagnostic label. The dependency-free TypeScript SDK exports the same LocalNeurosurgicalAgent facade from typescript/. For marker-level grounding, neurosurgery_glioma_molecular_map (Rust glioma_molecular_map, Python glioma_molecular_map(), TypeScript gliomaMolecularMap()) maps requested IDH1/IDH2, MGMT, EGFR, TERT, H3, 1p/19q, methylation, and related marker terms onto exact records in the validated real-glioma and PubMed snapshots. It preserves caller assay missingness, reports truncation and zero-hit review obligations, and never treats a literature or population match as a patient result. The map is read-only, provider-free, network-free, and human-review gated. For real case handoff, neurosurgery_case_asset_manifest (Rust NeurosurgicalAgent::case_asset_manifest, Python case_asset_manifest(), TypeScript caseAssetManifest()) accepts a caller-owned, de-identified manifest for imaging series, pathology, molecular assays, operative notes, functional/developmental assessments, longitudinal outcomes, and anatomical models. Every entry is bound to a SHA-256 content digest, source kind, explicit observation state, optional modality/body region, and an observation timepoint; the projection never opens asset bytes, extracts identifiers, calls a provider, or interprets a scan/report. It refuses synthetic manifests, direct identifiers, malformed digests, duplicate asset IDs, and specialty drift, then emits deterministic per-kind coverage, missingness, provenance gaps, and a bounded review queue. This is a real-data intake/provenance seam—not a pixel/content clinical parser—and it always returns a human-review hold. When an archive can export standard DICOM JSON, use neurosurgery_case_dicom_import (Rust NeurosurgicalAgent::case_dicom_import, Python case_dicom_import(), TypeScript caseDicomImport(), or CLI --case-dicom-import) to project bounded series metadata. It refuses patient-identifying tags and PixelData, ignores unknown/private tags, never opens DICOM bytes, and turns missing UIDs, dates, modality, body region, or object-byte digests into explicit reviewer obligations. Reports now include an ordered, typed research worklist that separates missing caller evidence from uninterpretable or conflicting evidence and names the observations and reviewer roles needed for the next review step; it never schedules a test or recommends care. Its runResearchMission/run_research_mission helper composes catalogue discovery, optional real-bundle querying, optional case-asset provenance, and the bounded session lifecycle; glioma missions require a validated public bundle and always return a human-review hold. Pass the de-identified manifest with caseAssetManifest/case_asset_manifest (or the CLI --case-asset-manifest flag) to carry metadata-only multimodal provenance in the mission; the evidence_synthesis.case_asset_report_digest field binds that projection into the same ledger; evidence_synthesis.case_asset_summary also exposes asset/observation/provenance counts, requested kinds still missing, review-item counts, and truncation without exposing asset bytes or identifiers. When present, evidence_synthesis.case_asset_review_items carries the bounded digest-only review obligations themselves. Pass a persisted case_asset_review_disposition with the mission to carry reviewer progress forward; the mission audit verifies its manifest/synthesis bindings and leaves unresolved or undecided items visible as workflow state. neurosurgery_case_asset_review_disposition (Rust NeurosurgicalAgent::case_asset_review_disposition, Python case_asset_review_disposition(), TypeScript caseAssetReviewDisposition()) applies caller-owned reviewed, unresolved, or not_applicable state to returned review-item sequence numbers. The resulting ledger is bound to the manifest report_digest, canonicalizes decision order, rejects duplicate/unknown sequences, and keeps omitted or undecided obligations pending. It stores no local IDs, asset bytes, secrets, clinical meaning, or external workflow state. The direct evidence-synthesis MCP tool and SDK facades accept that persisted ledger alongside the same manifest projection; digest/count mismatches fail closed, while the resulting synthesis exposes only the disposition digest and pending/resolved/unresolved counts for resumable human review. The offline CLI supports the same direct handoff with --evidence-synthesis plus --case-asset-manifest and optional --case-asset-manifest-query. For a persisted manifest projection, pipe a JSON decision array to --case-asset-review-disposition <report.json>; this revalidates the report digest before emitting the stateless reviewer ledger. For a mission replay, pass the persisted ledger with --mission-case-asset-review-disposition <report.json>; the mission audit verifies the same manifest/synthesis bindings before handoff. The same composite envelope is available directly from the offline Rust binary with cargo run -p bioprism-neurosurgery --offline -- --mission --real-glioma <snapshot>; add --mission-query <query.json> for a bounded public-record query. For any specialty, pass --public-literature <snapshot> instead to run the same mission or resumable session against the source-hashed PubMed corpus; its checkpoint records the bundle digest and refuses evidence drift. Both mission variants include the bounded research plan, and the MCP session/mission tools and SDK facades expose these public-literature-backed session methods as well. Add --mission-portfolio-query <portfolio.json> to a public-literature mission to attach the same bounded multi-lane portfolio (exact query, coverage workbench, and reviewer queue per lane) to the terminal mission envelope. For a glioma evidence-fusion mission, pass both --real-glioma <snapshot> and --public-literature <snapshot>; the real registry/genomics bundle remains the route's population evidence, the PubMed bundle remains independent citation context, and the mission returns an exact PMID/DOI literature_link_audit rather than merging cohorts or inventing clinical claims. Use --mission-public-literature-query <query.json> alongside --mission-query when the PubMed side needs a different bounded text, lane, date, publication-type, or MeSH filter. For a repeatable no-key run that refreshes both snapshots first, use scripts/run_neurosurgical_autonomous_mission.ps1 -RequestPath <request.json>; the runner defaults to the checked-in extended TCGA-GBM + TCGA-LGG population and broad glioma molecular PubMed lane. Add -SkipRefresh for an offline replay of those last validated snapshots. The runner persists the mission to work/neurosurgical-mission.json (override with -MissionOutputPath), replay-validates that file against the exact request and snapshots, and emits only the machine-readable mission envelope after both refresh scripts validate their candidates. To preserve the compact GBM-only baseline, pass -RealDataPath data/neurosurgery/glioma_public_snapshot.json -GdcProjectIds @("TCGA-GBM") -PubMedTerm "glioblastoma AND (molecular OR genomic)" -PubMedSourceId pubmed_glioblastoma.

Use run with a caller-owned MCP server when you are ready to invoke a provider. Keys are accepted only through a hidden prompt or an explicitly named environment variable; they are never command line arguments, MCP arguments, plans, or persisted state. See the autonomous brain guide for model discovery, durable inventory refresh, model-selection, approval, and credential-lifecycle details.

For post-run operations, both SDKs expose digest-bound, metadata-only trace analytics through analyze_autonomous_run_trace() / analyzeAutonomousRunTrace() and the corresponding agent facade methods. The report separates measured values from unmeasured domains, aggregates provider/model failure and latency observations, and emits conservative threshold alerts; it does not infer cost, task correctness, provider health, or domain truth. Longitudinal deployments can retain validated reports through the bounded AutonomousRunAnalyticsLedger with digest-checked restore and optional CAS persistence. TypeScript and Python application facades also provide restore-before-read analytics controllers that analyze verified traces, persist accepted reports, classify duplicates/conflicts, and expose safe all-domain rollups. See the analytics section. The TypeScript facade and Python agent also provide a run-observability controller, which restores and flushes both projections and coordinates publication plus analysis from one source snapshot so registry and analytics digests cannot drift during an append race. Partial persistence is reported explicitly and never retriggers execution. When configured, its caller-owned alert sink receives only deterministic, digest-keyed threshold metadata; delivery failures are isolated from analytics and execution outcomes.

Both SDKs also expose a tenant-scoped AutonomousAuthorizationLedger and fail-closed AutonomousAuthorizationGate. Caller-issued grants can cover one or all twelve domains and explicitly scope planning, provider invocation, evidence, connectors, tools, effects, evaluation, learning, memory, trace, or analytics by tenant, actor, session, capability, risk class, expiry, and bounded use count. The ledger is restart-safe and CAS-persistable, with hash-linked metadata events and request-digest replay protection. It never accepts task text, prompts, credentials, headers, provider payloads, tool arguments, or results; authentication, grant issuance, encrypted storage, distributed leases, and external effect reconciliation remain deployment-owned. See the tenant authorization contract.

For live model calls, bind an AutonomousAuthorizationContext created from the caller's grant to LLMRuntime.invoke(), invokeStream(), collectStream(), or invokeToolLoop() (and to the high-level autonomous run options). The runtime mints a fresh, metadata-only request immediately before every provider attempt and every tool-loop turn, then checks it before credential resolution, quota reservation, observers, effect journaling, or transport. A denied domain or exhausted grant therefore cannot contact a provider, while failover and streaming retain the same tenant/session boundary. The context never carries a key, prompt, message, response, or tool result; credentials remain caller-supplied opaque handles.

The same context can be passed to AutonomousEvidenceRuntime.execute() or the reviewed evidence execution controller. It authorizes evidence_acquisition immediately before each source adapter and evaluation immediately before each evaluator callback, binding the decision to a request or receipt digest rather than a raw value. Journal replay does not reacquire or consume an acquisition grant; reevaluatePending authorizes the fresh evaluator revision separately. A refusal raises the typed authorization error before the callback and does not create a misleading failed-evidence receipt. The Python high-level acquire_evidence() facade forwards the same options, preserving least-privilege behavior across direct, reviewed, resumable, and facade entry points.

The same least-privilege process now covers the remaining durable boundaries: provider planning authorizes plan before the planner invocation; episodic recall and recording authorize memory_retrieval and memory_write; evaluator-to-bandit settlement authorizes learning; and metadata-only trace append/complete plus longitudinal analytics ingestion authorize trace_write and analytics_write. These checks use only domain and digest metadata, are propagated through cross-domain helpers, and rethrow typed authorization refusals instead of converting them into provider, memory, or persistence failures. Applications can therefore issue one twelve-domain grant for a complete run or narrow grants to each worker boundary.

The same boundary is enforced by the high-level learning surfaces, not only by the primitive brain methods: workflow and mission learning, delayed trajectory settlement, cross-domain fan-out and synthesis, automatic decision cycles, replans, and consolidated-lesson recall all authorize the final memory operation immediately before it reaches a caller-owned store. Nested runs also forward the authorization context into each exact domain, so a convenience facade cannot silently turn a permitted provider call into an unscoped memory read or evaluation write.

Status

83 crates, 538,938 lines, clippy -D warnings enforced in CI. Byte-level parity with the CPython reference runtime is enforced by test and holds across three implementations: CPython, the Rust eager path, and the Rust indexed store.

The table below is generated. It used to be hand-maintained and drifted to claiming twenty-three crates and 820 tests — the same hand-copy drift crates/devx's exit-code audit exists to catch, sitting in the README of the repository that wrote the audit. Regenerate it, and the test count, with:

tools/status.sh --tests

The Blueprint column is derived rather than declared: it lists the sections whose module ids a crate actually cites in its own source, using the token rule tools/coverage.sh runs. A crate that stops citing a section drops it here without anyone remembering to edit a row.

How much of the blueprint is covered, and what the remainder is: docs/COVERAGE.md and docs/BACKLOG.md. Every uncovered module carries a typed verdict in crates/residue explaining why nothing implements it.

Crate Blueprint What it does
bioprism-adapter 04,28,40,43 Data adapter contract with mandatory semantic-loss reporting
bioprism-adaptive 08,43 Adaptive evaluation: capability posterior, information-gain suite selection, parent-aware uncertainty
bioprism-api 11 Bounded HTTP API, event stream, and signed webhook outbox for the Prism MCP kernel
bioprism-atlas 03,33,43 BioCapability atlas and metrics: capability ontology, coverage, failure atlas
bioprism-atlashub 09,27,34 BioAtlas surfaces: world cards, connector registry, value-of-experiment, federated evaluation, research CI
bioprism-atlasx 34 Capability atlas and public-hub remainder: coverage debt as a derived claim, and the failure-atlas browsing surface
bioprism-autopilot 40 Grant-gated autonomous mission driver: plan, dispatch, classify, repair — with mission-report and reconciliation receipts for every attempt
bioprism-backends 32,43 Physical backend portfolio: variable elimination, worst-case-optimal joins, structural estimation and the honest fallback
bioprism-baseline 43 Equal-engineering context baselines: full-context, k-hop incidence, connected component, lexical top-k, embedding top-k, directed dependency walk, query-graph, and the structural family sweep
bioprism-benchcompiler 06,35 Benchmark compiler: trajectory to decision cell, first causal divergence, minimization, oracle synthesis
bioprism-bioethics 13,30,36 Section 36 remainder: biology security, privacy, ethics and governance beyond policy and safety
bioprism-bioeval 26,31,43 Biological evaluation engine: scoring planes, partial credit, biological error classes
bioprism-bioevalx 07,26 Bio evaluation engine remainder: scoring planes, reader models, adjudication and the evaluation contract
bioprism-bioir 25,39 Biological IR: BioWorld, specimen lineage, AssayLens, cohort and split, uncertainty and reference standards
bioprism-biolang 25,28,39,43 The biological IR family and BioQL: typed world, state, intervention, worldline, oracle, mutation and bundle representations
bioprism-bioworlds 30,38,43 Reference bioworlds and vertical slices: worlds built to make blocked platform claims exercisable
bioprism-brain 09,11 Provider-neutral autonomous brain kernel: model routing, prompt assembly, bounded plans, and online bandit state
bioprism-bundle 10,12,13,34,43 Signed result bundles and reproduction: attestation, replay, and what symmetric authentication cannot promise
bioprism-choreography 23 Multiparty choreography: session types with projection, bounded protocol model checking, adjudication, quorum with checked independence, and sagas with honest compensation
bioprism-cli 40,43 The bioprism command-line interface
bioprism-conformance 14,40,43 Conformance suites, the test pyramid and release quality gates
bioprism-cookbook 03,11,13,14,19,21,38,39,40,41,43 Reference examples: worked recipes with the claim each one demonstrates and the property a reader can check
bioprism-dataops 12 Section 12 remainder: storage topology, relational catalog, SLOs, compute placement and federated deployment, each answer carrying the basis it was known from
bioprism-devplat 11,19 Developer platform remainder and reference examples: which of them are artifacts this repository can hold, and predicates over the ones that are
bioprism-devx 11,23,38,39,40,41,43 Developer platform: machine-actionable diagnostics, compile introspection, the local-loop invalidation contract and the 23.32 debugger surface model
bioprism-docgraph 39,41,43 Documentation graph: module registry, edge vocabulary, context cards, task routes, bundle compiler, change impact
bioprism-domain 43 Domain packs: declarative rule oracles and scope vocabularies that carry the FIBER pipeline to non-biological decision questions
bioprism-epistemic 43 The remaining FIBER calculus: coverage-aware selection, separator protocol, rate-distortion and value of information
bioprism-evalengine 06,07,43 Evaluation engine: the deterministic-first scoring ladder and causal component attribution
bioprism-examples 13,19,34,38,39,40,43 Reference BioWorlds and runnable vertical slices
bioprism-fabric 23,43 Interweave fabric above the microkernel: composition algebra, effect and information flow, contextual reputation, common ground, semantic lifecycle
bioprism-factory 40 Job, worker, lease and recovery lifecycle with idempotency-aware retry
bioprism-fiber 39,40,43 The FIBER query compiler: protected closure, dependency slicing, temporal cut and certificate emission
bioprism-foundation 24,40 BioPRISM foundation objects: the executable-biology thesis made typed
bioprism-governance 14,25,40,43 Schema versioning, migration, deprecation and compatibility gates
bioprism-graph 40,41,42,43 Generated graph, hypergraph, timeline and table projections over compiled decision regions
bioprism-hub 34,36,43 BioAtlas public hub: submission, moderation, provenance and ecosystem contracts
bioprism-hubapi 10 Registry and hub surface: discovery, resolution, mirroring, offline operation and trust propagation
bioprism-ids 11,40,43 Canonical serialization, content hashing, and typed identifiers for AURORA BioPRISM
bioprism-influence 43 Sound numeric influence bounds: the formal influence bounds the reference slicer's limitation string says it lacks
bioprism-infra 12,40 Data infrastructure: provable cache hits, invalidation that reports its completeness, quality gates, tiering, lifecycle and storage quota
bioprism-interweave 23 Section 23 remainder: interweave modules weave, fabric, choreography and weavelang did not claim
bioprism-lab 05,09,39 Inference Lab: hypothesis separation, architecture search, Pareto fronts, evolution cards, holdout and rollback policy
bioprism-ledger 12,40 Append-only event ledger with valid/record/release time, projections and checkpoints
bioprism-lens 03,33,42,43 Graph lens grammar: the typed lens catalogue behind the evaluation hub, and the non-visual contract
bioprism-mcp 11,43 Model Context Protocol server exposing the FIBER context compiler to agents
bioprism-megafactory 35 Section 35 remainder: million-scale factory modules scale and factory did not claim
bioprism-metrics 03,33,43 BioCapability metrics: aggregation rules, comparability of scores, and what a capability number may not claim
bioprism-modalities 28,30,43 Modality data standards: what each assay family measures, what it cannot, and when two modalities are comparable
bioprism-mutation 03,40 Metamorphic mutations with executable postconditions, lineage, deduplication and effective-diversity accounting
bioprism-obligation 39 Decision obligation graph, BioContext capsule and the token budget controller
bioprism-onco 30,43 OncoWorld: neuro-oncology domain model, longitudinal tumour worldlines, response criteria, molecular classification
bioprism-oncoworlds 30 OncoWorld domain depth: identity spine, clonal evolution, methylation classes, cross-modal and cross-system transport, era and site shift
bioprism-ops 40 Operational contracts of blueprint §40: configuration and feature flags, observability and audit, the capacity model, hardening, and the alpha acceptance criteria as predicates
bioprism-oracle 11,31,40 Oracle mesh: provider SDK, the deterministic-to-judge evidence ladder, set-valued combination and disagreement adjudication
bioprism-oraclex 31,32 Reference standards as claims about measurement processes, and the mutation validation program that decides whether a transformed case may be released
bioprism-packs 03,15,29 Benchmark pack taxonomy and portfolio definitions
bioprism-policy 13,36,39,43 Policy, privacy and information-flow fibers: consent, purpose, residency, role visibility, redaction
bioprism-prism 03,40,43 Decision Cells, matched counterfactual forks, state minimization and attested result bundles
bioprism-project 40 Project modeling: compiles a software project tree into a FIBER world through the sealed adapter contract, with every scanning loss declared
bioprism-registry 10,27,40,43 Benchmark packs, promotion, trust tiers and the CI release gate
bioprism-repair Issue repair planning and three-valued acceptance verification over a scanned project world: plans and checks, never edits and never executes
bioprism-residue The explained residue: every uncovered blueprint module with the reason no crate implements it
bioprism-routing 09,43 Evaluation-conditioned inference routing: pick a context architecture from prior evidence
bioprism-runtime 05 Execution runtime: run orchestrator, executor providers, WorldTape, fork/replay, virtualization, effects broker, budget controller
bioprism-safety 05,13,40 Platform security and safety: threat model, trust boundaries, prompt injection, poisoning, supply chain, disclosure
bioprism-scale 35,40 Million-scale factory: effective size, hidden-family splits, prospective escrow, cost accounting, content-addressed storage
bioprism-scope 43 Typed scope base: identity, region, specimen, time, coordinate, ontology and policy validity contexts
bioprism-sdk 11,23,40,43 Plugin and extension SDK: registration, capability declaration, version negotiation
bioprism-section 39,43 Decision Section IR and Context Certificate: the model-facing context ABI and its omission receipt
bioprism-services 10,40 Build-ready service contracts: request/response shapes, error taxonomy, versioning, the process graph
bioprism-standards 25,28,39,43 Biology data standards: ontology binding, units, coordinate frames, reference builds
bioprism-stewardship 14,43 Governance and quality: the checkable parts of section 14, and an honest account of which modules are process rather than code
bioprism-store 43 Content-addressed indexed world storage: point lookups that do not scale with corpus size
bioprism-stress 30,32,38 Biological stress program: prevalence shift, batch and site effects, assay uncertainty
bioprism-sweep 03,04,05,08,10,13,39,43 The small remainders: core specifications, ingestion, execution runtime, adaptive, registry and safety tails
bioprism-tokens 39 Token-efficient biological inference: golden context fixtures, staleness and recomputation, ablation design, multi-agent projection, summarisation contracts
bioprism-trace 03,04,39 Trajectory ingestion, decision segmentation, first-divergence localization and Decision Cell compilation
bioprism-weave 23 The Weave microkernel: typed acts, commitment and epistemic ledgers, attenuating authority, affine budgets, context capsules and continuations
bioprism-weavelang 23 WeaveLang and WeaveIR: surface syntax, canonical IR schema, compiler pipeline, operational semantics
bioprism-world 40,43 FIBER world model: local evidence sections, typed factors and the causal event structure
bioprism-worldfactory 03,10,27,34,35 Parent bioworld authoring and the biomutator: observed, semi-synthetic and mechanistic worlds, assay-fault and contradiction programs
bioprism-worldgen 38,43 Synthetic structural benchmark families: worlds whose topology, depth and tag informativeness vary independently

Cross-language parity

Certificate hashes are taken over canonical bytes, so Rust and Python must agree exactly or a certificate produced by one cannot be replayed by the other. Both the Decision Section and the Certificate are byte-identical to reference/fiber_runtime/fiber_compile.py:

certificate_sha256      c0da17ffc80465258345c8a538171bfd868100cd883e9a20780a0dc5477e7ea4
decision_section_sha256 7439b2262c52c1c794b59be86d922b723a2ea5646362d529f57fb11b5f7e93ce
world_sha256            b3809731cf93040fcd8aef43deb2a552492064b49154e07ea58caa724c10cbb5

Getting there required matching CPython in two places a naive port gets wrong: repr float formatting (CPython switches to exponential at a different threshold than Rust and zero-pads the exponent) and JSON object iteration order, which the reference relies on when building leakage witnesses.

Quickstart

cargo build --release --offline
./target/release/bioprism context explain --world fixtures/fiber-v0.1/radiogenomic_world.json --query fixtures/fiber-v0.1/leakage_query.json

That prints a database-style explain plan: which passes ran and what each retained, the backend, selection ratios, omissions grouped by influence class, the oracle verdict with its witnesses, and — importantly — which passes did not run and why.

./target/release/bioprism --json context compile --world fixtures/fiber-v0.1/radiogenomic_world.json --query fixtures/fiber-v0.1/leakage_query.json --certificate-out cert.json
./target/release/bioprism context verify --certificate cert.json

Scale

Compiling from a JSON document parses the whole world on every query. Index it once instead:

./target/release/bioprism world index --world big-world.json --store big-world.bpw

--world then accepts the store directory anywhere it accepted a document, and the certificate is identical. On a one-million-fact world this takes query time from 26.5 s to 41.6 ms (638×), and compile cost becomes roughly logarithmic in corpus size rather than linear. The reasoning and the full measurements are in ADR-001.

Exit codes

Ten codes, and every failure code carries exactly one retry decision, so a caller holding nothing but the process status can decide whether to re-send. bioprism --help prints the table; --json puts the same decision in the envelope as error.retryability.

code decision code decision
0 ok 5 io retryable_as_is
1 assertion_failed 6 conflict terminal
2 usage terminal 7 policy_denied retryable_after_change
3 invalid_input terminal 8 indeterminate retryable_after_change
4 compile_failed retryable_after_change 9 stale retryable_as_is

Codes 0 and 1 report a verdict rather than a failure — the checked property held, or it did not — so they publish no retry decision rather than a third state every consumer would special-case.

This is a breaking change. The registry previously had six codes, and 6–9 were all 4 compile_failed. Two of them are the reason for the split: a script reading exit 4 could not tell a policy refusal from an oracle abstention from a snapshot that had moved under it, and stale was advertised as not retryable when re-reading and re-sending the identical request is exactly what clears it. bioprism-devx's exit-code audit found both against blueprint 40.36 and now reports neither; the registry it found them in is retained there as the audit's known-positive input.

Installing (Claude surfaces)

  • Claude Desktop: download aurora-agent.mcpb (prebuilt for Windows only) from the latest release and double-click it (or Settings → Extensions). Ships with the reference fixtures; the "AURORA data root" setting can point at a full checkout.
  • Claude Code: this repo is a plugin marketplace — claude plugin marketplace add AURORA-NEURO/aurora-agent then claude plugin install aurora-agent@aurora (see plugins/README.md).
  • VS Code: sideload aurora-agent-0.1.3.vsix from the v0.1.3 release (code --install-extension aurora-agent-0.1.3.vsix). The extension registers the MCP server with VS Code (1.101+) so Copilot agent mode can call the 264 tools, and adds workflow/autopilot/pipeline views (see editors/vscode).
  • MCP registry: listed as io.github.MurariAmbati/aurora-agent on registry.modelcontextprotocol.io.
  • Privacy: local program, no network, no data collection — PRIVACY.md.

Documentation

Project site: aurora-neuro.github.io/aurora-agent. The full reference lives in docs/; contribution workflow in CONTRIBUTING.md.

Autonomous workflows, with receipts

bioprism autopilot drives an instantiated workflow's mission autonomously under an explicit AutonomyGrant — the only source of authority; there is no default grant. The driver dispatches the mission in-process, classifies every failed step by its declared 40.36 retry class (terminal, retryable_after_change, retryable_as_is, or unknown), and re-dispatches only what the grant authorises, as a repair subset with rematerialised bindings. Terminal and cancelled steps are never re-dispatched; an unknown failure is never retried unless the grant explicitly opts in.

Success is never inferred: it requires full step coverage, a succeeded mission report, and — by default — a complete workflow reconciliation with valid integrity. Every drive emits a digest-sealed autopilot report chaining the grant digest, every mission and report digest, and every reconciliation digest; bioprism autopilot verify recomputes it and detects a single tampered byte. --dry-run plans attempt 1 only — no dispatch, zero writes.

bioprism workflow instantiate --workflow decision_context --mission-id demo --goal "compile and verify" --steps steps.json
bioprism autopilot grant-template --json > grant.json
bioprism autopilot run --instantiation instantiation.json --grant grant.json --report-out report.json
bioprism autopilot verify --report report.json

What it deliberately does not do: no recurrence, no MCP tool exposure of the driver itself, and no ownership of wall-clock deadlines. Grants can authorize deterministic logical-tick retry backoff; the host supplies the wait/deadline implementation. Restart is supported only through a caller-owned, metadata-only checkpoint: mission/report material is rehydrated by the host and matched by digest before the planner can continue. Full reference: docs/AUTOPILOT.md.

Autonomous research

bioprism research executes a fixed protocol over synthetic decision worlds — generate, compile and certify, equal-engineering baseline panel, then optional structural sweep, metamorphic mutation, and minimization — and writes a digest-sealed dossier, a rendered report, and figures. Findings are derived by fixed public rules and locked to level observation: a single-variant enum, so no stronger level is representable. Each finding cites the sha256 of every artifact it was derived from, and each figure's footer carries the sha256 of the exact value rendered. research verify recomputes the seal and detects a one-byte tamper; --dry-run prints the plan and writes nothing.

bioprism --json research template > request.json
  # edit request.json: research_id, question, family, distractor_points, seed
bioprism research run --request request.json --out-dir out
bioprism research verify --dossier out/dossier.json

A committed worked example lives in docs/research-example/: the discriminating family at distractor points 50/250/750, 12 steps in about four seconds, 9 findings of which 7 are negative, and 7 figures. Its headline is a negative about this repository's own compiler — FIBER is tied by directed-walk-full at every declared distractor level (both admissible at 11 facts) and is not separated in 36 of 36 sweep cells. The run is deterministic: an independent re-run reproduced it byte-identically across all nine files.

Limitations, carried verbatim in every dossier: measurement over synthetic decision worlds only; no biology, no literature or prior-work coverage, and no external-world claims; oracle review is a human gate; the sweep deliberately does not vary decision-defining knobs; and negative findings are first-class results. Full reference: docs/RESEARCH.md.

The bioprism-research-campaign crate composes fixed, dependency-checked stages across the synthetic-research and brain-planning kernels while preserving negative findings, human-review pauses, missing input, exhaustion, refusal, and unknown completion as different states. A linear action authorization is released only after a caller-owned coordinator atomically stores the exact in-flight checkpoint and trusted head; a lost acknowledgement therefore restores into reconciliation_required, never an automatic redispatch. Native successful artifacts are rebuilt or replayed by their source kernel instead of being accepted from a self-digested JSON document.

The path-only MCP surface research_campaign_run_offline makes that bounded composition usable without placing research objectives, source material, or generated artifacts in the tool audit envelope. confirm: false performs full preflight with no authorization or writes. Confirmed runs support only synthetic_research and brain_plan, use an append-only filesystem coordinator, and return only typed status, digests, counts, and caller-owned artifact locators. This is an offline campaign runner, not full external literature research: provider retrieval, authenticated execution journals, model calls, and independent scientific validation remain explicit future/deployment boundaries.

A repeated, identical confirmed request against an existing output directory is verification-only: the runner rechecks the append-only authorization chain, checkpoint/trusted-head identity, artifact file digests, and native deterministic research/brain-plan replay without redispatching work or creating files. An interrupted directory is reported as reconciliation_required; it is never blindly resumed. An unconfirmed request against an existing target is refused because a fresh append-only destination can no longer be promised.

Using it from an agent

./target/release/bioprism-mcp --root .

Speaks JSON-RPC 2.0 over newline-delimited stdio. The session follows the MCP lifecycle: the client calls initialize, waits for the notifications/initialized acknowledgement, and only then calls tools or resources. fiber_compile returns the L0 decision contract — goal, verdict, what was omitted, whether the sufficiency claim holds — plus a versioned, content-addressed refinement handle, and not the evidence. An agent passes that handle to fiber_refine only when the contract is insufficient to act; the server recompiles and verifies the certificate digest before disclosing the requested layer. On the reference world L0 is ~204 estimated tokens against ~1,900 for the full section.

The invariant that makes that safe: omissions are reported at every layer, so an agent that stops at L0 still knows what it does not have. Layering hides volume, never the fact of an omission. Paths are confined to --root; absolute paths, .., and symlink escapes are refused. The shipped research-contract JSON schemas (including evaluation, release, instrument preflight, multimodal harmonization and replication, analysis qualification, and protocol-matrix receipts) and the capability catalog are available through read-only MCP resources, so a client can build valid documents and route work without reading arbitrary files. world_index previews its write unless called with confirm: true.

The repository also ships a dependency-free Python client in python/. It supports synchronous and asyncio MCP sessions, enforces the initialize/initialized lifecycle, keeps transport/protocol/remote-refusal errors distinct, bounds JSON-RPC frames, and provides thin helpers for developer_delivery_audit, developer_workbench, developer_workbench_verify, developer_workbench_import, developer_workbench_query, developer_workbench_get, ci_provider_normalize, ci_execution_evidence_audit, agent_mission, capability_discover, mission_evaluator_discover, mission_evaluator_review, mission_evaluator_replay, capability_audit, capability_dashboard, capability_route, adapter_plan, tabular_ingest, conformance_run, release_audit, operations_catalog, ops_acceptance, safety_release_gate, medical_boundary_check, biocapability_evidence_audit, bioql_compile, world_claim_check, observed_world_declare, lineage_audit, preanalytic_apply, contradiction_review, lab_plan, onco_boundary_check, onco_response_assess, onco_worldline_view, onco_classification_check, oncoworlds_identity_join, onco_outcome_analyze, oracle_combine, oracle_reference_panel, oracle_missingness, bioeval_reference_audit, evaluation_worldline_audit, evaluation_reproduction_check, evaluation_trajectory_check, routing_decide, repository_catalog, repository_bundle, repository_impact, telemetry_project, bioatlas_publication_audit, and the full fiber_compilefiber_refine/fiber_explain/fiber_verifyprojection_bundle lifecycle. Typed evaluator-candidate discovery, reviewed binding, replay, audit, dashboard, delivery, evidence, publication, adapter-plan, tabular-ingest, conformance, release-audit, operations, safety, lineage, pre-analytic, contradiction, inference-lab, oracle/evaluation, and oncology-boundary projections retain cross-domain metadata, schema-quality evidence, parity gaps, readiness gates, explicit blockers, claim prerequisites, omission accounting, publication gates, candidate refusal reasons, semantic-loss boundaries, conformance checks, fixture drift, delegated refusal state, advisory-only observations, storage promise parity, service-contract divergence, metric debt, three-way acceptance verdicts, risk-gate decision drivers, unrated dimensions, structured clinical refusal, partial aggregate release, privacy exclusions, tiered evidence ledgers, temporal leakage witnesses, reproducibility divergence, and strict release-conjunction evidence for operators and SDK callers. It is an integration foundation above the Rust kernel, not a claim that the full Python data-adapter, benchmark-statistics, or biological-format ecosystem is complete. Its authoring layer now builds digest-bound packs, decision cells, deterministic mutation plans, versioned oracle judgements, reference-panel requests, evaluation requests, and bounded FHIR JSON/NDJSON, FASTA, FASTQ, SAM, GFF3, PDB, SDF/MOL, mzML, DICOM, NIfTI, AnnData, VCF, BAM, and OME-Zarr projection audits, plus bounded heterogeneous projection batches, while leaving final health and oracle decisions to Rust. prism_sdk.ApiClient and AsyncApiClient also speak the bounded HTTP gateway described in docs/HTTP_API.md.

The Python clients also expose capability_route_plan, which composes caller-selected route candidates with authoritative mission preflight across MCP and REST. It returns a digest-bound mission and plan_digest with explicit dispatch: "not_started"; route-review and preflight blockers remain structured, and no nested domain tool is dispatched. They also expose capability_route_plan_verify, which rechecks a retained plan without dispatch; supplying the original route and selections enables full route-review replay, while a shape-only check is reported explicitly as verified_without_route_replay.

For every current or future MCP domain, the Python layer also exposes a schema-aware fallback: tool_catalogue() snapshots the live definitions, plan_tool() performs bounded transport-shape preflight, and tool_checked() executes only after that review. This does not claim domain validity or suppress refusals; unsupported schema features remain visible as warnings. Mission requests can additionally pass through mission_preflight() for digest-bound graph, wave, binding, authorization, and per-step schema review before the Rust mission executor is called. The executor is serial by default; an explicit execution_mode: "parallel_waves" policy dispatches independent wave members concurrently with bounded width and reserved output budget. Executed missions also return a deterministic clock-free trace of lifecycle, wave, step, refusal, block, digest, and byte-accounting transitions. Mission requests can additionally provide bounded caller-authored claim_requests; terminal reports then include a non-semantic claim_lineage projection that maps each claim to explicit step results, retained-output digests, omission states, and durable non-claims. The HTTP gateway exposes the same projection at /v1/missions/{mission_id}/claims, and the Python/TypeScript clients provide typed helpers for it. claimable describes retained evidence posture only: it never means the claim is true or release-ready. Claims can also declare explicit evaluator/adapter bindings to source-step output pointers; coverage and pointer/refusal/omission posture are reported separately, so every domain can plug in a named evaluator without giving the orchestration layer semantic authority. Multiple retained evaluator outputs also expose canonical-digest agreement/disagreement as an explicit witness, never as an automatic adjudication. Retained outcomes also distinguish refused, blocked, cancelled, output-omitted, pointer-missing, and successful evaluator rows, including output source/type/size and digest groups. A ready mission_evaluator_review can be supplied back as evaluator_review; agent_mission rechecks its catalogue digest and exact binding rows before any nested call, then preserves review provenance in the report and claim lineage. The Rust executor also performs bounded authoritative JSON Schema preflight against the live tools/list definitions: static arguments are checked before a mission is accepted or planned, and bound arguments are checked again after upstream payloads are materialized, before either serial or parallel nested dispatch. Refusals include the schema digest and bounded JSON-pointer diagnostics, so malformed calls cannot be mistaken for domain-level refusals or successes. The HTTP gateway adds bounded asynchronous mission jobs with typed status polling and cooperative cancellation between nested calls or parallel batches; a cancellation report records what completed and what was never dispatched rather than implying force-kill or rollback. POST /v1/missions/preflight provides the matching synchronous handoff: it validates the original execution policy and static schemas, returns the authoritative digest-bound plan, and forcibly marks dispatch as not_started. It never creates a job or invokes a domain tool. GET /v1/missions provides a bounded deterministic inventory with status filtering, lifecycle links, and step/refusal/byte summaries without returning unbounded terminal reports.

For browser and Node consumers, typescript/ provides the corresponding dependency-free Fetch client. It enforces request/response bounds, timeout and abort semantics, typed API errors, SSE cursor parsing, webhook outbox lifecycle, and typed facades for the evidence, BioAtlas, OTLP, runtime, bioethics, and developer-delivery workflows. See docs/TYPESCRIPT_SDK.md for the compatibility, workbench, mission, secret-handling, and schema-aware full-catalogue invocation contract. toolCatalogue() and planTool() make arbitrary domain calls reviewable before toolChecked() executes them; missionPreflight() extends that review across dependency graphs, bindings, and execution policy before agentMission() is sent. Remote refusals remain visible rather than becoming success. missionFromRoute() connects the generic capability catalogue to that review while keeping candidate selection and arguments explicit.

The repository ships bioprism-api for deployments that need a network boundary:

cargo run -p bioprism-api -- --root . --bind 127.0.0.1:8787 --token <visible-token> \
  --mission-state .local/mission-state.json --mission-queue-state .local/mission-queue.json \
  --event-state .local/event-state.json \
  --reconciliation-state .local/reconciliation-state.json

It exposes the exact MCP tool catalogue through REST and JSON-RPC, bounded health/capability routes, cursor-addressable event pages/SSE snapshots, receipt-correlated event queries, signed webhook outbox registration, retry, and acknowledgement. --mission-state adds an optional bounded, atomic checkpoint for mission status, progress, traces, and size-limited result metadata; interrupted queued/running missions are marked failed after restart instead of being falsely resumed. Mission checkpoints emit schema 2 with a content SHA-256 state_digest; schema-1 snapshots are accepted for migration and rewritten after startup, while tampered schema-2 state is rejected. Persistence status reports both the digest and observation-time integrity_verified state. --mission-queue-state adds a separate content-addressed factory checkpoint for mission leases, idempotency class, attempts, staged/committed output boundaries, and explicit startup recovery. --mission-queue-max-jobs and --mission-queue-max-active-leases add explicit local queue backpressure; the queue status reports per-resource-class fair-share limits and observed lease occupancy. Each lease attempt is also a fencing token, preventing stale attempts from committing after recovery. The queue checkpoint is now an execution-authority envelope: queue state and a bounded hash-chained transition journal are atomically replaced together, and cooperating API processes sharing the same local filesystem serialize mutations through a bounded lock. Status reports both the queue digest and authority digest, revision, event count, lock state, and integrity result. POST /v1/missions/queue/authority/release-lock is an attributed, audited operator override for a lock whose owner is known to be gone. This is local shared-file coordination; it does not provide tenant isolation, multi-host consensus, or network-partition tolerance. GET /v1/missions/queue exposes that queue projection without returning the original mission specification. Expired idempotent work is requeued and ambiguous non-idempotent work is quarantined, but no recovered job is automatically dispatched; the authority is a local recovery and audit boundary, not multi-host scheduling, provider authentication, or proof of external effect completion. --event-state checkpoints retained events, subscription metadata, and signed pending outbox rows while never persisting webhook secrets; the current schema-5 checkpoint is content-addressed with a SHA-256 state_digest, and startup rejects tampering before restoring rows. It also retains a bounded, cursor-addressable delivery-attempt journal for enqueue, send, retry, replay, acknowledgement, and secret-rebind outcomes without claiming receiver state beyond explicit worker acknowledgement; receipt-bearing attempts also retain the validated receipt ID and content digest for exact joins. Schema-1 through schema-4 checkpoints remain readable for migration and are upgraded on the next flush. Restored subscriptions pause until an explicit in-memory /rebind call. It deliberately reports gRPC, TLS termination, distributed scheduling, and external delivery as absent rather than inferring them from an HTTP listener. GET /v1/recovery and the Python/TypeScript recovery_matrix/recoveryMatrix helpers provide one operator matrix that keeps mission restoration, event rows, subscription metadata, pending outbox evidence, delivery-attempt provenance, secrets, and external effects separate. The GET /v1/operations/snapshot?after=N&limit=M route and matching typed SDK helpers compose that matrix with one bounded event page, event metrics, mission status counts, persistence digests, capability transport flags, exact domain-group/tool coverage, and actionable operator follow-ups. The same snapshot includes reconciliation_summary plus reconciliation checkpoint status: stored report counts are split into completion statuses, structural-ready rows, explicit review requirements, integrity-invalid rows, and evidence-invalid rows. These are derived audit counters only; they do not authorize execution or upgrade a domain, scientific, clinical, safety, or release claim. The summary also carries a per-workflow status matrix and distinct workflow count, so the cross-domain view cannot hide an unobserved or failed capability group inside one aggregate. The domain projection compares the authoritative workspace capability groups with the advertised tool catalogue, preserving missing names and omission counts without inferring semantic readiness. It is designed as a dashboard bootstrap and handoff surface: it never returns unbounded mission reports, executes no tools, and does not turn local observations into scientific validity, receiver acceptance, or automatic recovery claims. The event cursor remains authoritative, so consumers should persist recent_events.next_after and inspect gap before declaring continuity. POST /v1/operations/handoff turns caller-selected domains or capability groups into a content-addressed, non-executing capability_route request. It preserves unresolved selectors, catalogue gaps, complete-group omissions, and explicit next steps through capability review and mission preflight; it never dispatches the generated route or authorizes execution. GET /v1/operations/domains?after=N&limit=M adds bounded local activity observations per capability group, allowing operators to distinguish catalogued-but-unobserved tools from tools that actually emitted events in the requested cursor page. This is activity evidence only, not runtime, scientific, safety, or release readiness. GET /v1/operations/gates?after=N&limit=M turns the same bounded page into separate catalogue, activity, transport-completion, pooled evaluation, domain-evaluator, safety, and release evidence gates for every capability group. Domain-evaluator evidence is bound to a completed evaluation tool by exact name or the workspace catalogue; it does not assert scientific validity, evaluator calibration, or independence. A completed local call is never promoted into a readiness verdict: groups remain catalogue_blocked, insufficient_evidence, or review_required, with readiness_claimed: false. Each group also carries gates.reconciliation_evidence, joined only by the exact capability-group workflow_id against the bounded digest-valid reconciliation registry. missing means no retained matching report and never passes by inference; incomplete or invalid retained posture forces insufficient_evidence; structurally_ready remains review-required evidence and is never a release, safety, clinical, or scientific authorization. The summary exposes groups_reconciliation_blocked, and the same posture is typed by the Python and TypeScript SDKs, so all currently advertised workspace groups receive the same fail-closed join contract. The same gate response now carries an advisory gates.artifact_evidence posture for every group. It counts only records already admitted to the digest-verified artifact registry, matching explicit registration domains after case normalization or an artifact body's explicit group_id; it never infers membership from subjects, kind names, or free text. The posture reports artifact families, verification states, parent-linked records, match basis, and registry generation/size. Missing artifact evidence remains visible but is not a required gate and cannot change gate_state or create readiness. Python exposes a typed OperationsArtifactEvidencePosture with an explicit legacy-response fallback, and TypeScript exposes the corresponding group/summary posture fields. Handoffs now carry an operations_gate_acceptance execution prerequisite; preflight binds the mission’s exact tools to matching capability groups and the current gate_digest, while executable HTTP missions are refused until an operator acceptance covers every required gate for every group. Operators can persist that acceptance through POST /v1/operations/gate-reviews and replay it by content-addressed review_id; executable missions require the retained review record to survive the same event checkpoint and still match current evidence. Accepted executable missions retain a bioprism-mission-execution-provenance/0.1 projection in mission status, inventory, and /v1/missions/{mission_id}/provenance. It correlates the review, gate digest, domain-evaluator evidence, bounded preflight projection, and the accepted-dispatch event; mission checkpoints retain it when mission_state_path is configured. It is an audit and replay boundary, never a readiness or scientific-validity claim. GET /v1/webhooks/subscriptions/{id}/attempts route and matching SDK helpers expose the provenance cursor with explicit retention gaps and dropped-row accounting. Receipt-bearing rows are also available through /v1/delivery-receipts/{receipt_id}/attempts, which joins the same evidence across subscriptions without claiming external receiver state. Embedded Rust consumers can plug an egress-controlled DeliverySender into ApiRouter::deliver_once(...) to acknowledge successful signed webhook sends and classify bounded retryable/permanent failures without giving the gateway arbitrary network access. Delivery pages expose pending, retryable, failed, exhausted, and secret_rebind_required state with the last transport error; POST .../{id}/replay is an explicit operator reset that preserves the delivery ID, resets the attempt budget, and re-signs without claiming delivery. The serving path uses one immutable shared router across connection threads, atomically allocates request IDs, and clones ready MCP dispatch sessions per request. Mission, event, subscription, and delivery state remain independently bounded and synchronized, so unrelated domain calls do not serialize behind a global router mutex.

The same server exposes the broader workspace: world_validate checks a world before compilation, context_compare runs the equal-engineering baseline panel, bioworlds_catalog runs the reference vertical slices, modality_catalog exposes assay resolution and failure-mode contracts, modality_support_check evaluates typed claim eligibility and analysis-unit independence across the 17 modality families; modality_transport_check reports loss and fidelity, and modality_comparability_check preserves modality-first refusals, and literature_bind_check binds source claims to typed populations and historical horizons while keeping citation support separate from biological measurement support; reviews cannot be silently laundered into primary evidence, unstated populations refuse, and flagged sources require a recorded warrant, mutation_family validates metamorphic families with effective diversity, prism_minimize reduces and re-checks a diagnostic world, registry_gate fail-closes attested benchmark packs, registry_lifecycle_simulate replays the local content-addressed publication lifecycle with continuation state, append-only events, supersession, withdrawal, promotion, demotion and integrity verification, operations_catalog executes the local/team topology parity and service-contract audit while keeping undefined metrics explicit, capability_rank compares serialized metric vectors without collapsing holes or trade-offs and can apply a declared weighting with sensitivity evidence, while research_ci_check runs the claim, split, figure, regression, environment, egress, non-claim and provenance predicates, metrics_profile_audit emits per-capability leaders, measured populations, missing systems and uncontested-lead warnings for public-card construction without inventing a scalar score, biocapability_evidence_audit composes metric profiles with explicit evidence states across grounding, information acquisition, resource efficiency, temporal validity, cross-modal agreement, causal identification, reproducibility, translation maturity, and multi-agent coordination. It validates support fields, blocks future evidence and unknown dimensions, keeps declared evidence visible without counting it as measured, and releases only explicitly requested claims whose required dimensions are eligible; optional information-value, reference-distribution, worldline, and reexecution subaudits remain bounded projections rather than biological truth or clinical inference, cache_invalidation_simulate rebuilds typed cache keys and replays dependency-aware invalidation, partial unknown regions, fail-closed lookup misses and explicit re-proving, while storage_lifecycle_simulate plans pin-aware hot/warm/cold tiering and non-copyable quota delegation with reserve-protected accounting, policy_screen enforces caller-supplied policy rules before selection and preserves typed refusals, safety_posture reports section-13 threat populations without claiming runtime enforcement, and safety_release_gate applies the complete dual-use risk gate with unrated dimensions still blocking, hub_search performs bounded federated exact-facet discovery with typed authority, tier, digest, freshness, and near-miss provenance, measurement_compare checks standards declarations without silent unit or ontology coercion and returns typed conversion receipts and first blocking reasons; governance_schema_check checks the shipped schema contracts, medical_boundary_check admits research use cases and structurally refuses clinical outputs, tabular_ingest runs the real CSV/TSV adapter with independent conformance and loss accounting, observed_world_declare seals pinned observed-world declarations, world_claim_check enforces the provenance claim ladder, hub_resolve resolves a federated pack request with digest and freshness provenance, hub_lock builds a transitive provenance-preserving dependency lock, safety_posture reports residual threat populations, and security_redteam_simulate replays the section-13 safety loop across confirmed-finding regression cells, sequential vulnerability disclosure, evaluator/artifact trust boundaries, across-trial feedback paths, incident blast-radius containment gates, forensic timelines, hash-linked audit records, and observed-versus-asserted attestations. It keeps the crucial nonclaims beside every result: this is a bounded contract simulation, not a fuzzer, runtime sandbox, detector, credential revoker, incident channel, containment executor, notification service, or durable audit store. weave_protocol_catalog exposes typed agent-act antecedents. bioatlas_publication_audit composes atlas coverage, optional evidence-conditioned claim readiness, moderation/card rendering, and leaderboard ranking into explicit publication targets. It keeps atlas holes, withheld scores, unranked entries, and absent evidence visible; numeric public scores require both the disclosure-gated card result and an evidence audit, and no release claim is emitted without an explicit target request. It remains an in-memory contract workflow rather than a web publisher, identity service, assay runner, leakage detector, scientific truth oracle, or clinical approval. bioethics_action_review partitions research plans from physical actions and only produces an external referral after both required human approvals are present; bioethics_human_subject_screen keeps institutional review, consent, and return-of-results checks separate; bioethics_dual_use_review adds an explicit misuse-surface assessment in front of the section-13 release gate; bioethics_validation_check audits evidence completeness and independent reproduction; and bioethics_representation_audit preserves unmeasured and small-cell-suppressed strata while refusing attribution across unmatched resource context. influence_analyze computes caller-scoped numeric influence bounds over declared factor regions, defaults to structural-only analysis, and keeps unknown preconditions distinct from vacuous bounds. The Python and TypeScript SDKs expose the same factor-region request and report boundary, including hard budgets, attempted-method provenance, exact versus conservative validity, and typed unknown reasons; they never turn an uncomputable influence into infinity or a fabricated numeric bound. routing_decide selects only among an explicitly approved architecture panel, abstains on weak coverage or margins, and refuses held-out evidence leakage when a task identity is supplied; the Python and TypeScript SDKs preserve the selected architecture, structured abstention reason, considered panel, neighbourhood evidence, confidence score, and holdout check without treating a safe-default abstention as a routing win; token_context_plan checks mandatory token closure, dry-run restricted-data privacy, and policy-only comparisons while preserving estimator provenance; bioql_compile type-checks explicit biological schemas for units, frames, builds, clocks, labels, provenance, and cost bounds without executing a query; weavelang_compile compiles source to deterministic WeaveIR and can inspect or replay its local semantics, with replay as the default and world-mutating transitions refused. projection_bundle derives graph, hypergraph, timeline, and table views from the same compiled section and certificate, preserving provenance, fidelity, and unresolved-obstruction coverage; view bodies are opt-in and are never treated as proof. lens_catalogue exposes the implemented section-42 questions, evidence requirements, scope preconditions, and declared refusals before a run; lens_leakage_check executes the typed cohort leakage lens with sealed nonvisual witness rows, explicit underdetermination, and no split repair. choreography_check checks serialized multiparty protocols, projects every role, and preserves bounded or inconclusive model-checking results; conformance_run verifies shipped fixture digests before running the FIBER suite and returns its noncompensatory release decision. provider_capability_gate gates runtime/provider claims on passed correctness and security evidence, keeps performance values as measurements without invented thresholds, and marks cross-provider comparisons indeterminate when either side is untested. The Python and TypeScript SDKs expose the same evidence boundary with typed claim states, gate outcomes, run witnesses, measurement counts, and differential drift; a cleared gate never implies that runtime execution occurred or that unmeasured capabilities are safe. scale_family_split_verify verifies imported benchmark tiers against lineage roots and refuses family straddles; stewardship_review_check concludes evaluator reviews only when mandatory dimensions, corpus support, and independence hold, keeping unreviewed dimensions explicit. quality_gate_run preserves pass, fail-with-witness, and not-runnable data-quality outcomes; the Python SDK exposes typed witnesses, not-runnable reasons, check-level outcomes, and the separate failed-versus-obstructed verdict sets, while TypeScript preserves the serialized gate/check union and report shape without turning an indeterminate run into a pass; ledger_ingest appends bitemporal events while exposing quarantine, idempotency, causal release, hash-chain, clock-anomaly, temporal-cut, and digest-only projection state; the Python and TypeScript SDKs preserve those admission, release, and projection witnesses without implying durable storage or a live clock. fabric_synthesize evaluates typed agent-composition candidates against hard effects, privacy, budget, assurance, and terminal-state constraints, then returns the rejection map and Pareto frontier without inventing a weighted winner. interweave_workflow_catalogue exposes the six reference workflows and derives their 54 owed deliverables from the typed catalogue, keeping specification inventory separate from artefact availability. epistemic_voi prices explicit evidence actions and non-adaptive bundles while keeping gross risk reduction, declared cost, net value, action changes, complementarity, and exhaustive limits visible; the Python and TypeScript SDKs expose the same boundary with typed problem, belief, acquisition, value, bundle, action-identity, and fail-closed refusal projections; epistemic_adaptive_acquisition extends that boundary with an exact finite-horizon policy tree: each outcome can stop or choose a different unused acquisition, while expected terminal risk, expected scalarized cost, posterior branches, state caps, conditional-independence assumptions, and fail-closed refusals remain visible; it plans only and never executes an acquisition or claims causal, clinical, biological, or predictive truth. See docs/EPISTEMIC_ADAPTIVE_ACQUISITION.md; epistemic_adaptive_execute is the explicit next boundary: it requires a plan-scoped provider grant, validates one provider outcome against the selected branch at a time, preserves partial and refused prefixes, and replays through a receipt-only executor with no live fallback. The built-in MCP adapter is simulation-only and labels its rows simulated; Python and TypeScript expose typed receipt/provenance projections. See docs/EPISTEMIC_ADAPTIVE_EXECUTION.md; epistemic_adaptive_costed exposes the same exact finite-horizon planner with component-wise tokens/compute/latency/money/privacy/specimen/expert budgets and explicit scalar weights; Python and TypeScript preserve the canonical seven-dimension request/result contract. See docs/EPISTEMIC_COST_VECTORS.md; the versioned fiber-query/0.5 contract carries the same unperformed-acquisition semantics into the FIBER compiler and returns a certificate-bound named policy tree with execution: "not_started" and authorization: "not_granted"; the Python and TypeScript SDKs expose a typed replay-safe projection of that boundary. The interweave catalogue now has a typed workflow execution binding that carries workflow identity, capabilities, effect prohibitions, plan digests, explicit grants, and receipt-only replay across all six reference workflow identities without claiming generic release authority. The interweave_workflow_execute MCP route and the Python/TypeScript facades expose deterministic simulation, structured no-grant refusal, and same-binding receipt replay. See docs/WORKFLOW_EXECUTION_BINDING.md. Workflow receipts can also be converted into portable, digest-checked evidence with interweave_workflow_execution_evidence, then imported, queried, and fetched without re-running the workflow. Evidence retains caller-owned domain/subject labels and separates observed, simulated, and replayed provenance; registry presence remains review evidence rather than release authority. benchmark_trace_analyze adds the deeper benchmark compiler's causal, episode, boundary, and repetition analysis; the Python and TypeScript SDKs expose typed trace events, causal score components, divergence/verdict variants, boundaries, episodes, repetitions, and fail-closed refusals; and pack_catalogue exposes the agent and biological pack portfolio without turning declarations into measured scores. pack_health_assess runs the typed pack-health gate over observed calibration, trivial baselines, contamination, oracle posture, and materialization, binding every finding to the pack digest and refusing a numeric score for an unreportable revision. pack_catalogue exposes the corresponding bounded declaration inventory with typed axes, oracle ceilings, release sequencing, and duplicate-signature review candidates; it does not turn a portfolio declaration into observed performance. foundation_contract_check validates falsifiable-contract admissibility, safe refinement, claim applicability, counterfactual strength over the world class, reveal policy, and transition-plane consistency as separate gates. The Python and TypeScript SDKs expose those gates as typed subreports and keep a transport-success response distinct from an admitted contract or an authorized biological claim. world_generate creates deterministic synthetic world/query pairs from a bounded WorldSpec, parses both through the typed runtime, and returns exact digests and structural validation; hub_submission_review checks the public submission contract and can replay append-only moderation with independent verification attestations; telemetry_project applies typed redaction with a semantic-loss report and optionally evaluates observed-versus-asserted operational metrics. These three surfaces are local contract workflows only: they do not publish to a network, authenticate identities, persist a hub ledger, export OTLP, execute models, or make clinical claims. factory_lifecycle_simulate adds deterministic lease, expiry, idempotency, compensation, quarantine, and atomic-commit replay; factory_authority_verify audits the durable queue envelope and bounded transition chain without dispatching work; hub_disclosure_review, hub_card_render, and hub_leaderboard_render artifact_registry_audit indexes exact-content mission, evaluator, reconciliation, and domain artifacts across the capability surface. It preserves verification posture, declared parent edges, missing parents, and bounded lineage traversal while explicitly refusing to infer causal provenance, scientific validity, clinical safety, publication authority, or external-effect completion from a digest or registry presence. Trusted boundaries also project mission reports, evaluator replays, verified evidence-bundle imports, and digest-valid workflow reconciliations into this shared index automatically. Each response carries an artifact_registry projection with the exact registry digest or an explicit indexing failure; generic domain-tool outputs remain unindexed unless the caller registers them deliberately. artifact_registry_audit with operation: "domain_evidence_lineage" is the intake-specific read model over that same index. It filters any of the 29 capability groups by exact content, request, response, intake, source-plan, subject, source-tool, outcome, or domain identity; each returned row keeps the recoverable request/response digests, direct declared parent states, source-plan plan_digest versus indexed content-digest binding, and reverse direct child links. The MCP operation, GET /v1/domain-evidence/lineage, bioprism evidence domain-lineage, and the sync/ async Python and TypeScript facades all preserve cursor bounds and the distinction between a missing parent, a retained parent, and a digest that is merely declared. It is a structural lineage view only: no digest, parent edge, child edge, or intake outcome becomes execution, causal provenance, scientific, clinical, provider, release, or readiness authority. domain_decision_readiness_audit is the next cross-domain policy gate. It accepts the caller's same-subject canonical reports and explicit link roles, then evaluates required groups/domains, support and qualification floors, contradiction/refusal policy, review posture, report linkage, and optional lineage-parent requirements. Its blocked, incomplete, review_required, and ready_for_human_review states are structural dispositions, not scientific, clinical, release, execution, or truth claims; readiness_claimed remains false and execution remains not_started. The MCP tool is available to every current domain group, and the generic REST dispatcher plus sync/async Python and TypeScript clients preserve the same digest-bound audit and indexed artifact. domain_decision_readiness_query and GET /v1/domain-decision-readiness provide a bounded, digest-ordered retained read model with exact subject/state/policy filters, cursor pagination, and opt-in audit bodies; readiness query exposes the same query against a local artifact checkpoint. Workflow portfolios and reconciliations can carry a validated readiness_audit summary and opt into policy.require_readiness. That gate remains separate from mission preflight and completion: it records structural decision posture, never execution authorization or domain truth. carry disclosure ratchets, fail-closed score publication, comparability conditions, and typed unranked entries into agent-callable public-hub projections. release_audit composes required registry, bundle, quality, conformance, research-CI, operations, and pack-health gates while retaining repository impact and developer-platform diagnostics as advisory evidence. These surfaces remain bounded and local: they do not create durable queues, identity providers, web UI, CI execution, deployment, or network publication. The bundle layer now has deterministic offline Ed25519 verification plus an explicit caller-supplied key-registry policy layer for roles, delegation, rotation, revocation, producer binding, and validity. The registry is a bounded local snapshot, not an external identity, transparency, timestamp, or release-authorization service. The Python and TypeScript SDKs expose the factory result as an ordered, typed trace: successful leases, recovery variants, staged-output invisibility, committed-result snapshots, quarantined and dead-lettered jobs, and fail-closed action refusals remain independently inspectable across sync, async, MCP, and HTTP facades. storage_lifecycle_simulate adds the matching typed storage boundary: caller-epoch hot/warm/cold plans, pinned-object protection, skipped-tier witnesses, explicit dry-run/application accounting, reserve-aware quota charges, releases, non-copyable delegation/absorption, and raw reconstructible class attribution remain inspectable without moving bytes or creating a scheduler. registry_lifecycle_simulate carries the same evidence discipline into benchmark publication: attested pack preflight, serialized-index integrity, publish/promote/reassess/supersede/withdraw, lookup/history/revision/verification actions, append-only log state, and continuation indexes are typed while invalid packs and failed operations remain independent fail-closed rows. cache_invalidation_simulate adds the corresponding reproducibility boundary: component-complete key schemas, cross-build policy, declared versus opaque dependency graphs, complete versus partial invalidation, explicit dry-run/application state, reasoned pre/post misses, unproven entries, and attributed reproofs are typed without serving an entry whose currentness cannot be proved. hub_disclosure_review adds the public-hub disclosure boundary: immutable digest-keyed ratchets, contamination witnesses, split-integrity verdict folding, headline caveats, and score-withholding refusals remain distinct and replayable. A clean split verdict does not become a secrecy claim, and a visible benchmark cannot become a bare headline number without explicit acknowledgement. hub_card_render adds the renderer boundary: cards carry moderation-derived publication state, access, verification, provenance, limitations, non-claims, and a tagged published/withheld score; failed disclosure or publication gates preserve the card while keeping its numeric score null. hub_leaderboard_render and bioatlas_publication_audit complete the composed public surface: ranked and unranked entries retain typed reasons and scoped nonclaims, while atlas coverage, evidence-conditioned claims, card score attachment, and explicit release targets remain separate gates with fail-closed blockers. hub_submission_review exposes the preceding acceptance and moderation state machine with append-only events, reasons, verification attestations, and withdrawal tombstones; refusal stages remain explicit, and the endpoint still does not authenticate or publish externally. runtime_execution_simulate runs bounded serialized effect programs against the deterministic in-process world, returns policy and budget evidence, proves complete replay, and can open a forked suffix with observable state and divergence comparison. The Python and TypeScript SDKs expose typed runtime-effect, tape, and simulation projections plus the full bioethics review family, preserving authorization/refusal, simulated provenance, partial replay, physical referral, institutional review, dual-use assessment, validation maturity, and representation gaps across MCP and HTTP without claiming host execution or institutional clearance. megafactory_twin_audit qualifies mechanistic counterfactuals against alternative models while withholding oracle status on sign instability; megafactory_placement_audit checks worker capability, attestation, oracle independence, locality transfer, fencing, and duplicate-effect classes. These remain local contract workflows: they do not provide containers, restoration of external state, real workers, durable fencing, biological calibration, or distributed scheduling. trace_analyze ingests native JSONL trajectories with explicit import loss, while trace_otel_ingest maps bounded OTLP JSON spans into the same Event IR with source preservation, parent resolution, and semantic-loss accounting; the Python and TypeScript SDKs preserve the normalized event preview, mapping counts, loss categories, and compilation-readiness boundary. The trajectory tools validate causal ordering, rank decision-bearing review candidates, and compare lossless passing traces for first divergence. They return review-gated CellProposal previews; they do not replay tools, minimize state, export OTLP, or publish a Decision Cell. lineage_audit checks specimen ancestry, mass, time, material, artifacts, and identity evidence; preanalytic_apply runs the real pre-measurement mutation postconditions, family null control, response availability, and optional caller-threshold detectability. contradiction_review poses multimodal readings, filters admissible explanations, detects answer cues, ranks discriminating evidence, and keeps resolved, not-yet-examined, and unresolvable states distinct without choosing a correct modality. lab_plan orders declared evidence; obligation_gate_check enforces high-regret gates, while atlas_report preserves capability coverage debt, failure inconsistencies, measured-versus-unmeasured holes, and optional gated composites; the Python and TypeScript SDKs keep hole omission, evidence depth, family darkness, and composite refusals visible without rendering unmeasured capabilities as zero. atlas_surface_audit adds the atlasx publication surface: denominator-carrying CapabilityGrid coverage, named debt discharge, withheld failure browsing, explicit rate denominators, and declaration soundness. The SDKs preserve the same layers and fail-closed policy stages; see docs/ATLAS_SURFACE_AUDIT.md. ops_acceptance reports typed operational acceptance findings without turning unverifiable criteria into passes. ops_capacity projects qualified work and demand, refusing unbounded work or silent degradation. bundle_verify recomputes carried result-bundle content and keeps referenced, unrecomputed, and provenance-limited entries explicit; it also accepts an explicit Ed25519 PubliclyAttestedBundle plus verification key, checking purpose, key identity, signed instant, and caller-declared key validity without claiming registry-backed identity or external closure fetching. The complete wire format, threat-model boundary, and SDK/MCP mapping are documented in docs/BUNDLE_SIGNATURES.md. oracle_reference_panel preserves independent reader calls, minority evidence, adjudication blinding, and unresolved splits. oracle_missingness checks missingness informativeness, complete-case admissibility, and small-cell egress under an explicit caller policy. adaptive_panel audits clustered evaluation evidence, selects the next bounded candidate batch, and refuses reportable estimates below coverage or stopping floors; the Python and TypeScript SDKs preserve audit totals, coverage shortfalls, withheld estimates, clustered-versus-naive intervals, selection records, and comparison refusals. posterior_gate keeps capability-level posterior vectors separate from rationale-bearing release scalars, coverage floors, vetoes, and sensitivity; the Python and TypeScript SDKs preserve these layers and typed fail-closed refusals. oracle_combine combines tiered judgements without majority voting, retaining underdetermination, suppressed overrides, inadmissible evidence, and disagreement witnesses; its Python and TypeScript SDK projections now preserve nested oracle identities, admissibility, settlement routes, and resolution state. See docs/ORACLE_COMBINE.md. bioeval_reference_audit validates reference mass normalization and reports distributed truth, modal confidence, entropy, dispersion attribution, unresolved scope, and not-evaluable scope without treating an omitted state as zero or collapsing the reference to a label; the SDKs preserve the typed reference, resolution, and dispersion layers. See docs/BIOEVAL_REFERENCE_AUDIT.md. evaluation_worldline_audit separates future leakage from dangling context references, evaluation_reproduction_check certifies rerun outputs without promoting reproducibility to biological validity, and evaluation_trajectory_check evaluates declared path properties with bounded immediate/downstream suffixes. The SDKs preserve typed accessibility-clock leak witnesses, dangling-reference pairs, ordered reproduction verdicts, reconciled divergence/missing counts, fail-closed validity refusals, step/property/outcome ledgers, recovery transitions, and bounded suffix completeness; see docs/EVALUATION_WORLDLINE_AUDIT.md and docs/EVALUATION_REPRODUCTION_CHECK.md and docs/EVALUATION_TRAJECTORY_CHECK.md. runtime_effect_check authorizes effects under an explicit deny-by-default policy without executing them, while runtime_tape_verify verifies hash-chained world tapes, typed checkpoint restoration and artifact ledgers, simulated provenance, and first divergence. See docs/RUNTIME_TAPE_VERIFY.md. runtime_execution_simulate runs bounded programs in the deterministic in-process world and preserves typed recording/replay, policy-journal, budget, and fork evidence; see docs/RUNTIME_EXECUTION_SIMULATE.md. onco_boundary_check keeps research output separate from individualized clinical use, preserving partial-release counts, escalation routing, and fail-closed identifier refusals; see docs/ONCO_BOUNDARY_CHECK.md. onco_response_assess keeps post-treatment progression, threshold sensitivity, and non-identifiable change states explicit. Its versioned projection separates call kind, unconfirmed reading, treatment-window metadata, criterion divergence, sensitivity flips, and hypothesis identifiability; see docs/ONCO_RESPONSE_ASSESS.md. onco_worldline_view keeps acquisition, recording, release, and agent-visibility clocks distinct, reports indexed biological and record orders, and exposes a versioned visibility partition at a caller-supplied cutoff. Its typed SDK projection rejects forged clock copies, order indices, and leakage partitions; see docs/ONCO_WORLDLINE_VIEW.md. onco_classification_check runs the integrated molecular criteria table without treating uncollected assays as negative, and its typed projection preserves all five resolution states, obligations, satisfied evidence, and panel-state accounting; see docs/ONCO_CLASSIFICATION_CHECK.md. oncoworlds_identity_join checks participant, lesion, specimen, disease-epoch, relation, and permissible-use boundaries and returns a versioned decision record with typed join refusals, evidence counts, and bridge warrants rather than silently discarding cross-modal mismatches; see docs/ONCOWORLDS_IDENTITY_JOIN.md. oncoworlds_model_transport checks whether a model-system result can carry a declared, lossy research claim toward patients and returns a versioned projection of model identity, passage-specific fidelity, establishment selection, technical/biological replication, transport assumptions, and typed fail-closed refusal kinds; see docs/ONCOWORLDS_MODEL_TRANSPORT.md. oncoworlds_methylation_classify preserves QC abstention, threshold, calibration, and tumour-content caveats, while oncoworlds_methylation_compare keeps classifier-version disagreement version-conditioned. Both expose versioned outcome/divergence, threshold, score-coverage, and classifier-change projections; see docs/ONCOWORLDS_METHYLATION.md. oncoworlds_radiogenomic_check checks participant-safe splits, training-only feature fitting, specimen-versus-tumour target scope, mechanism strata, and declared transport assumptions before admitting a cross-modal claim. Its versioned projection retains the blocked sentence, design summary, required/declared transport assumptions, and refusal taxonomy even when support is denied; see docs/ONCOWORLDS_RADIOGENOMIC_CHECK.md. onco_outcome_analyze requires an explicit estimand before interpreting one subject’s follow-up, keeps loss to follow-up and competing death as censoring distinctions, and reports delayed-entry bias. Its versioned typed projection binds endpoint strategy, event/censoring tags, delayed-entry exposure, and complete versus informative bias flags; see docs/ONCO_OUTCOME_ANALYZE.md. oncoworlds_clonal_history_check audits candidate histories against cellular fractions and keeps multiple compatible histories as typed ambiguity rather than selecting one; its versioned projection retains per-candidate refusal kinds and candidate accounting (see docs/ONCOWORLDS_CLONAL_HISTORY_CHECK.md). oncoworlds_clonal_evidence_check extends that boundary to specimen promotion, recurrence- resistance explanation sets, assay sensitivity, declared copy-number conversion, and treatment attribution. It preserves sampled-region bounds and temporal-causation refusal rather than inventing a single phylogeny or treatment mechanism; see docs/ONCOWORLDS_CLONAL_EVIDENCE.md. oncoworlds_entity_world_check composes provenance-selection, alteration-mechanism, rare-class benchmark, lesion-clustering, and competing-event safeguards. Requested sections retain separate admissibility and refusal evidence, while the top-level report reconciles only the requested sections; see docs/ONCOWORLDS_ENTITY_WORLDS.md. literature_bind_check exposes the same fail-closed literature boundary through MCP and both SDKs: binding a source to a scope is not permission to use it as a measurement, and a successful bound claim may be citable only as published_claim_support; see docs/LITERATURE_BIND_CHECK.md. The modality support boundary is documented in docs/MODALITY_SUPPORT_CHECK.md. The modality transport boundary is documented alongside the SDK contracts in docs/MODALITY_TRANSPORT_CHECK.md. The Python and TypeScript SDKs expose the OncoWorlds workflows as typed MCP and HTTP projections, retaining domain refusals, QC abstention, version-conditioned disagreement, transport assumptions, clonal ambiguity, era/site comparability, resource absence, descriptor boundaries, and subgroup intervals without claiming clinical classification or patient-level truth. See docs/ONCOWORLDS_SHIFT_EQUITY.md. stress_profile and stress_report sweep biological stress families and report breaking points, generator defects, confounding, effective sample size, and unresolved measurements without reducing robustness to a single score. The Python and TypeScript SDKs expose both stress workflows with bounded serialized request types and typed projections for the intensity ladder, identifiability, required/probed relations, and guarded worst-family comparison; defective or non-identifiable families remain excluded from that comparison rather than being ranked as if they were evidence. developer_platform_status verifies the cookbook, walkthrough standing, diagnostics, exit-code audit and declared change-impact surfaces while keeping foreign SDK/CI artifacts explicit. The Python and TypeScript SDKs expose that projection with reconciled walkthrough standings, module classification counts, cookbook omission accounting, diagnostic and exit-code rows, declared contract surfaces, foreign-artifact posture, and optional full-detail evidence; a clean local check never implies that foreign SDK, CI, gRPC, or live-debugger surfaces were executed. sdk_registry_check validates serialized plugin manifests, computes whole/core digests, reports attributed trust evidence, and attempts deterministic registry admission under an explicit host policy; invalid declarations and capability conflicts return no partial resolution. The Python and TypeScript SDKs expose both refusal stages and the successful digest/trust/ registration projection without implying dynamic loading, signatures, isolation, or plugin execution. developer_delivery_audit composes those local platform and repository contracts with optional impact, SDK admission, conformance, provider, governance-document, and release evidence. It requires explicit readiness targets, keeps missing foreign SDK/CI artifacts visible, and never turns a partial green result or an unguarded walkthrough claim into a release. workspace_capabilities reports every major biological, evaluation, mutation, safety, orchestration, operations and documentation surface with its actual transport, while repository_catalog/repository_bundle provide bounded, route-aware access to the documentation graph. Documentation bundles preserve protected closure, route defects, traversal completeness and omission influence; requesting rendered markdown is explicit and fails rather than truncating over a caller-supplied limit. repository_impact computes conservative incoming-dependent closure and typed propagation stops for a changed module, with affected task routes retained as explicit invalidation evidence rather than a semantic-diff claim. Cross-domain capability_route responses additionally report per-need candidate domains and an aggregate route_coverage ledger, allowing the agent to see whether its proposed route spans the intended domains before constructing an explicit mission. The Python SDK exposes the same evidence through CapabilityRouteReport.from_wire(...) and sync/async capability_route_report(...) helpers; they reconcile the per-need counts, candidate ledgers, and bounded recommendation overflow while preserving the raw route for audit. capability_route_review then provides a cross-domain handoff checkpoint: it checks caller-selected candidates and dependency waves, emits blocked or ready diagnostics, and keeps mission preflight and execution explicitly separate. Its optional validate_schemas mode reports authoritative selected-tool schema digests and issue paths without turning schema conformance into domain readiness. Every review also carries a deterministic, content-addressed review_id derived from the route provenance, caller selections, and validation mode, making the same handoff correlate cleanly across transports and event records. Modern route responses also attach a separate evidence_digest over the selected candidate-group artifact and workflow-reconciliation postures, registry generations, and bounded counts. Each need retains its candidate_group_evidence rows so discovery can show missing or observed retained evidence before review; this is an advisory point-in-time observation, not an execution, readiness, authorization, scientific-validity, or release claim, and it is intentionally not folded into the catalogue-bound route_id. capability_route_review now validates and carries that digest/scope through evidence_binding, the review identity, and the generated mission draft. Its explicit carried_forward_not_recomputed posture prevents retained discovery observations from being silently dropped or promoted into execution/readiness claims; legacy routes report present: false. capability_route_plan closes the public handoff seam by composing a complete route review with the authoritative mission preflight boundary. It accepts only caller-selected candidates and explicit arguments, carries optional claim/evaluator/workflow bindings, returns the generated mission and plan_digest, and fails closed with dispatch: "not_started" when route review or preflight is blocked. It never dispatches a nested tool or turns routing evidence into authorization; callers must inspect the preflight before invoking agent_mission. capability_route_plan_verify provides the matching non-executing replay boundary: it reruns mission preflight, optionally recomputes route review from caller-supplied inputs, and exposes digest and identity mismatches without treating missing replay inputs as proof of current membership. The reviewed handoff can now be supplied directly as route_review on agent_mission or /v1/missions/preflight. The mission boundary requires the ready review to match the submitted goal and exact serialized steps, binds its review/route/catalogue identities into the plan digest, and retains compact evidence posture without granting permission or readiness. A changed draft, stale finding, or tampered evidence binding is refused before dispatch; legacy no-evidence reviews remain structurally supported with an explicit absent binding. The same reviewed handoff may cross the workflow-template boundary through domain_workflow_instantiate. After normalized steps are constructed, the generated mission retains the exact route review; the durable queue exposes only its spec_digest and compact provenance, mission checkpoints preserve that projection across restart, evaluator replay marks it absent, valid, or invalid, and workflow reconciliation compares it against the instantiated workflow. These joins add integrity evidence without turning route review into authorization, execution, or a domain conclusion. domain_workflow_catalogue closes the next gap between discovery and planning: it materializes one deterministic, digest-bound workflow template for each of the 29 capability groups, including available versus missing tool definitions, per-tool schema/evidence contracts, and advisory lexical stages. Every template also carries a domain contract that makes scope review, tool availability, argument preflight, execution policy, evidence retention, refusal/omission accounting, and completion review explicit without inventing domain semantics. domain_workflow_instantiate requires an explicit workflow, mission, goal, and step list; it refuses tools outside that group's declared scope or absent from authoritative tools/list, rejects out-of-scope policy allow-lists, validates the mission DAG, derives a least-scope allow-list for requested execution, emits a step-level evidence plan, and attaches authoritative no-dispatch MCP schema preflight. MCP, REST, CLI, Python, and TypeScript all expose the same kernel. A valid workflow remains a plan, not permission, scientific evidence, clinical guidance, deployment readiness, or execution. domain_workflow_scaffold is the bounded planning shortcut across the same 29 groups: it selects one live available tool per advisory stage by default, or accepts an explicit tool list and per-tool argument map, then materializes a deterministic domain_workflow_instantiate payload. Each catalogue tool contract carries bounded argument-schema facts, and the scaffold runs the authoritative MCP preflight before returning. Missing required arguments are an explicit blocked preflight result; they are never replaced with benign defaults. The response always preserves execution: "not_started", dispatch: "not_started", and readiness_claimed: false, so this convenience surface cannot silently become an executor or readiness credential. MCP, REST, Python, and TypeScript expose the same scaffold contract. The instantiated mission also carries a bounded workflow_binding containing the workflow, catalogue, domain-contract, and evidence-plan digests plus the contract snapshots needed to reconstruct that exact scope after dispatch. The binding is validated as structure and provenance; it is not an authorization token, readiness claim, or domain conclusion. domain_workflow_portfolio composes up to 64 explicit workflow instantiations for multi-domain planning. It runs each group independently, adds authoritative no-dispatch preflight, retains per-item refusal diagnostics, and makes complete-catalogue versus partial scope explicit. A portfolio can be inspected as a whole without hiding the domain-specific arguments that still need caller completion; portfolio_ready never grants execution or domain validity. The CLI exposes the same boundary as bioprism workflow portfolio --requests <path>, accepting either a JSON request array or an object with requests and optional policy; --allow-partial and --require-complete-catalogue make the two most important scope decisions visible in shell automation. A blocked portfolio returns its full per-item diagnostics in --json mode and uses the assertion-failed verdict when it is not ready, while preserving dispatch and execution as not_started. domain_workflow_portfolio_verify is the retained multi-domain audit continuation: it recomputes the portfolio digest and coverage, verifies every retained item independently, optionally replays an index-aligned array of original requests, and retains digest, identity, replay, and mission preflight mismatches per item. The CLI exposes this as workflow portfolio-verify --portfolio <path> [--replay-requests <path>] [--require-replay]; REST, MCP, Python, and TypeScript expose the same bounded contract. Verification remains review evidence only: it never dispatches, retries, resumes, grants readiness, or establishes domain validity. domain_workflow_verify is the retained-handoff gate before re-review: it validates the current catalogue and contract identities, checks the workflow binding and mission projection, reruns authoritative mission preflight, and optionally replays the original bounded instantiation request. It reports exact mismatch codes with compact digest witnesses, distinguishes full replay from verified_without_replay, and remains strictly non-executing with dispatch and execution both not_started. developer_workbench_verify provides the analogous authoring/notebook handoff audit: it recomputes the current session audit, replays a retained dashboard query, and optionally replays the original CI request while comparing report and audit digests. MCP, POST /v1/developer-workbench/verify, the CLI (bioprism workbench verify), Python, and TypeScript expose the same mismatch witnesses and policy controls. It never executes cells, writes YAML, contacts GitHub, runs CI, or grants release or domain authority. The retained workbench registry makes that audit durable without pretending to be a workbench database: developer_workbench_import, developer_workbench_query, and developer_workbench_get accept only structurally valid, digest-normalized reports, provide deterministic digest-ordered filters/cursors, and return full reports only when explicitly requested. The same contract is available at POST/GET /v1/developer-workbench/reports and GET /v1/developer-workbench/reports/{workbench_report_digest}, with atomic restart-safe checkpointing via --workbench-state and explicit persistence status/flush routes. The CLI provides workbench import, workbench query, and workbench get; Python and TypeScript expose typed MCP and REST facades. The registry is bounded to 512 reports and a 32 MiB snapshot, verifies every report and snapshot digest on import/restore, and never executes, re-evaluates, or authorizes the retained workbench output. domain_workflow_reconcile is the corresponding post-execution audit: it binds a retained agent_mission report or verified evidence bundle back to the instantiation, checks plan/result/ trace consistency, preserves refusals and omissions, and makes structural completion readiness explicit without retrying or dispatching tools. Its complete status is evidence posture only and still requires review before any domain claim. The reconciliation registry continuation makes that audit durable and searchable: import a digest-valid report through POST /v1/domain-workflows/reconciliations, query compact mission/workflow/plan/status index rows with bounded cursors, and fetch one record by its reconciliation_digest. --reconciliation-state <file> enables an atomic restart-safe checkpoint; startup verifies the snapshot and every report digest, while the explicit persistence status/flush routes expose the checkpoint posture. MCP exposes the same import/query/get tools, the CLI provides workflow reconciliation-import and workflow reconciliation-query, and the Python/TypeScript SDKs expose typed REST and MCP helpers. Registry presence is an audit lookup only: it never resumes, retries, or re-evaluates a mission and never authenticates provenance or a scientific, clinical, safety, or release claim. When an executable mission includes a valid workflow_binding, the authoritative MCP executor automatically runs this structural reconciliation after terminal execution and imports the full digest-valid record into the shared REST/MCP registry. The mission response exposes only a compact workflow_reconciliation link, completion/evidence/integrity posture, and idempotent import result; the full record remains available through the reconciliation lookup route. A reconciliation failure is retained as an explicit fail_closed response and never upgrades mission success into readiness. API synchronous calls checkpoint this shared registry before returning when reconciliation persistence is configured; asynchronous mission workers checkpoint it before publishing terminal job state. This makes the same post-dispatch audit visible to operations gates and restart recovery without making a gate pass automatic. The same artifact index is checkpointed by synchronous REST/MCP dispatch and asynchronous mission workers when --artifact-state is configured. Automatic indexing is an audit projection only: it does not add provenance, scientific validity, authorization, or release readiness. mission_evaluator_discover complements tool routing with a digest-bound catalogue of explicit evaluator candidates for every workspace capability group. It filters by intent, group, domain, mission level, or adapter ID and returns purpose, candidate evidence tools, and RFC 6901 pointer examples. Every row is marked candidate_only: discovery never runs an evaluator, validates domain semantics, or adjudicates a claim. The Python and TypeScript SDKs expose the same typed projection so callers can choose an adapter before adding an explicit evaluator_bindings row to agent_mission. mission_evaluator_review is the non-executing checkpoint after discovery: it binds caller-selected claim IDs to digest-fresh candidate adapters, validates candidate membership, domain support, unique selection IDs, per-claim limits, and RFC 6901 output pointers, then returns either a ready binding scaffold or bounded correction findings. A ready review still requires agent_mission validation; the checkpoint never executes an evaluator or a domain tool. mission_evaluator_replay is the non-executing audit after mission completion: it rechecks retained adapter/domain rows, output-digest shape, outcome counts, disagreement posture, refusal/omission states, and structural coverage against all 29 evaluator groups. It can emit four non-semantic fixture variants for every adapter, while preserving execution: "not_started"; replay is an audit and coverage instrument, not evaluator execution or a scientific/clinical/release verdict. The durable HTTP route /v1/missions/{mission_id}/evaluator-replay adds bounded restart-aware querying: retention.mode: "full" exposes the retained replay, while "summary_only" exposes digest, count, coverage, finding, and omission evidence after a large report body is trimmed. Python and TypeScript clients preserve this distinction in typed query helpers; neither mode reconstructs raw output or dispatches an evaluator. The adjacent /evaluator-replay/compare route detects catalogue-digest drift and checks whether referenced adapters remain bound in the current catalogue. It deliberately reports the boundary between digest-level comparison and exact historical row diffs. Reviews now retain a bounded, content-addressed snapshot of all 29 adapter rows, so valid snapshots produce exact added/removed/ changed/unchanged IDs and changed-field lists; legacy digest-only checkpoints remain explicit about their row-diff limitation. The durable /evidence-bundle route then exports mission status, retention and omission proofs, optional raw result/trace, replay, catalogue drift, execution provenance, navigable links, and a deterministic bundle digest in one bounded artifact. POST /v1/evidence-bundles/verify and the MCP mission_evidence_bundle_verify tool recompute that artifact's canonical and retained-result digests without executing any domain or evaluator tool. Both routes remain structural and non-executing, and the Python/TypeScript SDKs expose the same comparison, export, and verification contracts. The registry continuation adds POST /v1/evidence-bundles for independently verified, idempotent import; digest-ordered mission/domain queries; content-hash lookup; and an atomic restart-safe checkpoint enabled with --evidence-state <file>. MCP exposes the same import/query/get kernel and the CLI provides evidence import and evidence query. Restored bundles are reverified but never resume execution or become provenance, scientific, clinical, or release claims. capability_dashboard provides the bounded operator view beneath those routes: it binds the live catalogue to authoritative MCP schemas, reports callable/partial/declared-only groups, keeps crate/CLI/Python/MCP surface counts separate, and labels missing transports without pretending a declared surface has been executed. Its dashboard_digest, filters, and truncation warnings make the inventory reproducible before a caller selects tools for a mission; see docs/CAPABILITY_DASHBOARD.md. Mission/delegated-check handoffs are similarly available through the digest-bound docs/EXECUTION_PROVENANCE.md projection. ci_execution_evidence_audit closes the next authoring boundary: it regenerates the canonical workbench CI plan, binds caller-supplied run evidence to its digest and exact check set, requires per-check result digests, and keeps provider/caller provenance separate from structural verification. Complete passing evidence can produce a bounded ci_evidence_ready handoff signal, never a claim that GitHub was contacted, logs were fetched, a signature was verified, or deployment/scientific validity was established. ci_provider_normalize accepts a bounded GitHub Actions-shaped, GitLab CI, or generic provider payload and projects it into the exact CiRunEvidence envelope consumed by that audit. Missing provider result digests are derived from the supplied check object and labeled, while unknown and non-passing states remain visible; normalization never contacts a provider, verifies signatures, fetches logs, or turns caller-supplied data into authenticated execution truth. For GitHub consumers, the repository also provides the dependency-free composite action github-actions-evidence. It supports both a manual bounded checks file and an authenticated discovery mode that retrieves one run and its jobs through the GitHub API. With collect-evidence: true, discovery also retrieves at most 128 artifact metadata rows and derives bounded job-log locators from the job response; neither locator is followed by default. An explicit download-evidence: true switch follows those HTTPS locators (or manual artifact/log URIs) under 16 MiB per response and 256 MiB per collection, then replaces the row digest with SHA-256 over the locally retrieved response bytes. Rows retain an explicit digest scope (provider_metadata, caller_declared, or local_response_bytes), and optional attestation subject_digest values are checked against the named row or run digest. Redirects remain HTTPS-only and never receive the GitHub token. Archives are not extracted, logs are not interpreted, and attestations are not signature-verified. Both modes produce the same canonical provider payload and digest, while collection mode emits a separate envelope/digest, row counts, and stable download mode/count/byte outputs. Oversized or partial job, artifact, or locator lists are refused, and the token is never copied into any output. When a caller also supplies an explicit ci plan and evidence-output, the action emits the exact CiProviderEvidenceRequest accepted by the Rust provider-evidence audit/registry. This remains an ingestion handoff: metadata or local-byte digests are not authenticated provider truth, checks are not executed, and no release is approved; see docs/CI_EVIDENCE.md. ci_provider_evidence_audit extends the same handoff with bounded artifact, log, and attestation rows: it validates unique ids, content-digest syntax, provider/run/check bindings, and attestation subjects, preserves the original rows, and emits separate deterministic record digests. Its conformance_ready signal is structural only; the route does not fetch remote bytes, execute checks, authenticate providers, or cryptographically verify attestation statements. The retained provider-evidence registry makes this handoff durable and joinable: imports re-run the canonical audit, retain failed and unknown provider runs as explicit evidence, and expose deterministic provider/run/plan queries plus exact digest lookup through MCP, REST, CLI, Python, and TypeScript. The response carries separate artifact/log/attestation counts and record-family digests, while preserving the boundary that provider locators are not fetched bytes and supplied digests are not verified signatures. --ci-provider-evidence-state enables atomic restart-safe persistence with 512-record, 32 MiB snapshot, and 256-row query bounds; snapshot and per-record digests are checked on restore. Import summaries and compact query rows also retain local-byte hash and attestation subject-digest binding counts, and queries can require minimum thresholds for those counts without loading full audits. This makes provenance posture queryable while keeping it distinct from provider authentication. The registry remains an audit index: it never contacts GitHub/GitLab, executes CI, or grants release authority. developer_delivery_audit can compose that normalization directly through an explicit ci_provider argument; it returns both the normalized provider projection and the downstream ci_evidence audit, while rejecting simultaneous ci_provider and canonical ci_evidence inputs. The deeper ci_provider_evidence argument composes artifact, log, and attestation conformance into an independent delivery target; developer_delivery_receipt carries its complete projection digest, and developer_delivery_receipt_verify detects tampering in that retained evidence row. The three provider evidence paths remain mutually exclusive and structural-only. When a delivery decision needs this signal, developer_delivery_audit accepts the exact ci_evidence payload and exposes a separate ci_execution_evidence target; missing evidence blocks that target without changing the semantics of other delivery targets. The same delivery audit accepts an optional execution_provenance payload and exposes an independent execution_provenance target, so callers can require mission-trace handoff, CI evidence, or both without conflating structural evidence with execution authority. execution_provenance_audit closes the adjacent mission handoff: it reconciles the returned plan, terminal results, deterministic trace, and delegated check digests into one structural artifact. It flags missing, duplicated, or identity-mismatched evidence, but never replays the mission or upgrades caller/provider evidence into execution authority. developer_delivery_receipt turns the resulting delivery audit into a deterministic, content-addressed structural handoff with canonical target/evidence rows and joinable digests; it still does not execute checks, contact providers, or approve a release. developer_delivery_receipt_verify recomputes that handoff against a completed delivery audit and surfaces tampering by dimension, so downstream consumers can verify record consistency without mistaking it for provider authentication or release authority. Typed discovery projections now preserve the complete matched group context—domains, Rust crates, CLI entrypoints, Python artifacts, ranked fields, matched tools, catalog digest, and optional authoritative tool schemas—so cross-domain routing can inspect coverage without falling back to unvalidated nested JSON. The HTTP boundary exposes that evidence through exact review_id filtering on event pages and a bounded /v1/route-reviews/{review_id}/evidence lookup; the Python and TypeScript SDKs provide typed helpers while preserving retention gaps and the explicit “not found in retained window” meaning of an empty result. Delivery receipts have the parallel /v1/delivery-receipts/{receipt_id}/events join and receipt_id event filter; oversized tool responses retain only a bounded receipt projection, never an unverified release claim.

Evaluating a context policy

./target/release/bioprism prism fork --world w.json --query q.json --bundle-out bundle.json

Freezes a Decision Cell from the full-context verdict, then runs every architecture from that identical state — so a difference is attributable to the context policy and nothing else. On the discriminating world:

Architecture Facts Verdict Closure Cell
fiber 11 invalid 100% pass
full-context 762 invalid 100% pass
graph-5-hop 750 valid 0% fail
lexical-top-11 11 invalid 91% fail

Exit 1 when any architecture fails, so it gates CI. Acceptance is set-valued (03.07) and names its failure mode: graph-5-hop fails on verdict, lexical-top-11 on closure.

./target/release/bioprism prism minimize --world w.json

Reduces the world to a 1-minimal set preserving the oracle signature, then re-verifies it. On the reference world: 761 facts → 6, in 762 oracle evaluations.

That 6 is worth reading carefully against FIBER's 11. Only six facts are causally required for the verdict; the other five are protected-closure facts that participate in no witness. FIBER is deliberately not minimal — 43.13 makes identity, policy and negative-evidence closure mandatory whether or not it moves this particular decision. Minimization measures what the verdict rests on; closure decides what must be present regardless.

Composing agents

bioprism-weave is the microkernel of §23 — a deliberately small trusted computing base that enforces what cannot be delegated to untrusted participants and refuses to do anything else. Per 23.49 it "should not decide scientific truth, write patches, plan tasks, summarize evidence, or choose a model", and it does not: it never inspects an act's payload for meaning.

What it does enforce, each with a conformance test named after it:

  • typed acts — you cannot accept what was not proposed, challenge what was not claimed, or discharge what was not accepted, and a commitment cannot be discharged twice;
  • rejected acts never enter the ledger — an unauthorised or unfunded move must not be able to write history;
  • attenuating authority — delegation can only narrow, and revocation is transitive over the whole subtree;
  • affine budgetsBudget does not implement Clone, so duplicating an allowance is a compile error rather than a runtime check; splitting moves it;
  • hash-chained ledgers — claims and their challenges both survive; contradiction is preserved, not resolved into a score;
  • continuations — a handle bound to a stale ledger head is refused rather than silently rebased; forking from a superseded point is the supported move.

Where Weave meets FIBER is the Context Capsule. A capsule is a recipient-specific projection of a compiled Decision Section, so it inherits the certificate: a participant learns what the compiler omitted from the world and, separately, what the projection withheld from it. A filtered capsule reports supports_sufficiency_claim: false regardless of the compiler's own verdict — a participant reasoning from a partial view cannot vouch for completeness it never observed.

Generating a benchmark family

./target/release/bioprism mutate family --world w.json --out-dir family/

Applies eight metamorphic relations, each declaring what the oracle must do — four invariances (rename, reorder, add distractors, camouflage tags) and one repair per leakage mechanism. A mutation does not get to mark its own homework: the postcondition is checked by running the oracle, and a mutation whose declared relation does not hold is rejected rather than shipped.

The headline number is deliberately not the instance count:

8 validated instances from 1 audited parent across 8 mutation families,
providing 8 independent equivalence classes (inflation ×1.00).
Instance count is not benchmark count.

An equivalence class is a distinct (parent, mutation family, oracle signature) triple — a counted quantity, not a modelled one. Generate twenty reorderings of the same world and you get twenty instances, one equivalence class, and an inflation ratio of ×20; the family is reported as a robustness check rather than a benchmark. This is the executive summary's constraint made operational: a million paraphrases are not a million benchmarks.

Deduplication hashes semantic content — facts, factors, events — and deliberately not world_id, so a generator cannot defeat it by renaming.

What is deliberately not implemented

The blueprint describes far more than exists here, and the gap is reported by the software rather than buried in prose. Every compile returns deferred_passes, and bioprism context explain prints them:

Pass Why it cannot run
Gluing and obstruction tests (43.06) Requires a declared cover; fiber-world/0.1 carries none
Abstract interpretation (43.11) Requires an abstract-domain registry absent from the wire schema
FIBER wire integration of decision-equivalence quotient (43.10) fiber-query/0.3 now carries a bounded explicit loss/utility matrix and permitted-action boundary, and FIBER executes the exact quotient; 0.1/0.2 remain deferred
FIBER wire integration of rate-distortion optimisation (43.12) fiber-query/0.4 now binds a normalized prior, ordered observed evidence pool, compatibility floor and tolerance; FIBER executes identification, exhaustive frontier and minimal sufficiency. The 16-item bound and caller-declared model inputs remain explicit
FIBER wire integration of adaptive acquisition (43.15) fiber-query/0.5 now binds a normalized prior, complete outcome likelihood partitions, scalarized path budget, and finite horizon; FIBER executes the exact policy under 16/16/65,536 caps and returns certificate-bound planning provenance. It does not schedule, authorize, execute, or receipt an acquisition

The backend portfolio of 43.19–43.24 (FAQ/InsideOut, worst-case-optimal joins, tensor networks, decision diagrams, incremental view maintenance) is not built. Backend enumerates them so the plan descriptor is honest about which one ran; only backward_factor_slice_reference exists today.

Per 43.43, nothing here claims to have invented sheaves, factor graphs, semirings, tensor networks, abstract interpretation, rate-distortion theory, or database query optimisation.

Two honesty mechanisms worth knowing about

Zero influence is not unknown influence. The omission manifest classes every omitted group as zero, bounded, inaccessible_by_policy, deferred_acquisition or unknown. Only zero and bounded support a sufficiency claim; a single unknown group voids it. The reference v0.1 certificate has one classification string for all omissions and cannot express this, which is why --profile extended exists.

Zero-influence claims state their assumption. Facts with no backward dependency path are classed zero conditional on the declared factor graph being complete — the reason string says so, because an incomplete factor graph turns a zero-influence claim into an unknown-influence one.

Defects found in the v0.6 distribution

  1. machine/module_registry.jsonl is stale and omits FIBER entirely. It carries 935 rows and zero from section 43, while context_cards.jsonl and doc_graph.json both carry all 51 FIBER modules (994 rows each). machine/README.md claims one row per module. Any agent routing off the registry never sees the canonical runtime.
  2. The reference runtime hard-codes a radiogenomic goal string into every Decision Section, and compares label timestamps lexicographically as strings rather than as parsed instants. Both are reproduced for parity, both are flagged: see REFERENCE_GOAL in qir.rs and the note on temporal_witnesses in oracle.rs.

Only 131 of the 935 registered modules are marked Build-Ready Specification; 400 are Planned. Sections 01–19 and 23–29 are 0% build-ready, including 03_CORE_SPECIFICATIONS, all 50 files of 23_AGENT_INTERWEAVE_FABRIC and all 24 of 25_BIOLOGICAL_IR_AND_LANGUAGE. Those need design work before implementation, not just coding.

Repository layout

crates/           the workspace, bottom of the dependency DAG first
  ids/            canonical serialization + hashing + typed ids  (no internal deps)
  scope/          typed scope base                               (ids)
  world/          FIBER world model                              (ids, scope)
  section/        Decision Section + Context Certificate         (ids)
  fiber/          the query compiler                             (ids, scope, world, section)
  baseline/       equal-engineering comparators                  (ids, world, section, fiber)
  worldgen/       synthetic structural benchmark families        (world)
  store/          content-addressed indexed storage              (ids, scope, world)
  mcp/            Model Context Protocol server                  (fiber, section, store, world)
  prism/          decision-state evaluation                      (baseline, fiber, section, world)
  weave/          the multi-agent microkernel                    (ids, section)
  mutation/       metamorphic instance generation                (fiber, section, world)
  cli/            the bioprism binary                            (all)
docs/             ARCHITECTURE, FINDINGS, COVERAGE, the ADRs, and generated comparisons
fixtures/         golden worlds, queries and reference artifacts
reference/        the CPython reference runtime, vendored as the parity oracle
schemas/          fiber-world / fiber-query / fiber-context-certificate JSON Schemas
tools/            golden regeneration and ground-truth generation

section deliberately depends on neither world nor fiber: a consumer — an MCP client, an evaluator, a CI gate — must be able to read and verify a compiled context without linking the engine that produced it.

Development

cargo test --workspace --offline
cargo clippy --workspace --all-targets --offline
python tools/regenerate_golden.py

The last one re-derives the golden artifacts from the CPython reference. A diff there is a change to the wire format and needs a schema version bump.

Builds are offline by default (.cargo/config.toml) against pinned dependency versions.

Boundary

Research and developer infrastructure. It does not diagnose an individual, recommend treatment, triage care, autonomously enroll participants, or claim medical-device functionality. Compression or abstraction never authorizes crossing a data-use, consent, privacy, or clinical boundary.

Engineering manifest audit

The engineering_manifest_audit route adds the build-ready engineering artifact surface: technology baseline, package dependency topology, ticket-to-package contracts and readiness, ADR supersession, RACI ownership, independent-review separation, canonical digest, and explicit warning/blocking issue semantics. It validates declared coherence only; it does not inspect a checkout, run CI, query Git

from github.com/AURORA-NEURO/aurora-agent

Установка Aurora Agent

У этого сервера нет опубликованного пакета — он собирается из исходников. Открой репозиторий и следуй инструкции в README.

▸ github.com/AURORA-NEURO/aurora-agent

FAQ

Aurora Agent MCP бесплатный?

Да, Aurora Agent MCP бесплатный — установка в пару кликов через Unyly без оплаты.

Нужен ли API-ключ для Aurora Agent?

Нет, Aurora Agent работает без API-ключей и переменных окружения.

Aurora Agent — hosted или self-hosted?

Self-hosted: сервер запускается локально на твоей машине командой из раздела установки.

Как установить Aurora Agent в Claude Desktop, Claude Code или Cursor?

Открой Aurora Agent на unyly.org, выбери вкладку своего клиента (Claude Desktop, Claude Code, Cursor) и нажми Install — конфиг сгенерируется автоматически, без правки JSON.

Похожие MCP

Fetch

Web content fetching and conversion for efficient LLM usage.

автор: Community

Roblox Studio

Enables AI coding tools to control Roblox Studio for workspace exploration, instance manipulation, and script management. It provides tools for playtesting, sce

paralovавтор: paralov

Opencode Omniroute Plugin

OpenCode plugin for the OmniRoute AI Gateway. Drives dynamic model discovery, /connect auth flow, and multi-instance OmniRoute providers via the official @openc

GitHub Actionsавтор: GitHub Actions

AWS KB Retrieval

Retrieval from AWS Knowledge Base using Bedrock Agent Runtime.

modelcontextprotocolавтор: modelcontextprotocol

Spring AI MCP Server

Provides auto-configuration for setting up an MCP server in Spring Boot applications.

автор: Community

llm-analysis-assistant

A very streamlined mcp client that supports calling and monitoring stdio/sse/streamableHttp, and can also view request responses through the /logs page. It also

xuzexin-hzавтор: xuzexin-hz

MCP-Agent

A simple, composable framework to build agents using Model Context Protocol by [LastMile AI](https://www.lastmileai.dev)

lastmile-aiавтор: lastmile-ai

Spring AI MCP Client

Provides auto-configuration for MCP client functionality in Spring Boot applications.

автор: Community

mcp.natoma.ai

A Hosted MCP Platform to discover, install, manage and deploy MCP servers by [Natoma Labs](https://www.natoma.ai)

автор: Community

MCPHub

Website to list high quality MCP servers and reviews by real users. Also provide online chatbot for popular LLM models with MCP server support.

автор: Community

Compare Aurora Agent with

Не уверен что выбрать?

Найди свой стек за 60 секунд

Автор?

Embed-бейдж для README

Похожее

Все в категории ai