Source map¶
The source map ties each blueprint requirement to its schema, service, command and generated artefacts so readers can locate the implementation and its proof surface.
Requirements to files¶
| Requirement | Primary files |
|---|---|
| Source evidence is immutable | docs/pipeline/00-intake-and-sources.md, schemas/source-asset-manifest.schema.json, src/asset_factory_blueprint/services/source.py |
| Project workspaces are durable | docs/project-workspaces.md, src/asset_factory_blueprint/services/project.py |
| Stage execution is typed and immutable | configs/stage-contracts.json, schemas/stage-attempt.schema.json, src/asset_factory_blueprint/execution.py |
| Cross-record identity and checksum links validate | src/asset_factory_blueprint/validation.py, afb project validate |
| Provider output stays proposal material | docs/provider-abstraction.md, configs/provider-policy.json, src/asset_factory_blueprint/providers.py |
| Reconstruction backends use declared manifests | docs/platform/external-model-runners.md, configs/reconstruction-backends.json, scripts/reconstruction/run_reconstruction_backend.py |
| Segmentation is recorded with stable ids | docs/pipeline/02-segmentation.md, schemas/segmentation-manifest.schema.json, src/asset_factory_blueprint/services/segmentation.py |
| Material and physical inference is recorded | docs/pipeline/03-material-inference.md, schemas/material-inference-manifest.schema.json, src/asset_factory_blueprint/services/material_inference.py |
| Texturing and decals are recorded | docs/pipeline/04-texturing.md, schemas/texturing-manifest.schema.json, src/asset_factory_blueprint/services/texturing.py |
| Physics, articulation and grasp affordances are file-backed | docs/pipeline/05-physics-articulation.md, schemas/physics-articulation-manifest.schema.json, src/asset_factory_blueprint/services/physics_articulation.py |
| Nonvisual materials carry evidence and uncertainty | docs/pipeline/06-nonvisual-materials.md, schemas/nonvisual-material-manifest.schema.json, src/asset_factory_blueprint/services/nonvisual_materials.py |
| SimReady status is a promotion decision | docs/pipeline/07-simready-verification.md, schemas/simready-asset-manifest.schema.json, src/asset_factory_blueprint/services/simready.py |
| RL environments implement the accepted PhysX pick-task contract | docs/extensions/rl-environment.md, docs/design-decisions/rl-runtime-evidence-boundary.md, schemas/rl-environment-manifest.schema.json, skills/rl-environment-design-lead/references/environment-manifest-shape.md |
| RL probe, fidelity and render tooling produce and consume attested evidence | src/asset_factory_blueprint/rl_runtime_probe.py, src/asset_factory_blueprint/rl_collision_fidelity.py, src/asset_factory_blueprint/rl_probes.py, src/asset_factory_blueprint/rl_fidelity.py, src/asset_factory_blueprint/rl_render.py, src/asset_factory_blueprint/rl_probe_import.py, schemas/rl-probe-evidence.schema.json, schemas/rl-collision-fidelity.schema.json |
| Documentation citations resolve against one bibliography | references.bib, docs/references.md, scripts/docs/bibliography_hook.py, docs/assets/citation-style/harvard-cite-them-right.csl |
| Governance is required for release | docs/platform/governance.md, schemas/governance-record.schema.json, src/asset_factory_blueprint/services/governance.py |
| Operator decisions bind the current run, Profile and use | schemas/operator-release-decision.schema.json, src/asset_factory_blueprint/governance_decisions.py |
| Publication evidence is redistributable and verifiable | schemas/reference-run-capsule.schema.json, src/asset_factory_blueprint/capsule.py, docs/reference-run-capsule.md |
| Dependency and software evidence are locked | uv.lock, src/asset_factory_blueprint/release_evidence.py, RELEASE.md |
| Provenance is interoperable | schemas/provenance-record.schema.json, src/asset_factory_blueprint/provenance.py, projects/<slug>/provenance.prov.jsonld |
| Network tool execution is bounded and authorised | src/asset_factory_blueprint/tool_server.py, src/asset_factory_blueprint/service_approval.py, docs/platform/deployment.md |
Proof commands¶
afb format --check README.md docs skills deploy schemas configs scripts src pyproject.toml
afb provider check --policy configs/provider-policy.json
afb skill-audit --root . --output artifacts/skill-audit.json
uv lock --check
afb project validate --project projects/<slug>
afb release evidence --output-dir artifacts/release-evidence
Pytest suites and the reproducibility benchmark run from this repository (tests/, benchmarks/) and in .github/workflows/ci.yml.
Diagram reproducibility¶
The diagram set is generated by scripts/generate_diagrams.py. Check mode detects missing or changed SVG outputs registered by the generator; repository CI runs the drift gate directly.