docs(tracking): update roadmap with docs site progress

Author: LC43

docs/CURRENT.md

@@ -1,19 +1,23 @@
 # Current: Live Working State
 
 ## Working
+- Phase 5D: Documentation site infrastructure — VitePress + phpDocumentor hybrid, GitHub Actions deploy to docs.saltus.dev, @api annotations on 84 public classes/interfaces, doc content pages @since 2026-07-21
 - Phase 5A: Block Editor integration — Blocks feature service, per-CPT block registration, default templates @since 2026-07-08
-- Phase 5D: Documentation — fill README placeholders, add model examples @since 2026-07-05
-- MCP/REST gating refactor: McpPolicy + config-section model @since 2026-07-08
+- Phase 4F/4G: AbilityRuntime middleware pipeline integration — backward-compatible pipeline delegation added to execute() @since 2026-07-21
 
 ## Next
+- Phase 5D: Fill remaining README placeholders (features, labels, meta, settings tables)
+- Phase 5D: Create BLOCKS.md, WPCLI.md, FRONTEND.md content pages
+- Phase 5D: Create bin/generate-wpcli-docs.php doc generator
 - Phase 5B: WP-CLI tools — 7 grouped command classes mapping every MCP tool
 - Phase 5C: Frontend rendering — shortcodes, templates, meta field exposure
-- Phase 5D: New doc files (BLOCKS.md, WPCLI.md, FRONTEND.md, FEATURES.md)
 
 ## Blocked
 - None
 
 ## Recent Changes
+- Docs infrastructure: VitePress site scaffolded at `docs/.vitepress/`, phpDocumentor config at `phpdoc.dist.xml`, `.github/workflows/docs.yml` for auto-build + GH Pages deploy to `docs.saltus.dev`, `docs/public/CNAME` for custom domain, 6 doc content pages (getting-started, features, architecture, build, MCP overview, API index), `composer docs:all` script (`docs:mcp` + `docs:api`), @api annotations on 84 public classes/interfaces across all namespaces, README updated with docs.saltus.dev links, ROADMAP.md Phase 5D progress tracked @since 2026-07-21
+- AbilityRuntime middleware pipeline integration: backward-compatible `execute_via_pipeline()` delegated from `execute()`, `execute_legacy()` preserved as fallback, optional `MiddlewarePipeline` constructor injection — resolves Phase 4F/4G strip-cache/strip-rate-limit items @since 2026-07-21
 - Code review feedback: replaced wp_die with RuntimeException in single_export_query to avoid HTML death pages in REST/MCP contexts; added catch clause in export_post to return structured WP_Error; replaced unsafe property_exists with get_object_vars in ModelRestPolicy to avoid fatal errors on non-public properties; added explicit edit_posts permission checks for list_models/get_model/list_meta_fields/get_meta_fields in AbilityDefinitionFactory; changed AuditLogger created_at column from varchar(32) to datetime(3) — 2 commits @since 2026-07-04
 - Export query hardening: replaced fragile string-equality check in single_export_query with structural regex detection via is_fake_date_export_query; added wp_die fallback for unrecognized fake-date query shapes; added esc_html__ and wp_die test stubs — 1 commit @since 2026-07-04
 - Code review feedback: deferred RestServer instantiation inside rest_api_init to avoid overhead on non-REST requests; replaced wp_next_scheduled/wp_unschedule_event with wp_clear_scheduled_hook in MCP deactivation; gated ensure_table() behind DB version option to avoid unnecessary CREATE TABLE queries on every audit write; added wp_clear_scheduled_hook test stub — 3 commits @since 2026-07-04

docs/ROADMAP.md

@@ -152,7 +152,7 @@ Expose Saltus Framework capabilities through WordPress-native MCP/Abilities. Sal
 | **Docker image** | Skipped with standalone server path |
 | **GitHub Action** | Skipped with standalone server path |
 | **VS Code extension** | Future WordPress-native MCP client integration |
-| **Documentation site** | Source pages added at `docs/MCP.md`, `docs/MCP-CLIENTS.md`, and generated `docs/MCP-ABILITIES.md` for future `docs.saltus.dev/mcp` |
+| **Documentation site** | VitePress site live at `docs.saltus.dev`, phpDocumentor API docs, GitHub Actions auto-deploy, MCP docs integrated |
 | **MCP Registry listing** | Reassess for WordPress-native abilities |
 | **Support & SLA model** | Paid support contracts, custom tool development |
 
@@ -358,8 +358,16 @@ frontend:
 
 **Auto-generation:** `composer docs:wpcli` script in `bin/generate-wpcli-docs.php` to generate WP-CLI command tables (parallel to `bin/generate-mcp-docs.php`).
 
+**Docs site infrastructure (new):** VitePress static site at `docs.saltus.dev` + phpDocumentor API docs + GitHub Actions auto-deploy.
+
 | Item | Status |
 |------|--------|
+| VitePress site config + landing page | ✓ Done |
+| phpDocumentor config (phpdoc.dist.xml) | ✓ Done |
+| @api annotations on 84 public classes/interfaces | ✓ Done |
+| GitHub Actions workflow (build + deploy to Pages) | ✓ Done |
+| Docs content: getting-started, architecture, build, features, MCP | ✓ Done |
+| `composer docs:all` script (mcp + api) | ✓ Done |
 | README features table | ○ Pending |
 | README labels reference | ○ Pending |
 | README meta structure | ○ Pending |
@@ -372,11 +380,11 @@ frontend:
 | docs/FEATURES.md | ○ Pending |
 | bin/generate-wpcli-docs.php | ○ Pending |
 
-**Exit criteria:** Zero `(More Info Soon)` or `(Soon)` placeholders in README. All four new features have dedicated doc files. Feature reference is extracted to `docs/FEATURES.md`. WP-CLI docs are auto-generated.
+**Exit criteria:** `(More Info Soon)` placeholders filled, docs.saltus.dev live with VitePress + API docs, auto-deploy via GitHub Actions. All four feature doc files created. WP-CLI docs auto-generated.
 
 ---
 
-*Plugin Generator moved to its own repository — see [docs/PLUGIN_GENERATOR_ROADMAP.md](./PLUGIN_GENERATOR_ROADMAP.md).*
+*Plugin Generator moved to its own repository — see the [framework-demo repository](https://github.com/SaltusDev/framework-demo).*
 
 ## Framework Core Roadmap