chore(release): v1.0.0

.claude/hooks/session-start.sh

@@ -0,0 +1,67 @@
+#!/usr/bin/env bash
+# Session-start hook for LightSpeedWP/.github
+# Runs at the start of every Claude Code remote session.
+# - Renames any auto-generated claude/ branch to a valid chore/session-{hash} branch
+# - Installs npm dependencies
+
+set -euo pipefail
+
+# Only run in remote Claude Code environments
+if [ "${CLAUDE_CODE_REMOTE:-}" != "true" ]; then
+  exit 0
+fi
+
+# Skip on clear/compact — branch rename and dep install are only needed at startup/resume
+HOOK_INPUT="$(cat)"
+if echo "$HOOK_INPUT" | grep -qE '"source"\s*:\s*"(clear|compact)"'; then
+  exit 0
+fi
+
+cd "${CLAUDE_PROJECT_DIR:-.}"
+
+# ── 1. Enforce branch naming — rename claude/ branches ───────────────────────
+# Runs before npm install so a failing install can't prevent the rename.
+CURRENT_BRANCH="$(git branch --show-current 2>/dev/null || true)"
+
+if [[ "$CURRENT_BRANCH" == claude/* ]]; then
+  # Extract the short hash from the end of the auto-generated branch name.
+  # e.g. "claude/admiring-mendel-nqdk8j" → "nqdk8j"
+  # Falls back to stripping the "claude/" prefix if the name has no hyphen.
+  if [[ "$CURRENT_BRANCH" == *-* ]]; then
+    HASH_SUFFIX="${CURRENT_BRANCH##*-}"
+  else
+    HASH_SUFFIX="${CURRENT_BRANCH#claude/}"
+  fi
+  NEW_BRANCH="chore/session-${HASH_SUFFIX}"
+
+  echo ""
+  echo "╔══════════════════════════════════════════════════════════════╗"
+  echo "║  BRANCH RENAME: claude/ prefix is forbidden by CLAUDE.md    ║"
+  echo "╠══════════════════════════════════════════════════════════════╣"
+  printf "║  Old: %-55s ║\n" "${CURRENT_BRANCH}"
+  printf "║  New: %-55s ║\n" "${NEW_BRANCH}"
+  echo "╠══════════════════════════════════════════════════════════════╣"
+  echo "║  ACTION REQUIRED before committing any work:                 ║"
+  echo "║  Rename to match your task using:                            ║"
+  echo "║    git branch -m <new-name>                                  ║"
+  echo "║    git push -u origin <new-name>                             ║"
+  echo "║    git push origin --delete ${NEW_BRANCH}                    ║"
+  echo "╚══════════════════════════════════════════════════════════════╝"
+  echo ""
+
+  # Rename locally
+  git branch -m "${CURRENT_BRANCH}" "${NEW_BRANCH}"
+
+  # Push the new branch name to origin; non-fatal so network issues don't block the session.
+  git push -u origin "${NEW_BRANCH}" || echo "==> Warning: Could not push the renamed branch to origin."
+  # Delete the old remote branch; non-fatal (may already be gone or push may have failed).
+  git push origin --delete "${CURRENT_BRANCH}" 2>/dev/null || true
+
+  echo "==> Branch renamed: ${CURRENT_BRANCH} → ${NEW_BRANCH}"
+  echo "==> Please rename '${NEW_BRANCH}' to a meaningful {type}/{scope}-{title} branch before committing."
+fi
+
+# ── 2. Install npm dependencies ──────────────────────────────────────────────
+echo "==> Installing npm dependencies..."
+npm install --prefer-offline --no-fund --no-audit 2>&1
+echo "==> npm install complete."

.claude/settings.json

@@ -0,0 +1,14 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "$CLAUDE_PROJECT_DIR/.claude/hooks/session-start.sh"
+          }
+        ]
+      }
+    ]
+  }
+}

.codespellrc

@@ -0,0 +1,8 @@
+[codespell]
+# LightSpeedWP shared dictionary for governance and WordPress terminology.
+ignore-words-list =
+  LightspeedWP,LightSpeedWP,Codex,Copilot,Gemini,Claude,WordPress,Gutenberg,themejson,blockjson,frontmatter,labeler,WPCS,PHPCS
+
+# Skip generated and third-party directories.
+skip =
+  .git,node_modules,package-lock.json,coverage,dist,build,.vscode-insiders

.eslint.config.cjs

@@ -40,6 +40,7 @@ const ignoreFolders = process.env.ESLINT_IGNORE
       "docs/mustache-repo-templates/**", // Template files
       "scripts/utility/__tests__/**", // Test files
       "scripts/utility/__fixtures__/**", // Test fixtures
+      "design_handoff_awesome_github/**", // Design prototype (reference, not production code)
     ];
 
 /**
@@ -122,9 +123,10 @@ module.exports = [
       "no-console": "off",
     },
   },
-  // ES Modules (.mjs and scripts that use import/export)
+  // Standard JavaScript files and test utilities (.js)
   {
-    files: [
+    files: ["**/*.js"],
+    ignores: [
       "**/*.mjs",
       "scripts/**/*.js",
       ".github/agents/**/*.js",
@@ -135,7 +137,7 @@ module.exports = [
     languageOptions: {
       parserOptions: {
         ecmaVersion: 2024,
-        sourceType: "module",
+        sourceType: "commonjs",
       },
       globals: {
         // Node.js globals
@@ -147,6 +149,9 @@ module.exports = [
         clearTimeout: "readonly",
         global: "readonly",
         process: "readonly",
+        require: "readonly",
+        module: "readonly",
+        exports: "readonly",
         setImmediate: "readonly",
         setInterval: "readonly",
         setTimeout: "readonly",
@@ -172,13 +177,20 @@ module.exports = [
       "no-console": "off",
     },
   },
-  // Standard JavaScript files and test utilities (.js)
+  // ES Modules (.mjs and scripts that use import/export)
   {
-    files: ["**/*.js"],
+    files: [
+      "**/*.mjs",
+      "scripts/**/*.js",
+      ".github/agents/**/*.js",
+      ".github/metrics/**/*.js",
+      ".github/scripts/**/*.js",
+      "docs/ai/**/*.js",
+    ],
     languageOptions: {
       parserOptions: {
         ecmaVersion: 2024,
-        sourceType: "commonjs",
+        sourceType: "module",
       },
       globals: {
         // Node.js globals
@@ -190,9 +202,6 @@ module.exports = [
         clearTimeout: "readonly",
         global: "readonly",
         process: "readonly",
-        require: "readonly",
-        module: "readonly",
-        exports: "readonly",
         setImmediate: "readonly",
         setInterval: "readonly",
         setTimeout: "readonly",

.eslintignore

@@ -0,0 +1,3 @@
+design_handoff_awesome_github/design_source/**
+website/dist/**
+website/node_modules/**