Sourceless / Sourceless/infratomic
Make the CLI usable: help, install, reconciliation output
Nobody has claimed this yet.
- Dominant language
- Clojure
- Stars
- 0
- Forks
- 0
- Avg merge
- 12m
- Merged PRs (30d)
- 3
Description
TL;DR: The CLI has no --help, no installed command, and no visibility into auto-reconciliation — fix all three so a human can actually reach for it day-to-day.
User story
As an infrastructure engineer, I want a real infratomic command with discoverable help, so I don't have to read source or memorize the clojure -Sdeps ... incantation to use it.
Acceptance criteria
-
infratomicis a real installed command (wrapper script, packaged as a Nix flake app/package) -
infratomic --help(and no-args) lists every subcommand — passthrough terraform ones plussync/drift-check— and the--policy-check-url/--sync-url/--drift-urlflags -
infratomic sync --helpandinfratomic drift-check --helpexplain that subcommand's behavior and exit codes -
infratomic apply --helpexplains the Policy Check gate and--policy-check-url -
sync's printed summary includes reconciliation actions taken (resource, rule, action) from:reconciliation/*records, not just discovered/updated/drifted counts
How to verify
Run nix run .#infratomic -- --help from a clean checkout — confirm it lists all subcommands without reading source. Run infratomic sync --help. Run infratomic sync against a State Backend with a pending policy-violating resource and confirm the printed summary names the reconciliation action taken on it.
Out of scope
- Compiling a native (GraalVM) binary
- Changing Policy Check/Sync/Drift Check HTTP behavior itself
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by running nix run .#infratomic -- --help from a clean checkout and inspect the Nix flake app/package and current CLI entry point. Add the installed infratomic command and help for the main and named subcommands, including the listed flags and exit-code behavior. Verify the help output and run infratomic sync against a State Backend to confirm reconciliation actions appear in the summary.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- clojure, terraform
- Domain
- build-system, cli
- Issue type
- Feature
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Active
- Clarity
- Clearly specified
- Newbie friendliness
- 65/100