Sourceless / Sourceless/infratomic

Make the CLI usable: help, install, reconciliation output

Open
#47 1 comment 0 reactions 0 assignees View on GitHub

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

  • infratomic is a real installed command (wrapper script, packaged as a Nix flake app/package)
  • infratomic --help (and no-args) lists every subcommand — passthrough terraform ones plus sync/drift-check — and the --policy-check-url/--sync-url/--drift-url flags
  • infratomic sync --help and infratomic drift-check --help explain that subcommand's behavior and exit codes
  • infratomic apply --help explains 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

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.