Skip to content

docs(cli): lead with Audit Trail, fix 0.x scaffold pin and localhost default - #289

Merged
Eras256 merged 1 commit into
mainfrom
docs/cli-audit-trail-first
Nov 12, 2026
Merged

Eras256 merged 1 commit into
mainfrom
docs/cli-audit-trail-first

Conversation

@M0nsxx

@M0nsxx M0nsxx commented Nov 12, 2026

Copy link
Copy Markdown
Collaborator

Summary

SCF #46 reviewers land on GitHub/npm, and the ask is centered on Audit Trail. This reorders the README so anchor/verify come first (one intro sentence added, nothing else in those sections changed), ahead of the x402 quickstart. Tone matches #288.

Two real bugs found and fixed while in here:

  • nirium create x402/create bot scaffolded "nirium": "^0.16.0". Under 0.x semver that's >=0.16.0 <0.17.0 - every new project silently excluded everything 0.17+ shipped (maxAmountPerPayment, Bazaar discovery). Bumped to ^0.19.0, matching this CLI's own nirium dependency (also bumped).
  • status/anchor/report defaulted --url to http://localhost:3002, an agent this repo doesn't run - every README example failed with "unreachable" on a fresh install. Chose option (a): default is now https://nirium-agent.fly.dev (Nirium's testnet agent), so the CLI works out of the box with zero setup. Removed the now-false "the port pnpm dev runs the agent API on in this monorepo" line.

Also re-verified the telemetry note against the real dist/ of nirium 0.19.0 (downloaded the tarball, not just bumped the citation) - same opt-in behavior as documented, only the version number was stale.

Verification

  • npm test - 113/113.
  • nirium create x402 --name my-paid-api generates a project whose package.json now pins ^0.19.0; npm install pulls the real nirium@0.19.0, and npx tsx src/server.ts starts and prints 💸 cobrando en http://localhost:3000/premium/signals.

Next step

Once merged, publishing nirium-cli@3.2.2 to npm so the new README shows up there too (version bumped in package.json and CHANGELOG.md in this PR already).

🤖 Generated with Claude Code

…default

SCF reviewers open GitHub/npm first and the ask is centered on Audit
Trail, so the README now leads with anchor/verify instead of the x402
quickstart. No section content changed, only order, plus one intro
sentence.

Two real bugs fixed along the way:
- `nirium create x402`/`create bot` scaffolded `"nirium": "^0.16.0"`.
  Under 0.x semver that's `>=0.16.0 <0.17.0` - it silently excludes
  everything 0.17+ shipped (maxAmountPerPayment, Bazaar discovery).
  Bumped to ^0.19.0, same as this CLI's own `nirium` dependency.
- `status`/`anchor`/`report` defaulted `--url` to `http://localhost:3002`,
  an agent this repo never runs - a fresh install failed with
  "unreachable" on every example. Default is now
  `https://nirium-agent.fly.dev` (testnet), and the stale "the port
  pnpm dev runs the agent API on in this monorepo" sentence is gone.

Telemetry note re-verified against the real published dist/ of nirium
0.19.0 (not just the version bump) - same opt-in behavior as before,
only the citation was stale.

Verified: npm test (113/113), and `nirium create x402` generating a
project that `npm install`s and actually starts (prints "cobrando en
http://localhost:3000/premium/signals").

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@grantfox-oss

grantfox-oss Bot commented Nov 12, 2026

Copy link
Copy Markdown

Hey @M0nsxx 🦊, this PR isn't linked to an issue yet.

You're assigned to #103, #214 in this repository. Add Closes #<issue> to the PR description for the one this PR resolves.

Without it, your contribution can't be tracked on GrantFox and the issue won't close automatically when this PR is merged.

@Eras256 Eras256 left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reviewed all five files. The scaffold now pins nirium ^0.19.0 in both templates, the four --url defaults point to https://nirium-agent.fly.dev instead of localhost:3002, and 3.2.2 is consistent across package.json, the lockfile and the CHANGELOG. README leads with Audit Trail. CI green. Approved, thanks Monse.

@Eras256
Eras256 merged commit 396c04e into main Nov 12, 2026
4 checks passed
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.

2 participants