Task: Implement the add command
This page documents a task in the ores.compass Scaffold — agile authoring over codegen story. It captures the goal, current status, acceptance, and any notes or results.
Goal
Add a compass add <type> [flags] command that creates a v2 document by
calling ores.codegen's v2_doc_generate as a library, defaulting
--parent-dir from the current sprint/version via Locate where the
choice is unambiguous.
Status
| Field | Value |
|---|---|
| State | DONE |
| Parent story | ores.compass Scaffold — agile authoring over codegen |
| Now | Implemented and smoke-tested. |
| Waiting on | Nothing. |
| Next | Review. |
| Last touched | 2026-05-24 |
Acceptance
compass add story|task|sprint|...creates the artefact viav2_doc_generate.main([...])(in-process import, not a subprocess, not a copied generator).add storywith no--parent-dirlands in the current sprint;add sprintin the current version;add taskrequires explicit--parent-dir.add --helpdocuments the usage;pystacheis declared in compass'srequirements.txt(onlyaddneeds it).where/search/list/showcontinue to work withoutpystache.
Plan
- Confirm
v2_doc_generateis importable (main(argv)already exists). - Add a shared
current_version_sprint()helper (used bywhereandadd); add_default_parent_dirandcmd_add; short-circuitaddinmain()and register it for--help. - Lazy-import
v2_doc_generateinsidecmd_add(optional pystache dep); addpystachetorequirements.txt. - Smoke-test (
add storyinto the current sprint; clean up).
Notes
Dogfooded: this very task file was created with compass add task.
PRs
| PR | Title |
|---|---|
| #815 | [ores.compass] Implement the Scaffold pillar (add command) |
Review
| Comment summary | File | Decision | Notes |
|---|---|---|---|
| (pending PR review) |
| Comment summary | File | Decision | Notes |
|---|---|---|---|