Maintainer Map¶
Use this page when changing TopoExec rather than only consuming it.
Local Development Flow¶
- Read Codebase map for source ownership.
- Check the relevant semantic or API page before editing runtime behavior.
- Add or update focused tests for changed behavior.
- Run the focused goal check when available.
- Run
scripts/agent_check.shbefore declaring repository changes complete.
Common Change Routes¶
- Runtime semantics: Runtime semantics, Semantic contract, Runtime invariant coverage.
- Public API: API overview, Public API stability, API change checklist.
- Graph schema: Schema v1, Schema v2 notes.
- CLI or editor tooling: CLI, Editor and schema UX.
- Testing and release: Testing strategy, Build and package, Release runbook.
- Planning history: Goal backlog, Goal status.
Required Boundary¶
Keep the runtime target small and embeddable. Adapter previews, C API, Python automation, plugin loading, YAML loading, and CLI tooling must remain optional surfaces outside the core runtime dependency boundary.