data: salvage competitor-analysis pipeline from PR #27 (design dropped)

.cursor/rules/pdr-path-required.mdc

@@ -0,0 +1,17 @@
+---
+description: Require explicit PDR path for all Cursor tasks
+alwaysApply: true
+---
+
+Before any plan or code change, the prompt must include:
+
+`PDR_PATH: <exact file path in this repository>`
+
+Enforcement:
+1. If `PDR_PATH` is missing, ask for it and stop.
+2. If the file path does not resolve inside this repo, ask for a valid repo path and stop.
+3. Implement only the scoped requirements from that PDR file.
+4. Do not use old external issues as implementation authority unless mirrored to a repo PDR file.
+
+Preferred recovery baseline:
+`docs/pdr/recovery-pack/HowieZZ_PDR_Recovery_Pack/docs/pdr/PDR-000-recovery-and-source-of-truth.md`

.github/scripts/validate-community-data.mjs

@@ -0,0 +1,66 @@
+import { existsSync, readFileSync } from 'node:fs';
+
+let failures = 0;
+const fail = (msg) => { console.error('  x ' + msg); failures++; };
+const ok = (msg) => console.log('  ok ' + msg);
+
+const FILE = 'db/community_channels.json';
+if (!existsSync(FILE)) {
+  fail(FILE + ' is missing');
+} else {
+  try {
+    const raw = JSON.parse(readFileSync(FILE, 'utf8'));
+
+    if (!raw.meta || typeof raw.meta !== 'object') fail('meta object is missing');
+    if (!Array.isArray(raw.channels) || raw.channels.length === 0) fail('channels[] must be non-empty');
+    if (!Array.isArray(raw.official_handles)) fail('official_handles[] must be present');
+
+    const refs = raw.meta && Array.isArray(raw.meta.source_refs) ? raw.meta.source_refs : [];
+    if (!refs.length) fail('meta.source_refs[] must include at least one provenance entry');
+
+    refs.forEach((r, i) => {
+      if (!r || typeof r !== 'object') {
+        fail('source_refs[' + i + '] invalid');
+        return;
+      }
+      if (!r.path || !r.kind) fail('source_refs[' + i + '] must include path and kind');
+      if (r.path && !existsSync(r.path)) fail('source_refs[' + i + '] path missing: ' + r.path);
+    });
+
+    const requiredChannelFields = ['name', 'purpose', 'status', 'cadence', 'primary', 'secondary', 'primaryLabel', 'secondaryLabel'];
+    raw.channels.forEach((c, i) => {
+      requiredChannelFields.forEach((k) => {
+        if (!c[k] || typeof c[k] !== 'string') fail('channels[' + i + '].' + k + ' must be a non-empty string');
+      });
+      [c.primary, c.secondary].forEach((u) => {
+        if (!u) return;
+        if (u.startsWith('http://') || u.startsWith('https://')) {
+          try { new URL(u); } catch { fail('channels[' + i + '] has invalid URL: ' + u); }
+        } else {
+          const localPath = u.split('?')[0];
+          if (!existsSync(localPath)) fail('channels[' + i + '] local target missing: ' + localPath);
+        }
+      });
+    });
+
+    const requiredHandleFields = ['platform', 'handle', 'url', 'verification'];
+    raw.official_handles.forEach((h, i) => {
+      requiredHandleFields.forEach((k) => {
+        if (!h[k] || typeof h[k] !== 'string') fail('official_handles[' + i + '].' + k + ' must be a non-empty string');
+      });
+      const p = (h.url || '').split('?')[0];
+      if (p && !(h.url.startsWith('http://') || h.url.startsWith('https://')) && !existsSync(p)) {
+        fail('official_handles[' + i + '] local target missing: ' + p);
+      }
+    });
+
+    if (!failures) ok(FILE + ' schema and provenance checks passed');
+  } catch (err) {
+    fail(FILE + ' parse error: ' + err.message);
+  }
+}
+
+if (failures) {
+  console.error('\n' + failures + ' community data validation error(s).');
+  process.exit(1);
+}

.github/scripts/validate-community-events-data.mjs

@@ -0,0 +1,45 @@
+import { existsSync, readFileSync } from 'node:fs';
+
+let failures = 0;
+const fail = (msg) => { console.error('  x ' + msg); failures++; };
+const ok = (msg) => console.log('  ok ' + msg);
+
+const FILE = 'db/community_events.json';
+if (!existsSync(FILE)) {
+  fail(FILE + ' is missing');
+} else {
+  try {
+    const raw = JSON.parse(readFileSync(FILE, 'utf8'));
+    if (!Array.isArray(raw.events) || raw.events.length === 0) {
+      fail('events[] must be a non-empty array');
+    } else {
+      raw.events.forEach((ev, i) => {
+        ['title', 'date', 'mode', 'summary', 'ctaLabel', 'ctaHref'].forEach((k) => {
+          if (!ev[k] || typeof ev[k] !== 'string') fail('events[' + i + '].' + k + ' must be a non-empty string');
+        });
+
+        if (ev.date && !/^\d{4}-\d{2}-\d{2}$/.test(ev.date)) {
+          fail('events[' + i + '].date must be YYYY-MM-DD');
+        }
+
+        if (ev.ctaHref) {
+          if (ev.ctaHref.startsWith('http://') || ev.ctaHref.startsWith('https://')) {
+            try { new URL(ev.ctaHref); } catch { fail('events[' + i + '] has invalid URL: ' + ev.ctaHref); }
+          } else {
+            const localPath = ev.ctaHref.split('?')[0];
+            if (!existsSync(localPath)) fail('events[' + i + '] local target missing: ' + localPath);
+          }
+        }
+      });
+    }
+
+    if (!failures) ok(FILE + ' schema checks passed');
+  } catch (err) {
+    fail(FILE + ' parse error: ' + err.message);
+  }
+}
+
+if (failures) {
+  console.error('\n' + failures + ' community-events validation error(s).');
+  process.exit(1);
+}

.github/scripts/validate-pdr-path-task-files.mjs

@@ -0,0 +1,107 @@
+import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
+import { join, relative } from 'node:path';
+
+const ROOT = process.cwd();
+const MARKDOWN_SUFFIX = '.md';
+const TASK_ID_PATTERN = /^\s*-?\s*task_id\s*:/im;
+const PDR_PATH_PATTERN = /^\s*-?\s*pdr_path\s*:\s*(.+)$/gim;
+
+const SCAN_DIRS = [
+  'docs/handoffs',
+  'docs/pdr/recovery-pack'
+];
+
+const REQUIRED_TASK_FILES = [
+  'AGENTS.md',
+  'CLAUDE.md',
+  'CODEX.md'
+];
+
+let failures = 0;
+
+function walkMarkdownFiles(dirPath, out) {
+  if (!existsSync(dirPath)) return;
+  for (const entry of readdirSync(dirPath)) {
+    const fullPath = join(dirPath, entry);
+    const stats = statSync(fullPath);
+    if (stats.isDirectory()) {
+      walkMarkdownFiles(fullPath, out);
+    } else if (stats.isFile() && fullPath.toLowerCase().endsWith(MARKDOWN_SUFFIX)) {
+      out.push(fullPath);
+    }
+  }
+}
+
+function getPdrPaths(content) {
+  const matches = [];
+  for (const match of content.matchAll(PDR_PATH_PATTERN)) {
+    const pathValue = (match[1] || '').trim().replace(/^`|`$/g, '');
+    if (pathValue.length > 0) {
+      matches.push(pathValue);
+    }
+  }
+  return matches;
+}
+
+function validateTaskFile(filePath) {
+  const rel = relative(ROOT, filePath).replace(/\\/g, '/');
+  const content = readFileSync(filePath, 'utf8');
+
+  if (!TASK_ID_PATTERN.test(content)) return;
+
+  const pdrPaths = getPdrPaths(content);
+  if (pdrPaths.length === 0) {
+    console.error(`ERROR ${rel}: task file has task_id but no pdr_path`);
+    failures += 1;
+    return;
+  }
+
+  for (const pdrPath of pdrPaths) {
+    const resolved = join(ROOT, pdrPath);
+    if (!existsSync(resolved)) {
+      console.error(`ERROR ${rel}: pdr_path does not exist -> ${pdrPath}`);
+      failures += 1;
+    }
+  }
+}
+
+function validateRequiredTaskDocs() {
+  for (const relPath of REQUIRED_TASK_FILES) {
+    const fullPath = join(ROOT, relPath);
+    if (!existsSync(fullPath)) {
+      console.error(`ERROR ${relPath}: required policy file is missing`);
+      failures += 1;
+      continue;
+    }
+
+    const content = readFileSync(fullPath, 'utf8');
+    if (!/PDR_PATH/i.test(content)) {
+      console.error(`ERROR ${relPath}: missing PDR_PATH policy text`);
+      failures += 1;
+    }
+  }
+}
+
+function main() {
+  console.log('Running PDR_PATH task-file guard...');
+
+  validateRequiredTaskDocs();
+
+  const markdownFiles = [];
+  for (const dir of SCAN_DIRS) {
+    walkMarkdownFiles(join(ROOT, dir), markdownFiles);
+  }
+
+  for (const filePath of markdownFiles) {
+    validateTaskFile(filePath);
+  }
+
+  if (failures > 0) {
+    console.error(`PDR_PATH validation failed with ${failures} error(s).`);
+    process.exit(1);
+  }
+
+  console.log('PDR_PATH guard passed.');
+}
+
+main();

.github/scripts/validate-site.mjs

@@ -12,27 +12,26 @@ let failures = 0;
 const fail = (msg) => { console.error('  ✗ ' + msg); failures++; };
 const ok   = (msg) => console.log('  ✓ ' + msg);
 
-// Pages built on the shared kit (must load assets/site.js).
-const KIT_PAGES = [
-  'index.html', 'browse.html', 'series.html', 'body.html', 'character.html',
-  'family.html', 'quiz.html', 'craft.html', 'contact.html',
-];
-// Standalone legacy page — kept for reference, intentionally self-contained.
-const STANDALONE_PAGES = ['index-gallery-original.html'];
-const PAGES = [...KIT_PAGES, ...STANDALONE_PAGES];
+// Standalone legacy page(s) intentionally not on the shared runtime.
+const STANDALONE_PAGES = new Set(['index-gallery-original.html']);
+
+// Auto-discover root HTML pages so new pages are always validated.
+const PAGES = readdirSync('.')
+  .filter((n) => n.endsWith('.html'))
+  .sort();
 
 console.log('Validating pages…');
 for (const f of PAGES) {
   if (!existsSync(f)) { fail(`${f} is missing`); continue; }
   const html = readFileSync(f, 'utf8');
 
-  // shared-kit reference (kit pages only)
-  if (KIT_PAGES.includes(f) && !html.includes('assets/site.js')) {
+  // shared-kit reference (all non-legacy pages)
+  if (!STANDALONE_PAGES.has(f) && !html.includes('assets/site.js')) {
     fail(`${f} does not reference assets/site.js`);
   }
 
   // baseline SEO / social metadata (kit pages only)
-  if (KIT_PAGES.includes(f)) {
+  if (!STANDALONE_PAGES.has(f)) {
     const META_CHECKS = [
       [/<meta\s+name="description"\s+content="[^"]+"/i, 'meta description'],
       [/<link\s+rel="canonical"\s+href="https?:\/\/[^"]+"/i, 'canonical link'],

.github/workflows/ci.yml

@@ -9,6 +9,10 @@ on:
 permissions:
   contents: read
 
+env:
+  COMMUNITY_CHANNELS_REFERENCE_PATH: _local/reference/zelexdoll-theme/docs/community_channels.json
+  COMMUNITY_CHANNELS_REQUIRE_SOURCE: "false"
+
 concurrency:
   group: ci-${{ github.ref }}
   cancel-in-progress: true
@@ -38,6 +42,67 @@ jobs:
       - name: Validate pages, inline JS, and catalog JSON
         run: node .github/scripts/validate-site.mjs
 
+      - name: Validate community data schema + provenance
+        run: node .github/scripts/validate-community-data.mjs
+
+      - name: Validate community events data schema
+        run: node .github/scripts/validate-community-events-data.mjs
+
+      - name: Guard — community channel sync status (check mode)
+        shell: pwsh
+        run: |
+          if ($env:COMMUNITY_CHANNELS_REQUIRE_SOURCE -eq 'true') {
+            ./scripts/sync_community_channels_from_reference.ps1 -CheckOnly -RequireSource -SourcePath $env:COMMUNITY_CHANNELS_REFERENCE_PATH
+          } else {
+            ./scripts/sync_community_channels_from_reference.ps1 -CheckOnly -SourcePath $env:COMMUNITY_CHANNELS_REFERENCE_PATH
+          }
+
+      - name: Guard — PDR_PATH headers in agent task files
+        run: node .github/scripts/validate-pdr-path-task-files.mjs
+
+      - name: Guard — v2 HTML package is refreshed
+        shell: pwsh
+        run: |
+          ./scripts/refresh_v2_html.ps1 1
+          git diff --exit-code -- "v2 HTML"
+          if ($LASTEXITCODE -ne 0) {
+            Write-Error "v2 HTML package artifacts are stale. Run ./scripts/refresh_v2_html.ps1 and commit updated package files."
+            exit 1
+          }
+
+      - name: Analytics sanity suite
+        shell: pwsh
+        run: |
+          echo "Using threshold config: docs/pdr/PDR-analytics-sanity-thresholds.json"
+          $cfg = Get-Content -Raw docs/pdr/PDR-analytics-sanity-thresholds.json | ConvertFrom-Json
+          echo "Analytics config schema_version: $($cfg.schemaVersion)"
+          ./scripts/run_analytics_sanity_suite.ps1
+
+      - name: Analytics config guardrail (expected fail)
+        shell: pwsh
+        run: |
+          pwsh -File scripts/run_analytics_sanity_suite.ps1 -ConfigPath docs/pdr/PDR-analytics-sanity-thresholds.invalid.json
+          if ($LASTEXITCODE -ne 2) {
+            Write-Error "Expected exit code 2 for invalid analytics config, got $LASTEXITCODE"
+            exit 1
+          }
+
+      - name: Analytics config guardrail missing keys (expected fail)
+        shell: pwsh
+        run: |
+          pwsh -File scripts/run_analytics_sanity_suite.ps1 -ConfigPath docs/pdr/PDR-analytics-sanity-thresholds.missing-keys.json
+          if ($LASTEXITCODE -ne 2) {
+            Write-Error "Expected exit code 2 for missing-keys analytics config, got $LASTEXITCODE"
+            exit 1
+          }
+
+      - name: Upload analytics sanity artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: analytics-sanity-summaries
+          path: .artifacts/analytics
+          if-no-files-found: error
+
       - name: Guard — no images, video, or secrets committed
         run: |
           set -e

.gitignore

@@ -34,6 +34,7 @@ zelexdoll-theme/
 
 # ---- Build artifacts / distributables ----
 *.zip
+!docs/pdr/recovery-pack/HowieZZ_PDR_Recovery_Pack.zip
 *.pdf
 db/*.db
 db/catalog.db
@@ -83,3 +84,4 @@ desktop.ini
 .vscode/
 .idea/
 *.swp
+docs/pdr/qa-screenshots/

404.html

@@ -7,6 +7,8 @@
 <meta name="description" content="The page you were looking for has moved or never existed. Return to the ZELEX Character Atlas.">
 <meta name="theme-color" content="#121212">
 <meta name="robots" content="noindex,follow">
+<link rel="canonical" href="https://www.zelexdoll.com/404.html">
+<meta property="og:title" content="ZELEX — Page Not Found">
 <link rel="icon" type="image/svg+xml" href="/assets/favicon.svg">
 <link rel="preconnect" href="https://fonts.googleapis.com">
 <link href="https://fonts.googleapis.com/css2?family=Playfair+Display:ital,wght@0,400;0,600;0,700;1,400&family=Montserrat:wght@300;400;500;600&display=swap" rel="stylesheet">