genfile 0.6.0

CLI for genfile_core template archive management - create, manage, and materialize code generation templates.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

# CLI Test Specs

### Scope

- **Purpose:** Validate behavioral contracts defined in `docs/cli/` through executable test specifications
- **Responsibility:** Enumeration and organization of the CLI test surface across parameters, parameter groups, and commands
- **In Scope:** Parameter invariants, parameter group composition contracts, command behavioral specs, exit code contracts, and format output contracts
- **Out of Scope:** Implementation testing (belongs in `tests/`), manual testing procedures (see `tests/manual/`), type validation (covered by `docs/cli/type.md` invariants)

### Test Architecture

Three tiers of test specs, each covering a distinct layer of the CLI contract:

| Tier | Directory | Prefix | Covers |
|------|-----------|--------|--------|
| 1 | `param/` | `EC-` | Individual parameter invariants (default values, constraints, source priority, edge cases) |
| 2 | `param_group/` | `GRP-` | Parameter group composition contracts (co-membership, semantic coherence, cross-command consistency) |
| 3 | `command/` | `IT-` | Command behavioral specs (per-command contracts, exit codes, output format, integration flows) |

### Responsibility Table

| Directory | Responsibility |
|-----------|----------------|
| [command/](command/readme.md) | Spec files for each CLI command namespace (IT- prefix) |
| [param/](param/readme.md) | Spec files for CLI parameters (EC- prefix) |
| [param_group/](param_group/readme.md) | Spec files for CLI parameter groups (GRP- prefix) |