generated from coulomb/repo-seed
61 lines
1.2 KiB
Markdown
61 lines
1.2 KiB
Markdown
# Infospace Layout
|
|
|
|
An infospace is a file-backed project rooted at:
|
|
|
|
```text
|
|
infospaces/<slug>/
|
|
```
|
|
|
|
## Required Files
|
|
|
|
```text
|
|
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
|
|
|
|
```text
|
|
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
|
|
|
|
```bash
|
|
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
|
|
```
|