---
id: REUSE-WP-0009
type: workplan
title: "CLI hardening and test suite"
domain: helix_forge
repo: reuse-surface
status: finished
owner: codex
topic_slug: helix-forge
created: "2026-06-15"
updated: "2026-06-15"
state_hub_workstream_id: "9121d16f-879f-4db3-9df6-06f7543481d8"
---

# CLI hardening and test suite

Raise registry tooling reliability toward R3 with automated tests and stricter
CI gates after WP-0006 relation hygiene.

## Add pytest Suite

```task
id: REUSE-WP-0009-T01
status: done
priority: high
state_hub_task_id: "57d0869a-38bb-409a-b5b1-b3c73ff31a96"
```

Add `tests/` covering validate, query, export, overlaps, federation compose,
graph, and catalog commands. Add `[dev]` optional deps and document
`.venv/bin/pytest` in `AGENTS.md`.

## Add Fail-On-Warnings Flags

```task
id: REUSE-WP-0009-T02
status: done
priority: high
state_hub_task_id: "d10fde06-e09b-4292-b6c8-ced5e5ef213c"
```

Add `--fail-on-warnings` to `validate` and `graph --check`. Use in CI once
WP-0006 relation hygiene is complete.

## Tighten CI Pipeline

```task
id: REUSE-WP-0009-T03
status: done
priority: medium
state_hub_task_id: "79c0fa70-7ec1-4762-9a7c-9783f0997016"
```

Update `.gitea/workflows/ci.yml` to run pytest and fail on relation warnings.
Record reliability evidence on `capability.registry.register`.