38 lines
1.7 KiB
Markdown
38 lines
1.7 KiB
Markdown
## 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, including permalink-targeted image refetch support.
|
|
|
|
#### 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
|
|
- **AND** refetch-images help output documents optional permalink-targeted execution
|
|
|
|
### 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
|