Skip to content

feat(cli-entrypoint): add CLI entrypoint with --help and --version#109

Merged
nullhack merged 28 commits intomainfrom
feat/cli-entrypoint
Apr 22, 2026
Merged

feat(cli-entrypoint): add CLI entrypoint with --help and --version#109
nullhack merged 28 commits intomainfrom
feat/cli-entrypoint

Conversation

@nullhack
Copy link
Copy Markdown
Owner

Summary

  • Adds app/__main__.py — CLI entrypoint invoked via python -m app --help and python -m app --version
  • Zero new runtime dependencies (argparse + importlib.metadata are stdlib)
  • Full five-step workflow demo: scope → architecture → TDD → verification → acceptance

Acceptance Criteria

  • @id:c1a2b3d4: --help prints application name and tagline, exits 0
  • @id:e5f6a7b8: --help lists --help and --version options
  • @id:c9d0e1f2: --version prints name and version string, exits 0
  • @id:a3b4c5d6: version string matches importlib.metadata at runtime
  • @id:e7f8a9b0: unknown flag exits with error code 2
  • @id:b1c2d3e4: no arguments runs without error, exits 0

Testing

  • All tests pass: uv run task test (11 tests, 100% coverage)
  • Linting clean: uv run task lint
  • Type checking clean: uv run task static-check
  • Application runs: timeout 10s uv run task run exits 0

Reviewer Notes

  • Feature accepted at Step 5 by PO; this PR is the formal merge record
  • ADRs: ADR-2026-04-22-cli-parser-library (argparse over click/typer), ADR-2026-04-22-version-source (importlib.metadata, never hardcoded)
  • Release: v7.2.20260422 - Resolute Hermes

nullhack added 28 commits April 22, 2026 13:46
…l/config files

- WORK.md: stripped Session Log section and Next: blocks; now contains only @id/@state/@Branch
- AGENTS.md: removed 'session log' from WORK.md description and Chain of Responsibility section
- run-session/SKILL.md: removed Next: line format examples, Rule 5 about Next:, and 'Always close with Next:' from Output Style
- flow/SKILL.md: removed Rule 4 about Next: line in session output
- flow/flow.md.template: replaced 'Every session must close with Next:' with neutral output style guidance
- FLOW.md: removed 'Every agent session must close with Next:' from Output Style
- architect/SKILL.md: fix erroneous 'update FLOW.md Next:' instruction → update WORK.md @State
- verify/SKILL.md: fix erroneous 'update FLOW.md Next:' instruction → update WORK.md @State
- implement/SKILL.md: fix 'Note gap in FLOW.md under ## Next' → document gap in handoff message
…docs and skills

- architect/SKILL.md: domain analysis rule now reads 'Nouns in feature/glossary language
  → candidate Entities, Value Objects, or Aggregates' and 'Verbs in feature/glossary
  language → candidate Actions (operations on an Entity, standalone function, or Domain
  Service)'; lines 129-130 updated to use 'actions' when writing to system.md
- architect/system.md.template: '### Verbs' section renamed to '### Actions'; row
  placeholder updated from verb to action
- update-docs/SKILL.md: 'nouns and verbs from the Domain Model' → 'entities and actions
  from the Domain Model'
- define-scope/SKILL.md line 143 intentionally unchanged: PO reads sources using
  business-language framing (nouns/verbs is correct cognitive framing for the PO role)
…ntel

Remove the gold lemniscate path from the temple mark. Add a horizontal
load-bearing lintel spanning the two central columns at mid-height. The
entablature above, the lintel, and the stylobate below now form two
rectangular voids between the inner pillars — the 8 is implied by the
negative space, not drawn.
…g, soften structural outlines

Replace explicit 8 glyph with structural crossbeam lintel. Add inner-wall
shadows on facing column surfaces to imply the 8 via negative space. Grade
stylobate stairs top-to-bottom (#ede8e0 → #d8d4cc → #a09890). Soften
pediment, entablature, and top stair borders from deep brown to stone (#c8c0b8).
@nullhack nullhack merged commit 1dd5f40 into main Apr 22, 2026
9 checks passed
@nullhack nullhack deleted the feat/cli-entrypoint branch April 22, 2026 19:54
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant