lightspeedwp · ashleyshaw · Jun 3, 2026 · Jun 3, 2026 · gemini-code-assist · Jun 3, 2026
@@ -7,7 +7,7 @@ created_date: "2026-06-03"
 last_updated: "2026-06-03"
 status: active
 stability: stable
-domain: website
+domain: governance
 owners:
   - Ash Shaw
 tags:

@@ -7,7 +7,7 @@ created_date: "2026-06-03"
 last_updated: "2026-06-03"
 status: active
 stability: stable
-domain: website
+domain: governance
 owners:
   - Ash Shaw
 tags:

@@ -7,7 +7,7 @@ created_date: "2026-06-03"
 last_updated: "2026-06-03"
 status: active
 stability: stable
-domain: website
+domain: governance
 owners:
   - Ash Shaw
 tags:

@@ -7,7 +7,7 @@ created_date: "2026-06-03"
 last_updated: "2026-06-03"
 status: active
 stability: stable
-domain: opsx
+domain: governance
 owners:
   - Ash Shaw
 tags:

@@ -6,8 +6,8 @@ version: "1.0.0"
 created_date: "2026-06-03"
 last_updated: "2026-06-03"
 status: active
-stability: draft
-domain: website
+stability: experimental
+domain: governance
 owners:
   - Ash Shaw
 tags:

@@ -6,8 +6,8 @@ version: "1.0.0"
 created_date: "2026-06-03"
 last_updated: "2026-06-03"
 status: active
-stability: draft
-domain: website
+stability: experimental
+domain: governance
 owners:
   - Ash Shaw
 tags:

@@ -7,7 +7,7 @@ created_date: "2026-06-03"
 last_updated: "2026-06-03"
 status: active
 stability: stable
-domain: opsx
+domain: governance
 owners:
   - Ash Shaw
 tags:

@@ -7,7 +7,7 @@ created_date: "2026-06-03"
 last_updated: "2026-06-03"
 status: active
 stability: stable
-domain: website
+domain: governance
 owners:
   - Ash Shaw
 tags:

@@ -7,7 +7,7 @@ created_date: "2026-06-03"
 last_updated: "2026-06-03"
 status: active
 stability: stable
-domain: website
+domain: governance
 owners:
   - Ash Shaw
 tags:

@@ -1,7 +1,7 @@
 ---
 title: "Agent Tools and MCP Permissions Audit"
 description: "Deep audit of all agent specifications against the release agent tools and permissions baseline, including MCP-related access posture."
-file_type: "report"
+file_type: "documentation"
 category: "agents"
 created_date: "2026-06-02"
 last_updated: "2026-06-02"

@@ -31,8 +31,15 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - **Awesome GitHub Site Planning Pack** — Created a new active project under `.github/projects/active/awesome-github-site/` with phase 1 and phase 2 planning docs, normalised briefing copies, and an updated execution tracker for the new GitHub-led website programme.
 - **Awesome GitHub Site GitHub Pages Implementation** — Added the Astro phase 1 site scaffold, GitHub Pages deployment workflow, custom `404` page, canonical `github.lightspeedwp.agency` domain support, and review-driven fixes for frontmatter, motion, and package metadata.
 
+## [0.5.0] - 2026-06-03
+
 ### Fixed
 
+- **v0.5.0 Readiness: Frontmatter schema cleanup for release docs and site-planning briefs** — Normalised invalid frontmatter values across the Awesome GitHub Site planning tree and related website docs so the repo’s frontmatter validator no longer trips on release-blocking schema errors:
+  - Replaced unsupported `domain: website` and `domain: opsx` values with schema-valid `domain: governance`.
+  - Updated draft-only site brief metadata to use supported `stability: experimental`.
+  - Converted the stray `report` frontmatter type in the agent permissions audit to `documentation`.
+
 - **v0.5.0 Readiness: Coverage and Reliability Gate Execution (`#746`, `#602`, `#599`, `#600`, `#601`)** — Re-activated planner/reviewer test coverage from skipped state into active Jest suites, added module-system consistency guards, and improved reviewer workflow dry-run support for safe validation:
   - Added `scripts/agents/__tests__/planner.agent.test.js` and `scripts/agents/__tests__/reviewer.agent.test.js` with expanded fatal-path, dry-run, blocker-detection, and API-failure coverage.
   - Added `scripts/agents/__tests__/module-system-consistency.test.js` to enforce ESM consistency across planner/reviewer and `package.json` module type.

@@ -1 +1 @@
-0.3.0
+0.5.0
@@ -1,6 +1,6 @@
 {
   "name": "@lightspeedwp/github-community-health",
-  "version": "0.2.0",
+  "version": "0.5.0",
   "description": "The GitHub Community Health file for LightspeedWP. Community health files, agent scripts, and automation for the LightSpeed WordPress organization.",
   "license": "GPL-3.0-or-later",
   "author": {

@@ -20,6 +20,12 @@ function runNodeEsm(code) {
 describe("release.agent MCP provider", () => {
   test("full run path in mcp dry-run performs preflight and no live mutations", () => {
     const output = runNodeEsm(`
+      import { createRequire } from 'node:module';
+
+      const require = createRequire(import.meta.url);
+      const fs = require('node:fs');
+      const originalReadFileSync = fs.readFileSync;
+
       process.env.GITHUB_TOKEN = 'token';
       process.env.GITHUB_REPOSITORY = 'lightspeedwp/.github';
       process.env.RELEASE_FORCE_VERSION = '1';
@@ -33,6 +39,12 @@ describe("release.agent MCP provider", () => {
           text: async () => JSON.stringify({ message: 'Not Found' }),
         };
       };
+      fs.readFileSync = (filePath, ...args) => {
+        if (String(filePath).endsWith('VERSION')) {
+          return '0.4.0\\n';
+        }
+        return originalReadFileSync.call(fs, filePath, ...args);
+      };
 
       const { run } = await import('./scripts/agents/release.agent.js');
       const logs = [];
@@ -42,11 +54,12 @@ describe("release.agent MCP provider", () => {
       console.log = (...args) => logs.push(args.join(' '));
       console.warn = (...args) => warnings.push(args.join(' '));
 
-      process.argv = ['node', 'release.agent.js', '--scope=patch', '--version=0.4.0', '--provider=mcp', '--dry-run'];
+      process.argv = ['node', 'release.agent.js', '--scope=patch', '--version=0.5.0', '--provider=mcp', '--dry-run'];
-      process.argv = ['node', 'release.agent.js', '--scope=patch', '--version=0.5.0', '--provider=mcp', '--dry-run'];
+      process.argv = ['node', 'release.agent.js', '--scope=minor', '--version=0.5.0', '--provider=mcp', '--dry-run'];
-      process.argv = ['node', 'release.agent.js', '--scope=patch', '--version=0.5.0', '--provider=mcp', '--dry-run'];
+      process.argv = ['node', 'release.agent.js', '--scope=minor', '--version=0.5.0', '--provider=mcp', '--dry-run'];
       await run();
 
       console.log = originalLog;
       console.warn = originalWarn;
+      fs.readFileSync = originalReadFileSync;
       console.log(JSON.stringify({ fetchCalls, logs, warnings }));
     `);
 

@@ -1,7 +1,8 @@
 ---
 title: "WCEU 2026 Talk Asset Pack"
 description: "Working assets for the WordCamp Europe 2026 talk on evolving lightspeedwp/.github into an installable AI-ops and governance plugin platform."
-last_updated: "2026-06-02"owners: ["Ash Shaw"]
+last_updated: "2026-06-02"
+owners: ["Ash Shaw"]
 ---
 
 # WCEU 2026 Talk Asset Pack

@@ -1,7 +1,8 @@
 ---
 title: "NotebookLM Deep Research Prompt"
 description: "Prompt for NotebookLM to analyse the talk direction using only lightspeedwp/.github files and this wceu-2026 asset pack."
-last_updated: "2026-06-02"owners: ["Ash Shaw"]
+last_updated: "2026-06-02"
+owners: ["Ash Shaw"]
 ---
 
 # NotebookLM Deep Research Prompt

@@ -1,7 +1,8 @@
 ---
 title: "NotebookLM Source Ingestion Checklist"
 description: "Checklist to ensure NotebookLM only ingests approved repository sources for this talk."
-last_updated: "2026-06-02"owners: ["Ash Shaw"]
+last_updated: "2026-06-02"
+owners: ["Ash Shaw"]
 ---
 
 # NotebookLM Source Ingestion Checklist

@@ -1,7 +1,8 @@
 ---
 title: "Repo Source Index"
 description: "Curated source index for talk claims. Only references files inside lightspeedwp/.github."
-last_updated: "2026-06-02"owners: ["Ash Shaw"]
+last_updated: "2026-06-02"
+owners: ["Ash Shaw"]
 ---
 
 # Repo Source Index

@@ -1,7 +1,8 @@
 ---
 title: "Slide to Source Mapping"
 description: "Fast mapping from each slide to supporting repository files."
-last_updated: "2026-06-02"owners: ["Ash Shaw"]
+last_updated: "2026-06-02"
+owners: ["Ash Shaw"]
 ---
 
 # Slide to Source Mapping

@@ -1,7 +1,8 @@
 ---
 title: "Slide 01 - Hook and Stakes"
 description: "Open with the operational pain and why this matters now."
-last_updated: "2026-06-02"owners: ["Ash Shaw"]
+last_updated: "2026-06-02"
+owners: ["Ash Shaw"]
 ---
 
 # Slide 01 - Hook and Stakes

@@ -1,7 +1,8 @@
 ---
 title: "Slide 02 - Why a .github Control Plane"
 description: "Explain why centralising standards in one .github repo was the first successful step."
-last_updated: "2026-06-02"owners: ["Ash Shaw"]
+last_updated: "2026-06-02"
+owners: ["Ash Shaw"]
 ---
 
 # Slide 02 - Why a .github Control Plane

@@ -1,7 +1,8 @@
 ---
 title: "Slide 03 - Inheritance Boundaries"
 description: "Clarify what central .github can and cannot enforce by default."
-last_updated: "2026-06-02"owners: ["Ash Shaw"]
+last_updated: "2026-06-02"
+owners: ["Ash Shaw"]
 ---
 
 # Slide 03 - Inheritance Boundaries

@@ -1,7 +1,8 @@
 ---
 title: "Slide 04 - Control Plane Architecture"
 description: "Visualise the architecture of governance data, workflows, and standards."
-last_updated: "2026-06-02"owners: ["Ash Shaw"]
+last_updated: "2026-06-02"
+owners: ["Ash Shaw"]
 ---
 
 # Slide 04 - Control Plane Architecture

@@ -1,7 +1,8 @@
 ---
 title: "Slide 05 - Canonical Governance Assets"
 description: "Show the concrete governance assets that made scaling possible."
-last_updated: "2026-06-02"owners: ["Ash Shaw"]
+last_updated: "2026-06-02"
+owners: ["Ash Shaw"]
 ---
 
 # Slide 05 - Canonical Governance Assets

@@ -1,7 +1,8 @@
 ---
 title: "Slide 06 - Why We Pivoted"
 description: "Explain why centralisation alone was insufficient and why a plugin model emerged."
-last_updated: "2026-06-02"owners: ["Ash Shaw"]
+last_updated: "2026-06-02"
+owners: ["Ash Shaw"]
 ---
 
 # Slide 06 - Why We Pivoted

@@ -1,7 +1,8 @@
 ---
 title: "Slide 07 - Plugin Pack Architecture"
 description: "Break down what sits inside a plugin pack and why it matters."
-last_updated: "2026-06-02"owners: ["Ash Shaw"]
+last_updated: "2026-06-02"
+owners: ["Ash Shaw"]
 ---
 
 # Slide 07 - Plugin Pack Architecture

@@ -1,7 +1,8 @@
 ---
 title: "Slide 08 - Multi-Platform Parity"
 description: "Explain manifest parity across Copilot, Claude Code, Codex, and Gemini."
-last_updated: "2026-06-02"owners: ["Ash Shaw"]
+last_updated: "2026-06-02"
+owners: ["Ash Shaw"]
 ---
 
 # Slide 08 - Multi-Platform Parity

@@ -1,7 +1,8 @@
 ---
 title: "Slide 09 - Quality and Release Gates"
 description: "Show how validation, linting, and release workflows are enforced."
-last_updated: "2026-06-02"owners: ["Ash Shaw"]
+last_updated: "2026-06-02"
+owners: ["Ash Shaw"]
 ---
 
 # Slide 09 - Quality and Release Gates

@@ -1,7 +1,8 @@
 ---
 title: "Slide 10 - Metrics and Governance Outcomes"
 description: "Connect governance system design to measurable outcomes and accountability."
-last_updated: "2026-06-02"owners: ["Ash Shaw"]
+last_updated: "2026-06-02"
+owners: ["Ash Shaw"]
 ---
 
 # Slide 10 - Metrics and Governance Outcomes

@@ -1,7 +1,8 @@
 ---
 title: "Slide 11 - Lessons and Anti-Patterns"
 description: "Capture hard lessons and what to avoid when centralising governance and AI ops."
-last_updated: "2026-06-02"owners: ["Ash Shaw"]
+last_updated: "2026-06-02"
+owners: ["Ash Shaw"]
 ---
 
 # Slide 11 - Lessons and Anti-Patterns

@@ -1,7 +1,8 @@
 ---
 title: "Slide 12 - Adoption Playbook"
 description: "Close with a practical implementation sequence other teams can follow."
-last_updated: "2026-06-02"owners: ["Ash Shaw"]
+last_updated: "2026-06-02"
+owners: ["Ash Shaw"]
 ---
 
 # Slide 12 - Adoption Playbook

@@ -1,7 +1,8 @@
 ---
 title: "Slide 13 - Agent Layer"
 description: "Explain how agent specifications structure operational automation."
-last_updated: "2026-06-02"owners: ["Ash Shaw"]
+last_updated: "2026-06-02"
+owners: ["Ash Shaw"]
 ---
 
 # Slide 13 - Agent Layer

@@ -1,7 +1,8 @@
 ---
 title: "Slide 14 - Skill Layer"
 description: "Explain reusable skills as practical capability units."
-last_updated: "2026-06-02"owners: ["Ash Shaw"]
+last_updated: "2026-06-02"
+owners: ["Ash Shaw"]
 ---
 
 # Slide 14 - Skill Layer

@@ -1,7 +1,8 @@
 ---
 title: "Slide 15 - Hook Layer"
 description: "Show hook-based guardrails and execution safety checks."
-last_updated: "2026-06-02"owners: ["Ash Shaw"]
+last_updated: "2026-06-02"
+owners: ["Ash Shaw"]
 ---
 
 # Slide 15 - Hook Layer

@@ -1,7 +1,8 @@
 ---
 title: "Slide 16 - Workflow Layer"
 description: "Explain orchestration through GitHub workflows for daily operations."
-last_updated: "2026-06-02"owners: ["Ash Shaw"]
+last_updated: "2026-06-02"
+owners: ["Ash Shaw"]
 ---
 
 # Slide 16 - Workflow Layer

@@ -1,7 +1,8 @@
 ---
 title: "Slide 17 - Issue Template System"
 description: "Explain issue template strategy and structured intake."
-last_updated: "2026-06-02"owners: ["Ash Shaw"]
+last_updated: "2026-06-02"
+owners: ["Ash Shaw"]
 ---
 
 # Slide 17 - Issue Template System