SaltusDev · LC43 · Jul 8, 2026 · Jul 8, 2026 · Jul 8, 2026 · Jul 8, 2026
diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
@@ -0,0 +1,71 @@
+name: Docs
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - 'src/**'
+      - 'docs/**'
+      - 'bin/**'
+      - 'phpdoc.dist.xml'
+      - 'package.json'
+  workflow_dispatch:
+
+concurrency:
+  group: pages
+  cancel-in-progress: true
+
+jobs:
+  build-and-deploy:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pages: write
+      id-token: write
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-php@v4
+        with:
+          php-version: 8.2
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: 'npm'
+
+      - name: Install phpDocumentor
+        run: |
+          wget -q https://github.com/phpDocumentor/phpDocumentor/releases/download/v3.10.0/phpDocumentor.phar
+          chmod +x phpDocumentor.phar
+
+      - name: Install PHP dependencies
+        run: composer install --no-interaction --no-progress
+
+      - name: Generate API docs
+        run: php phpDocumentor.phar -c phpdoc.dist.xml
+
+      - name: Generate MCP docs
+        run: composer docs:mcp
+
+      - name: Install Node dependencies
+        run: npm ci
+
+      - name: Build VitePress site
+        run: npm run docs:build
+
+      - name: Setup Pages
+        uses: actions/configure-pages@v4
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: docs/.vitepress/dist
+
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4
diff --git a/.gitignore b/.gitignore
@@ -1,5 +1,11 @@
 # dev
 vendor/
+node_modules/
+
+# docs
+docs/public/api/
+docs/.vitepress/dist/
+build/phpdoc-cache/
 
 # editor/OS files
 .DS_Store

diff --git a/README.md b/README.md
@@ -3,7 +3,7 @@ Saltus Framework helps you develop WordPress plugins that are based on Custom Po
 
 We built it to make things easier and faster for developers with different skills. Add metaboxes, settings pages and other enhancements with just a few lines of code.
 
-Visit saltus.dev for more information.
+Visit [saltus.dev](https://saltus.dev) for more information. Full documentation is available at [docs.saltus.dev](https://docs.saltus.dev).
 
 ## Version
 
@@ -42,7 +42,7 @@ composer require saltus/framework
 
 ### Demo
 
-Refer to the [Framework Demo](https://github.com/SaltusDev/framework-demo) for a complete plugin example and to the [Wiki](https://github.com/SaltusDev/saltus-framework/wiki) for complete documentation.
+Refer to the [Framework Demo](https://github.com/SaltusDev/framework-demo) for a complete plugin example and to the [documentation site](https://docs.saltus.dev) for complete documentation.
 
 
 Once the framework is installed and Composer's autoloader is loaded by your plugin, you can initialize it the following way:
@@ -187,7 +187,7 @@ Includes support for [github-updater](https://github.com/afragen/github-updater)
 
 Saltus Framework exposes its AI-facing tool surface through the WordPress-native MCP/Abilities API. Native WordPress MCP clients can discover and call the `saltus/*` abilities directly from the active plugin.
 
-For full documentation, see [docs/MCP.md](docs/MCP.md). For client integration guidance, see [docs/MCP-CLIENTS.md](docs/MCP-CLIENTS.md). These pages are source material for the future Saltus MCP documentation site.
+For full documentation, see [docs/MCP.md](docs/MCP.md) or the [MCP section](https://docs.saltus.dev/mcp/) of the documentation site. For client integration guidance, see [docs/MCP-CLIENTS.md](docs/MCP-CLIENTS.md) or the [client guide](https://docs.saltus.dev/mcp/clients).
 
 ### Quick Start
 

diff --git a/bin/generate-mcp-docs.php b/bin/generate-mcp-docs.php
@@ -16,6 +16,12 @@
 $root = dirname( __DIR__ );
 require_once $root . '/vendor/autoload.php';
 
+if ( ! function_exists( 'apply_filters' ) ) {
+	function apply_filters( string $hook_name, $value, ...$args ) {
+		return $value;
+	}
+}
+
 if ( ! class_exists( 'WP_REST_Request' ) ) {
 	class WP_REST_Request {
 		private string $method;

diff --git a/bin/generate-wpcli-docs.php b/bin/generate-wpcli-docs.php
@@ -0,0 +1,16 @@
+#!/usr/bin/env php
+<?php
+/**
+ * Generate WP-CLI command documentation from command class metadata.
+ *
+ * This script uses Reflection to introspect src/Features/WpCli/Commands/*.php
+ * classes and generates Markdown command reference tables, parallel to
+ * bin/generate-mcp-docs.php.
+ *
+ * Run with: composer docs:wpcli
+ */
+
+declare( strict_types=1 );
+
+echo "WP-CLI doc generation not yet implemented.\n";
+echo "Run after Phase 5B (WP-CLI tools) is implemented.\n";
diff --git a/composer.json b/composer.json
@@ -66,7 +66,13 @@
 		"test:phpstan": "./vendor/bin/phpstan analyse --memory-limit=2G",
 		"test:phpcs": "./vendor/bin/phpcs --standard=phpcs.xml",
 		"fix:phpcbf": "./vendor/bin/phpcbf --standard=phpcs.xml",
-		"docs:mcp": "php bin/generate-mcp-docs.php"
+		"docs:mcp": "php bin/generate-mcp-docs.php",
+		"docs:api": "php phpDocumentor.phar -c phpdoc.dist.xml",
+		"docs:wpcli": "php bin/generate-wpcli-docs.php",
+		"docs:all": [
+			"@docs:mcp",
+			"@docs:api"
+		]
 	},
 	"minimum-stability": "dev",
 	"prefer-stable": true,

diff --git a/docs/.vitepress/config.mjs b/docs/.vitepress/config.mjs
@@ -0,0 +1,89 @@
+import { defineConfig } from 'vitepress'
+
+export default defineConfig({
+  title: 'Saltus Framework',
+  description: 'WordPress plugin development framework for Custom Post Types',
+  lang: 'en-US',
+  base: '/',
+
+  ignoreDeadLinks: [
+    /^\/roadmap/,
+    /^\/current/,
+  ],
+
+  head: [
+    ['link', { rel: 'icon', href: '/favicon.ico' }],
+  ],
+
+  themeConfig: {
+    logo: '/logo.png',
+
+    nav: [
+      { text: 'Getting Started', link: '/getting-started' },
+      {
+        text: 'Guides',
+        items: [
+          { text: 'Features', link: '/guides/features' },
+          { text: 'Architecture', link: '/guides/architecture' },
+          { text: 'Build & Setup', link: '/guides/build' },
+        ],
+      },
+      {
+        text: 'MCP/Abilities',
+        link: '/mcp/index',
+      },
+      {
+        text: 'API Reference',
+        link: '/api/index',
+      },
+    ],
+
+    sidebar: {
+      '/getting-started': [
+        {
+          text: 'Getting Started',
+          items: [
+            { text: 'Quick Start', link: '/getting-started' },
+          ],
+        },
+      ],
+      '/guides/': [
+        {
+          text: 'Guides',
+          items: [
+            { text: 'Features', link: '/guides/features' },
+            { text: 'Architecture', link: '/guides/architecture' },
+            { text: 'Build & Setup', link: '/guides/build' },
+          ],
+        },
+      ],
+      '/mcp/': [
+        {
+          text: 'MCP/Abilities',
+          items: [
+            { text: 'Overview', link: '/mcp/index' },
+            { text: 'Abilities Reference', link: '/mcp/abilities' },
+            { text: 'Client Integration', link: '/mcp/clients' },
+          ],
+        },
+      ],
+    },
+
+    editLink: {
+      pattern: 'https://github.com/SaltusDev/saltus-framework/edit/main/docs/:path',
+    },
+
+    socialLinks: [
+      { icon: 'github', link: 'https://github.com/SaltusDev/saltus-framework' },
+    ],
+
+    footer: {
+      message: 'GPL-3.0 License',
+      copyright: 'Copyright Saltus Plugin Framework',
+    },
+
+    search: {
+      provider: 'local',
+    },
+  },
+})
diff --git a/docs/CURRENT.md b/docs/CURRENT.md
@@ -1,18 +1,23 @@
 # Current: Live Working State
 
 ## Working
-- Phase 5A: Block Editor integration — Blocks feature service, per-CPT block registration, default templates @since 2026-07-06
-- Phase 5D: Documentation — fill README placeholders, add model examples @since 2026-07-05
+- 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 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
@@ -111,6 +116,8 @@
 - MetaController PUT route: `update_item` + `update_item_permissions_check` at `PUT /saltus-framework/v1/meta/{post_type}/{post_id}` with serialized meta merging; UpdateMetaFields MCP tool and MetaControllerTest + UpdateMetaFieldsTest added — 1 commit @since 2026-07-07
 - Test suite: 226 tests, 639 assertions (bumped from 214/605 by +12 tests, +34 assertions for new MCP tool, MetaController PUT, and count updates) @since 2026-07-07
 - ModelsController: use `check_method` for description property access to prevent PHP 8.2+ dynamic property deprecation notices @since 2026-07-07
+- MCP namespace config filterability: added MCPConfig utility class with 3 WordPress filters (saltus/framework/mcp/namespace, saltus/framework/mcp/ability_category, saltus/framework/mcp/ability_prefix); added mcp_route() helper to RestTool base; refactored 21 source files from hardcoded strings to MCPConfig calls; added MCPConfigTest with 13 test cases — 6 commits, 236 tests, 655 assertions @since 2026-07-08
+- MCP/REST capability gating refactored: added get_config() to Model interface; added McpPolicy class with 14 test cases for MCP-specific mcp_tools/show_in_mcp gating; refactored ModelRestPolicy from saltus_rest array to per-feature config-section model; updated REST controller error hints; updated all existing tests for new config-section pattern — 7 commits, 250 tests, 669 assertions @since 2026-07-08
 
 ## Known Issues
 - `composer test` passes; Composer still prints a dependency deprecation notice from `justinrainbow/json-schema` under PHP 8.5.4.

diff --git a/docs/MCP-ABILITIES.md b/docs/MCP-ABILITIES.md
@@ -2,7 +2,7 @@
 
 <!-- This file is auto-generated by `composer docs:mcp`. Do not edit by hand. -->
 
-Saltus Framework exposes 17 WordPress-native MCP/Abilities tools.
+Saltus Framework exposes 18 WordPress-native MCP/Abilities tools.
 
 | Tool | Ability | REST request | Description |
 |------|---------|--------------|-------------|
@@ -21,6 +21,7 @@ Saltus Framework exposes 17 WordPress-native MCP/Abilities tools.
 | `list_posts` | `saltus/list-posts` | `GET /wp/v2/posts` | Query posts from a Custom Post Type with optional filters |
 | `list_terms` | `saltus/list-terms` | `GET /wp/v2/{taxonomy_rest_base}` | List terms from a taxonomy (categories, tags, or custom taxonomies) |
 | `reorder_posts` | `saltus/reorder-posts` | `POST /saltus-framework/v1/reorder` | Reorder multiple posts by updating their menu_order values in a single batch operation |
+| `update_meta_fields` | `saltus/update-meta-fields` | `PUT /saltus-framework/v1/meta/{post_type}/123` | Update meta fields for a specific post of a registered Saltus post type |
 | `update_post` | `saltus/update-post` | `PUT /wp/v2/posts/123` | Update an existing post's fields and meta data |
 | `update_settings` | `saltus/update-settings` | `PUT /saltus-framework/v1/settings/{post_type}` | Update the Saltus Framework settings for a specific post type |
 
@@ -284,6 +285,24 @@ Reorder multiple posts by updating their menu_order values in a single batch ope
 |-----------|------|----------|---------|-------------|
 | `items` | `array` | yes |  | Array of objects with "id" (post ID) and "menu_order" (integer position) |
 
+## `update_meta_fields`
+
+Update meta fields for a specific post of a registered Saltus post type
+
+- Ability: `saltus/update-meta-fields`
+- REST request: `PUT /saltus-framework/v1/meta/{post_type}/123`
+- REST capability: `meta (post_type)`
+- Cacheable: `no`
+- Cache TTL: `n/a`
+
+### Parameters
+
+| Parameter | Type | Required | Default | Description |
+|-----------|------|----------|---------|-------------|
+| `post_id` | `number` | yes |  | The post ID to update meta fields for |
+| `post_type` | `string` | yes |  | The post type slug |
+| `meta` | `object` | yes |  | Meta fields to update as key-value pairs |
+
 ## `update_post`
 
 Update an existing post's fields and meta data