# Vapor Roadmap

Status: active planning surface.

This is the root roadmap. It lists the current roadmap chapters in dependency order. Each chapter owns its own folder and may grow deeper folders when the topic needs it.

Unresolved entries are not implementation approval. Current code and repo-local config define implemented behavior. Owner answers and ledger files are the source trail for accepted direction.

## Chapters

1. [Documentation substrate](01-documentation-substrate/README.md)
2. [Repository topology](02-repository-topology/README.md)
3. [Steam root and self-bootstrap](03-steam-root-self-bootstrap/README.md)
4. [Toolchain portability and targets](04-toolchain-portability-targets/README.md)
5. [Workspace execution and hermeticity](05-workspace-execution-hermeticity/README.md)
6. [Manifest, lockfile, artifact, and fingerprint](06-manifest-lockfile-artifact-fingerprint/README.md)
7. [Packs, capability, Rhai, and runtime concepts](07-packs-capability-rhai-runtime/README.md)
8. [Workshop, registry, trust, and install ledger](08-workshop-registry-trust-install-ledger/README.md)
9. [Command surface and safety](09-command-surface-safety/README.md)
10. [Code cleanup and maintainability](10-code-cleanup-maintainability/README.md)

The order is topological, not a promise that work happens one chapter at a time.

## Current Active Work

The active child branch is glossary migration:
`ai_conversation_logs/decision_ledger_020/branches/glossary_migration/`

Roadmap owner:
[Documentation substrate](01-documentation-substrate/README.md)

Next concrete output:
finish enough glossary migration answers to produce an inventory and migration packet.

## Rules

- Keep this root page short.
- Put detail in the chapter folder that owns it.
- Split a chapter into deeper folders when one page stops being straightforward.
- Do not turn roadmap text into stable doctrine unless the owner has approved that promotion.

## Source Trail

- `ai_conversation_logs/decision_ledger_020/020d_referee_queue.txt`
- `ai_conversation_logs/decision_ledger_020/branches/roadmap_hierarchy/020d-rm-a_root_roadmap.md`