Merge pull request #4 from lightspeedwp/feature/markdown-reference-guardrail

PR: Feature/markdown reference guardrail

Author: ashleyshaw

.babelrc.json

@@ -1,3 +1,3 @@
 {
-	"presets": ["@wordpress/babel-preset-default"]
+	"presets": [ "@wordpress/babel-preset-default" ]
 }

.devcontainer/devcontainer.json

@@ -34,8 +34,8 @@
 				"[php]": {
 					"editor.defaultFormatter": "bmewburn.vscode-intelephense-client"
 				},
-				"eslint.validate": ["javascript", "javascriptreact"],
-				"stylelint.validate": ["css", "scss", "postcss"],
+				"eslint.validate": [ "javascript", "javascriptreact" ],
+				"stylelint.validate": [ "css", "scss", "postcss" ],
 				"files.associations": {
 					"*.php": "php",
 					"*.html": "html"
@@ -49,7 +49,7 @@
 		}
 	},
 
-	"forwardPorts": [8080, 8443, 3306],
+	"forwardPorts": [ 8080, 8443, 3306 ],
 
 	"postCreateCommand": "npm ci && composer install",
 

.eslintrc.js

@@ -0,0 +1,35 @@
+module.exports = {
+	root: true,
+	env: {
+		browser: true,
+		node: true,
+		es2021: true,
+		jest: true, // Add Jest global variables
+	},
+	extends: [
+		'plugin:jest/recommended',
+		'plugin:jest/style',
+		'eslint:recommended',
+		'prettier',
+	],
+	plugins: [ 'jest' ],
+	overrides: [
+		{
+			files: [ 'tests/**/*.js' ],
+			env: {
+				jest: true,
+			},
+			globals: {
+				jest: 'readonly',
+				describe: 'readonly',
+				it: 'readonly',
+				test: 'readonly',
+				beforeAll: 'readonly',
+				afterAll: 'readonly',
+				beforeEach: 'readonly',
+				afterEach: 'readonly',
+				expect: 'readonly',
+			},
+		},
+	],
+};

scripts/fix-instruction-references.js …test-temp/localstorage/localstorage.jsonscripts/fix-instruction-references.js renamed to .github/.test-temp/localstorage/localstorage.json scripts/fix-instruction-references.js renamed to .github/.test-temp/localstorage/localstorage.json

@@ -0,0 +1,8 @@
+# README for Test Helpers
+
+This folder contains shared test helpers for Jest and Playwright.
+
+- Place all shared test helpers here.
+- Add new helpers as needed for test consistency.
+
+See `.github/instructions/jest-tests.instructions.md` for Jest usage and conventions.

.github/__tests__/README.md

@@ -0,0 +1,33 @@
+/**
+ * Shared test helpers for Jest and Playwright
+ *
+ * Use for common setup, teardown, and utility functions across JS and E2E tests.
+ *
+ * - Use TestLogger for consistent logging
+ * - Use retryOperation for async retries
+ * - Add Playwright helpers for block theme E2E
+ */
+
+const TestLogger = require('../.github/tests/test-logger');
+const { retryOperation } = require('../scripts/utils/test-utils');
+
+// Example: Playwright helper for theme activation
+async function activateTheme(page, themeSlug) {
+  await page.goto('/wp-admin/themes.php');
+  await page.click(`button[aria-label="Activate ${themeSlug}"]`);
+}
+
+// Example: Playwright helper for block rendering
+async function renderBlock(page, blockName) {
+  await page.goto('/wp-admin/post-new.php');
+  await page.click('button[aria-label="Add block"]');
+  await page.type('input[placeholder="Search for a block"]', blockName);
+  await page.click(`button[aria-label="${blockName}"]`);
+}
+
+module.exports = {
+  TestLogger,
+  retryOperation,
+  activateTheme,
+  renderBlock,
+};

.github/__tests__/test-helper.js

@@ -3,6 +3,10 @@ description: "Block Theme Accessibility Expert — WCAG-aligned guidance and act
 name: "Block Theme Accessibility Expert"
 model: GPT-4.1
 tools: ["vscode", "execute/testFailure", "execute/getTerminalOutput", "execute/runTask", "execute/getTaskOutput", "execute/createAndRunTask", "execute/runInTerminal", "execute/runTests", "read/problems", "read/readFile", "read/terminalSelection", "read/terminalLastCommand", "edit/editFiles", "search", "web"]
+permissions: ["read", "write", "execute", "filesystem", "shell"]
+metadata:
+  guardrails: |
+    Only apply types/labels from canonical configs. Never overwrite without warning. Validate all content. Log all actions. Preserve user data integrity.
 ---
 
 # Block Theme Accessibility Expert (WCAG & WordPress)

.github/agents/a11y.agent.md

@@ -7,6 +7,10 @@ audience: "Developers, AI Agents"
 model: "GPT-4.1"
 date: 2025-12-01
 tools: ["search", "edit", "fetch"]
+permissions: ["read", "write", "execute", "filesystem", "network", "shell"]
+metadata:
+  guardrails: |
+    Only apply types/labels from canonical configs. Never overwrite without warning. Validate all content. Log all actions. Preserve user data integrity.
 ---
 
 # Block Theme Build Agent Spec

.github/agents/block-theme-build.agent.md

@@ -2,6 +2,10 @@
 name: Block Theme Development Assistant
 description: AI development assistant for WordPress block theme development
 tools: ["search", "edit", "fetch", "semantic_search", "read_file", "grep_search", "file_search", "run_in_terminal", "grep_search", "file_search", "run_in_terminal", file_search, run_in_terminal]
+permissions: ["read", "write", "execute", "filesystem", "network", "shell"]
+metadata:
+  guardrails: |
+    Only apply types/labels from canonical configs. Never overwrite without warning. Validate all content. Log all actions. Preserve user data integrity.
 ---
 
 # Block Theme Development Assistant

.github/agents/development-assistant.agent.md

@@ -5,6 +5,11 @@ category: Project
 type: Reference
 audience: AI Assistants, Developers
 date: 2025-12-01
+tools: ["search", "edit", "fetch", "web"]
+permissions: ["read", "write", "network", "shell", "filesystem"]
+metadata:
+  guardrails: |
+    Only apply types/labels from canonical configs. Never overwrite without warning. Validate all content. Log all actions. Preserve user data integrity.
 ---
 
 ## Overview