feat: add sidc-kit CLI

[the-Drunken-coder]

Summary

• Add a dependency-free sidc-kit bin CLI for search, explain, render, and build.
• Keep success output script-friendly with JSON support and typed error JSON on stderr when --json is used.
• Add subprocess tests for command output and failure exit codes, plus README examples and package publish metadata.

Validation

• npm test
• npm pack --dry-run
• Manual smoke: node dist/cli.js search friendly infantry platoon --limit 1
• Manual smoke: node dist/cli.js build --affiliation friend --domain land --entity infantry --echelon platoon

Scope limits

• Curated semantic coverage is unchanged.
• No CLI framework or runtime dependency was added; @types/node is dev-only for TypeScript Node globals.
• The PR does not alter release automation.

Greptile Summary

This PR adds a dependency-free sidc-kit command-line tool. The main changes are:

• New sidc-kit bin entry for npm installs.
• CLI commands for search, explain, render, and build.
• JSON success output and typed JSON errors when requested.
• README examples and subprocess tests for CLI behavior.

Confidence Score: 5/5

The CLI behavior and packaging path match the described command-line contract.

The changed command surface is covered by subprocess tests and smoke validation for package metadata, build output, success commands, JSON output, and error handling.

None.

T-Rex Logs

What T-Rex did

• The before-state CLI contract was captured from the base commit 3b6285..., showing there is no bin and that running node dist/cli.js results in MODULE_NOT_FOUND.
• The after-state CLI contract was captured from the head commit dd979..., showing npm test passes, the CLI includes sidc-kit: ./dist/cli.js, and it prints the expected search/build outputs, emits JSON success for search/explain, emits a typed JSON usage error on stderr for unknown --json, and renders SVG.
• Artifacts documenting the CLI contract were created at trex-artifacts/cli-contract-01-before.md and trex-artifacts/cli-contract-02-after.md.

_{Ran code and verified through T-Rex}

_{Reviews (2): Last reviewed commit: "fix: harden CLI argument handling" | Re-trigger Greptile}

[coderabbitai]

Warning

Review limit reached

@the-Drunken-coder, we couldn't start this review because you've reached your PR review rate limit.

More reviews will be available in 3 minutes and 10 seconds. Learn how PR review limits work.

Your organization has used up its prepaid credits, and credit purchases are no longer available. Enable the review add-on in the billing tab to keep reviews running — you're only billed for reviews past your plan's rate limits ($0.25/file).

⌛ How to resolve this issue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based credits.

🚦 How do rate limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please see our Fair Usage Limits Policy for further information.

ℹ️ Review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: d0a46c1d-050f-478b-8c51-9d03ee612406

📥 Commits

Reviewing files that changed from the base of the PR and between 3b6285b and dd979ce.

⛔ Files ignored due to path filters (1)

• package-lock.json is excluded by !**/package-lock.json

📒 Files selected for processing (4)

• README.md
• package.json
• src/cli.ts
• test/cli.test.mjs

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch codex/add-cli

---

_{Comment @coderabbitai help to get the list of available commands.}

[the-Drunken-coder]

@codex review

[the-Drunken-coder]

@greptileai review

[chatgpt-codex-connector]

Codex Review: Didn't find any major issues. Swish!

Reviewed commit: e5679df0f7

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".