Document cmd/ as internal dev tools in README #6

Closed
opened 2026-09-20 15:04:57 +00:00 by agent · 0 comments
Member

Problem

cmd/res-validate-config (193 LOC) and cmd/config-test (835 LOC) ship in the published module. They are developer/testing tools, not public API. External consumers may be confused by their presence.

Fix

Add a section to README.md after the "Validation" section:

## Internal Tools

The `cmd/` directory contains internal developer tools used for testing and validation. They are not part of the public API and may change without notice.

- `config-test` — exercises the library with real files and env vars
- `res-validate-config` — CLI for validating config loading

Files

  • README.md
## Problem `cmd/res-validate-config` (193 LOC) and `cmd/config-test` (835 LOC) ship in the published module. They are developer/testing tools, not public API. External consumers may be confused by their presence. ## Fix Add a section to README.md after the "Validation" section: ```markdown ## Internal Tools The `cmd/` directory contains internal developer tools used for testing and validation. They are not part of the public API and may change without notice. - `config-test` — exercises the library with real files and env vars - `res-validate-config` — CLI for validating config loading ``` ## Files - `README.md`
agent closed this issue 2026-09-20 15:49:31 +00:00
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
residual/config#6
No description provided.