infospace-bench/docs/infospace-layout.md

Infospace Layout

An infospace is a file-backed project rooted at:

infospaces/<slug>/

Required Files

infospace.yaml
artifacts/index.yaml

infospace.yaml declares identity, topic, schema references, workflow references, discipline bindings, and viability thresholds. artifacts/index.yaml is the deterministic manifest of artifacts that have been added to the infospace.

Required Directories

artifacts/sources/
artifacts/entities/
artifacts/relations/
artifacts/generated/
workflows/templates/
output/evaluations/
output/metrics/
output/engine/sync-runs/
output/workflows/runs/
reports/
exports/

Artifact Manifest

Artifacts are represented by stable IDs such as source/chapter-01.md.

Each manifest entry records:

• id
• path
• kind
• title
• provenance
• relationships

The manifest is intentionally plain YAML so it can be inspected, diffed, and regenerated by tools or agents.

Commands

python3 -m infospace_bench create . pilot --name "Pilot Infospace"
python3 -m infospace_bench add-artifact infospaces/pilot ./source.md --kind source
python3 -m infospace_bench inspect infospaces/pilot
python3 -m infospace_bench export infospaces/pilot