feat: initial app, data + CI and Pages workflows

Author: nullnuller

.github/workflows/ci.yml

@@ -0,0 +1,23 @@
+name: CI
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  validate:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Validate JSON dataset
+        run: |
+          jq . data/controls.json > /dev/null
+
+      - name: Basic HTML presence
+        run: |
+          test -f index.html
+

.github/workflows/pages.yml

@@ -0,0 +1,37 @@
+name: Deploy GitHub Pages
+
+on:
+  push:
+    branches: [ main ]
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: .
+
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    needs: build
+    runs-on: ubuntu-latest
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4
+

AGENTS.md

@@ -0,0 +1,39 @@
+# Repository Guidelines
+
+## Project Structure & Module Organization
+- `index.html`: Single-page app entry point (tabs, layout).
+- `styles.css`: Theme and component styles (dark/light toggle).
+- `app.js`: Vanilla JS for routing, filters, dialog, study tools.
+- `data/controls.json`: Source of truth for CIS v8 controls (IDs, text, checklists).
+- `cis_v8_infographic.svg` and `cis_v8_infographic.html`: Infographic assets.
+- `CIS Controls V8/`: Upstream reference docs (PDF/XLSX). Do not edit.
+
+## Build, Test, and Development Commands
+- Run locally (no build step):
+  - `open index.html` (macOS) or double‑click in Explorer/Finder.
+  - `python3 -m http.server 8000` then visit `http://localhost:8000`.
+- Lint (optional if you add tooling):
+  - `npx eslint app.js` and `npx prettier -w .` (if configured).
+
+## Coding Style & Naming Conventions
+- HTML/JS/CSS with 2‑space indentation; wrap at ~100 chars where sensible.
+- Filenames: kebab‑case (`cis_v8_infographic.svg`, `styles.css`).
+- JS: lowerCamelCase for variables/functions, PascalCase for classes, no one‑letter names.
+- Keep logic framework‑free, modular, and accessible (ARIA roles, semantic tags).
+
+## Testing Guidelines
+- No automated tests configured. For manual QA:
+  - Verify search/filter/sort in Controls tab.
+  - Open a card: dialog shows Why/How/Metrics; add to Study.
+  - Study tab: flashcard flip, checklist persistence (localStorage), reset.
+  - Light/dark toggle persists across refresh.
+- If adding tests, place under `tests/` and prefer lightweight browser tests (Playwright). Document commands in this section.
+
+## Commit & Pull Request Guidelines
+- Messages: imperative, concise. Prefer Conventional Commits, e.g., `feat: add IG filters`, `fix: dialog close on ESC`.
+- PRs: include summary, screenshots/GIFs for UI, and reference any issue IDs. Limit scope; avoid unrelated refactors.
+
+## Security & Configuration Tips
+- Do not commit large binaries (e.g., the included video). Keep external assets out of `data/`.
+- Local file links to PDFs/XLSX rely on hosting from the project root or a static server.
+- Treat `data/controls.json` as the canonical content; validate JSON before commit.

README.md

@@ -0,0 +1,31 @@
+# Learn CIS Controls v8 – Interactive Web App
+
+An interactive, self-contained web app to explore CIS Controls v8. It features search, filters (IG1–IG3 and NIST CSF ID/PR/DE/RS/RC), detailed control dialogs with examples and metrics, a Study mode (flashcards, checklists, scenarios), and a quiz system. A built-in Data Loader lets you import authoritative datasets via CSV for accuracy.
+
+## Quick Start
+- Open `index.html` directly, or serve locally:
+  - `python3 -m http.server 8000` → http://localhost:8000
+- Resources → Data Loader to import CSV (columns: `control_num,control_title,sg_id,sg_title,igs,csf`).
+- Use the Controls tab to search and filter; Study tab for scenarios and quizzes.
+
+## Project Structure
+- `index.html` – SPA entry, tabs, inline data fallback, PDF embed
+- `styles.css` – theme, responsive layout, accessible color tokens
+- `app.js` – routing, filters, dialogs, study flow, CSV loader
+- `data/controls.json` – canonical CIS v8 dataset (served via http)
+- `cis_v8_infographic.svg` – infographic used on Overview
+- `.github/workflows/ci.yml` – CI checks (JSON validation)
+- `.github/workflows/pages.yml` – Deploy static site to GitHub Pages
+
+## Accuracy & Data
+- For exact safeguards/IG/CSF mappings, export from your official XLSX to CSV and import via the Data Loader.
+- Scenario mode in Study → Quiz will grade against exact scenario safeguards if provided.
+
+## Development Notes
+- No build step required; pure HTML/CSS/JS.
+- Theme toggle persists; bookmarks and progress stored in localStorage.
+- To extend to other standards (e.g., NIST CSF 2.0, OWASP), provide a JSON/CSV aligned to the app schema.
+
+## License
+No license specified by the author. Consult repository owner before reuse.
+