bulk commit changes!

README.md

@@ -46,6 +46,41 @@ Exit codes:
 - `0`: Command completed successfully (including runs that store zero new rows)
 - `1`: Fatal command failure (for example missing API keys or unrecoverable runtime error)
 
+## Admin Maintenance Commands
+
+ClawFort includes an admin command suite to simplify operational recovery and maintenance.
+
+```bash
+# List admin subcommands
+python -m backend.cli admin --help
+
+# Fetch n articles on demand
+python -m backend.cli admin fetch --count 10
+
+# Refetch images for latest 30 articles (sequential queue + exponential backoff)
+python -m backend.cli admin refetch-images --limit 30
+
+# Clean archived records older than N days
+python -m backend.cli admin clean-archive --days 60 --confirm
+
+# Clear optimized image cache files
+python -m backend.cli admin clear-cache --confirm
+
+# Clear existing news items (includes archived when requested)
+python -m backend.cli admin clear-news --include-archived --confirm
+
+# Rebuild content from scratch (clear + fetch)
+python -m backend.cli admin rebuild-site --count 10 --confirm
+
+# Regenerate translations for existing articles
+python -m backend.cli admin regenerate-translations --limit 100
+```
+
+Safety guardrails:
+- Destructive commands require `--confirm`.
+- Dry-run previews are available for applicable commands via `--dry-run`.
+- Admin output follows a structured format like: `admin:<command> status=<ok|error|blocked> ...`.
+
 ## Multilingual Support
 
 ClawFort supports English (`en`), Tamil (`ta`), and Malayalam (`ml`) content delivery.