1.6 KiB
1.6 KiB
Purpose
Canonical specification for admin-maintenance-command-suite requirements synced from OpenSpec change deltas.
Requirements
Requirement: Unified admin command surface
The system SHALL provide a single admin CLI command family exposing maintenance subcommands.
Scenario: Subcommand discovery
- WHEN an operator runs the admin command help output
- THEN available subcommands include refetch-images, clean-archive, clear-cache, clear-news, rebuild-site, regenerate-translations, and fetch
Requirement: Fetch command supports configurable article count
The admin fetch command SHALL support an operator-provided article count parameter.
Scenario: Fetch with explicit count
- WHEN an operator invokes fetch with
n=25 - THEN the command executes ingestion targeting the requested count
- AND prints completion summary including processed/stored counts
Requirement: Translation regeneration command
The system SHALL provide a command to regenerate translations for existing articles.
Scenario: Regenerate translations run
- WHEN an operator runs regenerate-translations
- THEN the system attempts translation regeneration for supported languages
- AND outputs success/failure totals
Requirement: Rebuild site command
The system SHALL provide a rebuild-site command that executes the defined rebuild workflow.
Scenario: Rebuild execution
- WHEN an operator runs rebuild-site
- THEN the system executes the documented rebuild steps in deterministic order
- AND prints a final success/failure summary