clawfort/openspec/specs/admin-maintenance-command-suite/spec.md

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