38 lines
1.5 KiB
Markdown
38 lines
1.5 KiB
Markdown
## Purpose
|
|
|
|
Canonical specification for site-admin-safety-and-ergonomics requirements synced from OpenSpec change deltas.
|
|
|
|
## Requirements
|
|
|
|
### Requirement: Confirmation guard for destructive commands
|
|
Destructive admin commands SHALL require explicit confirmation before execution.
|
|
|
|
#### Scenario: Missing confirmation flag
|
|
- **WHEN** an operator runs clear-news or clean-archive without required confirmation
|
|
- **THEN** the command exits without applying destructive changes
|
|
- **AND** prints guidance for explicit confirmation usage
|
|
|
|
### Requirement: Dry-run support where applicable
|
|
Maintenance commands SHALL provide dry-run mode for previewing effects where feasible.
|
|
|
|
#### Scenario: Dry-run preview
|
|
- **WHEN** an operator invokes a command with dry-run mode
|
|
- **THEN** the command reports intended actions and affected counts
|
|
- **AND** persists no data changes
|
|
|
|
### Requirement: Actionable failure summaries
|
|
Admin commands SHALL output actionable errors and final status summaries.
|
|
|
|
#### Scenario: Partial failure reporting
|
|
- **WHEN** a maintenance command partially fails
|
|
- **THEN** output includes succeeded/failed counts
|
|
- **AND** includes actionable next-step guidance
|
|
|
|
### Requirement: Admin workflows have automated verification coverage
|
|
Admin safety-critical workflows SHALL be covered by automated tests.
|
|
|
|
#### Scenario: Safety command regression test
|
|
- **WHEN** admin command tests run in CI
|
|
- **THEN** confirmation and dry-run behavior are validated by tests
|
|
- **AND** regressions in safety guards fail the gate
|