diff --git a/.github/workflows/pages.yml b/.github/workflows/pages.yml new file mode 100644 index 0000000..8c90d6b --- /dev/null +++ b/.github/workflows/pages.yml @@ -0,0 +1,71 @@ +name: Publish Studio preview + +on: + push: + branches: [main] + workflow_dispatch: + +permissions: + contents: read + pages: write + id-token: write + +concurrency: + group: pages + cancel-in-progress: true + +jobs: + quality: + runs-on: ubuntu-latest + timeout-minutes: 30 + steps: + - uses: actions/checkout@v4 + - uses: actions/setup-node@v4 + with: + node-version: 22 + - uses: actions/setup-python@v5 + with: + python-version: "3.12" + - name: Enable pinned pnpm + run: corepack enable && corepack prepare pnpm@11.7.0 --activate + - name: Install project dependencies + run: pnpm install --frozen-lockfile + - name: Install Studio server dependencies + run: python -m pip install --disable-pip-version-check -r requirements.txt + - name: Install Chromium + run: pnpm exec playwright install --with-deps chromium + - name: Run release quality gate + env: + CI: true + CCA_STUDIO_VERBOSE: "1" + run: pnpm test + build: + needs: quality + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v4 + - uses: actions/setup-node@v4 + with: + node-version: 22 + - name: Enable pinned pnpm + run: corepack enable && corepack prepare pnpm@11.7.0 --activate + - name: Install dependencies + run: pnpm install --frozen-lockfile + - name: Build AI-disabled preview + env: + VITE_CCAF_PUBLIC_PREVIEW: "true" + run: pnpm run studio:build && pnpm run studio:preview:check + - uses: actions/upload-pages-artifact@v3 + with: + path: studio/dist + + deploy: + environment: + name: github-pages + url: ${{ steps.deployment.outputs.page_url }} + runs-on: ubuntu-latest + needs: build + steps: + - name: Deploy to GitHub Pages + id: deployment + uses: actions/deploy-pages@v4 diff --git a/.github/workflows/quality.yml b/.github/workflows/quality.yml new file mode 100644 index 0000000..1623cc6 --- /dev/null +++ b/.github/workflows/quality.yml @@ -0,0 +1,46 @@ +name: Course quality + +on: + push: + pull_request: + +jobs: + audit-and-test: + runs-on: ubuntu-latest + timeout-minutes: 15 + steps: + - uses: actions/checkout@v4 + - uses: actions/setup-node@v4 + with: + node-version: 22 + - uses: actions/setup-python@v5 + with: + python-version: "3.12" + - name: Enable pinned pnpm + run: corepack enable && corepack prepare pnpm@11.7.0 --activate + - name: Install project dependencies + run: pnpm install --frozen-lockfile + - name: Install Studio server dependencies + run: python -m pip install --disable-pip-version-check -r requirements.txt + - name: Install Chromium + run: pnpm exec playwright install --with-deps chromium + - name: Course audit + run: pnpm run audit + - name: Studio typecheck and unit tests + run: pnpm run typecheck && pnpm run test:unit + - name: Save-server tests + run: pnpm run test:server + - name: Studio server tests + run: pnpm run test:studio-server + - name: Production Studio build + run: pnpm run studio:build + - name: Verify release identity + run: pnpm run studio:release:check + - name: Browser journey tests + run: pnpm run test:e2e + - name: Upload verified Studio build + uses: actions/upload-artifact@v4 + with: + name: studio-dist + path: studio/dist + retention-days: 14 diff --git a/.gitignore b/.gitignore index 4a56977..187cb1e 100644 --- a/.gitignore +++ b/.gitignore @@ -2,3 +2,11 @@ my-progress.json my-progress.backup.json my-progress.json.tmp .DS_Store +node_modules/ +.venv/ +.studio-data/ +studio/dist/ +test-results/ +playwright-report/ +__pycache__/ +*.pyc diff --git a/AGENTS.md b/AGENTS.md index 631a54c..3a7bc0e 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -1,36 +1,74 @@ -# AI Tutor Briefing — CCA-F Study Course - -You are the learner's personal tutor for the CCA-F (Claude Certified Architect – Foundations) exam. This folder is a static study site (plain HTML/JS, no build step). Serve it with `python3 serve.py` (auto-saves progress to `my-progress.json`; plain `python3 -m http.server 8000` also works but skips file-saving). - -## Your job - -1. **Teach on request.** When the learner pastes an "Ask my tutor" prompt, answer in this order: plain meaning, tiny example, boxes-and-arrows sketch, production reason, then two short checks. Define jargon on first use. -2. **Grade exercise reports.** Grade the fixed build against the rubric in [exercise-library.js](exercise-library.js). State what is right, what needs repair, one small redo, and the current level: Beginner, Developing, Exam-ready, or Strong. -3. **Grow the course.** After grading or a study session: - - Log real mistakes in a `Mistake Log.md` you create/maintain (date, their wrong idea, the correct idea, a redo exercise). - - Add flashcards for new vocabulary or mistakes by **APPENDING** cards to the right deck in [flashcards.js](flashcards.js) — never reorder or delete existing cards (indices are how learner progress is stored). - - Add new exercises by APPENDING to [exercises.js](exercises.js). Do not replace the fixed build attached to a required unit without a migration plan. -4. **Keep quality up.** Follow [DESIGN-STANDARD.md](DESIGN-STANDARD.md) and [VISUAL-MEDIA-PIPELINE.md](VISUAL-MEDIA-PIPELINE.md): visual first, short chunks, one idea per scene, real screenshots for real interfaces, captioned audio/video, and typed fallbacks. -5. **Protect honest mastery.** A passing score with guesses is not mastery. Required evidence is five lesson steps, quiz at least 80% with zero guesses, an independent build, and a complete teach-back. - -## How the site fits together - -- `course-data.js` is the shared manifest for all 23 required units, prerequisites, resources, lesson cards, and checkpoint banks -- `dashboard.html` = Home · `today.html` = current lesson · `curriculum.html` = 23 units · `timeline.html` = visual progress path -- `foundation-lab.html` = visual/audio Workbench lessons · `concept-map.html` = prerequisite map -- `teachback.html` = voice/typed explanation · `review.html` = spaced review · `tutor-bridge.html` = grounded copy/paste tutor handoff -- `engineer-path.html` = the parallel Applied Engineer and technical-cofounder literacy path -- `flashcards.html?deck=X&mode=browse|learn` reads decks from `flashcards.js` -- `exercise.html?id=X` reads legacy exercises from `exercises.js` plus required fixed builds from `exercise-library.js` -- `quiz.html?set=X` reads question banks from `quizzes.js` · `pretest.html` = 30-Q diagnostic -- Article pages (`article-*.html`) retell Anthropic engineering posts as diagrams; `repair-map.html`, `learning-map.html`, and `concept-map.html` are visual guides -- Shared nav lives in `nav.js` (edit once, applies everywhere) · styles in `study.css` -- **All learner progress lives in browser localStorage** (`ccaf-*` keys). Key ones: `ccaf-curriculum` (units done/opened), `ccaf-pipeline` (today's 5 steps), `ccaf-learn-` (card mastery), `ccaf-ex-` (exercise answers), `ccaf-last` (resume pointer). When served via `serve.py`, nav.js also mirrors every `ccaf-*` change into `my-progress.json` (gitignored) and auto-restores from it — NEVER commit, edit, or delete that file; it is the learner's progress. - -## Rules - -- Content edits must be **append-only** for `flashcards.js` decks and legacy `exercises.js` entries because progress is index-based. -- Do not present reported exam specifications as official. Use the current Exam Facts page, label unverified numbers as "community-reported," and prefer current official Anthropic sources when available. -- Never paste in copyrighted material (book PDFs, full articles) — link instead. -- Never commit `my-progress.json`, backups, private PDFs, Obsidian settings, or personal study notes. -- After any curriculum or JS edit, run `node course-audit.mjs` and load the changed journey in a browser at desktop and phone widths. +# AI Tutor Briefing - CCA-F Study Studio + +You are the learner's tutor, grader, quizmaster, and architecture reviewer for +the Claude Certified Architect - Foundations exam. The learner is a complete +beginner and is dyslexic. Define jargon once, use short chunks, lead with a +visual example, and teach through: + +```text +watch -> draw -> build -> explain aloud -> flashcard +``` + +## Start here + +1. Read this file and `FRONTIER-AI.md`. +2. Launch `./Start CCA-F Study Studio.command` if the app is not already live. +3. Open `http://127.0.0.1:8765/`. +4. If MCP is available, call `get_tutor_briefing`, then `get_current_session`. +5. Continue the one next activity shown by the server. Do not infer progress from old HTML pages. + +## Current architecture + +- `studio/`: React + TypeScript + Vite desktop interface. +- `studio_server/`: FastAPI, deterministic lesson engine, SQLite, optional Ollama tutor, and stdio MCP server. +- `studio/src/content/course-manifest.json`: protected typed course manifest. +- `scripts/start_studio.py`: low-lag Mac launcher using cached runtime and build folders. +- `scripts/run_frontier_mcp.py`: common stdio entry point for Codex, Claude, or another MCP client. +- `/legacy/`: compatibility copy of the original HTML/JavaScript tutor. +- Mutable learner data: `~/Library/Application Support/CCA-F Study Studio/studio.sqlite3`. + +Only W1 is fully wired into the new interactive engine in this release. The +remaining units stay in the protected manifest for staged migration. + +## Teaching and grading + +1. Plain meaning in one or two lines. +2. One tiny concrete example. +3. A simple boxes-and-arrows sketch. +4. One learner action. +5. A brief check, then three flashcards for completed lessons. + +Grade with four levels: **Beginner**, **Developing**, **Exam-ready**, and +**Strong**. Track confidence and guessing separately from correctness. A +correct guess is not secure knowledge. + +## Authority boundaries + +- Deterministic code owns correctness, prerequisites, progression, mastery, and review scheduling. +- Ollama provides requested hints or simplification only. Its output is advisory and cannot change progress. +- Frontier models may grade work, identify failure modes, submit a review, report a content gap, or propose a plan update. +- Frontier models must never change mastery or curriculum directly. The learner accepts or rejects proposals in the app. + +## Content and privacy rules + +- Do not promote community-reported exam specifications to official facts. +- Do not alter exam facts, answer keys, lesson meaning, or video mappings without explicit approval and source verification. +- Never commit or expose progress databases, `my-progress*.json`, credentials, private notes, Obsidian settings, audio, or confidential PDFs. +- Real interface procedures require real screenshots or recordings. Generated visuals may explain invisible concepts but cannot impersonate real software. +- Preserve Atkinson Hyperlegible, 20px body text, visible focus, reduced motion, 200% reflow, and one primary action per scene. + +## Verification + +For code changes, run: + +```bash +pnpm run audit +pnpm run typecheck +pnpm run test:unit +python -m pytest tests/studio_server -q +pnpm run studio:build +pnpm run test:e2e +``` + +Keep the legacy tutor and existing progress compatible until a separately +approved cutover removes them. diff --git a/CLAUDE.md b/CLAUDE.md index 631a54c..229dc6a 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -1,36 +1,16 @@ -# AI Tutor Briefing — CCA-F Study Course +# Claude Code Entry Point -You are the learner's personal tutor for the CCA-F (Claude Certified Architect – Foundations) exam. This folder is a static study site (plain HTML/JS, no build step). Serve it with `python3 serve.py` (auto-saves progress to `my-progress.json`; plain `python3 -m http.server 8000` also works but skips file-saving). +Read `AGENTS.md`, then `FRONTIER-AI.md`, before tutoring or changing code. -## Your job +Use the project MCP server named `ccaf-study-studio` when it is configured. Its +first two calls should be: -1. **Teach on request.** When the learner pastes an "Ask my tutor" prompt, answer in this order: plain meaning, tiny example, boxes-and-arrows sketch, production reason, then two short checks. Define jargon on first use. -2. **Grade exercise reports.** Grade the fixed build against the rubric in [exercise-library.js](exercise-library.js). State what is right, what needs repair, one small redo, and the current level: Beginner, Developing, Exam-ready, or Strong. -3. **Grow the course.** After grading or a study session: - - Log real mistakes in a `Mistake Log.md` you create/maintain (date, their wrong idea, the correct idea, a redo exercise). - - Add flashcards for new vocabulary or mistakes by **APPENDING** cards to the right deck in [flashcards.js](flashcards.js) — never reorder or delete existing cards (indices are how learner progress is stored). - - Add new exercises by APPENDING to [exercises.js](exercises.js). Do not replace the fixed build attached to a required unit without a migration plan. -4. **Keep quality up.** Follow [DESIGN-STANDARD.md](DESIGN-STANDARD.md) and [VISUAL-MEDIA-PIPELINE.md](VISUAL-MEDIA-PIPELINE.md): visual first, short chunks, one idea per scene, real screenshots for real interfaces, captioned audio/video, and typed fallbacks. -5. **Protect honest mastery.** A passing score with guesses is not mastery. Required evidence is five lesson steps, quiz at least 80% with zero guesses, an independent build, and a complete teach-back. +1. `get_tutor_briefing` +2. `get_current_session` -## How the site fits together +The Study Studio server owns correctness and mastery. Claude may review work +and propose changes, but it must not directly alter progress or curriculum. -- `course-data.js` is the shared manifest for all 23 required units, prerequisites, resources, lesson cards, and checkpoint banks -- `dashboard.html` = Home · `today.html` = current lesson · `curriculum.html` = 23 units · `timeline.html` = visual progress path -- `foundation-lab.html` = visual/audio Workbench lessons · `concept-map.html` = prerequisite map -- `teachback.html` = voice/typed explanation · `review.html` = spaced review · `tutor-bridge.html` = grounded copy/paste tutor handoff -- `engineer-path.html` = the parallel Applied Engineer and technical-cofounder literacy path -- `flashcards.html?deck=X&mode=browse|learn` reads decks from `flashcards.js` -- `exercise.html?id=X` reads legacy exercises from `exercises.js` plus required fixed builds from `exercise-library.js` -- `quiz.html?set=X` reads question banks from `quizzes.js` · `pretest.html` = 30-Q diagnostic -- Article pages (`article-*.html`) retell Anthropic engineering posts as diagrams; `repair-map.html`, `learning-map.html`, and `concept-map.html` are visual guides -- Shared nav lives in `nav.js` (edit once, applies everywhere) · styles in `study.css` -- **All learner progress lives in browser localStorage** (`ccaf-*` keys). Key ones: `ccaf-curriculum` (units done/opened), `ccaf-pipeline` (today's 5 steps), `ccaf-learn-` (card mastery), `ccaf-ex-` (exercise answers), `ccaf-last` (resume pointer). When served via `serve.py`, nav.js also mirrors every `ccaf-*` change into `my-progress.json` (gitignored) and auto-restores from it — NEVER commit, edit, or delete that file; it is the learner's progress. +Current local app: `http://127.0.0.1:8765/` -## Rules - -- Content edits must be **append-only** for `flashcards.js` decks and legacy `exercises.js` entries because progress is index-based. -- Do not present reported exam specifications as official. Use the current Exam Facts page, label unverified numbers as "community-reported," and prefer current official Anthropic sources when available. -- Never paste in copyrighted material (book PDFs, full articles) — link instead. -- Never commit `my-progress.json`, backups, private PDFs, Obsidian settings, or personal study notes. -- After any curriculum or JS edit, run `node course-audit.mjs` and load the changed journey in a browser at desktop and phone widths. +Legacy HTML is available at `/legacy/`; it is not the source of current session state. diff --git a/COURSE-AUDIT.md b/COURSE-AUDIT.md index 5fbd3f2..699411b 100644 --- a/COURSE-AUDIT.md +++ b/COURSE-AUDIT.md @@ -105,7 +105,7 @@ The broad lane covers programming, web/networking, data, Git/testing/delivery, s ## Release safeguards -- `course-data.js` is the single source for order, prerequisites, resources, builds, concepts, quiz destinations, and tutor prompts. +- `course-data.js` is the single editing source for order, prerequisites, resources, builds, concepts, quiz destinations, and tutor prompts; the Study Studio's protected `studio/src/content/course-manifest.json` is generated from it (plus `video-data.js`) by `scripts/export-studio-manifest.mjs` and checked in CI. - `course-audit.mjs` validates prerequisites, unique builds, review cards, beginner quiz banks, internal resources, and stale old-unit labels. - Private PDFs, personal progress JSON, Obsidian settings, and personal notes are never included in the public release. - Exam facts remain separately labeled **official** or **reported** and were not rewritten during this repair. diff --git a/FRONTIER-AI.md b/FRONTIER-AI.md new file mode 100644 index 0000000..6b9b6f4 --- /dev/null +++ b/FRONTIER-AI.md @@ -0,0 +1,59 @@ +# Frontier AI Handoff + +This repository contains two tutor surfaces: + +- **CCA-F Study Studio** at `http://127.0.0.1:8765/` is the current local tutor. +- **Legacy tutor** remains available at `/legacy/` for one compatibility release. + +Start the local app with: + +```bash +./Start\ CCA-F\ Study\ Studio.command +``` + +## Connect through MCP + +Study Studio exposes a local **stdio MCP server**. It gives frontier models a +server-authoritative learner session and accepts advisory reviews or proposals. +It cannot directly change mastery or curriculum. + +Universal command: + +```bash +/usr/bin/python3 scripts/run_frontier_mcp.py +``` + +The launcher reuses the cached Study Studio runtime and the same SQLite data in +`~/Library/Application Support/CCA-F Study Studio/`. Launch the app once before +the first MCP connection so that runtime dependencies exist. + +Available tools: + +- `get_tutor_briefing` +- `get_current_session` +- `get_review_packet` +- `submit_frontier_review` +- `propose_study_plan_update` +- `report_content_gap` + +Frontier workflow: + +```text +learner work -> deterministic server -> review packet -> frontier review + | + v + advisory proposal only + | + v + learner accepts or rejects +``` + +## Authority boundaries + +- The server owns correctness, progression, prerequisites, mastery, and review timing. +- The local Ollama model supplies optional hints only and unloads after each response. +- A frontier model may grade, diagnose, and propose changes. +- Only the learner can accept a plan proposal. +- Never read, print, commit, or upload SQLite data, progress snapshots, credentials, private notes, or confidential PDFs. + +Read `AGENTS.md` before tutoring or changing code. Run `npm test` before publishing a code change. diff --git a/QUALITY-REVIEW.md b/QUALITY-REVIEW.md new file mode 100644 index 0000000..cad8464 --- /dev/null +++ b/QUALITY-REVIEW.md @@ -0,0 +1,73 @@ +# CCA-F Tutor Quality Review + +Date: 2026-07-15 + +Branch: `codex/site-quality-review` + +## Findings + +### High - fixed + +1. **An older delayed save could replace newer learner progress.** + - Reproduced with out-of-order POST requests. + - Fixed with monotonic client revisions plus locked, timestamp-aware atomic writes. + - Code: `nav.js:65`, `serve.py:59`, `serve.py:77`. + - Regression: `tests/test_serve.py::test_older_delayed_save_cannot_replace_newer_progress`. + +2. **The wrong build could satisfy a lesson's required evidence.** + - An optional legacy exercise could be credited to a different unit. + - Fixed by requiring the manifest's exact exercise ID and clearing matching evidence when a build is unmarked. + - Code: `nav.js:199`, `exercise.html:209`, `exercise.html:234`. + - Regression: `tests/e2e/learner-journey.spec.js` covers canonical, optional, and unmark flows. + +### Medium - fixed + +3. **Progress imports and resume links trusted malformed or unsafe input.** + - Fixed with a shared size/type/key validator, same-origin HTML resume links, and import confirmation. + - Code: `nav.js:6-43`, `dashboard.html:287-300`, `serve.py:36-57`. + +4. **A weaker quiz retake could erase a previously earned zero-guess pass.** + - Fixed by preserving qualified mastery separately from the latest practice attempt. + - Code: `nav.js:192-216`, `quiz.html:210-214`, `pretest.html`. + +5. **Several pages could silently fall back to an older partial course path.** + - Fixed by using the shared 23-unit manifest and showing a visible load failure when it is absent. + - Code: `today.html:188-196`, plus the shared order in Dashboard, Notes, and Quiz. + +6. **Curriculum summaries had drifted from the shared course manifest.** + - Fixed after explicit learner approval by hydrating title, goal, tutor prompt, and quiz URL from the manifest. + - Rich words, chapters, preparation, diagrams, and videos remain unchanged. + - Code: `curriculum.html:273-305`. + +7. **Core interactions were mouse-first or did not announce state changes.** + - Fixed native buttons, menu keyboard behavior, focus return, visible focus, live feedback, flashcard state, and read-aloud semantics. + - Code: `nav.js:298-325`, `timeline.html:122`, `flashcards.html:58`, `read-aloud.js`, `review.html`, `teachback.html`. + +8. **Long lesson examples could push the Notes page sideways on a phone.** + - Reproduced at 390 px with the file-path example. + - Fixed with safe wrapping and retained diagnostic overflow reporting. + - Code: `notes.html:16`. + +### Low - fixed + +9. **Shared navigation had patchwork Back/Home behavior.** + - The old Back action could leave the course; its first repair duplicated Home. + - The later UX pass replaced it with stable Home, Today, Course, Practice, Progress, and Menu destinations. + - See `UX-FLOW-REVIEW.md` for the current journey contract. + +## Verification + +- Course integrity: **825 checks passed**. +- JavaScript syntax: **15 files passed**. +- Server safety: **9 tests passed**. +- Browser journeys: **20 desktop flows and 1 phone flow passed**. +- Phone reflow: **passed** across Dashboard, Today, Timeline, Curriculum, Notes, Quiz, Build, Teach-back, and Review. +- Manual browser pass: Dashboard, Today, Notes, and Quiz rendered without console errors; quiz keyboard focus was visibly clear. +- Protected content: no diff in exam facts, course data, unit data, lesson notes, quiz answers, exercises, or video mappings. + +## Remaining Risks + +1. `notes-corrections.js` still applies targeted string corrections. The audit now fails if a target disappears, but a later data-model cleanup would be safer than expanding this patch system. +2. GitHub Pages remains browser-only storage by design. Cross-browser file restore requires the local `serve.py` tutor. +3. Automated checks and manual keyboard testing do not equal a complete screen-reader or WCAG conformance audit. +4. A plaintext MCP credential was detected in the local Codex configuration. Rotate it outside this repository; it was never printed or committed. diff --git a/README.md b/README.md index 008de7b..0d24682 100644 --- a/README.md +++ b/README.md @@ -9,6 +9,8 @@ A complete, self-contained study site for Anthropic's **Claude Certified Archite - **⚛️ The Atomic Curriculum** — 23 prerequisite-aware units, starting with a five-lesson computer-skills Workbench and building through Claude foundations, agentic systems, reliability, and production scenarios - **🛤️ Timeline** — the whole course as one visual path with ✓ done / ⭐ you-are-here tracking - **▶️ Lesson page** — tells you exactly what to do next: your current lesson, its video, and its 5 steps (they stay with the lesson until you finish it) +- **🔊 Natural read-along** — the seven beginner Workbench lessons include local ElevenLabs narration, word highlighting, a seek bar, and remembered `0.75x`-`2x` speed control +- **🎥 Reviewed video library** — 22 recent community episodes catalogued, with 14 exact lesson clips, full-episode links, transcript provenance, and current-product warnings - **🗺️ Prerequisite concept map** + **3 engineering articles retold as ~30 diagrams** (Building Effective Agents, Multi-Agent Research System, Writing Tools for Agents — original links included) - **🃏 5 flashcard decks** with two modes: flip-through *and* a Quizlet-style Learn mode that re-asks what you miss - **🧪 Pre-test (30 Q) + 6 checkpoint quizzes** that track your score *and how much you guessed* @@ -17,12 +19,13 @@ A complete, self-contained study site for Anthropic's **Claude Certified Archite - **💬 Grounded tutor bridge** that copies the current lesson, prerequisite, rubric, and recent evidence into a focused tutor prompt - **🧰 Applied Engineer path** for programming, APIs, databases, Git, testing, systems, security, architecture, and technical-cofounder judgment - **🩹 Repair guide** — the trickiest pre-test questions explained as pictures -- Progress is saved automatically — every tick, card and typed answer, the instant you make it; no account, no tracking. On the hosted site it lives in your browser (per-browser, per-address — with **Export/Import backup buttons** on the Home page). Run it locally with `serve.py` and it's **also written to a real file, `my-progress.json`**, which auto-restores if the browser's copy is ever cleared. +- **🎛️ NEW: CCA-F Study Studio** — a rebuilt guided app (React + a local Python server + a private SQLite database) that walks one unit at a time through **Learn → Draw → Build → Teach → Quiz → Review**, with server-side grading, verified backups, and an MCP connection for AI tutors ([FRONTIER-AI.md](FRONTIER-AI.md)). Unit **W1 is fully interactive** today; the other 22 units are in the protected manifest for staged migration, and the classic pages above stay available at `/legacy/`. +- Progress is saved automatically **when you run the course locally** — every tick, card and typed answer; no account, no tracking. The classic pages save to your browser and (with `serve.py`) to a real file, `my-progress.json`, which auto-restores if the browser's copy is ever cleared; Study Studio saves to a private local database with verified export/import backups. The hosted site is a **preview only and does not save progress**. ## 🚀 Run it — two ways -### 🌐 Option 1: just use the website (zero setup) -Open **https://zengdaniel7.github.io/claude-architect-study-course/** — everything works right there: lessons, diagrams, quizzes, flashcards, exercises, and **your progress saves automatically in your browser** (checkmarks, mastered cards, exercise answers — no account needed). One catch: that progress lives in *that* browser on *that* device, and the course content itself is fixed — you can't change it. +### 🌐 Option 1: peek at the live preview (zero setup) +Open **https://zengdaniel7.github.io/claude-architect-study-course/** — a **preview of the new Study Studio**. You can click through the first unit (W1) end to end: Learn → Draw → Build → Teach → Quiz → Review. It shows **"Preview only. Progress is not saved."** and means it — nothing persists between visits, and the AI tutor is switched off. Use it to *see* the course; download it to *study*. ### 💻 Option 2: download it for FULL access (recommended) ```bash @@ -30,16 +33,22 @@ git clone https://github.com/zengdaniel7/claude-architect-study-course.git cd claude-architect-study-course python3 serve.py ``` -Open http://localhost:8000 — start at the **Home** page. Downloading unlocks what the website can't do: +Open http://localhost:8000 — start at the **Home** page. Downloading unlocks what the hosted preview can't do: - **Your progress becomes a real file** — `serve.py` mirrors every tick and typed answer into `my-progress.json` in the folder, automatically, and restores from it if browser data is ever cleared. (Plain `python3 -m http.server 8000` works too, but then saves stay browser-only.) - **The course becomes YOURS to grow** — run an AI coding agent (like [Claude Code](https://claude.com/claude-code)) in the folder and the included [CLAUDE.md](CLAUDE.md) turns it into your personal tutor: it grades your exercise reports, keeps your mistake log, **adds new flashcards and exercises to the actual files** as you learn. The hosted site can never edit itself — a local copy can. - Works offline, and you can edit any lesson to match how you learn. -| | 🌐 Website | 💻 Downloaded | +**⭐ Want the new Study Studio app locally?** It ships as source. Build it once with Node 20+ and pnpm (`corepack enable && pnpm install && pnpm run studio:build`), then launch: +```bash +./Start\ CCA-F\ Study\ Studio.command +``` +Open **http://127.0.0.1:8765/** — W1 fully guided with server-side grading, progress in a private local database (with verified export/import backups), the classic pages at `/legacy/`, and MCP hookup for AI tutors ([FRONTIER-AI.md](FRONTIER-AI.md)). + +| | 🌐 Hosted preview | 💻 Downloaded | |---|---|---| -| Lessons, quizzes, flashcards, exercises | ✅ | ✅ | -| Progress auto-saves (in your browser) | ✅ | ✅ | -| Progress also saved to a real file on disk, with auto-restore | ❌ | ✅ | +| See the new Study Studio (W1 guided journey) | ✅ preview | ✅ (after one build) | +| Full classic course: lessons, quizzes, flashcards, exercises | ❌ | ✅ | +| Progress saves | ❌ never (preview only) | ✅ browser + `my-progress.json`, or the Studio database | | AI tutor that grades + upgrades the course files | ❌ | ✅ | | Edit lessons / add your own content | ❌ | ✅ | | Works offline | ❌ | ✅ | @@ -53,7 +62,7 @@ The course is model-agnostic. Every **"Ask my tutor"** and **"🧠 Check my answ ## 📖 How to study with it 1. Open **Home** → take the **Pre-Test** to set your baseline (watch your *guess count*, not just the score) -2. Every day, open **Today** — it tees up one unit and 5 small steps (watch → draw → build → explain → flashcards) +2. Every day, open **Today** — watch the short assigned clip first, open the full episode when useful, then continue through notes → draw → build → explain → flashcards 3. Complete the unit's independent build and 60-second teach-back 4. Retake its quiz until you reach at least 80% with **zero guessing** 5. A unit is mastered only when all four evidence types are present: lesson steps, quiz, independent build, and teach-back @@ -62,8 +71,10 @@ The course is model-agnostic. Every **"Ask my tutor"** and **"🧠 Check my answ - Curriculum structure inspired by [Atomic Design](https://atomicdesign.bradfrost.com/) by Brad Frost - Accessibility baseline documented in [DESIGN-STANDARD.md](DESIGN-STANDARD.md) +- Video choices and timestamps are documented in [VIDEO-CURRICULUM-MAP.md](VIDEO-CURRICULUM-MAP.md); community videos are clearly separated from official Anthropic sources - Diagrams retell three Anthropic engineering articles (linked at the top of each article page) - Font: [Atkinson Hyperlegible](https://www.brailleinstitute.org/freefont/) (Braille Institute, SIL OFL) — designed for low-vision and dyslexic readers +- Foundation narration: generated through Higgsfield using an ElevenLabs preset voice; audio is stored locally and no API key is shipped in the site - Free prep courses: [Anthropic Academy](https://anthropic.skilljar.com/) ## 📄 License diff --git a/STUDIO-QUALITY-REVIEW.md b/STUDIO-QUALITY-REVIEW.md new file mode 100644 index 0000000..3fc1315 --- /dev/null +++ b/STUDIO-QUALITY-REVIEW.md @@ -0,0 +1,80 @@ +# CCA-F Study Studio Quality Review + +Date: 2026-07-16 +Branch: `codex/study-studio-rebuild` + +## Findings and repairs + +### P1 - Bodyless requests could freeze the whole app + +`BodyLimitMiddleware` waited for a request-body event even on `GET`. Uvicorn does not promise that event, so the page and every read API could stay blank indefinitely. + +**Repair:** bypass body buffering for `GET`, `HEAD`, and `OPTIONS`; preserve streaming size enforcement for writes; add an exact regression test that fails if a `GET` touches `receive()`. + +### P1 - Learner progress could be raced or self-scored + +Stage changes, review creation, and frontier submissions were not fully atomic. Quiz payloads could also report their own score. + +**Repair:** use `BEGIN IMMEDIATE` for transitions; enforce one pending review; derive quiz correctness and guess counts from the canonical manifest; require the real pending review ID; schedule Hard/Got it reviews deterministically; keep proposal decisions immutable; reject newer database schemas instead of silently downgrading them. + +### P1 - Local/private files had weak boundaries + +The legacy server could expose dot-prefixed paths such as `.studio-data`, and the Studio compatibility routes did not require the local instance token. + +**Repair:** block all dot-prefixed paths, progress files, and temporary files; validate Host and exact Origin including port; require the instance header or HttpOnly same-site cookie for private reads and writes; return the real stale-save result. + +### P1 - The learner journey had dead ends and overlays + +Stage changes retained the old scroll position. The sticky action bar covered explanations and inputs. A completed review still looked active, Home still said Continue, and the Review hub offered a zero-card review. + +**Repair:** focus and scroll each new scene to its heading; keep actions in normal document flow; add explicit mastered, empty-review, and completed-course states; update the top bar and Home state; replace completed weekly goals with a calm next-review message. + +### P2 - Several interactions could become stale or silently fail + +Strict Mode could initialize twice; failed saves had no learner-facing recovery; Stop tutor could leave a spinner; resetting CodeMirror did not reliably update the editor; microphone and speech resources could survive the screen. + +**Repair:** share one API initialization promise, show save failures without discarding on-screen work, make tutor waits abortable, synchronize CodeMirror from props, and clean up recorder, blob URL, speech, and tutor tasks. + +### P2 - A local startup failure could masquerade as preview mode + +If the local progress API failed during initialization, the app silently switched to the unsaved public demo. A learner could continue without realizing the work was temporary. + +**Repair:** localhost now shows a clear recovery screen and never enters demo mode after an API failure. AI-disabled preview remains available only when the static public site has no local API. + +### P2 - Development I/O looked like application lag + +The production bundle is modest, but Node and thousands of development files were being read from the synced Documents folder while an 8 GB Mac was under memory compression. + +**Repair:** daily launch now uses a cached Python environment, cached built site, cached server source, and SQLite in macOS Application Support. No Vite, Node, test worker, or model starts during study. The Ollama guard keeps the model off below 35% free memory on a low-memory Mac. + +### P2 - Public preview and CI did not cover Studio + +The Vite build used root-relative assets, the Pages flow was missing, and the quality workflow did not run Studio type, unit, server, or build checks. + +**Repair:** use a relative Vite base; add an AI-disabled GitHub Pages preview; expand CI; explicitly allow only the pinned `esbuild` install script under pnpm 11; add an isolated Studio browser server and a full W1 journey test. + +## Measured results + +- Warm production page: 16-22 ms local response time. +- Warm launcher: server announces within about 1 second; no dependency install on later launches. +- Initial JavaScript: 330.35 kB raw, 103.70 kB gzip. +- CodeMirror workbench: lazy 293.94 kB raw, 95.56 kB gzip; it loads only during Build. +- CSS: 22.95 kB raw, 5.35 kB gzip. +- Production build: PASS, 130 modules, 2m 15s under current synced-folder pressure. +- Curriculum audit: PASS, 825 checks. +- Protected curriculum baseline: PASS, 4 files unchanged. +- Typed manifest check: PASS, 23 canonical units match. +- TypeScript: PASS. +- Frontend unit suite: PASS, 6 files and 10 tests from the local test cache. +- Studio server: PASS, 17 tests. +- Legacy save server: PASS, 9 tests. +- In-app browser: PASS through Learn, Draw, Build boundary, Teach, zero-guess Quiz, Review, mastery, empty queue, scheduled review, Again/Hard spacing, and low-memory Settings state. + +## Remaining risks + +- Vitest workers cannot start within their fixed timeout when launched directly from the synced folder. The identical cached worktree passes all 10 tests in 1.93 seconds; CI remains the clean repository gate. +- The in-app browser driver cannot synthesize a local file selection. The live file UI was inspected, the server transition was tested separately, and the committed Playwright journey uses `setInputFiles` in CI. +- Only W1 is wired into the interactive engine in this release. The full course remains in the protected typed manifest for staged migration. +- FastAPI's current TestClient emits a deprecation warning about its HTTPX adapter; behavior is covered, but the adapter should be updated when the upstream replacement is stable. + +No exam claim, quiz answer, video mapping, or protected curriculum file changed in this repair. diff --git a/Start CCA-F Study Studio.command b/Start CCA-F Study Studio.command new file mode 100755 index 0000000..1e0097c --- /dev/null +++ b/Start CCA-F Study Studio.command @@ -0,0 +1,3 @@ +#!/bin/zsh +cd "$(dirname "$0")" +exec /usr/bin/python3 scripts/start_studio.py diff --git a/UX-FLOW-REVIEW.md b/UX-FLOW-REVIEW.md new file mode 100644 index 0000000..d9933e9 --- /dev/null +++ b/UX-FLOW-REVIEW.md @@ -0,0 +1,95 @@ +# CCA-F Tutor UX and Flow Review + +Date: 2026-07-15 + +Branch: `codex/ux-flow-overhaul` + +## Target Journey + +Every lesson now follows one visible path: + +`Learn -> Draw -> Build -> Teach -> Quiz -> Review` + +Each stage has one primary action. Optional tools and alternate routes stay behind disclosures or in the Practice hub. + +## Findings + +### Critical - fixed + +1. **The local tutor could stall on a blank page after rendering only the navigation shell.** + - Reproduced in the in-app browser while opening Flashcards. + - Plain `http.server` was receiving unsupported progress POSTs on page after page. Its terminal log could fill while course scripts were still loading. + - Fixed with a one-time `/__health` capability check. Plain servers remain browser-only and issue no progress POSTs; `serve.py` stays quiet and keeps file backups. + - Code: `nav.js`, `serve.py`. + - Regression: `plain static-server mode never floods unsupported progress saves` and the server health tests. + +### High - fixed + +2. **The site did not behave like one course.** + - Learn, Notes, Build, Teach-back, Quiz, and Review each had different exits and generic Back links. + - Added one shared six-stage rail and a shared next-action component across the complete lesson journey. + - Code: `nav.js`, `dashboard.html`, `today.html`, `foundation-lab.html`, `notes.html`, `draw.html`, `exercise.html`, `teachback.html`, `quiz.html`, `review.html`. + +3. **Review cards had no visible Next-card step.** + - The old flow auto-advanced after grading, and the large blank card made the control relationship unclear. + - Review now uses: Reveal answer -> choose Again/Hard/Got it -> explicit Next card. + - A card is not scheduled until Next card is pressed. + - Code: `review.html`. + +4. **Quiz and Pre-Test controls covered answer choices.** + - Reproduced visually at desktop size: the sticky Previous/Next bar sat over the final answer and guessing checkbox. + - Both assessments now show one question at a time, place navigation after the answers, retain progress, and move focus to the next question. + - Code: `quiz.html`, `pretest.html`. + - Regression: `quiz controls come after the answer choices instead of covering them`. + +5. **Draw was a named stage without a real activity.** + - The old Draw link returned to a checklist row. + - Added a touch/mouse sketchpad with concept boxes, color swatches, pen size, undo, clear, autosave, a paper option, and a text alternative. + - Completing it saves lesson evidence and hands off directly to Build. + - Code: `draw.html`, `nav.js`, `today.html`. + +### Medium - fixed + +6. **Several pages competed with the primary action.** + - Stale resume links, lesson browsers, tutor-copy controls, and optional practice appeared beside the required next step. + - Resume and alternate actions now live in disclosures. Build and Teach-back end with one next-stage action. + +7. **Two flashcard systems looked like the same requirement.** + - The lesson Review queue and the optional Flashcard library used overlapping names and modes. + - The Practice hub and library now state which is required. Library modes are named Browse and Quiz me. + +8. **Normal navigation caused avoidable request and save churn.** + - File restore is checked once per tab, static course files can revalidate, and long text inputs save on a short debounce instead of every keystroke. + - Code: `nav.js`, `serve.py`, `exercise.html`, `teachback.html`. + +9. **Keyboard and screen-reader names were incomplete.** + - Weekly controls, daily checkboxes, exercise fields, filter controls, progress feedback, and disclosure state now expose names and state. + - A global hidden rule prevents hidden controls from reappearing when a component sets its own display style. + +10. **Mobile navigation carried the desktop information load.** + - Phone navigation now keeps Home, Today, and Menu visible. Course, Practice, and Progress move into Menu. + +## Protected Content + +- Exam claims and reported/official labels were not changed. +- Unit order, lesson meaning, quiz answers, exercise prompts, and video mappings were not rewritten. +- Existing `ccaf-*` storage keys remain compatible. +- Personal progress files are excluded from the change set. + +## Remaining Risks + +1. **Content sequencing needs a separate curriculum decision.** The first file lesson's build asks for valid JSON before the following JSON lesson teaches the syntax. This review flags it but does not rewrite protected curriculum content. +2. **Speech features depend on browser support.** Typing, paper drawing, and text alternatives remain complete fallbacks. +3. **GitHub Pages remains browser-only storage.** Local `serve.py` is required for automatic `my-progress.json` backups. +4. **Older reference pages are denser than the primary lesson journey.** They remain optional and no longer interrupt the required path. + +## Acceptance Matrix + +- Fresh and established progress +- Home -> lesson -> Learn -> Draw -> Build -> Teach -> Quiz -> Review +- Explicit card progression and scheduling +- One-question Quiz and Pre-Test progression +- Export/import and malformed progress +- Plain server and file-saving server modes +- Desktop, phone, 200% zoom, reduced motion, keyboard operation, long text, and overflow +- No unintended curriculum or exam-fact edits diff --git a/VIDEO-CURRICULUM-MAP.md b/VIDEO-CURRICULUM-MAP.md new file mode 100644 index 0000000..ebb0b0b --- /dev/null +++ b/VIDEO-CURRICULUM-MAP.md @@ -0,0 +1,57 @@ +# Video Curriculum Map + +Use this note to audit how reviewed videos enter the course. The live learner view is [video-library.html](video-library.html). + +## July 15, 2026 snapshot + +- Reviewed all 22 available videos in the Peace Of Code playlist from native captions. +- Assigned 14 exact clips across 13 lessons; every clip is under 10 minutes. +- Each assigned video has two choices: **watch the lesson clip** or **open the full episode**. +- Kept official Anthropic lessons and documentation as the authority. +- Excluded the promo, unofficial exam-coaching episode, and two unavailable playlist items from the teaching path. +- Corrected current-product differences for stop reasons, MCP Tool Search, Structured Outputs, Skills, CLAUDE.md, Batch API, and deliberate memory persistence. + +## Alignment gate + +A segment enters a lesson only when it: + +- matches the lesson objective; +- does not require an untaught prerequisite; +- is current enough for the product or API shown; +- supports an exam concept, practical build, or applied-engineer skill; +- has a verified timestamp and a clear reason to watch. + +## Approved lesson segments + +| Lesson | Video | Start-end | One-line focus | Domain | Evidence | +|---|---|---|---|---|---| +| o1 · Agent Loop | [Ep 01 clip](https://www.youtube.com/watch?v=ldqOnljDINc&t=1157s) · [full](https://www.youtube.com/watch?v=ldqOnljDINc) | 19:17-21:46 | Reason, call a tool, read the result, decide again. | Agentic | Native captions; ends before stale stop-reason claim | +| o2 · Orchestrator-Workers | [Ep 02 clip](https://www.youtube.com/watch?v=ejPWvBcc_DU&t=362s) · [full](https://www.youtube.com/watch?v=ejPWvBcc_DU) | 06:02-08:34 | Name the coordinator's jobs before adding workers. | Agentic | Native captions | +| t2 · Research system | [Ep 03 clip](https://www.youtube.com/watch?v=a2N6vKdQUfE&t=640s) · [full](https://www.youtube.com/watch?v=a2N6vKdQUfE) | 10:40-18:24 | Carry sources with findings and resolve conflicts. | Agentic | Native captions | +| t1 · Support system | [Ep 05 clip](https://www.youtube.com/watch?v=JJBcpwpsKzk&t=1338s) · [full](https://www.youtube.com/watch?v=JJBcpwpsKzk) | 22:18-27:40 | Block an action until a required fact is verified. | Agentic / Code | Native captions | +| m2 · One tool call | [Ep 06 clip](https://www.youtube.com/watch?v=s1j1vTnCKns&t=58s) · [full](https://www.youtube.com/watch?v=s1j1vTnCKns) | 00:58-09:48 | See how names and descriptions change tool choice. | Tools & MCP | Native captions | +| o3 · MCP server | [Ep 08 clip](https://www.youtube.com/watch?v=IVUxGTxSuH8&t=104s) · [full](https://www.youtube.com/watch?v=IVUxGTxSuH8) | 01:44-11:24 | See the MCP client-server picture and connection. | Tools & MCP | Native captions; stale later section excluded | +| m4 · Built-in tools | [Ep 09 clip](https://www.youtube.com/watch?v=eh-xxQpfBBY&t=1216s) · [full](https://www.youtube.com/watch?v=eh-xxQpfBBY) | 20:16-27:28 | Follow search -> read -> edit through a codebase. | Claude Code | Native captions | +| o4 · Claude Code workflows | [Ep 12 clip](https://www.youtube.com/watch?v=q-n1cut5e7c&t=280s) · [full](https://www.youtube.com/watch?v=q-n1cut5e7c) | 04:40-09:08 | Choose plan mode for complex, ambiguous, or risky work. | Claude Code | Native captions | +| d2 · Commits, PRs, CI | [Ep 13 clip](https://www.youtube.com/watch?v=GWCnDhgH840&t=342s) · [full](https://www.youtube.com/watch?v=GWCnDhgH840) | 05:42-08:22 | Connect a pull request to automatic checks. | Claude Code | Native captions | +| m3 · Prompt techniques | [Ep 14 clip](https://www.youtube.com/watch?v=HqwULqy1egw&t=902s) · [full](https://www.youtube.com/watch?v=HqwULqy1egw) | 15:02-22:00 | Replace vague guidance with pass/fail criteria. | Prompting | Native captions; primary | +| m3 · Prompt techniques | [Ep 15 clip](https://www.youtube.com/watch?v=FbIcU6YFrhw&t=772s) · [full](https://www.youtube.com/watch?v=FbIcU6YFrhw) | 12:52-17:26 | Target ambiguous edge cases with a few examples. | Prompting | Native captions; optional | +| p2 · PR-review capstone | [Ep 17 clip](https://www.youtube.com/watch?v=BXs7QoLQxX0&t=1246s) · [full](https://www.youtube.com/watch?v=BXs7QoLQxX0) | 20:46-28:46 | Review each item, then run an integration pass. | Reliability | Native captions | +| rel · Reliability | [Ep 18 clip](https://www.youtube.com/watch?v=7kaJdZ7veDs&t=206s) · [full](https://www.youtube.com/watch?v=7kaJdZ7veDs) | 03:26-11:42 | Separate working context from durable memory. | Reliability | Native captions | +| px · Anti-patterns | [Ep 20 clip](https://www.youtube.com/watch?v=tsIxzFg76Nw&t=2544s) · [full](https://www.youtube.com/watch?v=tsIxzFg76Nw) | 42:24-45:42 | Use a human checkpoint for high-risk synthesis. | Reliability | Native captions | + +## Reference-only episodes + +- Episodes 04, 07, 10, 11, 16, and 19 remain available as extra review in the video library. +- Each reference card explains any historical or simplified behavior before the learner opens the full episode. +- Episode 00 and the bonus exam-coaching episode are visible as **not assigned**, so exclusions are transparent. + +## Rules + +- Keep one primary video and at most one optional video per lesson. +- Link to the exact YouTube timestamp; do not copy full transcripts. +- Store the source URL and review date for provenance. +- Use transcript-first review for long videos, then focused frames around demonstrations. +- Mark outdated or contradictory claims instead of silently teaching them. +- Turn only verified ideas into lesson notes, flashcards, or build steps. +- Keep the learner flow visible: **watch clip -> open full episode if useful -> read notes -> review notes**. diff --git a/VISUAL-MEDIA-PIPELINE.md b/VISUAL-MEDIA-PIPELINE.md index b08e489..5f2045b 100644 --- a/VISUAL-MEDIA-PIPELINE.md +++ b/VISUAL-MEDIA-PIPELINE.md @@ -22,3 +22,11 @@ Every lesson communicates its main idea visually before sustained reading. 5. alt text that states the teaching point No autoplay. No dense body copy inside an image. Every video needs a still or text fallback. Generated interfaces must never be presented as real product screenshots. + +## Reviewed video rule + +- Review long videos transcript-first, then inspect frames around demonstrations. +- Link the exact lesson segment and keep a separate full-episode link. +- Use one primary source and at most one optional community clip per lesson. +- Label community material clearly; current official documentation wins when behavior differs. +- Keep captions, a one-line focus, and a local notes fallback. diff --git a/artifacts/studio-audit/01-home-natural.png b/artifacts/studio-audit/01-home-natural.png new file mode 100644 index 0000000..866bac7 Binary files /dev/null and b/artifacts/studio-audit/01-home-natural.png differ diff --git a/artifacts/studio-audit/01-home.png b/artifacts/studio-audit/01-home.png new file mode 100644 index 0000000..7219533 Binary files /dev/null and b/artifacts/studio-audit/01-home.png differ diff --git a/artifacts/studio-audit/02-learn.png b/artifacts/studio-audit/02-learn.png new file mode 100644 index 0000000..310dd27 Binary files /dev/null and b/artifacts/studio-audit/02-learn.png differ diff --git a/artifacts/studio-audit/03-draw.png b/artifacts/studio-audit/03-draw.png new file mode 100644 index 0000000..a0bcaaf Binary files /dev/null and b/artifacts/studio-audit/03-draw.png differ diff --git a/artifacts/studio-audit/04-build-bridge.png b/artifacts/studio-audit/04-build-bridge.png new file mode 100644 index 0000000..cabdd4e Binary files /dev/null and b/artifacts/studio-audit/04-build-bridge.png differ diff --git a/artifacts/studio-audit/05-build-practice.png b/artifacts/studio-audit/05-build-practice.png new file mode 100644 index 0000000..d48c267 Binary files /dev/null and b/artifacts/studio-audit/05-build-practice.png differ diff --git a/artifacts/studio-audit/06-build-mac.png b/artifacts/studio-audit/06-build-mac.png new file mode 100644 index 0000000..a88c25f Binary files /dev/null and b/artifacts/studio-audit/06-build-mac.png differ diff --git a/artifacts/studio-audit/07-teach.png b/artifacts/studio-audit/07-teach.png new file mode 100644 index 0000000..eae2a3e Binary files /dev/null and b/artifacts/studio-audit/07-teach.png differ diff --git a/artifacts/studio-audit/08-quiz.png b/artifacts/studio-audit/08-quiz.png new file mode 100644 index 0000000..0d333d5 Binary files /dev/null and b/artifacts/studio-audit/08-quiz.png differ diff --git a/artifacts/studio-audit/09-quiz-feedback.png b/artifacts/studio-audit/09-quiz-feedback.png new file mode 100644 index 0000000..9fb0c99 Binary files /dev/null and b/artifacts/studio-audit/09-quiz-feedback.png differ diff --git a/artifacts/studio-audit/10-review-front.png b/artifacts/studio-audit/10-review-front.png new file mode 100644 index 0000000..a579667 Binary files /dev/null and b/artifacts/studio-audit/10-review-front.png differ diff --git a/artifacts/studio-audit/11-review-back.png b/artifacts/studio-audit/11-review-back.png new file mode 100644 index 0000000..965f0be Binary files /dev/null and b/artifacts/studio-audit/11-review-back.png differ diff --git a/artifacts/studio-audit/12-complete-stuck.png b/artifacts/studio-audit/12-complete-stuck.png new file mode 100644 index 0000000..0c857c1 Binary files /dev/null and b/artifacts/studio-audit/12-complete-stuck.png differ diff --git a/artifacts/studio-audit/13-split-800.png b/artifacts/studio-audit/13-split-800.png new file mode 100644 index 0000000..53710b2 Binary files /dev/null and b/artifacts/studio-audit/13-split-800.png differ diff --git a/artifacts/studio-audit/14-zoom-200.png b/artifacts/studio-audit/14-zoom-200.png new file mode 100644 index 0000000..a77a2ef Binary files /dev/null and b/artifacts/studio-audit/14-zoom-200.png differ diff --git a/artifacts/studio-audit/15-home-after.jpg b/artifacts/studio-audit/15-home-after.jpg new file mode 100644 index 0000000..ecf3c44 Binary files /dev/null and b/artifacts/studio-audit/15-home-after.jpg differ diff --git a/artifacts/studio-audit/16-learn-after.jpg b/artifacts/studio-audit/16-learn-after.jpg new file mode 100644 index 0000000..f8040ff Binary files /dev/null and b/artifacts/studio-audit/16-learn-after.jpg differ diff --git a/artifacts/studio-audit/17-quiz-feedback-after.jpg b/artifacts/studio-audit/17-quiz-feedback-after.jpg new file mode 100644 index 0000000..8e3b8ea Binary files /dev/null and b/artifacts/studio-audit/17-quiz-feedback-after.jpg differ diff --git a/artifacts/studio-audit/18-review-after.jpg b/artifacts/studio-audit/18-review-after.jpg new file mode 100644 index 0000000..dc03a84 Binary files /dev/null and b/artifacts/studio-audit/18-review-after.jpg differ diff --git a/artifacts/studio-audit/19-review-comparison.jpg b/artifacts/studio-audit/19-review-comparison.jpg new file mode 100644 index 0000000..66fdc09 Binary files /dev/null and b/artifacts/studio-audit/19-review-comparison.jpg differ diff --git a/artifacts/studio-audit/comparison.html b/artifacts/studio-audit/comparison.html new file mode 100644 index 0000000..02f09b3 --- /dev/null +++ b/artifacts/studio-audit/comparison.html @@ -0,0 +1,30 @@ + + + + + + Review flow comparison + + + +

Review flow: reported problem and verified repair

+
+
+
Before: no visible next-card path
+ Original legacy review queue screenshot +
+
+
After: reveal, rate, then a clear Finish review action
+ Rebuilt Study Studio review screen +
+
+ + diff --git a/artifacts/studio-audit/design-qa.md b/artifacts/studio-audit/design-qa.md new file mode 100644 index 0000000..2988a13 --- /dev/null +++ b/artifacts/studio-audit/design-qa.md @@ -0,0 +1,28 @@ +# Studio Design QA + +## Reviewed journey + +Home -> Learn -> Draw -> Build bridge -> practice editor -> Mac file check -> Teach -> Quiz -> Review -> Complete -> Home -> empty Review -> scheduled Review -> Settings. + +## Visible checks + +- New stages begin at the heading instead of inheriting the prior scroll position. +- Action rows no longer cover lesson text, the file picker, the teach-back field, or quiz feedback. +- The first correct quiz answer immediately shows `1 correct so far`. +- Review has a visible sequence: Show answer -> rating -> Finish review. +- A mastered lesson shows `Review due`; `Again` repeats the card and `Hard` returns it in two days without lowering mastery. +- Completion changes the top bar to `Complete` and removes false Continue/Start review actions. +- The local tutor visibly reports when it is paused to protect memory. +- Atkinson Hyperlegible, 20px base text, semantic colors, visible focus, and 8px-or-less radii remain intact. + +## Evidence + +- `15-home-after.jpg` - fresh Home state. +- `16-learn-after.jpg` - corrected Learn layout. +- `17-quiz-feedback-after.jpg` - immediate score and unobscured explanation. +- `18-review-after.jpg` - reveal/rate/finish sequence. +- `19-review-comparison.jpg` - original reported review screen beside the repaired flow. + +## Result + +PASS for the W1 desktop journey at the in-app browser's current Mac viewport. Earlier split-view checks at 800px and 200% browser zoom found no horizontal overflow. The CI browser suite now repeats 800, 1024, 1440, and 1728px Mac window widths. diff --git a/artifacts/studio-audit/reference-legacy-review.png b/artifacts/studio-audit/reference-legacy-review.png new file mode 100644 index 0000000..13a63da Binary files /dev/null and b/artifacts/studio-audit/reference-legacy-review.png differ diff --git a/audio/foundation/d1-one-idea.mp3 b/audio/foundation/d1-one-idea.mp3 new file mode 100644 index 0000000..fab1446 Binary files /dev/null and b/audio/foundation/d1-one-idea.mp3 differ diff --git a/audio/foundation/d2-one-idea.mp3 b/audio/foundation/d2-one-idea.mp3 new file mode 100644 index 0000000..8b28b52 Binary files /dev/null and b/audio/foundation/d2-one-idea.mp3 differ diff --git a/audio/foundation/w1-one-idea.mp3 b/audio/foundation/w1-one-idea.mp3 new file mode 100644 index 0000000..7eaf830 Binary files /dev/null and b/audio/foundation/w1-one-idea.mp3 differ diff --git a/audio/foundation/w2-one-idea.mp3 b/audio/foundation/w2-one-idea.mp3 new file mode 100644 index 0000000..170c66a Binary files /dev/null and b/audio/foundation/w2-one-idea.mp3 differ diff --git a/audio/foundation/w3-one-idea.mp3 b/audio/foundation/w3-one-idea.mp3 new file mode 100644 index 0000000..b35a10b Binary files /dev/null and b/audio/foundation/w3-one-idea.mp3 differ diff --git a/audio/foundation/w4-one-idea.mp3 b/audio/foundation/w4-one-idea.mp3 new file mode 100644 index 0000000..398fc83 Binary files /dev/null and b/audio/foundation/w4-one-idea.mp3 differ diff --git a/audio/foundation/w5-one-idea.mp3 b/audio/foundation/w5-one-idea.mp3 new file mode 100644 index 0000000..7a47335 Binary files /dev/null and b/audio/foundation/w5-one-idea.mp3 differ diff --git a/course-audit.mjs b/course-audit.mjs index a1fd8c6..2380551 100644 --- a/course-audit.mjs +++ b/course-audit.mjs @@ -5,12 +5,21 @@ const root = new URL("./", import.meta.url); const read = (name) => fs.readFileSync(new URL(name, root), "utf8"); const exists = (name) => fs.existsSync(new URL(name, root)); const context = vm.createContext({ window: {} }); +const rawNotes = read("notes-data.js"); +const correctionSource = read("notes-corrections.js"); vm.runInContext(read("course-data.js"), context, { filename: "course-data.js" }); +vm.runInContext(read("video-data.js"), context, { filename: "video-data.js" }); +vm.runInContext(rawNotes, context, { filename: "notes-data.js" }); +vm.runInContext(correctionSource, context, { filename: "notes-corrections.js" }); +vm.runInContext(read("units-data.js"), context, { filename: "units-data.js" }); vm.runInContext(read("exercises.js"), context, { filename: "exercises.js" }); vm.runInContext(read("exercise-library.js"), context, { filename: "exercise-library.js" }); const course = context.window.CCAF_COURSE; +const media = context.window.CCAF_MEDIA; +const notes = context.window.LESSON_NOTES; +const chapters = context.UNIT_CHAPTERS; const exercises = context.EXERCISES; const failures = []; const pass = []; @@ -39,6 +48,66 @@ for (const [index, unit] of course.units.entries()) { check(Array.isArray(course.cards[unit.id]) && course.cards[unit.id].length >= 3, `${unit.id}: at least three review cards exist`); } +check(media && media.lessons && media.clips && media.episodes, "reviewed video manifest loads"); +check(media.reviewedAt === "2026-07-15", "video manifest records its transcript review date"); +check(Object.values(media.episodes).filter((episode) => episode.status !== "unavailable").length === 22, "playlist records 22 available episodes"); + +const assignedClips = new Set(); +for (const unit of course.units) { + const lesson = media.lessons[unit.id]; + check(Boolean(lesson), `${unit.id}: media lesson entry exists`); + check(Boolean(lesson && lesson.primary), `${unit.id}: primary watch source exists`); + check(!lesson || lesson.optional == null || lesson.optional.type === "clip", `${unit.id}: optional slot contains at most one reviewed clip`); + for (const item of lesson ? [lesson.primary, lesson.optional].filter(Boolean) : []) { + if (item.type !== "clip") continue; + const resolved = media.resolve(item); + assignedClips.add(item.clip); + check(Boolean(resolved), `${unit.id}: reviewed clip resolves`); + if (!resolved) continue; + check(resolved.startSec < resolved.endSec, `${unit.id}: clip has a valid time range`); + check(resolved.endSec - resolved.startSec <= 600, `${unit.id}: clip stays under ten minutes`); + check(resolved.endSec <= media.episodes[resolved.episodeKey].durationSec, `${unit.id}: clip ends inside the full episode`); + check(/[?&]t=\d+s/.test(resolved.url), `${unit.id}: clip URL includes its exact start time`); + check(!/[?&]t=\d+s/.test(resolved.fullUrl), `${unit.id}: full-episode URL starts at the beginning`); + check(resolved.captionSource && resolved.reviewedAt, `${unit.id}: clip records caption source and review date`); + } +} +check(assignedClips.size === Object.keys(media.clips).length, "every selected playlist clip is assigned to a lesson"); +for (const [key, clip] of Object.entries(media.clips)) { + check(assignedClips.has(key), `${key}: selected clip appears in the course`); + check(media.episodes[clip.episode].status !== "unavailable", `${key}: selected clip does not use an unavailable episode`); +} +for (const [key, episode] of Object.entries(media.episodes)) { + if (episode.status !== "used") continue; + check(Object.values(media.clips).some((clip) => clip.episode === key), `${key}: assigned episode has an exact lesson clip`); +} + +const correctedTeachingText = JSON.stringify({ + chapters, + notes:Object.fromEntries(Object.entries(notes).map(([id,note]) => [id,{title:note.title,html:note.html}])) +}); +for (const stale of [ + "short-term memory", + "re-reads every request", + "tools from every connected MCP server are all available at once", + "scratchpad + memory files let agents resume after context loss", + "tool_use = continue, end_turn = done", + "The 6 exam scenarios", + "The shape is guaranteed, not left to luck", + "a feature that guarantees valid JSON via constrained decoding", + "so JSON is always valid", + "so it is always valid JSON", + "reliable way to guarantee the JSON is valid" +]) check(!correctedTeachingText.includes(stale), `rendered teaching text removes stale phrase: ${stale}`); + +const correctionPairs = [...correctionSource.matchAll(/\[\s*("(?:\\.|[^"\\])*")\s*,\s*("(?:\\.|[^"\\])*")\s*\]/g)]; +check(correctionPairs.length >= 20, "notes correction targets are discoverable by the audit"); +for (const match of correctionPairs) { + const target = JSON.parse(match[1]); + check(rawNotes.includes(target), `notes correction still matches its source phrase: ${target.slice(0, 58)}`); +} +check(rawNotes.includes("The exam gives you scenarios"), "production-scenario correction still matches its source phrase"); + const requiredExercises = course.units.map((unit) => unit.exercise); check(new Set(requiredExercises).size === requiredExercises.length, "every required unit has a unique fixed build"); const exerciseMap = new Map(exercises.map((exercise) => [exercise.id, exercise])); @@ -55,12 +124,27 @@ for (const id of ["w1", "w2", "w3", "w4", "w5", "d1", "d2"]) { check(course.banks[id] && course.banks[id].questions.length >= 5, `${id}: beginner checkpoint bank has at least five questions`); } -for (const page of ["dashboard.html", "today.html", "curriculum.html", "timeline.html", "quiz.html", "pretest.html"]) { +for (const page of ["dashboard.html", "today.html", "notes.html", "curriculum.html", "timeline.html", "quiz.html", "pretest.html", "video-library.html"]) { const html = read(page); check(html.indexOf("course-data.js") < html.indexOf("nav.js"), `${page}: loads the manifest before navigation`); check(!/0 \/ 16 units|\/16 units|All 16 units/.test(html), `${page}: no stale 16-unit progress label`); } +for (const page of ["today.html", "notes.html", "curriculum.html", "video-library.html"]) { + const html = read(page); + const courseIndex = html.indexOf("course-data.js"); + const dataIndex = html.indexOf("video-data.js"); + const uiIndex = html.indexOf("video-ui.js"); + const navIndex = html.indexOf("nav.js"); + check(courseIndex >= 0 && courseIndex < dataIndex && dataIndex < uiIndex && uiIndex < navIndex, `${page}: loads course, video data, media UI, then navigation`); +} + +const videoLibrary = read("video-library.html"); +check(videoLibrary.includes("Full episode") && videoLibrary.includes("Watch "), "video library exposes exact clips and full episodes"); +check(videoLibrary.includes("notes.html?unit=") && videoLibrary.includes("review.html?unit="), "video library connects watch, notes, and review"); +check(!/ 10000, `${id}: natural foundation narration exists and is nonempty`); +} const visualPipelineName = exists("Visual Media Pipeline.md") ? "Visual Media Pipeline.md" : "VISUAL-MEDIA-PIPELINE.md"; const designStandardName = exists("Dyslexia UI Standard.md") ? "Dyslexia UI Standard.md" : "DESIGN-STANDARD.md"; diff --git a/course-data.js b/course-data.js index bf9fe90..fc58200 100644 --- a/course-data.js +++ b/course-data.js @@ -90,7 +90,7 @@ prereq:["m2"],concepts:["agent-loop","stop-reason","tool-use-loop","guardrail","workflow-vs-agent"],exercise:"agent-loop-board", quiz:"quiz.html?set=agentic",notes:"notes.html?unit=o1", ask:"Teach me the agent loop: model -> tool request -> application -> tool result -> model. Cover stop_reason, runaway guards, and when one call is enough.", - watch:[["article-effective-agents.html","Building effective agents | Visual article","Focus: workflow holds a fixed map; agent chooses its next step."],["https://platform.claude.com/docs/en/build-with-claude/handling-stop-reasons","Anthropic docs | Handling stop reasons","Focus: tool_use continues; end_turn finishes."]] + watch:[["article-effective-agents.html","Building effective agents | Visual article","Focus: workflow holds a fixed map; agent chooses its next step."],["https://platform.claude.com/docs/en/build-with-claude/handling-stop-reasons","Anthropic docs | Handling stop reasons","Focus: branch on the returned reason; tool_use requires a tool result."]] }, { id:"a2",level:"Atoms",title:"Model physics and economics", @@ -199,7 +199,7 @@ ]; var lessons={ - w1:{plain:"A file is one saved item. A folder holds files. A path is the full route to an item. An extension is the ending after the final dot.",example:"/Users/learner/Documents/study/tiny-order.json",diagram:["Finder","study folder","tiny-order.json","JSON text"],danger:"Saving rich text or adding .txt changes the file you meant to create."}, + w1:{plain:"A file is one saved item. A folder holds files. A path is the full route to an item. An extension is the ending after the final dot.",example:"/Users/student/Documents/study/tiny-order.json",diagram:["Finder","study folder","tiny-order.json","JSON text"],danger:"Saving rich text or adding .txt changes the file you meant to create."}, w2:{plain:"JSON is plain text arranged as labeled key and value pairs. The punctuation is part of the format.",example:'{ "item": "tea", "quantity": 2 }',diagram:["{ object }","\"key\"","value","validator"],danger:"Missing quotes, extra commas, and smart quotes make JSON invalid."}, w3:{plain:"A program follows instructions. A function is a named action. Arguments go in, a return value comes out, and an error explains why it could not finish.",example:"total(2, 3) -> 5",diagram:["arguments","function","return value","caller"],danger:"An error is not proof you failed. It is evidence about the next repair."}, w4:{plain:"An API lets one program ask another program to do work. The request goes out; the response comes back.",example:"order app -> GET /orders/42 -> order service -> 200 + JSON",diagram:["your app","request","API","response"],danger:"An API key is a secret. Keep it in an environment variable, not inside a shared file."}, @@ -210,7 +210,7 @@ var banks={ w1:{questions:[ - {q:"Which item is a file?",opts:["study","Documents","tiny-order.json","/Users/learner"],ans:2,why:"The .json item is one saved file; the others name folders or a partial path."}, + {q:"Which item is a file?",opts:["study","Documents","tiny-order.json","/Users/student"],ans:2,why:"The .json item is one saved file; the others name folders or a partial path."}, {q:"TextEdit saved tiny-order.json.txt. What happened?",opts:["It became an API","A .txt extension was added","The folder was deleted","JSON requires .txt"],ans:1,why:"The final extension is now .txt, so it is not the filename the task requested."}, {q:"What does a path tell you?",opts:["The route to a file or folder","The file's password","The program's output","The JSON schema"],ans:0,why:"A path names the folders to follow to reach an item."}, {q:"Why use plain text for JSON?",opts:["It removes formatting codes","It encrypts the file","It makes every value a number","It runs the file"],ans:0,why:"JSON is a text data format; rich-text formatting can add content JSON parsers do not understand."}, diff --git a/curriculum.html b/curriculum.html index 77513df..370e21c 100644 --- a/curriculum.html +++ b/curriculum.html @@ -55,6 +55,8 @@ + +
@@ -129,7 +131,7 @@

🪜 The whole system at a glance

- Built on Atomic Design by Brad Frost — used here as a learning map. Prefer a week-by-week view? The plan lives on the dashboard. + Built on Atomic Design by Brad Frost (2016) — used here as a learning map, not a UI method. Read Atomic Design. Prefer a week-by-week view? The 12-week plan lives on the dashboard. · updated 2026-07-15
@@ -149,7 +151,7 @@

🪜 The whole system at a glance

var UNITS=[ {id:"a1",lvl:"atoms",ic:"🔤",title:"Core vocabulary",one:"The 8 words everything is built from",tag:{t:"✓ locked — keep warm",c:"light"}, words:"API, JSON, schema, token, context window, prompt, tool, model. You already nailed these (4/5, 0 guesses) — just keep them fresh with flashcards.", - chapters:["API = two programs talking","JSON = data with labels","Schema = the shape rules","Context window = short-term memory","Prompt · Tool · Token · Model"], + chapters:["API = two programs talking","JSON = data with labels","Schema = the shape rules","Context window = limited working input, not durable memory","Prompt · Tool · Token · Model"], dia:{h:"learning-map.html#m-sysdesign",l:"System-design foundations diagram"}, vids:[["https://anthropic.skilljar.com/claude-101/383389","Claude 101 ▶ play"],[V+"claude-platform-101","Claude Platform 101"]], prep:["Why the context window matters: it is like a whiteboard with limited space \u2014 Claude can only use what is on the board right now. When the board is FULL, new text does not fit: you get an error / stop_reason: model_context_window_exceeded \u2014 nothing silently disappears. Chat apps make room by dropping the OLDEST turns first. Separate idea: text that fits but sits buried in the MIDDLE gets less attention \u2014 that is \u201clost-in-the-middle\u201d (taught in the Reliability unit).","API keys are secrets. Never put a key in your code, in a README, or in logs (logs get saved and shared). Store it in an environment variable \u2014 a value your computer holds outside the code. Example: not key = \"sk-abc123\" written in the file, but key = os.environ[\"API_KEY\"]."], @@ -194,8 +196,8 @@

🪜 The whole system at a glance

quiz:["quiz.html?set=tools-mcp","Tools & MCP quiz"], ask:"Teach me Claude Code's built-in tools for CCA-F: when to use Grep vs Glob vs Read/Write vs Edit vs Bash, and the 'grep an entry point then read to follow imports' pattern. One example, 3 flashcards."}, {id:"o1",lvl:"organisms",ic:"🤖",title:"The Agent Loop",one:"Model + tools + a loop until stop_reason says done",tag:{t:"🔴 weak · 27%",c:"weak"},start:true, - words:"An agent keeps going: think then use a tool then read the result then repeat then finish. The real stop signal is stop_reason (tool_use = keep going, end_turn = done) — NOT a fixed max-5-turns.", - chapters:["think then tool then result then repeat","stop_reason runs the loop: tool_use = continue, end_turn = done","know the other values too: max_tokens, stop_sequence, pause_turn, refusal, model_context_window_exceeded","NEVER read the text to decide when to stop — check stop_reason","why fixed iteration caps are a weak primary stop","model decides the next tool from context — not a fixed decision tree","guardrails so it can't run away","start with RAW API calls + simple patterns — a framework hides prompts, tools & errors (glass box vs magic box)"], + words:"An agent keeps going: think, request a tool, read the result, and decide again. Branch on stop_reason: tool_use means run the requested tool; end_turn means natural completion; every other value needs its own handling. A fixed turn cap is only a safety backstop.", + chapters:["think then tool then result then repeat","branch on stop_reason: tool_use = run the tool; end_turn = natural completion","handle max_tokens, stop_sequence, pause_turn, refusal, and model_context_window_exceeded explicitly","NEVER read the text to decide when to stop — check stop_reason","why fixed iteration caps are a weak primary stop","model decides the next tool from context — not a fixed decision tree","guardrails so it can't run away","start with RAW API calls + simple patterns — a framework hides prompts, tools & errors (glass box vs magic box)"], dia:{h:"learning-map.html#m-agentic",l:"The Agent Loop diagram"}, vids:[["article-effective-agents.html","🧩 Effective agents — as pictures"],["https://platform.claude.com/docs/en/build-with-claude/handling-stop-reasons","Handling stop reasons (docs)"]], quiz:["quiz.html?set=agentic","Agentic quiz"], @@ -210,14 +212,14 @@

🪜 The whole system at a glance

ask:"Teach me Orchestrator–Workers (multi-agent) for CCA-F: coordinator role, explicit context passing, parallel work, provenance, and when NOT to use multi-agent. One example, 3 flashcards."}, {id:"o3",lvl:"organisms",ic:"🔌",title:"An MCP server",one:"Tools (actions) vs resources (read-only) vs prompts (workflows)",tag:{t:"18%",c:"light"}, words:"MCP is the standard plug that connects Claude to outside systems. Three parts: tools = actions, resources = read-only context, prompts = reusable workflows. If Claude only needs to READ, it's a resource — not a tool.", - chapters:["tools = actions (model-controlled)","resources = read-only (app-controlled)","prompts = workflows (user-controlled)","transport: stdio vs Streamable HTTP","config: .mcp.json (project) vs ~/.claude.json (user)","secrets via env vars","tools from every connected MCP server are all available at once","resources can double as content catalogs, cutting exploratory tool calls","thin tool descriptions push Claude to prefer built-in tools like Grep"], + chapters:["tools = actions (model-controlled)","resources = read-only (app-controlled)","prompts = workflows (user-controlled)","transport: stdio vs Streamable HTTP","config: .mcp.json (project) vs ~/.claude.json (user)","secrets via env vars","Claude Code Tool Search discovers MCP tools on demand by default; some setups can load them directly","resources can double as content catalogs, cutting exploratory tool calls","thin tool descriptions push Claude to prefer built-in tools like Grep"], dia:{h:"learning-map.html#m-toolsmcp",l:"MCP three-parts diagram"}, vids:[["https://anthropic.skilljar.com/claude-code-101/469797","Claude Code 101 ▶ MCP"],[V+"introduction-to-model-context-protocol","Introduction to MCP"],[V+"model-context-protocol-advanced-topics","MCP: Advanced Topics"]], quiz:["quiz.html?set=tools-mcp","Tools & MCP quiz"], ask:"Teach me MCP for CCA-F: tools vs resources vs prompts, who controls each, scope, and secrets. The classic trap is using a tool when a read-only resource fits. One example, 3 flashcards."}, {id:"o4",lvl:"organisms",ic:"⚙️",title:"Claude Code workflows",one:"CLAUDE.md, commands, skills, subagents, hooks, headless",tag:{t:"20%",c:"light"}, - words:"Three jobs, in order. SET UP: CLAUDE.md project memory, slash commands, skills, path rules. RUN: plan mode, subagents, hooks, headless claude -p. STEER: concrete examples, TDD, the interview pattern, resume/fork sessions. One rule above all: rules that MUST hold go in hooks, not just a prompt.", - chapters:["§ ⚙️ Set it up", "CLAUDE.md = project rules Claude re-reads every request (not keys/history)", "CLAUDE.md hierarchy: project (git-shared) vs user-level (personal, NOT shared)", "slash commands & skills: project dir (shared, version-controlled) vs user dir (personal)", "§ ▶️ Run it", "plan mode (plan first, approve) + permission modes (ask-first → automatic)", "subagents run in their OWN fresh context — inherit nothing, pass context in the prompt", "hooks = deterministic gates: PreToolUse (before, can block) / PostToolUse (after, can check)", "a rule that MUST hold goes in a hook, not a polite prompt line", "headless claude -p = non-interactive CLI for automation & CI", "§ 🎯 Steer it", "refine output with 2–3 concrete I/O examples or one failing test", "🔨 practiced in the capstone: advanced hooks, SKILL.md details, session control --resume/fork"], + words:"Three jobs, in order. SET UP: CLAUDE.md project instructions, Skills, and path rules. RUN: plan mode, subagents, hooks, and headless claude -p. STEER: concrete examples, tests, and session controls. Rules that MUST hold go in deterministic code or hooks, not only a prompt.", + chapters:["§ ⚙️ Set it up", "CLAUDE.md = scoped project instructions loaded for a Claude Code session (not keys/history)", "CLAUDE.md hierarchy: project (git-shared) vs user-level (personal, NOT shared)", "Skills are the current workflow format; .claude/commands remains compatible", "§ ▶️ Run it", "plan mode (plan first, approve) + permission modes (ask-first → automatic)", "subagents run in their OWN fresh context — inherit nothing, pass context in the prompt", "hooks = deterministic gates: PreToolUse (before, can block) / PostToolUse (after, can check)", "a rule that MUST hold goes in a hook, not a polite prompt line", "headless claude -p = non-interactive CLI for automation & CI", "§ 🎯 Steer it", "refine output with 2–3 concrete I/O examples or one failing test", "🔨 practiced in the capstone: advanced hooks, SKILL.md details, session control --resume/fork"], dia:{h:"learning-map.html#m-claudecode",l:"Claude Code anatomy diagram"}, vids:[["https://anthropic.skilljar.com/claude-code-101/469789","Claude Code 101 ▶ How it works"],["https://anthropic.skilljar.com/claude-code-101/469795","Claude Code 101 ▶ CLAUDE.md"],[V+"claude-code-in-action","Claude Code in Action"],[V+"introduction-to-agent-skills","Introduction to agent skills"]], prep:["Plan mode: Claude writes its PLAN first and shows you, before touching any files \u2014 you approve or edit it, THEN the work happens. Use it when a task is complex with more than one reasonable approach (\"redesign the login page\"); skip it for tiny obvious fixes (one typo).","Why make a skill: a skill (SKILL.md) packages a repeatable workflow \u2014 the instructions, plus (optionally) a pinned list of allowed tools so it cannot overstep when that list is set. Example: a \"write-tests\" skill that follows your test format and may only use Read and Write (no Bash \u2192 no risky commands)."], @@ -237,8 +239,8 @@

🪜 The whole system at a glance

vids:[["https://anthropic.skilljar.com/claude-code-101/469796","Claude Code 101 ▶ Subagents"],["article-multi-agent.html","🕸️ Multi-agent research — as pictures"]], quiz:["quiz.html?set=agentic","Agentic quiz"], ask:"Walk me through a research multi-agent system for CCA-F: decompose, pass context, gather, and attach provenance (source/date/confidence) to every finding. Where does it usually break? One example, 3 flashcards."}, - {id:"p1",lvl:"pages",ic:"📄",title:"The 6 exam scenarios",one:"Whole systems, real tradeoffs — exam style",tag:null, - words:"The exam gives production scenarios. For each: read it, pick which box (prompt? tool? agent? hook?) and WHY, name the tradeoff (cost/latency/safety), and state the reliability angle. Practice by re-taking the pre-test and quizzes under time.", + {id:"p1",lvl:"pages",ic:"📄",title:"Production scenarios",one:"Whole systems, real tradeoffs — reported exam style",tag:null, + words:"Reported exam descriptions use production scenarios; Anthropic has not publicly confirmed the scenario count here. For each practice case: identify the constraint, choose an approach, defend the tradeoff, and name the reliability angle.", chapters:["read the scenario carefully","pick the box + justify it","name the tradeoff","add the reliability/guardrail angle"], dia:{h:"learning-map.html#m-roadmap",l:"Your roadmap"}, vids:[["article-effective-agents.html","🧩 Effective agents — as pictures"]], @@ -260,7 +262,7 @@

🪜 The whole system at a glance

ask:"Drill me on CCA-F anti-patterns (the wrong answers). Give me 8 scenario questions where one option is a classic trap — parsing text to stop a loop, iteration caps, prompt-enforcing critical rules, sentiment-based escalation, swallowing errors as success, too many tools, same-session self-review, aggregate metrics hiding failures. Make me pick AND explain why the others are wrong. Then grade me."}, {id:"rel",lvl:"thread",ic:"🛡️",title:"Reliability, context & evals",one:"Context, memory, RAG, evals, human-in-loop — a property at every level",tag:{t:"🔴 weak · 15% · cross-cutting",c:"thread"}, words:"Like safety in a real building, reliability shows up at every level. Revisit it inside every Organism, Template and Page: keep context tight, verify with code first, handle and propagate errors with structure (not silence), track sources, and route risk to a human.", - chapters:["context window & lost-in-the-middle", "context window ≠ memory: bigger window is not recall", "compaction / summarization keeps a long agent going but is lossy", "case-facts block: pull amounts / dates / IDs into a block outside the summary", "what survives /compact (CLAUDE.md, memory) vs what's lost", "scratchpad + memory files let agents resume after context loss", "RAG vs long context: retrieval for many/changing docs, long context for single-doc depth", "verification ladder = eval tiers: code > visual > LLM-judge", "evals: saved cases + a rubric, re-run as a regression test (not 'worked once in chat')", "guardrails: least-privilege tools — give each agent only the tools its role needs", "guardrails: human-in-the-loop approval before risky, hard-to-undo actions", "structured error context: failure type, what was tried, partial results, alternatives", "is_error / isError is real; constrained decoding still needs validation + specific-error retry", "don't silently return empty as success or abort the whole workflow on one failure", "escalate on COMPLEXITY, not sentiment", "multiple customer matches: ask for another identifier, don't guess", "provenance + handling conflicting / temporal data", "human review: stratified sampling + field-level confidence", "batch vs real-time · retries + prompt caching"], + chapters:["context window & lost-in-the-middle", "context window ≠ memory: bigger window is not recall", "compaction / summarization keeps a long agent going but is lossy", "case-facts block: pull amounts / dates / IDs into a block outside the summary", "what survives /compact (CLAUDE.md, memory) vs what's lost", "scratchpad + memory files help only when the application writes and reloads them deliberately", "RAG vs long context: retrieval for many/changing docs, long context for single-doc depth", "verification ladder = eval tiers: code > visual > LLM-judge", "evals: saved cases + a rubric, re-run as a regression test (not 'worked once in chat')", "guardrails: least-privilege tools — give each agent only the tools its role needs", "guardrails: human-in-the-loop approval before risky, hard-to-undo actions", "structured error context: failure type, what was tried, partial results, alternatives", "is_error / isError is real; constrained decoding still needs validation + specific-error retry", "don't silently return empty as success or abort the whole workflow on one failure", "escalate on COMPLEXITY, not sentiment", "multiple customer matches: ask for another identifier, don't guess", "provenance + handling conflicting / temporal data", "human review: stratified sampling + field-level confidence", "batch vs real-time · retries + prompt caching"], dia:{h:"learning-map.html#m-reliability",l:"Reliability diagrams"}, vids:[["https://anthropic.skilljar.com/claude-code-101/469793","Claude Code 101 ▶ Context management"]], prep:["Human-in-the-loop review: a person checks the agent's work before it counts, whenever a case is uncertain (the agent is not confident), risky (big money, safety), or policy-sensitive (it touches a rule someone could get in trouble for breaking \u2014 legal, medical, company policy). Example: the agent approves a $20 refund alone, but a $600 request goes to a human because policy caps solo approvals at $500.","Stratified sampling = humans spot-check a fair slice of EVERY case type, not just the easy ones, so problems in rare categories get caught. Field-level confidence = the agent says how sure it is per field, so human effort goes to the shaky fields first. One warning: confidence helps humans decide where to LOOK first \u2014 it must never be the ONLY gate that decides IF a human looks at all (that is anti-pattern trap #4)."], @@ -268,12 +270,20 @@

🪜 The whole system at a glance

ask:"This is my weak spot. Teach me Reliability for CCA-F as a thread that touches everything: lost-in-the-middle, the verification ladder (code>visual>LLM-judge), provenance, human-in-the-loop, batch vs real-time, retries + caching. One example each, then quiz me."} ]; -// The original Atomic units stay rich and detailed. The shared manifest adds -// the repaired beginner Workbench and Developer Bridge without duplicating data. +// Keep the rich curriculum detail here, but hydrate shared summary fields from +// the authoritative manifest so the Timeline, Today, Notes, and Curriculum agree. if(window.CCAF_COURSE){ - var existing={};UNITS.forEach(function(u){existing[u.id]=true;}); + var existing={};UNITS.forEach(function(u){existing[u.id]=u;}); CCAF_COURSE.units.forEach(function(u){ - if(existing[u.id])return; + if(existing[u.id]){ + var rich=existing[u.id]; + rich.title=u.title; + rich.one=u.one; + rich.ask=u.ask; + rich.quiz=rich.quiz||[u.quiz,u.title+" quiz"]; + rich.quiz[0]=u.quiz; + return; + } var lesson=CCAF_COURSE.lessons[u.id]||{}; var vids=(u.watch||[]).map(function(v){return [v[0],v[1]+(v[2]?" — "+v[2]:"")];}); UNITS.push({ @@ -342,7 +352,7 @@

🪜 The whole system at a glance

'
📐 Diagram
'+u.dia.l+' →'+repairLinks(u.id)+'
'+ '
📝 In words
'+u.words+'
'+ '
📚 Chapters
'+chapters(u.chapters)+'
'+ - '
🎥 Videos
'+rowVids(u.vids)+'
'+ + '
🎥 Videos
'+(window.CCAFMediaUI?CCAFMediaUI.inlineHTML(u.id):rowVids(u.vids))+'
'+ '
📖 Notes
Read the full lesson notes → everything the quiz tests, in plain words
'+ '
🔎 Go deeper
'+moreLinks(u.id)+'
'+ (u.prep&&u.prep.length?'
📒 Prep notes
    '+u.prep.map(function(x){return "
  • "+x+"
    • ";}).join("")+'

👆 These are the exact ideas the quiz and flashcards will test — read them before quizzing.

':"")+ diff --git a/daily-pipeline.html b/daily-pipeline.html index 3f162c6..e7aea0f 100644 --- a/daily-pipeline.html +++ b/daily-pipeline.html @@ -20,6 +20,8 @@ .stepbox{display:inline-flex;flex-direction:column;align-items:center;gap:2px;font-size:.8rem} .stepbox input{width:20px;height:20px;accent-color:#2F9E63;cursor:pointer} .dayrow .dsum{margin-left:auto;font-size:.78rem;color:var(--muted);font-weight:700} + .routine-toggle{display:flex;align-items:center;justify-content:space-between;gap:10px;flex:1 1 auto;border:0;background:transparent;color:var(--ink);font:inherit;font-weight:700;text-align:left;padding:7px 4px;cursor:pointer} + .routine-toggle:hover,.routine-toggle:focus-visible{color:var(--accent)} @@ -27,7 +29,7 @@ -
+

📋 Weekly Pipeline & Progress

@@ -43,13 +45,13 @@

🗓️ Your week

-

Steps: 🎥 watch · ✏️ draw · 🔨 build · 🗣️ explain · 🃏 flashcards — tick them on any day (backfill is fine). Today's row syncs with the Lesson page.

+

Habits: learn · draw · build · teach · review. Tick them on any day; backfill is fine. Today's row syncs with your lesson.

🔁 Today's routine, step by step

-

Tap a step's name (or ▸) for exactly what to do. This is the same 5 steps as today's row above.

+

Open a habit for exactly what to do. These are the same five checks as today's row.

@@ -76,13 +78,13 @@

🏁 Master checklist

Mirrors Daily Pipeline.md · your written backup lives in Obsidian.
- -
Copied 👍
+ +
Copied 👍
-
+

🏠 CCA-F Study Dashboard

Claude Certified Architect – Foundations · your home base

- - - - - - - - - - -

📍 Where you are · live — same tracker as the Lesson page

-
-

0 / 23 units done · next up: …

+
+
Current lesson
+

Loading your lesson

+

0 / 23 units done

-

👉 Open your lesson page → it tees up the exact lesson, video and 5 steps.

- -

First step: take the Pre-Test to set your baseline — score AND how much you guessed. (Example: one real learner started at 20/30 with 18 guesses → real base ≈ 12.)

-
+
+ Continue lesson + + +
Study maps and supporting paths
+ + My plan + Concept map + Applied Engineer path +
+
Exam facts, domains, and official courses

📌 The exam — what's official vs reported

@@ -240,12 +235,13 @@

🎨 Color key (use these in every note & sketch)

  • Orange — human review, judgment, handoff
    • +
    -

    📋 Your lesson's 5 steps — check things off (fresh steps with each new lesson)

    +

    Practice habits for this lesson

    -

    👉 Tap a step's name (or the ▸) to see exactly what to do and where.

    +

    Five habits support the six-stage lesson path. Your quiz score updates separately.

    Today: 0 / 5 done

    @@ -260,6 +256,7 @@

    💾 Your progress

    +

    Everything you tick or type saves itself the moment you do it. Heads-up: progress belongs to the exact address in the bar — localhost:8000 and the hosted site each keep their own. Study at the same address every time.

    + +
    +
    +
    +

    Draw the idea

    +

    +
    + +
    + +
    +

    Draw this

    +

    +
    +

    Use boxes and arrows. Add one red note for what could go wrong.

    +
    + +
    +

    Sketchpad

    +
    +
    + Pen + + + + + +
    + + + +
    +
    +

    Your sketch saves after each stroke.

    +
    + +
    Draw on paper or describe it in words
    + + + +
    + + +
    +
    +
    + + + diff --git a/exercise.html b/exercise.html index b4c0a5f..ecbf12b 100644 --- a/exercise.html +++ b/exercise.html @@ -38,6 +38,7 @@ .exlist a.start{display:inline-block;background:var(--accent);color:#fff;text-decoration:none;font-weight:800;padding:9px 18px;border-radius:7px;font-size:.88rem} #toast{position:fixed;left:50%;bottom:26px;transform:translateX(-50%) translateY(40px);background:var(--ink);color:#fff;padding:12px 20px;border-radius:8px;font-weight:700;opacity:0;transition:.25s;pointer-events:none;z-index:60} #toast.show{opacity:1;transform:translateX(-50%) translateY(0)} + .tutor-actions{margin-top:14px}.tutor-actions .actions{margin:4px 0 10px} @media(max-width:620px){.modepick{grid-template-columns:1fr}} @@ -46,7 +47,7 @@ -
    +
    Copied 👍
    @@ -89,7 +90,15 @@ var SKEY="ccaf-ex-"+ex.id; var st={a:{}}; try{var s=JSON.parse(localStorage.getItem(SKEY)||"{}");if(s&&typeof s==="object"){st=s;st.a=st.a||{};}}catch(_){} - function save(){st.ts=Date.now();try{localStorage.setItem(SKEY,JSON.stringify(st));}catch(_){}} + var saveTimer=null; + function saveNow(){clearTimeout(saveTimer);st.ts=Date.now();try{localStorage.setItem(SKEY,JSON.stringify(st));}catch(_){}} + function save(){clearTimeout(saveTimer);saveTimer=setTimeout(saveNow,300);} + window.addEventListener("pagehide",saveNow); + + var creditUnit=null; + if(window.CCAF&&CCAF.COURSE&&CCAF.COURSE.map){ + (ex.units||[]).some(function(id){if(CCAF.COURSE.map[id]&&CCAF.COURSE.map[id].exercise===ex.id){creditUnit=id;return true;}return false;}); + } // ordered list of every answer field (step fields first, then quiz questions) var FIELDS=[]; @@ -100,8 +109,8 @@ '

    '+ex.mins+''+ex.level+'💾 saves as you type

    '+ '

    Goal: '+ex.goal+'

    '+ '

    '+ex.why+'

    '+ - '
    The loop: 1 · do each step here → 2 · 🧠 instant check → 3 · 📤 report to Claude → course upgrades itself
    '+ - ''; + '
    1 · Do → 2 · Check → 3 · Save
    '+ + ''+(creditUnit?'
    ':''); var boxNum=0; ex.steps.forEach(function(s,i){ @@ -112,8 +121,8 @@ } if(s.field){ boxNum++; - h+='
    '+boxNum+''+s.field.label+'
    '+ - '
    '; + h+='
    '+ + '
    '; } if(s.hints&&s.hints.length){ h+='
    '; @@ -125,8 +134,8 @@ h+='

    '+ex.quiz.title+'

    '+ex.quiz.intro+'

    '; ex.quiz.questions.forEach(function(q){ boxNum++; - h+='
    '+boxNum+''+q.q+'
    '+ - '
    '; + h+='
    '+ + '
    '; }); h+='
    '; } @@ -136,16 +145,19 @@ ''+ ''+ ''+ - '

    1. Check: Copy your answers and rubric. Paste them into your tutor for a grade.

    '+ - '

    2. Save: Copy the report for your course tutor. Mark done records the Build step.

    '+ '
    '+ - ''+ - ''+ - ''+ - '
    '; + ''+ + '
    '+ + '
    Ask a tutor to grade this build
    '+ + ''+ + ''+ + '
    '; + + if(creditUnit)h+='
    '; h+=''; app.innerHTML=h; + if(creditUnit&&window.CCAFFlow)CCAFFlow.mount("lesson-flow",{unit:creditUnit,stage:"build"}); // prompts go in via textContent (no HTML-escaping worries) ex.steps.forEach(function(s,i){ if(s.prompt){document.getElementById("pb"+i).textContent=s.prompt;} }); @@ -211,20 +223,29 @@ if(missing.length||!st.mode){ msg.style.display="block"; msg.innerHTML="One small thing remains.
    "+(missing.length?(missing.length+" answer box"+(missing.length===1?" is":"es are")+" empty.
    "):"")+(!st.mode?"Choose With guidance or Independent redo.":""); + msg.focus(); return; } } - st.done=!st.done;save(); + st.done=!st.done;saveNow(); doneBtn.classList.toggle("is-done",st.done); - doneBtn.textContent=st.done?"✓ Done":"Mark done"; + doneBtn.textContent=st.done?"✓ Build saved":"Save build"; if(st.done){ - var uid=ex.units[0],_ct=uid; - try{if(window.CCAF){CCAF.setStep(uid,2,true);CCAF.recordEvidence(uid,"build",{exercise:ex.id,mode:st.mode,complete:true});_ct=CCAF.TITLES[uid]||_ct;}}catch(_){} + var uid=creditUnit,_ct=uid||ex.title; + try{if(uid&&window.CCAF){CCAF.setStep(uid,2,true);CCAF.recordEvidence(uid,"build",{exercise:ex.id,mode:st.mode,complete:true});_ct=CCAF.TITLES[uid]||_ct;}}catch(_){} msg.style.display="block";msg.style.borderLeftColor=st.mode==="independent"?"var(--green)":"var(--yellow)";msg.style.background=st.mode==="independent"?"#EAF7EF":"#FFF4D6"; - msg.innerHTML=st.mode==="independent"?"Independent build evidence saved. This can count toward mastery.":"Guided build saved. Good learning evidence. Do a fresh independent redo later for mastery."; + msg.innerHTML=!uid?"Optional practice saved. This exercise does not replace the fixed build for a lesson.":(st.mode==="independent"?"Independent build evidence saved. This can count toward mastery.":"Guided build saved. Good learning evidence. Do a fresh independent redo later for mastery."); + msg.focus(); + if(uid&&window.CCAFFlow){CCAFFlow.mount("lesson-flow",{unit:uid,stage:"build"});CCAFFlow.mountNext("next-step",uid,st.mode==="independent"?{stage:"teach",context:"Independent build saved.",label:"Next: teach it back"}:{stage:"build",context:"Guided attempt saved. Redo once without hints.",label:"Redo independently"});} flash('Build saved for "'+_ct+'"'); + }else{ + if(creditUnit&&window.CCAF){ + try{var ev=JSON.parse(localStorage.getItem("ccaf-evidence")||"{}");if(ev[creditUnit]&&ev[creditUnit].build&&ev[creditUnit].build.data&&ev[creditUnit].build.data.exercise===ex.id){delete ev[creditUnit].build;localStorage.setItem("ccaf-evidence",JSON.stringify(ev));CCAF.setStep(creditUnit,2,false);}}catch(_){} + } + msg.style.display="block";msg.innerHTML=creditUnit?"Build unmarked. Its lesson evidence was cleared.":"Optional practice unmarked. No lesson mastery was changed.";if(document.getElementById("next-step"))document.getElementById("next-step").textContent="";if(creditUnit&&window.CCAFFlow)CCAFFlow.mount("lesson-flow",{unit:creditUnit,stage:"build"});msg.focus(); } }); + if(st.done&&creditUnit&&window.CCAFFlow){CCAFFlow.mountNext("next-step",creditUnit,st.mode==="independent"?{stage:"teach",context:"Independent build saved.",label:"Next: teach it back"}:{stage:"build",context:"Guided attempt saved. Redo once without hints.",label:"Redo independently"});} })(); diff --git a/flashcards.html b/flashcards.html index 3252db5..a6875b8 100644 --- a/flashcards.html +++ b/flashcards.html @@ -12,9 +12,9 @@ .take{text-decoration:none;font-weight:700;padding:9px 16px;border-radius:7px;font-size:.85rem;white-space:nowrap;display:inline-block} .take.browse{background:var(--accent);color:#fff} .take.learn{background:var(--green);color:#fff} - .flash{min-height:230px;display:flex;align-items:center;justify-content:center;text-align:center; + .flash{width:100%;min-height:230px;display:flex;align-items:center;justify-content:center;text-align:center; background:var(--card);border:2px solid var(--line);border-radius:8px;padding:30px 26px;cursor:pointer; - font-size:1.5rem;font-weight:700;line-height:1.5;user-select:none} + color:var(--ink);font:inherit;font-size:1.5rem;font-weight:700;line-height:1.5;user-select:none} .flash.back{background:#EAF2FB;border-color:var(--accent);font-size:1.25rem;font-weight:500} .fwrap{position:relative;margin:10px 0} .side{font-size:.8rem;color:var(--muted);text-align:center;margin-bottom:6px} @@ -26,7 +26,7 @@ .modetag{font-size:.78rem;font-weight:800;padding:4px 12px;border-radius:999px} .modetag.browse{background:#EAF2FB;color:var(--accent)} .modetag.learn{background:#E9F6EF;color:var(--green)} - /* Learn mode */ + /* Quiz mode */ .qcard{background:var(--card);border:2px solid var(--line);border-radius:8px;padding:26px 24px;text-align:center;font-size:1.3rem;font-weight:700;line-height:1.5;margin:10px 0} .opts{display:flex;flex-direction:column;gap:10px;margin-top:16px} .opt{text-align:left;border:2px solid var(--line);background:#fff;border-radius:8px;padding:14px 16px;font:inherit;font-size:1rem;line-height:1.45;cursor:pointer;color:var(--ink)} @@ -43,19 +43,20 @@ -
    +
    +
    +
    Foundation Workbench
    @@ -49,15 +63,31 @@

    Loading lesson

    +
    +

    One idea

    -

    -
    - - +

    + +
    + + +
    + + +
    + +
    0:00 / 0:00Arthur · ElevenLabs
    +

    @@ -79,11 +109,11 @@

    Tiny example

    Watch out:
    - - - +
    +
    +
    diff --git a/my-plan.html b/my-plan.html index 1029a98..877c2b8 100644 --- a/my-plan.html +++ b/my-plan.html @@ -57,6 +57,7 @@

    🎯 How the example learner spends time

    🟢 Context & Reliability2/515%🔴 DEEP & SLOW (your weakest)

    * The example learner scored 4/5 but guessed often, so those areas still need a quick confirmation pass.

    +

    Exam percentages here are community-reported, not official — see ✅ Exam Facts for what Anthropic has actually confirmed.

    Your CCA-F path (about 10-12 weeks at 20 hrs/week)

    Phase -1 (Week 1) - Foundation Workbench
    One small lesson and fixed build at a time: files -> JSON -> functions -> API -> Terminal. Mastery means 80%+, zero guesses, independent redo, and teach-back.
    Digital foundations checkpoint ->
    diff --git a/nav.js b/nav.js index c820d91..1bf90aa 100644 --- a/nav.js +++ b/nav.js @@ -2,35 +2,83 @@ Usage on a page: load course-data.js before nav.js, then render #site-nav. 5 primary tabs + a "More ▾" menu. Auto-highlights the current page. */ -/* ---- progress file-sync (runs on every page, localhost only) ---- +/* Progress files are user-controlled input. Keep one compatibility-preserving + validator for file restore, dashboard import, and safe resume links. */ +(function(global){ + var MAX_KEYS=1000,MAX_KEY=128,MAX_VALUE=1000000,MAX_TOTAL=1800000; + function isObject(value){return Object.prototype.toString.call(value)==="[object Object]";} + function validKey(key){return typeof key==="string"&&key.length<=MAX_KEY&&/^ccaf-[A-Za-z0-9][A-Za-z0-9._-]*$/.test(key)&&key!=="ccaf-sync-ts";} + function snapshot(value){ + if(!isObject(value))return {ok:false,error:"Progress data must be an object."}; + var keys=Object.keys(value),out={},total=0; + if(keys.length>MAX_KEYS)return {ok:false,error:"Progress data has too many saved items."}; + for(var i=0;iMAX_VALUE)return {ok:false,error:"Progress data contains an invalid value."}; + total+=key.length+item.length; + if(total>MAX_TOTAL)return {ok:false,error:"Progress data is too large."}; + out[key]=item; + } + return {ok:true,data:out,count:keys.length}; + } + function backup(value){ + if(!isObject(value))return {ok:false,error:"That file is not a progress backup."}; + var wrapped=Object.prototype.hasOwnProperty.call(value,"data"),ts=wrapped?value.ts:null; + if(wrapped&&(!Number.isFinite(ts)||ts<0))return {ok:false,error:"That backup has an invalid timestamp."}; + var checked=snapshot(wrapped?value.data:value); + if(!checked.ok)return checked; + checked.ts=wrapped?ts:null;checked.legacy=!wrapped; + return checked; + } + function localPage(value){ + if(typeof value!=="string"||!value||value.length>2048)return null; + try{ + var url=new URL(value,global.location.href); + if(url.origin!==global.location.origin||!/^https?:$/.test(url.protocol))return null; + if(!/\/[A-Za-z0-9][A-Za-z0-9._-]*\.html$/.test(url.pathname))return null; + return url.href; + }catch(error){return null;} + } + global.CCAFProgress={snapshot:snapshot,backup:backup,localPage:localPage}; +})(window); + +/* ---- progress file-sync (runs on every page served over local HTTP) ---- Mirrors every ccaf-* localStorage change into my-progress.json on disk (via serve.py) and restores from that file when the browser copy is missing or older — clearing browser data can no longer lose progress. On the hosted site this whole block stays inactive (browser-only saves). */ (function(){ - var LOCAL=(location.hostname==="localhost"||location.hostname==="127.0.0.1"); + var LOCAL=location.protocol==="http:"; window.CCAF_SYNC={mode:LOCAL?"probing":"pages",ts:0,restored:false}; function snap(){var d={};for(var i=0;imine){ - for(var k in f.data)rawSet(k,f.data[k]); + var checked=(f&&f.data)?window.CCAFProgress.snapshot(f.data):{ok:false}; + if(checked.ok&&typeof f.ts==="number"&&Number.isFinite(f.ts)&&f.ts>mine){ + for(var k in checked.data)rawSet(k,checked.data[k]); rawSet("ccaf-sync-ts",String(f.ts)); window.CCAF_SYNC.ts=f.ts;window.CCAF_SYNC.restored=true;didRestore=true; } - restoring=false;announce("file"); + restoring=false;announce("file");try{sessionStorage.setItem(SESSION_KEY,"file");}catch(e){} // Page scripts may already have read the old local state. One reload is // enough; the saved timestamp prevents a loop on the second load. - if(didRestore)setTimeout(function(){location.reload();},0);else push(); + if(didRestore)setTimeout(function(){location.reload();},0); }) - .catch(function(){clearTimeout(abortTimer);restoring=false;announce("nofile");push();}); + .catch(function(){clearTimeout(abortTimer);saveCapable=false;restoring=false;announce("nofile");try{sessionStorage.setItem(SESSION_KEY,"nofile");}catch(e){}}); })(); (function(){ // completion-gate upgrade: strict about the future, GENEROUS about the past. @@ -110,7 +167,7 @@ var ORDER=COURSE?COURSE.order.slice():["w1","w2","w3","w4","w5","a1","m3","m1","m2","o1","a2","d1","d2","m4","o3","o4","o2","rel","t1","t2","p1","px","p2"]; var TITLES={}; if(COURSE){COURSE.units.forEach(function(u){TITLES[u.id]=u.title;});} - else{TITLES={w1:"Files, folders, and plain text",w2:"JSON by hand",w3:"Programs, functions, and errors",w4:"API request and response",w5:"Safe Terminal basics",a1:"Core vocabulary",m3:"Prompt techniques",m1:"A structured-output call",m2:"One tool call",o1:"The Agent Loop",a2:"Model physics & economics",d1:"Repositories, trees, and diffs",d2:"Commits, pull requests, and CI",m4:"Built-in tools",o3:"An MCP server",o4:"Claude Code workflows",o2:"Orchestrator-Workers",rel:"Reliability, context & evals",t1:"Support-agent system",t2:"Research multi-agent system",p1:"The 6 exam scenarios",px:"Anti-patterns & decision frameworks",p2:"Capstone: PR-review pipeline"};} + else{TITLES={w1:"Files, folders, and plain text",w2:"JSON by hand",w3:"Programs, functions, and errors",w4:"API request and response",w5:"Safe Terminal basics",a1:"Core vocabulary",m3:"Prompt techniques",m1:"A structured-output call",m2:"One tool call",o1:"The Agent Loop",a2:"Model physics & economics",d1:"Repositories, trees, and diffs",d2:"Commits, pull requests, and CI",m4:"Built-in tools",o3:"An MCP server",o4:"Claude Code workflows",o2:"Orchestrator-Workers",rel:"Reliability, context & evals",t1:"Support-agent system",t2:"Research multi-agent system",p1:"Production scenarios",px:"Anti-patterns & decision frameworks",p2:"Capstone: PR-review pipeline"};} function cur(){var d=(J("ccaf-curriculum",{})||{}).done||{};for(var i=0;i0&&(q.score/q.total)>=0.8&&Number(q.guessed||0)===0); - var buildOK=ever||!!(ev.build&&ev.build.data&&ev.build.data.mode==="independent"); + var quizOK=ever||isProject||!!(qPass&&qPass.total>0&&(qPass.score/qPass.total)>=0.8&&Number(qPass.guessed||0)===0); + var buildOK=ever||!!(ev.build&&ev.build.data&&ev.build.data.mode==="independent"&&unit&&ev.build.data.exercise===unit.exercise); var teachOK=ever||!!(ev.teachback&&ev.teachback.data&&ev.teachback.data.complete); var allOK=ever||(sg.all&&quizOK&&buildOK&&teachOK); var touched=sg.n>0||!!q||!!ev.build||!!ev.teachback; @@ -158,6 +215,14 @@ var state=allOK?"proficient":(practiced?"practiced":(touched?"seen":"new")); return {unit:u,state:state,mastered:allOK,grandfathered:ever,steps:sg,quiz:q,quizOK:quizOK,buildOK:buildOK,teachOK:teachOK}; } + function qualifiesQuiz(result){return !!(result&&result.total>0&&(result.score/result.total)>=0.8&&Number(result.guessed||0)===0);} + function quizRecord(result){return {score:result.score,total:result.total,guessed:Number(result.guessed||0),set:result.set||"",ts:result.ts||""};} + function mergeQuizResult(previous,latest){ + var qualified=previous&&previous.qualified?quizRecord(previous.qualified):(qualifiesQuiz(previous)?quizRecord(previous):null); + if(qualifiesQuiz(latest))qualified=quizRecord(latest); + if(qualified)latest.qualified=qualified; + return latest; + } // one-time migration: OR-merge old pipeline + stash into ccaf-steps (true wins, backup first) try{ if(!localStorage.getItem("ccaf-steps-v")){ @@ -191,19 +256,92 @@ if(chA){rA.date=tod();stA[cAb]=rA;S("ccaf-steps",stA);} }}catch(e){} syncPipeline(); - window.CCAF={ORDER:ORDER,TITLES:TITLES,COURSE:COURSE,cur:cur,today:tod,getSteps:getSteps,setStep:setStep,stepsFor:stepsFor,syncPipeline:syncPipeline,recordEvidence:recordEvidence,mastery:mastery}; + window.CCAF={ORDER:ORDER,TITLES:TITLES,COURSE:COURSE,cur:cur,today:tod,getSteps:getSteps,setStep:setStep,stepsFor:stepsFor,syncPipeline:syncPipeline,recordEvidence:recordEvidence,mastery:mastery,mergeQuizResult:mergeQuizResult}; })(); +(function(global){ // ---- one lesson path shared by every learning surface ---- + var STAGES=[ + {id:"learn",label:"Learn",step:0}, + {id:"draw",label:"Draw",step:1}, + {id:"build",label:"Build",step:2}, + {id:"teach",label:"Teach",step:3}, + {id:"quiz",label:"Quiz"}, + {id:"review",label:"Review",step:4} + ]; + function addUnit(href,id){ + if(!href)return "today.html"; + if(!/^(quiz|pretest)\.html/.test(href))return href; + return href+(href.indexOf("?")>=0?"&":"?")+"unit="+encodeURIComponent(id); + } + function unit(id){return global.CCAF_COURSE&&global.CCAF_COURSE.map?global.CCAF_COURSE.map[id]:null;} + function route(id,stage){ + var u=unit(id);if(!u)return "today.html"; + if(stage==="learn")return u.notes||("notes.html?unit="+encodeURIComponent(id)); + if(stage==="draw")return "draw.html?unit="+encodeURIComponent(id); + if(stage==="build")return "exercise.html?id="+encodeURIComponent(u.exercise); + if(stage==="teach")return "teachback.html?unit="+encodeURIComponent(id); + if(stage==="quiz")return addUnit(u.quiz,id); + if(stage==="review")return "review.html?unit="+encodeURIComponent(id); + return "today.html?unit="+encodeURIComponent(id); + } + function states(id){ + var checks=global.CCAF?global.CCAF.getSteps(id):[false,false,false,false,false]; + var mastery=global.CCAF?global.CCAF.mastery(id):null; + return { + learn:!!checks[0],draw:!!checks[1], + build:!!(mastery&&mastery.buildOK),teach:!!(mastery&&mastery.teachOK), + quiz:!!(mastery&&mastery.quizOK),review:!!checks[4] + }; + } + function next(id){ + var done=states(id); + for(var i=0;i=0;} var inMore=MORE.some(function(x){return x.href.toLowerCase()===cur;}); - var html='
    '; - html+='← Back'; + var html='
    '; PRIMARY.forEach(function(p){ var c=[]; if(p.cls)c.push(p.cls); if(here(p.m))c.push("here"); - html+=''+p.label+''; + html+=''+p.label+''; }); - html+='
    '; var host=document.getElementById("site-nav"); if(!host) return; host.innerHTML=html; + function markMain(){var main=document.querySelector("main")||document.querySelector("body > .wrap");if(main&&!main.id)main.id="main-content";} + markMain(); + if(document.readyState==="loading")document.addEventListener("DOMContentLoaded",markMain); var btn=document.getElementById("navMoreBtn"), menu=document.getElementById("navMenu"); if(btn&&menu){ - btn.addEventListener("click",function(e){e.stopPropagation();menu.classList.toggle("open");}); - document.addEventListener("click",function(){menu.classList.remove("open");}); + function setOpen(open,returnFocus){menu.hidden=!open;menu.classList.toggle("open",open);btn.setAttribute("aria-expanded",String(open));if(returnFocus)btn.focus();} + btn.addEventListener("click",function(e){e.stopPropagation();setOpen(menu.hidden);}); + btn.addEventListener("keydown",function(e){if(e.key==="ArrowDown"){e.preventDefault();setOpen(true);var first=menu.querySelector("a");if(first)first.focus();}else if(e.key==="Escape")setOpen(false,true);}); + menu.addEventListener("keydown",function(e){if(e.key==="Escape"){e.preventDefault();setOpen(false,true);}}); + document.addEventListener("click",function(){setOpen(false,false);}); } })(); diff --git a/notes-corrections.js b/notes-corrections.js new file mode 100644 index 0000000..ea02bd6 --- /dev/null +++ b/notes-corrections.js @@ -0,0 +1,66 @@ +/* Current-product corrections applied after the compact generated notes file loads. */ +(function(){ + var notes=window.LESSON_NOTES; + if(!notes)return; + + function replaceEvery(text,from,to){return String(text).split(from).join(to);} + function revise(id,replacements){ + var note=notes[id]; + if(!note)return; + replacements.forEach(function(pair){note.html=replaceEvery(note.html,pair[0],pair[1]);}); + } + + revise("a1",[ + ["the model's short-term memory. It is how much text the model can hold at one time.","the model's limited working input space. It is how much text the model can use at one time; it is not durable memory."], + ["the model's short-term memory; text beyond it cannot be used.","the model's limited working input space; text beyond the limit cannot be used in that request."] + ]); + + revise("o1",[ + ["tool_use = continue, end_turn = done","tool_use = run the requested tool, end_turn = natural completion; handle every other value explicitly"], + ["tool_use = keep going, end_turn = done","tool_use = run the requested tool, end_turn = natural completion; handle every other value explicitly"] + ]); + + revise("m3",[ + ["The shape is guaranteed, not left to luck.","On a normally completed response, the output follows the schema. Refusals and token cutoffs still need their own branch."], + ["Structured Outputs makes sure the reply always fits it — no missing braces.","A normally completed Structured Outputs reply fits it — no missing braces."], + ["do NOT guarantee valid JSON. Only constrained decoding guarantees the shape.","do NOT enforce valid JSON. Constrained decoding enforces the shape on a normally completed response; handle refusals and truncation separately."], + ["a feature that guarantees valid JSON via constrained decoding.","a feature that constrains normally completed responses to schema-valid JSON."], + ["forcing the model's output to fit a schema so it is always valid.","constraining a normally completed response to fit a schema; refusals and truncation need separate handling."], + ["Only Structured Outputs (constrained decoding) guarantees the reply fits your schema.","Structured Outputs constrains normal responses to fit your schema; refusal and truncation paths still need handling."] + ]); + + revise("m1",[ + ["locking the shape during generation so JSON is always valid","constraining the shape during normal generation; refusals and truncation still need handling"], + ["Only Structured Outputs (constrained decoding) guarantees it.","Structured Outputs constrains it on normal completion; handle refusals and truncation separately."] + ]); + + revise("o4",[ + ["a file of project rules Claude re-reads every request.","scoped project instructions Claude Code loads for a session. The file is not a secret store, and its content can be re-injected after compaction."], + ["a saved prompt you run by its /name.","a compatibility form for a saved workflow. Current Claude Code presents commands and Skills together."] + ]); + + revise("rel",[ + ["the model's short-term memory. It only holds so much text at once. Extra text falls out.","the model's limited working input space, not durable memory. It can use only the text kept inside that space."], + ["forces the shape of the JSON, so it is always valid JSON.","constrains a normally completed response to the JSON shape. Refusals and truncated outputs still need separate handling."], + ["The scratchpad is the safety net. Chat is temporary; the file is the memory.","A file helps only when the application writes progress and deliberately reads it again; saving and resuming are not automatic."], + ["files that hold progress and facts so an agent can resume","files that can hold progress and facts when the application writes and reloads them"] + ]); + + revise("p1",[ + ["tool_use = continue, end_turn = done","tool_use = run the requested tool, end_turn = natural completion; handle every other value explicitly"], + ["tool_use = keep going, end_turn = done","tool_use = run the requested tool, end_turn = natural completion; handle every other value explicitly"] + ]); + + revise("p2",[ + ["Structured Outputs (constrained decoding) is the reliable way to guarantee the JSON is valid — but you STILL validate it and retry with the specific error","Structured Outputs (constrained decoding) reliably enforces the JSON shape on normal completion — but you STILL handle refusals or truncation, validate meaning, and retry with the specific error"] + ]); + + if(notes.p1){ + notes.p1.title="Production scenarios"; + notes.p1.html=replaceEvery( + notes.p1.html, + "The exam gives you scenarios", + "Reported exam descriptions use production scenarios" + ); + } +})(); diff --git a/notes.html b/notes.html index fed9b54..b61b396 100644 --- a/notes.html +++ b/notes.html @@ -13,45 +13,57 @@ .pgbtn:hover{border-color:var(--accent);color:var(--accent)} .pgbtn.off{opacity:.35;pointer-events:none} #notes h3{margin:1.4em 0 .5em;font-size:1.15rem} - #notes .idea{background:#fff;border:1px solid var(--line);border-left:6px solid var(--accent);border-radius:8px;padding:12px 16px;margin:10px 0;line-height:1.65} + #notes .idea{background:#fff;border:1px solid var(--line);border-left:6px solid var(--accent);border-radius:8px;padding:12px 16px;margin:10px 0;line-height:1.65;overflow-wrap:anywhere} #notes ul{line-height:1.8} #notes p{line-height:1.7;max-width:62ch} .b{display:inline-block;border:0;cursor:pointer;font:inherit;font-weight:800;border-radius:7px;padding:10px 18px;text-decoration:none;font-size:.92rem;margin:4px 8px 0 0} .b.go{background:var(--accent);color:#fff} .b.quiz{background:var(--green);color:#fff} .b.plain{background:#fff;color:var(--ink);border:1.5px solid var(--line)} - @media print{nav.top,.npager,.actions{display:none}} + @media print{nav.top,.lesson-switcher,.actions,.lesson-flow-shell,.study-actionbar{display:none}} + + -
    +

    📖 Lesson notes

    Everything this lesson's quiz, flashcards and exercises test — in plain words, made for taking your own notes from.

    -
    - ◀ Previous lesson -
     
    - Next lesson ▶ -
    +
    + Browse another lesson +
    + Previous lesson +
     
    + Next lesson +
    +
    Loading…
    -
    +
    + +
    +
    Loading notes…
    +
    +
    +
    Write these ideas in your own words — that's the step that makes them stick. · Notes print cleanly if you want them on paper.
    -
    + + diff --git a/package.json b/package.json new file mode 100644 index 0000000..ee602f3 --- /dev/null +++ b/package.json @@ -0,0 +1,48 @@ +{ + "name": "cca-f-study-course", + "version": "1.0.0", + "private": true, + "scripts": { + "audit": "node course-audit.mjs && node scripts/check-syntax.mjs && node scripts/verify-studio-baseline.mjs && node scripts/export-studio-manifest.mjs --check", + "studio:manifest": "node scripts/export-studio-manifest.mjs", + "studio:manifest:check": "node scripts/export-studio-manifest.mjs --check", + "typecheck": "tsc -p studio/tsconfig.json --noEmit", + "studio:dev": "vite --config studio/vite.config.ts", + "studio:build": "pnpm run studio:manifest && vite build --config studio/vite.config.ts && python3 scripts/release_identity.py generate --dist studio/dist", + "studio:release:check": "python3 scripts/release_identity.py verify --dist studio/dist", + "studio:preview:check": "node scripts/verify-preview-bundle.mjs", + "studio:preview": "vite preview --config studio/vite.config.ts", + "studio:start": "python3 scripts/start_studio.py --no-open", + "test:unit": "vitest run --config studio/vitest.config.ts --maxWorkers=1", + "test:studio-server": "python -m pytest tests/studio_server tests/test_mcp_safety.py tests/test_release_hardening.py -vv --durations=10", + "test:server": "python3 -m unittest discover -s tests -p 'test_serve.py'", + "test:e2e": "playwright test", + "test": "pnpm run audit && pnpm run typecheck && pnpm run test:unit && pnpm run test:server && pnpm run test:studio-server && pnpm run studio:build && pnpm run studio:release:check && pnpm run test:e2e" + }, + "devDependencies": { + "@axe-core/playwright": "4.12.1", + "@playwright/test": "1.61.1", + "@testing-library/jest-dom": "6.9.1", + "@testing-library/react": "16.3.2", + "@testing-library/user-event": "14.6.1", + "@types/node": "24.10.0", + "@types/react": "19.2.17", + "@types/react-dom": "19.2.3", + "@vitejs/plugin-react": "6.0.3", + "happy-dom": "20.10.6", + "typescript": "7.0.2", + "vite": "8.1.4", + "vitest": "4.1.10" + }, + "packageManager": "pnpm@11.7.0", + "dependencies": { + "@codemirror/commands": "6.10.4", + "@codemirror/lang-json": "6.0.2", + "@codemirror/state": "6.7.1", + "@codemirror/view": "6.43.6", + "lucide-react": "1.24.0", + "react": "19.2.7", + "react-dom": "19.2.7", + "react-router-dom": "7.18.1" + } +} diff --git a/playwright.config.js b/playwright.config.js new file mode 100644 index 0000000..16bc29f --- /dev/null +++ b/playwright.config.js @@ -0,0 +1,55 @@ +const { defineConfig, devices } = require("@playwright/test"); + +const ci = Boolean(process.env.CI); +const verbose = ci || process.env.CCA_STUDIO_VERBOSE === "1"; +const studioBaseURL = process.env.CCA_STUDIO_E2E_URL || "http://127.0.0.1:8765"; +const boundedTimeout = (name, fallback, maximum) => { + const value = Number(process.env[name] || fallback); + return Number.isFinite(value) ? Math.min(Math.max(value, 1_000), maximum) : fallback; +}; +const testTimeout = boundedTimeout("CCA_STUDIO_TEST_TIMEOUT_MS", 90_000, 120_000); +const webServerTimeout = boundedTimeout("CCA_STUDIO_WEB_SERVER_TIMEOUT_MS", 120_000, 180_000); + +module.exports = defineConfig({ + testDir: "./tests/e2e", + timeout: testTimeout, + globalTimeout: boundedTimeout("CCA_STUDIO_GLOBAL_TIMEOUT_MS", 10 * 60_000, 20 * 60_000), + expect: { timeout: 5_000 }, + fullyParallel: false, + workers: 1, + maxFailures: ci ? 1 : 0, + forbidOnly: ci, + retries: 0, + reporter: verbose + ? [["line"], ["json", { outputFile: "test-results/playwright-report.json" }]] + : [["list", { printSteps: true }]], + use: { + baseURL: "http://127.0.0.1:4173", + actionTimeout: 15_000, + navigationTimeout: 30_000, + trace: "retain-on-failure", + screenshot: "only-on-failure", + video: "retain-on-failure" + }, + webServer: [ + { + command: "python3 scripts/serve_legacy_archive.py --port 4173", + url: "http://127.0.0.1:4173/dashboard.html", + reuseExistingServer: !process.env.CI, + timeout: webServerTimeout, + stdout: verbose ? "pipe" : "ignore", + stderr: verbose ? "pipe" : "ignore" + }, + { + command: "python3 scripts/e2e_studio_server.py", + url: `${studioBaseURL}/__health`, + reuseExistingServer: !process.env.CI, + timeout: webServerTimeout, + stdout: verbose ? "pipe" : "ignore", + stderr: verbose ? "pipe" : "ignore" + } + ], + projects: [ + { name: "desktop-chromium", use: { ...devices["Desktop Chrome"] } } + ] +}); diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml new file mode 100644 index 0000000..17dbd84 --- /dev/null +++ b/pnpm-lock.yaml @@ -0,0 +1,2181 @@ +lockfileVersion: '9.0' + +settings: + autoInstallPeers: true + excludeLinksFromLockfile: false + +importers: + + .: + dependencies: + '@codemirror/commands': + specifier: 6.10.4 + version: 6.10.4 + '@codemirror/lang-json': + specifier: 6.0.2 + version: 6.0.2 + '@codemirror/state': + specifier: 6.7.1 + version: 6.7.1 + '@codemirror/view': + specifier: 6.43.6 + version: 6.43.6 + lucide-react: + specifier: 1.24.0 + version: 1.24.0(react@19.2.7) + react: + specifier: 19.2.7 + version: 19.2.7 + react-dom: + specifier: 19.2.7 + version: 19.2.7(react@19.2.7) + react-router-dom: + specifier: 7.18.1 + version: 7.18.1(react-dom@19.2.7(react@19.2.7))(react@19.2.7) + devDependencies: + '@axe-core/playwright': + specifier: 4.12.1 + version: 4.12.1(playwright-core@1.61.1) + '@playwright/test': + specifier: 1.61.1 + version: 1.61.1 + '@testing-library/jest-dom': + specifier: 6.9.1 + version: 6.9.1 + '@testing-library/react': + specifier: 16.3.2 + version: 16.3.2(@testing-library/dom@10.4.1)(@types/react-dom@19.2.3(@types/react@19.2.17))(@types/react@19.2.17)(react-dom@19.2.7(react@19.2.7))(react@19.2.7) + '@testing-library/user-event': + specifier: 14.6.1 + version: 14.6.1(@testing-library/dom@10.4.1) + '@types/node': + specifier: 24.10.0 + version: 24.10.0 + '@types/react': + specifier: 19.2.17 + version: 19.2.17 + '@types/react-dom': + specifier: 19.2.3 + version: 19.2.3(@types/react@19.2.17) + '@vitejs/plugin-react': + specifier: 6.0.3 + version: 6.0.3(vite@8.1.4(@types/node@24.10.0)(esbuild@0.28.1)) + happy-dom: + specifier: 20.10.6 + version: 20.10.6 + typescript: + specifier: 7.0.2 + version: 7.0.2 + vite: + specifier: 8.1.4 + version: 8.1.4(@types/node@24.10.0)(esbuild@0.28.1) + vitest: + specifier: 4.1.10 + version: 4.1.10(@types/node@24.10.0)(happy-dom@20.10.6)(jsdom@29.1.1)(vite@8.1.4(@types/node@24.10.0)(esbuild@0.28.1)) + +packages: + + '@adobe/css-tools@4.5.0': + resolution: {integrity: sha512-6OzddxPio9UiWTCemp4N8cYLV2ZN1ncRnV1cVGtve7dhPOtRkleRyx32GQCYSwDYgaHU3USMm84tNsvKzRCa1Q==} + + '@asamuzakjp/css-color@5.1.11': + resolution: {integrity: sha512-KVw6qIiCTUQhByfTd78h2yD1/00waTmm9uy/R7Ck/ctUyAPj+AEDLkQIdJW0T8+qGgj3j5bpNKK7Q3G+LedJWg==} + engines: {node: ^20.19.0 || ^22.12.0 || >=24.0.0} + + '@asamuzakjp/dom-selector@7.1.1': + resolution: {integrity: sha512-67RZDnYRc8H/8MLDgQCDE//zoqVFwajkepHZgmXrbwybzXOEwOWGPYGmALYl9J2DOLfFPPs6kKCqmbzV895hTQ==} + engines: {node: ^20.19.0 || ^22.12.0 || >=24.0.0} + + '@asamuzakjp/generational-cache@1.0.1': + resolution: {integrity: sha512-wajfB8KqzMCN2KGNFdLkReeHncd0AslUSrvHVvvYWuU8ghncRJoA50kT3zP9MVL0+9g4/67H+cdvBskj9THPzg==} + engines: {node: ^20.19.0 || ^22.12.0 || >=24.0.0} + + '@asamuzakjp/nwsapi@2.3.9': + resolution: {integrity: sha512-n8GuYSrI9bF7FFZ/SjhwevlHc8xaVlb/7HmHelnc/PZXBD2ZR49NnN9sMMuDdEGPeeRQ5d0hqlSlEpgCX3Wl0Q==} + + '@axe-core/playwright@4.12.1': + resolution: {integrity: sha512-rMd7xriptqKpP+w5265i4Hdkv2X5kbu6uiBi/B2I7uf3hieRBM3qDCfaKPtxfiYb2mKXfF+yLODJwIx+Jv1GDw==} + peerDependencies: + playwright-core: '>= 1.0.0' + + '@babel/code-frame@7.29.7': + resolution: {integrity: sha512-Aup7aUOfpbAUg2ROOJN6Iw5f9DMBlzu0mIkm/malLQFN/YQgO48wCj0Kxa3sEHJvPVFg7siR+qRInwXd2qhQKw==} + engines: {node: '>=6.9.0'} + + '@babel/helper-validator-identifier@7.29.7': + resolution: {integrity: sha512-qehxGkRj55h/ff8EMaJ+cYhyaKlHIxqYDn682wQD7RNp9UujOQsHog2uS0r2vzr4pW+sXf90NeeayjcNaX3fFg==} + engines: {node: '>=6.9.0'} + + '@babel/runtime@7.29.7': + resolution: {integrity: sha512-Nq8OhGWiZIZGV6hLHoyAKLLcJihP/xFeBMGJoUrxTX2psI8dCifzLhZISFb+VWS3wFMRDmCGw5R+dOySCqPLhw==} + engines: {node: '>=6.9.0'} + + '@bramus/specificity@2.4.2': + resolution: {integrity: sha512-ctxtJ/eA+t+6q2++vj5j7FYX3nRu311q1wfYH3xjlLOsczhlhxAg2FWNUXhpGvAw3BWo1xBcvOV6/YLc2r5FJw==} + hasBin: true + + '@codemirror/commands@6.10.4': + resolution: {integrity: sha512-Ryk9y9T0FFVF0cUGhAknveAyUOl/A1qReTFi+qPKtOh2Z9F4AUBz3XOrYD4ZEgZirdugVzHvd/2/Wcwy5OliTg==} + + '@codemirror/lang-json@6.0.2': + resolution: {integrity: sha512-x2OtO+AvwEHrEwR0FyyPtfDUiloG3rnVTSZV1W8UteaLL8/MajQd8DpvUb2YVzC+/T18aSDv0H9mu+xw0EStoQ==} + + '@codemirror/language@6.12.4': + resolution: {integrity: sha512-1q4PaT+o6PbgpkJt4Q8Fv5XJxTy4FUZ4MWETtyiDw3J0Pyr9E2vqcKL+k9wcvjNTIsauxvE7OfmWj3FRPHQ76A==} + + '@codemirror/state@6.7.1': + resolution: {integrity: sha512-9QzNDgE4EYDnAHfrTlR2lwiPciiOymLtwKK+8yHQzCc7GXhAP9xdEbEJFy2IWB1j9UGUl9BsgMmTo/ImA02T7A==} + + '@codemirror/view@6.43.6': + resolution: {integrity: sha512-EVunGSYN1wz1p75WY1s3Xg7t3i8Yol0kGZGizNdX9BUFgMFILYVe8/u6EVpo7Ff5PwbZuILb4QAq7IZoKzIEQA==} + + '@csstools/color-helpers@6.1.0': + resolution: {integrity: sha512-064IFJdjTfUqnjpCVpMOdbr8FLQBhinbZj6yRv2An2E41O/pLEXqfFRWqGq/SxlE5PEUYTlvWsG2r8MswAVvkg==} + engines: {node: '>=20.19.0'} + + '@csstools/css-calc@3.2.1': + resolution: {integrity: sha512-DtdHlgXh5ZkA43cwBcAm+huzgJiwx3ZTWVjBs94kwz2xKqSimDA3lBgCjphYgwgVUMWatSM0pDd8TILB1yrVVg==} + engines: {node: '>=20.19.0'} + peerDependencies: + '@csstools/css-parser-algorithms': ^4.0.0 + '@csstools/css-tokenizer': ^4.0.0 + + '@csstools/css-color-parser@4.1.9': + resolution: {integrity: sha512-paQcIaOO53Rk5+YrBaBjm/SgrV4INImjo2BT1DtQRYr+XeTRbeAYlS+jxXp9drqvKmtFnWRJKIalDLhZZDu42A==} + engines: {node: '>=20.19.0'} + peerDependencies: + '@csstools/css-parser-algorithms': ^4.0.0 + '@csstools/css-tokenizer': ^4.0.0 + + '@csstools/css-parser-algorithms@4.0.0': + resolution: {integrity: sha512-+B87qS7fIG3L5h3qwJ/IFbjoVoOe/bpOdh9hAjXbvx0o8ImEmUsGXN0inFOnk2ChCFgqkkGFQ+TpM5rbhkKe4w==} + engines: {node: '>=20.19.0'} + peerDependencies: + '@csstools/css-tokenizer': ^4.0.0 + + '@csstools/css-syntax-patches-for-csstree@1.1.6': + resolution: {integrity: sha512-TcJCWFbXLPpJYq6z7bfOyjWYJDiDg2/I4gyUC9pqPNqHFRIey0EB0q0L5cSnQDfWJg8Jd6VadakxdIez/3zkqQ==} + peerDependencies: + css-tree: ^3.2.1 + peerDependenciesMeta: + css-tree: + optional: true + + '@csstools/css-tokenizer@4.0.0': + resolution: {integrity: sha512-QxULHAm7cNu72w97JUNCBFODFaXpbDg+dP8b/oWFAZ2MTRppA3U00Y2L1HqaS4J6yBqxwa/Y3nMBaxVKbB/NsA==} + engines: {node: '>=20.19.0'} + + '@emnapi/core@1.11.1': + resolution: {integrity: sha512-RSvbQmHzdKzNsLYa/wHrbc3KN4sYLKAdPZxqiM2HATqv/SBk2/ENSHpvXGaLOMcsAyz0poEGqkmmKYG3OWiJEQ==} + + '@emnapi/runtime@1.11.1': + resolution: {integrity: sha512-vgj7R3y3Wgx24IQaGPA/R6YFXLHVMOZ0uVEyIQPaWs+rd1AzfEMXlAC22FYwO1XkKR6NPsq7mUandH8oIRdZFw==} + + '@emnapi/wasi-threads@1.2.2': + resolution: {integrity: sha512-c95qOXkHdydNKhscBTebqEC1CVAZpyqOfVfBzQ1qgzyl3gfeldUjIggDbIZgDKsHLgnsM+igH7TJ/eAasaVuMA==} + + '@esbuild/aix-ppc64@0.28.1': + resolution: {integrity: sha512-Svl7tq8k/08+p6CXPpRjQ1fKX+1odH/BQbb48fV6fj3CWHhsoIOoY87w1oHXm0qEpkIK3ZfVgp0hed3XBXzXMQ==} + engines: {node: '>=18'} + cpu: [ppc64] + os: [aix] + + '@esbuild/android-arm64@0.28.1': + resolution: {integrity: sha512-34EGEbCIAgosYz6goLcopX6Mo7NyGv9tfwEM2/7Ce2VcVRk568iSvniGWcUXIy7wEDR1wzolcxcriFVrWYcwBg==} + engines: {node: '>=18'} + cpu: [arm64] + os: [android] + + '@esbuild/android-arm@0.28.1': + resolution: {integrity: sha512-0k2F129Xdio1TdJfzJ8sy1Q47vUD2NnwdhiAf7drUN1EBTfPf4hsFCtmMgu/6m8JSzsBrlmVjudMBQqOfG8usQ==} + engines: {node: '>=18'} + cpu: [arm] + os: [android] + + '@esbuild/android-x64@0.28.1': + resolution: {integrity: sha512-dbwY7ltSMDWsRatcRpCnES4F+im88OCUgGZjy52shC7GqHRE/cYlxNbB4Z4UpJswpcc4Qxd2oE/ufM0p61IKng==} + engines: {node: '>=18'} + cpu: [x64] + os: [android] + + '@esbuild/darwin-arm64@0.28.1': + resolution: {integrity: sha512-TZbWkQY7kvTAXbXUT7uVACR5cMHsDiSz9z7ZKAX/RTq/WJEk3QyRr0wZpNhBDX+/0CtdqUIJlOiodQcta6tY3Q==} + engines: {node: '>=18'} + cpu: [arm64] + os: [darwin] + + '@esbuild/darwin-x64@0.28.1': + resolution: {integrity: sha512-zfdzgK9ACBNZLI/CyHTOx81SyNbM6YXn7rxSgX97VjyiPl9W1i4Ka4fgKECEoFCKGpvBj5qArWIGgQjOwkgskQ==} + engines: {node: '>=18'} + cpu: [x64] + os: [darwin] + + '@esbuild/freebsd-arm64@0.28.1': + resolution: {integrity: sha512-wG2EA8ENdEI0qhkSZMjfqrdY+ziCYCPMmtZjjIwOmXFjmyzEHn+UUxk5of+SYsjtfs3VpnlC7QLzSI5hY/rOAw==} + engines: {node: '>=18'} + cpu: [arm64] + os: [freebsd] + + '@esbuild/freebsd-x64@0.28.1': + resolution: {integrity: sha512-i7dZ9vQgnvSCzi/rYCXNgtF/U+eKZNJBzu3eTQbRgHnM7tNSizLOkRFAl3qzVc/Op/u5YkHHa4pf/3DOYHthLQ==} + engines: {node: '>=18'} + cpu: [x64] + os: [freebsd] + + '@esbuild/linux-arm64@0.28.1': + resolution: {integrity: sha512-yHs+0uc8+nvEAfAfxrWQKK5peSNzBc4PegcMO0EJ2hT71uA7vB8Ihg2e77R2P7SG5uYjPbHlLLmve4LLLRCf0g==} + engines: {node: '>=18'} + cpu: [arm64] + os: [linux] + + '@esbuild/linux-arm@0.28.1': + resolution: {integrity: sha512-qVXBOHQS+d5Y722GwJzJUtOLlX7km3CraOaGormF1pDtPd2C/l1SHRPgjLunLGe51Sh5YYWKMFDyV4SxgMQYTQ==} + engines: {node: '>=18'} + cpu: [arm] + os: [linux] + + '@esbuild/linux-ia32@0.28.1': + resolution: {integrity: sha512-d1z4ZuP0ajrfz/FhGT4vv278rX8KnPPJx8i5+AtK7TYbx9Le9F1hyzurZpkEyjkGa9dUGhQow4C1NmeGvqxN2w==} + engines: {node: '>=18'} + cpu: [ia32] + os: [linux] + + '@esbuild/linux-loong64@0.28.1': + resolution: {integrity: sha512-M5sRjUVZrkm1OAPR3dlOYzNmN+loZKGVi1VUQGrwuqLcbR6qeAz+famMhjASeH3YVKvZz+zT1jlh/keC3Rj/lg==} + engines: {node: '>=18'} + cpu: [loong64] + os: [linux] + + '@esbuild/linux-mips64el@0.28.1': + resolution: {integrity: sha512-mRObBZeHh2OxcBFPWE/FjylkRgZdYuiTR3vaTozquCGOH14iP9oN4x4Ge81CoIDYQrXmIxpFumJBu5MtZpnQJQ==} + engines: {node: '>=18'} + cpu: [mips64el] + os: [linux] + + '@esbuild/linux-ppc64@0.28.1': + resolution: {integrity: sha512-slScBsMAb3GFDcdrCgLwZtPYRoH2H/youv10QiZyRjmsP48fznoveWytSgCI/R0ZcUgpc0ZhIUEx6LHts8yrfQ==} + engines: {node: '>=18'} + cpu: [ppc64] + os: [linux] + + '@esbuild/linux-riscv64@0.28.1': + resolution: {integrity: sha512-kw0owk1o0GFETUJyW0jc0G4Yzs0BHZn0JDZ8JRT088vjJYX777BAs1fDGxAC+q831qOs2DTC96mNsG2opdfyyQ==} + engines: {node: '>=18'} + cpu: [riscv64] + os: [linux] + + '@esbuild/linux-s390x@0.28.1': + resolution: {integrity: sha512-/lAIjX8aYFRByhh6L5rYtPEDRqa9de/4V/juOXcta5frjvzXO4/sqEtyytse0g3zZFuWu5cDN0MkLz2qRDD2Ag==} + engines: {node: '>=18'} + cpu: [s390x] + os: [linux] + + '@esbuild/linux-x64@0.28.1': + resolution: {integrity: sha512-u/anNYF2mmVOEDwLtnQ1wOr3EZ9sTNGLWrsYGYwHWzGA3Si84IOkHXlbWTD1NB+9/1lcnweYKO54uhxZydNzfA==} + engines: {node: '>=18'} + cpu: [x64] + os: [linux] + + '@esbuild/netbsd-arm64@0.28.1': + resolution: {integrity: sha512-oks0DYbLwWMmaakTsCb+zL4E+aHRVLom9IJZOAthMQEPiQmydXHkziYEsGYRx0uNV/IjEKGAV941JzH02pflqw==} + engines: {node: '>=18'} + cpu: [arm64] + os: [netbsd] + + '@esbuild/netbsd-x64@0.28.1': + resolution: {integrity: sha512-aeL6lAnN89Hz43Mlh1G8ARasbuoYvSITDEx0tHh5b7jJnHcssqgjy9Yx430GDpmCa6OyrKoS0aNRjKundRizGg==} + engines: {node: '>=18'} + cpu: [x64] + os: [netbsd] + + '@esbuild/openbsd-arm64@0.28.1': + resolution: {integrity: sha512-MEFJe5C3R8pwXdZ5Y21oo6m7ePiS0d9pWucn99O/wvyJZChoIQKrQDxKrGeW8F5+T0okTHesAmDeiHDTIq0V/Q==} + engines: {node: '>=18'} + cpu: [arm64] + os: [openbsd] + + '@esbuild/openbsd-x64@0.28.1': + resolution: {integrity: sha512-i/ZLIOafE0Z8cI/XANJAixoJL/uRAoS2xOA3rb0xN+KK0K177cMAsQYkzHtBrtMXAKuAc7HGgcWiZ/sRC1Nxgw==} + engines: {node: '>=18'} + cpu: [x64] + os: [openbsd] + + '@esbuild/openharmony-arm64@0.28.1': + resolution: {integrity: sha512-ge+Z7EXFNt2BO1oAMsVpiQ8EwndV9i1xXerAeTIK7AtPs3bKFXQM7nlRxDSIUIMeueR1CNXxqztLzdNeReKBJg==} + engines: {node: '>=18'} + cpu: [arm64] + os: [openharmony] + + '@esbuild/sunos-x64@0.28.1': + resolution: {integrity: sha512-BEjgtECkL3vY+SaSQ6nzVfiALUeFxpawyp8Jmf5PtYhf1Ug40N1h/hxlhts+f1FvSvarEigdxS3BlSMI2PJLcQ==} + engines: {node: '>=18'} + cpu: [x64] + os: [sunos] + + '@esbuild/win32-arm64@0.28.1': + resolution: {integrity: sha512-lCv9eK/H6ZJWbE7bh2nw54CZ9M2nupBxJcTsdk/QQnWkdSjKGuxmmH8/GWrlT1eMmZfn4dGcCjRte397WqfQXA==} + engines: {node: '>=18'} + cpu: [arm64] + os: [win32] + + '@esbuild/win32-ia32@0.28.1': + resolution: {integrity: sha512-zvb/mB2bSCoJOpoCBgYKKpX6YM6mJBlBUVUtVj41DlZJVEB6/0CKlRYxP5wWl1C1ILiCoAU5wZZ4q1P3qeS6Eg==} + engines: {node: '>=18'} + cpu: [ia32] + os: [win32] + + '@esbuild/win32-x64@0.28.1': + resolution: {integrity: sha512-bm4Mowrv+GXMlpWX++EcXw/iLyd1o3+bJkC2DkWXYVvgZCqD/bSj9ctZeAMC3cIxgjRVR2Dufaiu4YPxr5gW1A==} + engines: {node: '>=18'} + cpu: [x64] + os: [win32] + + '@exodus/bytes@1.15.1': + resolution: {integrity: sha512-S6mL0yNB/Abt9Ei4tq8gDhcczc4S3+vQ4ra7vxnAf+YHC02srtqxKKZghx2Dq6p0e66THKwR6r8N6P95wEty7Q==} + engines: {node: ^20.19.0 || ^22.12.0 || >=24.0.0} + peerDependencies: + '@noble/hashes': ^1.8.0 || ^2.0.0 + peerDependenciesMeta: + '@noble/hashes': + optional: true + + '@jridgewell/sourcemap-codec@1.5.5': + resolution: {integrity: sha512-cYQ9310grqxueWbl+WuIUIaiUaDcj7WOq5fVhEljNVgRfOUhY9fy2zTvfoqWsnebh8Sl70VScFbICvJnLKB0Og==} + + '@lezer/common@1.5.2': + resolution: {integrity: sha512-sxQE460fPZyU3sdc8lafxiPwJHBzZRy/udNFynGQky1SePYBdhkBl1kOagA9uT3pxR8K09bOrmTUqA9wb/PjSQ==} + + '@lezer/highlight@1.2.3': + resolution: {integrity: sha512-qXdH7UqTvGfdVBINrgKhDsVTJTxactNNxLk7+UMwZhU13lMHaOBlJe9Vqp907ya56Y3+ed2tlqzys7jDkTmW0g==} + + '@lezer/json@1.0.3': + resolution: {integrity: sha512-BP9KzdF9Y35PDpv04r0VeSTKDeox5vVr3efE7eBbx3r4s3oNLfunchejZhjArmeieBH+nVOpgIiBJpEAv8ilqQ==} + + '@lezer/lr@1.4.10': + resolution: {integrity: sha512-rnCpTIBafOx4mRp43xOxDJbFipJm/c0cia/V5TiGlhmMa+wsSdoGmUN3w5Bqrks/09Q/D4tNAmWaT8p6NRi77A==} + + '@marijn/find-cluster-break@1.0.3': + resolution: {integrity: sha512-FY+MKLBoTsLNJF/eLWaOsXGdz6uh3Iu1axjPf6TUq92IYumcTcXWHoS747JARLkcdlJ/Waiaxc5wQfFO8jC6NA==} + + '@napi-rs/wasm-runtime@1.1.6': + resolution: {integrity: sha512-ZLv/JdUfkvOy9eCnnBaGfiO+XimbjebAeO+MRQqD/B+FR1tnRN0tpKSJHRbE8sFfS6aqsXZ67TQjfwfsxULVbg==} + peerDependencies: + '@emnapi/core': ^1.7.1 + '@emnapi/runtime': ^1.7.1 + + '@oxc-project/types@0.139.0': + resolution: {integrity: sha512-r9gHphtCs+1M7J0pw6Sn/hh/Wpa/iQrOOkrNAlVLF/gHq+/CJmHIWKKUUhdWjcD6CIa8idarspCsASiXCXvFUw==} + + '@playwright/test@1.61.1': + resolution: {integrity: sha512-8nKv6+0RJSL9FE4jYOEGXnPeM/Hg12qZpmqzZjRh3qM0Y7c3z1mrOTfFLids72RDQYVh9WpLEfR5WdpNX4fkig==} + engines: {node: '>=18'} + hasBin: true + + '@rolldown/binding-android-arm64@1.1.5': + resolution: {integrity: sha512-lZg8fqIv2v7FF237bwMgzGZEJvGL79/s5knJ/i6FmsGF4XXlzccZ4jb+TrFIxtSSxFtIpdsgrPZeMk1I9AFcyQ==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [arm64] + os: [android] + + '@rolldown/binding-darwin-arm64@1.1.5': + resolution: {integrity: sha512-51Bnx9pNiMRKSUNtBfySkNJ9vMU9Hh3I1ozDd6gyPPYzaXCfnptUcEZxXGYFn+ul2dtcMUiqGR1Yai2K10uoTw==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [arm64] + os: [darwin] + + '@rolldown/binding-darwin-x64@1.1.5': + resolution: {integrity: sha512-Tm+gbfC0aHu1tBA/JvKQh32S0K6YgCHkiAF4/W6xX0K0RmNuc94VeK419dJoE65R5aRxmo+noZQSWrAMF6yb6g==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [x64] + os: [darwin] + + '@rolldown/binding-freebsd-x64@1.1.5': + resolution: {integrity: sha512-JMzDKCCXq93YccG5gz3hvOs1oXRKAf0XYpfOS88e+wZrC8Iugj6j68867vrYZkvpDDpKn/KoKORThmchMpF6TA==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [x64] + os: [freebsd] + + '@rolldown/binding-linux-arm-gnueabihf@1.1.5': + resolution: {integrity: sha512-uML21j2K5TfPGutKxub+M+nLjZIrWjXQ5Grx4lCe/nimTj9B4L63zHpjXLl4y0L3mcm2htEQIb06oCG/szerNw==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [arm] + os: [linux] + + '@rolldown/binding-linux-arm64-gnu@1.1.5': + resolution: {integrity: sha512-navSiuTMogvnQoZoM/v+l3ZWo50/NTwSHSzheABx/RCnmUPaKwq9qSo4Br2OYRs21+Fz8uFqITZM3H4opOB0/Q==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [arm64] + os: [linux] + libc: [glibc] + + '@rolldown/binding-linux-arm64-musl@1.1.5': + resolution: {integrity: sha512-lAryqH7IteztmCXQXk0etKj4wBQ7Gx5S6LjKhsgp9zb8I5bsuvU/2llH1hDQcjsFeqIsovMVN339/8pUDDBXxA==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [arm64] + os: [linux] + libc: [musl] + + '@rolldown/binding-linux-ppc64-gnu@1.1.5': + resolution: {integrity: sha512-fsK/sNBnxzBlL4O1JNrZakVQxPspqpED5dLtNsZS9oOKmtSpdNIzxH2kkol5HYTWJN47sE20ztMJPxfZ89qGOg==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [ppc64] + os: [linux] + libc: [glibc] + + '@rolldown/binding-linux-s390x-gnu@1.1.5': + resolution: {integrity: sha512-gLYb4BIadlfTOYT5gO503n8zQjXflgzpD0FcyKh0Mzx3rqCZKnHoJWV9xe1KXUJ5lx2JfcSHr/mhzS0PC/McAA==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [s390x] + os: [linux] + libc: [glibc] + + '@rolldown/binding-linux-x64-gnu@1.1.5': + resolution: {integrity: sha512-FjcpEKUyJygHgs1o50VYNvkt5+7Le/VEdYt0AkRpkL33MnyQfwr8l5mXwMmfmTbyMPr5vJLC+8/Gd9gXnwU1QQ==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [x64] + os: [linux] + libc: [glibc] + + '@rolldown/binding-linux-x64-musl@1.1.5': + resolution: {integrity: sha512-Me+PfPI2TMeOQk0gYWfLQZtTktrmzbr8cDboqX83XKc7UrgAi55gF+2dUkWdxd19n55Essp2yeca+O9N5rBxHg==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [x64] + os: [linux] + libc: [musl] + + '@rolldown/binding-openharmony-arm64@1.1.5': + resolution: {integrity: sha512-yc5WrLzXks6zCQfn9Oxr8pORKyl/pF+QjHmW/Qx3qu0oyrrNC+y2JLTU1E2rcWYAmzlnqngWXHQjy51VzW70Vw==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [arm64] + os: [openharmony] + + '@rolldown/binding-wasm32-wasi@1.1.5': + resolution: {integrity: sha512-VbQGPX2b4r48TAMIM2cjgluIM1HYutm4pcTEJsle7iEP7sB1dFqtPLBVbdLAZCxy1txCcPxf4QFf4v8uvltPqA==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [wasm32] + + '@rolldown/binding-win32-arm64-msvc@1.1.5': + resolution: {integrity: sha512-gHv82k63z4qpV5+Q1y/12KrK0ltWBukVDI8nZcbT7Tt/ZlOIVwppazneq0F93oDxTo3IgAMEDIoQh3E2n6mVsw==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [arm64] + os: [win32] + + '@rolldown/binding-win32-x64-msvc@1.1.5': + resolution: {integrity: sha512-tTZuDBPw85tEN5PQi1pnEBzDy0Z49HtScLAbD5t6hyeU92A95pRWaSMw1GZZi/RwgSgUIl0xrSlXIT/9QzvYSA==} + engines: {node: ^20.19.0 || >=22.12.0} + cpu: [x64] + os: [win32] + + '@rolldown/pluginutils@1.0.1': + resolution: {integrity: sha512-2j9bGt5Jh8hj+vPtgzPtl72j0yRxHAyumoo6TNfAjsLB04UtpSvPbPcDcBMxz7n+9CYB0c1GxQFxYRg2jimqGw==} + + '@standard-schema/spec@1.1.0': + resolution: {integrity: sha512-l2aFy5jALhniG5HgqrD6jXLi/rUWrKvqN/qJx6yoJsgKhblVd+iqqU4RCXavm/jPityDo5TCvKMnpjKnOriy0w==} + + '@testing-library/dom@10.4.1': + resolution: {integrity: sha512-o4PXJQidqJl82ckFaXUeoAW+XysPLauYI43Abki5hABd853iMhitooc6znOnczgbTYmEP6U6/y1ZyKAIsvMKGg==} + engines: {node: '>=18'} + + '@testing-library/jest-dom@6.9.1': + resolution: {integrity: sha512-zIcONa+hVtVSSep9UT3jZ5rizo2BsxgyDYU7WFD5eICBE7no3881HGeb/QkGfsJs6JTkY1aQhT7rIPC7e+0nnA==} + engines: {node: '>=14', npm: '>=6', yarn: '>=1'} + + '@testing-library/react@16.3.2': + resolution: {integrity: sha512-XU5/SytQM+ykqMnAnvB2umaJNIOsLF3PVv//1Ew4CTcpz0/BRyy/af40qqrt7SjKpDdT1saBMc42CUok5gaw+g==} + engines: {node: '>=18'} + peerDependencies: + '@testing-library/dom': ^10.0.0 + '@types/react': ^18.0.0 || ^19.0.0 + '@types/react-dom': ^18.0.0 || ^19.0.0 + react: ^18.0.0 || ^19.0.0 + react-dom: ^18.0.0 || ^19.0.0 + peerDependenciesMeta: + '@types/react': + optional: true + '@types/react-dom': + optional: true + + '@testing-library/user-event@14.6.1': + resolution: {integrity: sha512-vq7fv0rnt+QTXgPxr5Hjc210p6YKq2kmdziLgnsZGgLJ9e6VAShx1pACLuRjd/AS/sr7phAR58OIIpf0LlmQNw==} + engines: {node: '>=12', npm: '>=6'} + peerDependencies: + '@testing-library/dom': '>=7.21.4' + + '@tybys/wasm-util@0.10.3': + resolution: {integrity: sha512-F3fo1MYrRJYL3zER0OUOmkutjr1Vp23m7OsSgp7nq4SP6OqX6C/56XFIPAl5bt3zaBRjmW7SGz3u/6LwFpYcOg==} + + '@types/aria-query@5.0.4': + resolution: {integrity: sha512-rfT93uj5s0PRL7EzccGMs3brplhcrghnDoV26NqKhCAS1hVo+WdNsPvE/yb6ilfr5hi2MEk6d5EWJTKdxg8jVw==} + + '@types/chai@5.2.3': + resolution: {integrity: sha512-Mw558oeA9fFbv65/y4mHtXDs9bPnFMZAL/jxdPFUpOHHIXX91mcgEHbS5Lahr+pwZFR8A7GQleRWeI6cGFC2UA==} + + '@types/deep-eql@4.0.2': + resolution: {integrity: sha512-c9h9dVVMigMPc4bwTvC5dxqtqJZwQPePsWjPlpSOnojbor6pGqdk541lfA7AqFQr5pB1BRdq0juY9db81BwyFw==} + + '@types/estree@1.0.9': + resolution: {integrity: sha512-GhdPgy1el4/ImP05X05Uw4cw2/M93BCUmnEvWZNStlCzEKME4Fkk+YpoA5OiHNQmoS7Cafb8Xa3Pya8m1Qrzeg==} + + '@types/node@24.10.0': + resolution: {integrity: sha512-qzQZRBqkFsYyaSWXuEHc2WR9c0a0CXwiE5FWUvn7ZM+vdy1uZLfCunD38UzhuB7YN/J11ndbDBcTmOdxJo9Q7A==} + + '@types/react-dom@19.2.3': + resolution: {integrity: sha512-jp2L/eY6fn+KgVVQAOqYItbF0VY/YApe5Mz2F0aykSO8gx31bYCZyvSeYxCHKvzHG5eZjc+zyaS5BrBWya2+kQ==} + peerDependencies: + '@types/react': ^19.2.0 + + '@types/react@19.2.17': + resolution: {integrity: sha512-MXfmqaVPEVgkBT/aY0aGCkRWWtByiYQXo3xdQ8r5RzuFrPiRn8Gar2tQdXSUQ2GKV3bkXckek89V8wQBY2Q/Aw==} + + '@types/whatwg-mimetype@3.0.2': + resolution: {integrity: sha512-c2AKvDT8ToxLIOUlN51gTiHXflsfIFisS4pO7pDPoKouJCESkhZnEy623gwP9laCy5lnLDAw1vAzu2vM2YLOrA==} + + '@types/ws@8.18.1': + resolution: {integrity: sha512-ThVF6DCVhA8kUGy+aazFQ4kXQ7E1Ty7A3ypFOe0IcJV8O/M511G99AW24irKrW56Wt44yG9+ij8FaqoBGkuBXg==} + + '@typescript/typescript-aix-ppc64@7.0.2': + resolution: {integrity: sha512-MTKKkWB7p/0E9xi1d1tHtZ5PiLkGEMIq88pK2CubZjOsLtYTLqhgIgi6zepFa+9GHZ6h05NMCkQxGKiPXMxXtQ==} + engines: {node: '>=16.20.0'} + cpu: [ppc64] + os: [aix] + + '@typescript/typescript-darwin-arm64@7.0.2': + resolution: {integrity: sha512-gowzar9MwS/aRWp6f3a4KUqzRjAZjOsmGNCM6LcTgXum+dBfgsBVMN+AgvOCCbguXyick6LJhpBszxMebJ8syA==} + engines: {node: '>=16.20.0'} + cpu: [arm64] + os: [darwin] + + '@typescript/typescript-darwin-x64@7.0.2': + resolution: {integrity: sha512-SZ9xZInqApNlNGc9s0W1VSsktYSOe9cFqNOIqmN1Gs8SmkjKZYFt017G4VwPxASInODuAdbTW7sXiFUf893RgA==} + engines: {node: '>=16.20.0'} + cpu: [x64] + os: [darwin] + + '@typescript/typescript-freebsd-arm64@7.0.2': + resolution: {integrity: sha512-W5NH4y/J0plIIS5b2xvTEkU7JFxyqdMAOgf+Ilhl0vHQXKO5dZoxd+C/jEtq56c4F3wk71RB4BMRQ2XdI+bwYQ==} + engines: {node: '>=16.20.0'} + cpu: [arm64] + os: [freebsd] + + '@typescript/typescript-freebsd-x64@7.0.2': + resolution: {integrity: sha512-UMGDx5sTpzNw3WiPebH7l90IWfJggEd+egHt/q6p7/Cm3zqoV7VxkGXt+3DxPIw8CcmvAB0j3sVVfbhX+M4Tpw==} + engines: {node: '>=16.20.0'} + cpu: [x64] + os: [freebsd] + + '@typescript/typescript-linux-arm64@7.0.2': + resolution: {integrity: sha512-Qh4eU4/y3yDjnfjjyPYihMj5/ODIlmt+Bzu17OI+fiSRDW57QmU5SiN63exPRNJPKUzcc1INa1NXdrJ+MqHjUQ==} + engines: {node: '>=16.20.0'} + cpu: [arm64] + os: [linux] + + '@typescript/typescript-linux-arm@7.0.2': + resolution: {integrity: sha512-gffT3xPz9sR7j/YJExkyPntrI0P2EP9XbOyWzth2/Gs0RstK+90RBcO0ncXoXy/beYll1SXw846Nf2zdnEz0QQ==} + engines: {node: '>=16.20.0'} + cpu: [arm] + os: [linux] + + '@typescript/typescript-linux-loong64@7.0.2': + resolution: {integrity: sha512-uEHck9i8hoAzXPiYRib1O7miOnz23SxIeVl6F4LXox+qov1K35jHcEW6VHKvZI+pyvl7fZEP4MCU5LYvIq1GuQ==} + engines: {node: '>=16.20.0'} + cpu: [loong64] + os: [linux] + + '@typescript/typescript-linux-mips64el@7.0.2': + resolution: {integrity: sha512-R4KvAMnE43W5Qeqb0Ly56O3mWMWIAgsMyz36DCaycd5nbg/9kzm0liw3JocfRqyJY0KPmzFjbswozXyW0DnIYA==} + engines: {node: '>=16.20.0'} + cpu: [mips64el] + os: [linux] + + '@typescript/typescript-linux-ppc64@7.0.2': + resolution: {integrity: sha512-DORx5b3sd/4S7eayxm4FQv+A7CrkUIGRaHiwI8oiHTAI1fAPWhF4J0vAlkC8biAlHSVVwxMQ3tjZ2/DVbnQiiA==} + engines: {node: '>=16.20.0'} + cpu: [ppc64] + os: [linux] + + '@typescript/typescript-linux-riscv64@7.0.2': + resolution: {integrity: sha512-wf0jqEDOjrPRnKwYRyyJDRo11KMbvMFrU+q4zqKyChODBzvlkbhNQfKvLxQCcwTpdDaXSHZTVuh0JoCrKCUMHQ==} + engines: {node: '>=16.20.0'} + cpu: [riscv64] + os: [linux] + + '@typescript/typescript-linux-s390x@7.0.2': + resolution: {integrity: sha512-IkwJc3L7yhytWd/ewjyxNDfOmswCm9GWMJT/ue/dU4aZNbwZeYAetq42VyLmsmSjvoX7z74X6ZaYCtzAr0EuGw==} + engines: {node: '>=16.20.0'} + cpu: [s390x] + os: [linux] + + '@typescript/typescript-linux-x64@7.0.2': + resolution: {integrity: sha512-EYdf2cNg7rgCWJnxCdJ+F3V39O8ihb37eHAu1LK8oAFizgTQbPOK7zHHXbPt8rX24COqODXeI3sIf0fCXG7H/A==} + engines: {node: '>=16.20.0'} + cpu: [x64] + os: [linux] + + '@typescript/typescript-netbsd-arm64@7.0.2': + resolution: {integrity: sha512-+polYF4MF04aPpO5FTkHran9yUQDSXqy5GiSDKpsll5jy3l3+g9QLhpf39T+ePtefhXLOGrLl0QIjkQP6VnelA==} + engines: {node: '>=16.20.0'} + cpu: [arm64] + os: [netbsd] + + '@typescript/typescript-netbsd-x64@7.0.2': + resolution: {integrity: sha512-8YIT0EHM/3dq10ZOVF/A7pc/YSMtbcecct4rWtexrnSCHOPcpC2KTLXfTCR6vDpnSiY12heNb1GiN/wu+T/FyA==} + engines: {node: '>=16.20.0'} + cpu: [x64] + os: [netbsd] + + '@typescript/typescript-openbsd-arm64@7.0.2': + resolution: {integrity: sha512-APT8+ClYnuYm1u9+kgGXoMj2VzWzcymwh2gNSQVySHfkRDGOTVkoWLjCmOQSaO+PoqQ57B0flRp9SA+7GnnkzQ==} + engines: {node: '>=16.20.0'} + cpu: [arm64] + os: [openbsd] + + '@typescript/typescript-openbsd-x64@7.0.2': + resolution: {integrity: sha512-yX7s+Q0Dln0Dt9tEzZsAjXXR/+ytBM7AlglaqyeMPxQszJ1JhlJdZ6jLA+IzldHtflX81em7lDao1xXu+aRRkg==} + engines: {node: '>=16.20.0'} + cpu: [x64] + os: [openbsd] + + '@typescript/typescript-sunos-x64@7.0.2': + resolution: {integrity: sha512-dLJDGaLZ1D4HPQn62u1n8mBDkJREwMsAkCdkwd4Ieqw+x3TUyTsqY0YiBCtE6H6OzzgGk3iuZ3vFWRS+E8/d1g==} + engines: {node: '>=16.20.0'} + cpu: [x64] + os: [sunos] + + '@typescript/typescript-win32-arm64@7.0.2': + resolution: {integrity: sha512-Gyl1Vy6OsWesLzmq+EP0Fb7b4Nid5232AvcA2SFcdYreldpNtYFFofPjnt62y9hQy7VTaZp65ICJjuAQRaVcIQ==} + engines: {node: '>=16.20.0'} + cpu: [arm64] + os: [win32] + + '@typescript/typescript-win32-x64@7.0.2': + resolution: {integrity: sha512-0BQ3HkAHHlKLSp1qRvf3SUhGpGsDuhB/jgFw75guyqbxJqEaS0Cw/VFO8i2nHglJUzQCRtMMR/IBAKE3ETMC4g==} + engines: {node: '>=16.20.0'} + cpu: [x64] + os: [win32] + + '@vitejs/plugin-react@6.0.3': + resolution: {integrity: sha512-vmFvco5/QuC2f9Oj+wTk0+9XeDFkHxSamwZKYc7MxYwKICfvUvlMhqKI0VuICPltGqh1neqBKDvO4kes1ya8vg==} + engines: {node: ^20.19.0 || >=22.12.0} + peerDependencies: + '@rolldown/plugin-babel': ^0.1.7 || ^0.2.0 + babel-plugin-react-compiler: ^1.0.0 + vite: ^8.0.0 + peerDependenciesMeta: + '@rolldown/plugin-babel': + optional: true + babel-plugin-react-compiler: + optional: true + + '@vitest/expect@4.1.10': + resolution: {integrity: sha512-YsCn+qAk1GWjQOWFEsEcL2gNQ0zmVmQu3T03qP6UyjhtmdtwtbuI+DASn/7iQB3HGTXkdBwGddzxPlmiql5vlA==} + + '@vitest/mocker@4.1.10': + resolution: {integrity: sha512-v0xaezt+DKEmKfaxg133ldzADrwLGd7Ze1MfQQTYfvs8OqZIwbxyxaYURivwV7sWy5fqn3rH5uOrSp07bp44Ow==} + peerDependencies: + msw: ^2.4.9 + vite: ^6.0.0 || ^7.0.0 || ^8.0.0 + peerDependenciesMeta: + msw: + optional: true + vite: + optional: true + + '@vitest/pretty-format@4.1.10': + resolution: {integrity: sha512-W1HsjSH4MXQ9YfmmhLAoIYf1HRfekQCGngeIgcei6MP5QQGWUe0gkopdZQaVCFO+JDJMrAJGwa5pRpNpvy4P8Q==} + + '@vitest/runner@4.1.10': + resolution: {integrity: sha512-IKI6kpIH+LmpROplyLwBBaCfMgOZOMsygVa6BARD6ahA04VRuJSa6OaVG7kRvSEMD870Vd91rSSw0eegtWyLGg==} + + '@vitest/snapshot@4.1.10': + resolution: {integrity: sha512-xRkfOT1qpTAi/Ti4Y1LtfRc3kEuqxGw59eN2jN9pRWMtS/XDevekhcFSqvQqjUNGksfjMJu3Y+oJ+4Ypn2OaJw==} + + '@vitest/spy@4.1.10': + resolution: {integrity: sha512-PLf/Ugvoq5wO/b4rwYCR1h2PSIdXz7wnkQFMiUpLdtM7l6pqVFcQIBEHyT1+l+cj7mNwAfZHzqXqDyjvOuwbDw==} + + '@vitest/utils@4.1.10': + resolution: {integrity: sha512-fy9am/HWxbaGt/Sawrp90vt6Y6jQwf1RX77cz3uwoJwJVMli/e1IEwRPnMNJ7vKfPTwo0diXifkpPvwH9v7nGA==} + + ansi-regex@5.0.1: + resolution: {integrity: sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==} + engines: {node: '>=8'} + + ansi-styles@5.2.0: + resolution: {integrity: sha512-Cxwpt2SfTzTtXcfOlzGEee8O+c+MmUgGrNiBcXnuWxuFJHe6a5Hz7qwhwe5OgaSYI0IJvkLqWX1ASG+cJOkEiA==} + engines: {node: '>=10'} + + aria-query@5.3.0: + resolution: {integrity: sha512-b0P0sZPKtyu8HkeRAfCq0IfURZK+SuwMjY1UXGBU27wpAiTwQAIlq56IbIO+ytk/JjS1fMR14ee5WBBfKi5J6A==} + + assertion-error@2.0.1: + resolution: {integrity: sha512-Izi8RQcffqCeNVgFigKli1ssklIbpHnCYc6AknXGYoB6grJqyeby7jv12JUQgmTAnIDnbck1uxksT4dzN3PWBA==} + engines: {node: '>=12'} + + axe-core@4.12.1: + resolution: {integrity: sha512-s7iGf5GaVMxEG0ENN9x+xTr7GFZCb1ZP/1uATUpCEK2X78nDB3RwbtFCo9pGAf9ru+VwoQ464DkaLEeRM08wJA==} + engines: {node: '>=4'} + + bidi-js@1.0.3: + resolution: {integrity: sha512-RKshQI1R3YQ+n9YJz2QQ147P66ELpa1FQEg20Dk8oW9t2KgLbpDLLp9aGZ7y8WHSshDknG0bknqGw5/tyCs5tw==} + + buffer-image-size@0.6.4: + resolution: {integrity: sha512-nEh+kZOPY1w+gcCMobZ6ETUp9WfibndnosbpwB1iJk/8Gt5ZF2bhS6+B6bPYz424KtwsR6Rflc3tCz1/ghX2dQ==} + engines: {node: '>=4.0'} + + chai@6.2.2: + resolution: {integrity: sha512-NUPRluOfOiTKBKvWPtSD4PhFvWCqOi0BGStNWs57X9js7XGTprSmFoz5F0tWhR4WPjNeR9jXqdC7/UpSJTnlRg==} + engines: {node: '>=18'} + + convert-source-map@2.0.0: + resolution: {integrity: sha512-Kvp459HrV2FEJ1CAsi1Ku+MY3kasH19TFykTz2xWmMeq6bk2NU3XXvfJ+Q61m0xktWwt+1HSYf3JZsTms3aRJg==} + + cookie@1.1.1: + resolution: {integrity: sha512-ei8Aos7ja0weRpFzJnEA9UHJ/7XQmqglbRwnf2ATjcB9Wq874VKH9kfjjirM6UhU2/E5fFYadylyhFldcqSidQ==} + engines: {node: '>=18'} + + crelt@1.0.7: + resolution: {integrity: sha512-aK6BbWfhf4U/wCcLHKPJl/xa6VkVstRaPywWtMKGwuOLc/wZTyQYuoxgvZnNsBvv7Kg3YTBQYYBCggcviQczuA==} + + css-tree@3.2.1: + resolution: {integrity: sha512-X7sjQzceUhu1u7Y/ylrRZFU2FS6LRiFVp6rKLPg23y3x3c3DOKAwuXGDp+PAGjh6CSnCjYeAul8pcT8bAl+lSA==} + engines: {node: ^10 || ^12.20.0 || ^14.13.0 || >=15.0.0} + + css.escape@1.5.1: + resolution: {integrity: sha512-YUifsXXuknHlUsmlgyY0PKzgPOr7/FjCePfHNt0jxm83wHZi44VDMQ7/fGNkjY3/jV1MC+1CmZbaHzugyeRtpg==} + + csstype@3.2.3: + resolution: {integrity: sha512-z1HGKcYy2xA8AGQfwrn0PAy+PB7X/GSj3UVJW9qKyn43xWa+gl5nXmU4qqLMRzWVLFC8KusUX8T/0kCiOYpAIQ==} + + data-urls@7.0.0: + resolution: {integrity: sha512-23XHcCF+coGYevirZceTVD7NdJOqVn+49IHyxgszm+JIiHLoB2TkmPtsYkNWT1pvRSGkc35L6NHs0yHkN2SumA==} + engines: {node: ^20.19.0 || ^22.12.0 || >=24.0.0} + + decimal.js@10.6.0: + resolution: {integrity: sha512-YpgQiITW3JXGntzdUmyUR1V812Hn8T1YVXhCu+wO3OpS4eU9l4YdD3qjyiKdV6mvV29zapkMeD390UVEf2lkUg==} + + dequal@2.0.3: + resolution: {integrity: sha512-0je+qPKHEMohvfRTCEo3CrPG6cAzAYgmzKyxRiYSSDkS6eGJdyVJm7WaYA5ECaAD9wLB2T4EEeymA5aFVcYXCA==} + engines: {node: '>=6'} + + detect-libc@2.1.2: + resolution: {integrity: sha512-Btj2BOOO83o3WyH59e8MgXsxEQVcarkUOpEYrubB0urwnN10yQ364rsiByU11nZlqWYZm05i/of7io4mzihBtQ==} + engines: {node: '>=8'} + + dom-accessibility-api@0.5.16: + resolution: {integrity: sha512-X7BJ2yElsnOJ30pZF4uIIDfBEVgF4XEBxL9Bxhy6dnrm5hkzqmsWHGTiHqRiITNhMyFLyAiWndIJP7Z1NTteDg==} + + dom-accessibility-api@0.6.3: + resolution: {integrity: sha512-7ZgogeTnjuHbo+ct10G9Ffp0mif17idi0IyWNVA/wcwcm7NPOD/WEHVP3n7n3MhXqxoIYm8d6MuZohYWIZ4T3w==} + + entities@7.0.1: + resolution: {integrity: sha512-TWrgLOFUQTH994YUyl1yT4uyavY5nNB5muff+RtWaqNVCAK408b5ZnnbNAUEWLTCpum9w6arT70i1XdQ4UeOPA==} + engines: {node: '>=0.12'} + + entities@8.0.0: + resolution: {integrity: sha512-zwfzJecQ/Uej6tusMqwAqU/6KL2XaB2VZ2Jg54Je6ahNBGNH6Ek6g3jjNCF0fG9EWQKGZNddNjU5F1ZQn/sBnA==} + engines: {node: '>=20.19.0'} + + es-module-lexer@2.3.1: + resolution: {integrity: sha512-shc1dbU90Yl/xq1QrC7QRtfcwURZuVRfPhZbDoldJ1cn1gzDvBaBWlv0eFolj5+0znnPJz5TXLxsN77X/12KTA==} + + esbuild@0.28.1: + resolution: {integrity: sha512-HrJrvZv5ayxBzPfwphOoNzkzOIIlifzk0KJrGK2c8R4+LKpMtpYLQeUdjnwjWv/LZlkH2laZk+4w78pi99D4Vw==} + engines: {node: '>=18'} + hasBin: true + + estree-walker@3.0.3: + resolution: {integrity: sha512-7RUKfXgSMMkzt6ZuXmqapOurLGPPfgj6l9uRZ7lRGolvk0y2yocc35LdcxKC5PQZdn2DMqioAQ2NoWcrTKmm6g==} + + expect-type@1.4.0: + resolution: {integrity: sha512-KfYbmpRm0VbLjEvVa9yGwCi9GI34xvi7A/HXYWQO65CSD2u3MczUJSuwXKFIxlGsgBQizV9q5J9NHj4VG0n+pA==} + engines: {node: '>=12.0.0'} + + fdir@6.5.0: + resolution: {integrity: sha512-tIbYtZbucOs0BRGqPJkshJUYdL+SDH7dVM8gjy+ERp3WAUjLEFJE+02kanyHtwjWOnwrKYBiwAmM0p4kLJAnXg==} + engines: {node: '>=12.0.0'} + peerDependencies: + picomatch: ^3 || ^4 + peerDependenciesMeta: + picomatch: + optional: true + + fsevents@2.3.2: + resolution: {integrity: sha512-xiqMQR4xAeHTuB9uWm+fFRcIOgKBMiOBP+eXiyT7jsgVCq1bkVygt00oASowB7EdtpOHaaPgKt812P9ab+DDKA==} + engines: {node: ^8.16.0 || ^10.6.0 || >=11.0.0} + os: [darwin] + + fsevents@2.3.3: + resolution: {integrity: sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==} + engines: {node: ^8.16.0 || ^10.6.0 || >=11.0.0} + os: [darwin] + + happy-dom@20.10.6: + resolution: {integrity: sha512-6QD0ilzDDt93tX44y8tbmZdAcdTRYDhUP+Asgi6pC8Pp5IA3cvaZGyoVN/EGtlq9ziT65iPuBBn3ASLr6hCgVw==} + engines: {node: '>=20.0.0'} + + html-encoding-sniffer@6.0.0: + resolution: {integrity: sha512-CV9TW3Y3f8/wT0BRFc1/KAVQ3TUHiXmaAb6VW9vtiMFf7SLoMd1PdAc4W3KFOFETBJUb90KatHqlsZMWV+R9Gg==} + engines: {node: ^20.19.0 || ^22.12.0 || >=24.0.0} + + indent-string@4.0.0: + resolution: {integrity: sha512-EdDDZu4A2OyIK7Lr/2zG+w5jmbuk1DVBnEwREQvBzspBJkCEbRa8GxU1lghYcaGJCnRWibjDXlq779X1/y5xwg==} + engines: {node: '>=8'} + + is-potential-custom-element-name@1.0.1: + resolution: {integrity: sha512-bCYeRA2rVibKZd+s2625gGnGF/t7DSqDs4dP7CrLA1m7jKWz6pps0LpYLJN8Q64HtmPKJ1hrN3nzPNKFEKOUiQ==} + + js-tokens@4.0.0: + resolution: {integrity: sha512-RdJUflcE3cUzKiMqQgsCu06FPu9UdIJO0beYbPhHN4k6apgJtifcoCtT9bcxOpYBtpD2kCM6Sbzg4CausW/PKQ==} + + jsdom@29.1.1: + resolution: {integrity: sha512-ECi4Fi2f7BdJtUKTflYRTiaMxIB0O6zfR1fX0GXpUrf6flp8QIYn1UT20YQqdSOfk2dfkCwS8LAFoJDEppNK5Q==} + engines: {node: ^20.19.0 || ^22.13.0 || >=24.0.0} + peerDependencies: + canvas: ^3.0.0 + peerDependenciesMeta: + canvas: + optional: true + + lightningcss-android-arm64@1.32.0: + resolution: {integrity: sha512-YK7/ClTt4kAK0vo6w3X+Pnm0D2cf2vPHbhOXdoNti1Ga0al1P4TBZhwjATvjNwLEBCnKvjJc2jQgHXH0NEwlAg==} + engines: {node: '>= 12.0.0'} + cpu: [arm64] + os: [android] + + lightningcss-darwin-arm64@1.32.0: + resolution: {integrity: sha512-RzeG9Ju5bag2Bv1/lwlVJvBE3q6TtXskdZLLCyfg5pt+HLz9BqlICO7LZM7VHNTTn/5PRhHFBSjk5lc4cmscPQ==} + engines: {node: '>= 12.0.0'} + cpu: [arm64] + os: [darwin] + + lightningcss-darwin-x64@1.32.0: + resolution: {integrity: sha512-U+QsBp2m/s2wqpUYT/6wnlagdZbtZdndSmut/NJqlCcMLTWp5muCrID+K5UJ6jqD2BFshejCYXniPDbNh73V8w==} + engines: {node: '>= 12.0.0'} + cpu: [x64] + os: [darwin] + + lightningcss-freebsd-x64@1.32.0: + resolution: {integrity: sha512-JCTigedEksZk3tHTTthnMdVfGf61Fky8Ji2E4YjUTEQX14xiy/lTzXnu1vwiZe3bYe0q+SpsSH/CTeDXK6WHig==} + engines: {node: '>= 12.0.0'} + cpu: [x64] + os: [freebsd] + + lightningcss-linux-arm-gnueabihf@1.32.0: + resolution: {integrity: sha512-x6rnnpRa2GL0zQOkt6rts3YDPzduLpWvwAF6EMhXFVZXD4tPrBkEFqzGowzCsIWsPjqSK+tyNEODUBXeeVHSkw==} + engines: {node: '>= 12.0.0'} + cpu: [arm] + os: [linux] + + lightningcss-linux-arm64-gnu@1.32.0: + resolution: {integrity: sha512-0nnMyoyOLRJXfbMOilaSRcLH3Jw5z9HDNGfT/gwCPgaDjnx0i8w7vBzFLFR1f6CMLKF8gVbebmkUN3fa/kQJpQ==} + engines: {node: '>= 12.0.0'} + cpu: [arm64] + os: [linux] + libc: [glibc] + + lightningcss-linux-arm64-musl@1.32.0: + resolution: {integrity: sha512-UpQkoenr4UJEzgVIYpI80lDFvRmPVg6oqboNHfoH4CQIfNA+HOrZ7Mo7KZP02dC6LjghPQJeBsvXhJod/wnIBg==} + engines: {node: '>= 12.0.0'} + cpu: [arm64] + os: [linux] + libc: [musl] + + lightningcss-linux-x64-gnu@1.32.0: + resolution: {integrity: sha512-V7Qr52IhZmdKPVr+Vtw8o+WLsQJYCTd8loIfpDaMRWGUZfBOYEJeyJIkqGIDMZPwPx24pUMfwSxxI8phr/MbOA==} + engines: {node: '>= 12.0.0'} + cpu: [x64] + os: [linux] + libc: [glibc] + + lightningcss-linux-x64-musl@1.32.0: + resolution: {integrity: sha512-bYcLp+Vb0awsiXg/80uCRezCYHNg1/l3mt0gzHnWV9XP1W5sKa5/TCdGWaR/zBM2PeF/HbsQv/j2URNOiVuxWg==} + engines: {node: '>= 12.0.0'} + cpu: [x64] + os: [linux] + libc: [musl] + + lightningcss-win32-arm64-msvc@1.32.0: + resolution: {integrity: sha512-8SbC8BR40pS6baCM8sbtYDSwEVQd4JlFTOlaD3gWGHfThTcABnNDBda6eTZeqbofalIJhFx0qKzgHJmcPTnGdw==} + engines: {node: '>= 12.0.0'} + cpu: [arm64] + os: [win32] + + lightningcss-win32-x64-msvc@1.32.0: + resolution: {integrity: sha512-Amq9B/SoZYdDi1kFrojnoqPLxYhQ4Wo5XiL8EVJrVsB8ARoC1PWW6VGtT0WKCemjy8aC+louJnjS7U18x3b06Q==} + engines: {node: '>= 12.0.0'} + cpu: [x64] + os: [win32] + + lightningcss@1.32.0: + resolution: {integrity: sha512-NXYBzinNrblfraPGyrbPoD19C1h9lfI/1mzgWYvXUTe414Gz/X1FD2XBZSZM7rRTrMA8JL3OtAaGifrIKhQ5yQ==} + engines: {node: '>= 12.0.0'} + + lru-cache@11.5.2: + resolution: {integrity: sha512-4pfM1Ff0x50o0tQwb5ucw/RzNyD0/YJME6IVcStalZuMWxdt3sR3huStTtxz4PUmvZfRguvDejasvQ2kifR11g==} + engines: {node: 20 || >=22} + + lucide-react@1.24.0: + resolution: {integrity: sha512-YT6mBD8lGKkg4nM39enlm94/sfJIiW0YKUT60fBy4YK8tai31ylg1VhGNWxkpSKHo9UagfnZqwIff3HTDQwXeA==} + peerDependencies: + react: ^16.5.1 || ^17.0.0 || ^18.0.0 || ^19.0.0 + + lz-string@1.5.0: + resolution: {integrity: sha512-h5bgJWpxJNswbU7qCrV0tIKQCaS3blPDrqKWx+QxzuzL1zGUzij9XCWLrSLsJPu5t+eWA/ycetzYAO5IOMcWAQ==} + hasBin: true + + magic-string@0.30.21: + resolution: {integrity: sha512-vd2F4YUyEXKGcLHoq+TEyCjxueSeHnFxyyjNp80yg0XV4vUhnDer/lvvlqM/arB5bXQN5K2/3oinyCRyx8T2CQ==} + + mdn-data@2.27.1: + resolution: {integrity: sha512-9Yubnt3e8A0OKwxYSXyhLymGW4sCufcLG6VdiDdUGVkPhpqLxlvP5vl1983gQjJl3tqbrM731mjaZaP68AgosQ==} + + min-indent@1.0.1: + resolution: {integrity: sha512-I9jwMn07Sy/IwOj3zVkVik2JTvgpaykDZEigL6Rx6N9LbMywwUSMtxET+7lVoDLLd3O3IXwJwvuuns8UB/HeAg==} + engines: {node: '>=4'} + + nanoid@3.3.16: + resolution: {integrity: sha512-bzlKTyNJ7+LdGIIwy8ijFpIqEQIvafahV7eYykJ8Cvh42EdJeODoJ6gUJXpQJvej1BddH8OqTXZNE/KfbWAu8Q==} + engines: {node: ^10 || ^12 || ^13.7 || ^14 || >=15.0.1} + hasBin: true + + obug@2.1.3: + resolution: {integrity: sha512-9miFgM2OFba7hB+pRgvtV84pYTBaoTHohvmIgiRt6dRIzbwEOIaNaP+dIlGs2fNFoB0SeISs0Jz5WFVRid6Xyg==} + engines: {node: '>=12.20.0'} + + parse5@8.0.1: + resolution: {integrity: sha512-z1e/HMG90obSGeidlli3hj7cbocou0/wa5HacvI3ASx34PecNjNQeaHNo5WIZpWofN9kgkqV1q5YvXe3F0FoPw==} + + pathe@2.0.3: + resolution: {integrity: sha512-WUjGcAqP1gQacoQe+OBJsFA7Ld4DyXuUIjZ5cc75cLHvJ7dtNsTugphxIADwspS+AraAUePCKrSVtPLFj/F88w==} + + picocolors@1.1.1: + resolution: {integrity: sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==} + + picomatch@4.0.5: + resolution: {integrity: sha512-RvwwcruNjI1ncT5xRakeyS9Lf8lcItv34KD+aif+VH9kduAyfYBipGh12274xtenIPZ119/R9BdTBa8gAwSh0A==} + engines: {node: '>=12'} + + playwright-core@1.61.1: + resolution: {integrity: sha512-h7Qlt6m4REp25qvIdvbDtVmD4LqVXfpRxhORv9L0jzETM05p4fuPJ3dKyuSXQxDSbXnmS79HAgi9589lGSpLkg==} + engines: {node: '>=18'} + hasBin: true + + playwright@1.61.1: + resolution: {integrity: sha512-DWnY5o3YbLWK4GovuAVwpqL+1VwGNdUGrRr++8j8PtQQzvAVZUIMjKQ90fY689sEJZJBbZVw1rXaOKSTitkzPQ==} + engines: {node: '>=18'} + hasBin: true + + postcss@8.5.19: + resolution: {integrity: sha512-Mz8SaolMd8nB+G13WkORcxQKHZ/NE4xXevtkJHVuG+guo9/wYKlIMTKAqGdEmYOXR2ijPjTYNHssizdaVSUNdQ==} + engines: {node: ^10 || ^12 || >=14} + + pretty-format@27.5.1: + resolution: {integrity: sha512-Qb1gy5OrP5+zDf2Bvnzdl3jsTf1qXVMazbvCoKhtKqVs4/YK4ozX4gKQJJVyNe+cajNPn0KoC0MC3FUmaHWEmQ==} + engines: {node: ^10.13.0 || ^12.13.0 || ^14.15.0 || >=15.0.0} + + punycode@2.3.1: + resolution: {integrity: sha512-vYt7UD1U9Wg6138shLtLOvdAu+8DsC/ilFtEVHcH+wydcSpNE20AfSOduf6MkRFahL5FY7X1oU7nKVZFtfq8Fg==} + engines: {node: '>=6'} + + react-dom@19.2.7: + resolution: {integrity: sha512-t0BRVXvbiE/o20Hfw669rLbMCDWtYZLvmJigy2f0MxsXF+71pxhR3xOkspmsO8h3ZlNzyibAmtCa3l4lYKk6gQ==} + peerDependencies: + react: ^19.2.7 + + react-is@17.0.2: + resolution: {integrity: sha512-w2GsyukL62IJnlaff/nRegPQR94C/XXamvMWmSHRJ4y7Ts/4ocGRmTHvOs8PSE6pB3dWOrD/nueuU5sduBsQ4w==} + + react-router-dom@7.18.1: + resolution: {integrity: sha512-KaZh+X/6UtEp28x51AUYZDMg9NGoz2ja3dNHa+ta/tk40vCzKhQ/RypCWBMLbmDr6//E24Vv5uPsrqXFozdkAg==} + engines: {node: '>=20.0.0'} + peerDependencies: + react: '>=18' + react-dom: '>=18' + + react-router@7.18.1: + resolution: {integrity: sha512-GDLgg3i3uM0aeJO3Fm+TCS+sDQ7gu12T6x0qdTEzcwqEfleci7JwugVNIF3U//0FWKnJT7ptG+20B2jfDqnZAg==} + engines: {node: '>=20.0.0'} + peerDependencies: + react: '>=18' + react-dom: '>=18' + peerDependenciesMeta: + react-dom: + optional: true + + react@19.2.7: + resolution: {integrity: sha512-HNe9WslTbXmFK8o8cmwgAeJFSBvt1bPdHCVKtaaV+WlAN36mpT4hcRpwbf3fY56ar2oIXzsBpOAiIRHAdY0OlQ==} + engines: {node: '>=0.10.0'} + + redent@3.0.0: + resolution: {integrity: sha512-6tDA8g98We0zd0GvVeMT9arEOnTw9qM03L9cJXaCjrip1OO764RDBLBfrB4cwzNGDj5OA5ioymC9GkizgWJDUg==} + engines: {node: '>=8'} + + require-from-string@2.0.2: + resolution: {integrity: sha512-Xf0nWe6RseziFMu+Ap9biiUbmplq6S9/p+7w7YXP/JBHhrUDDUhwa+vANyubuqfZWTveU//DYVGsDG7RKL/vEw==} + engines: {node: '>=0.10.0'} + + rolldown@1.1.5: + resolution: {integrity: sha512-t9z29cJjXf/vxQ8dyhCSpt6H6aSwHTk8cT5I3iy6SMXuFpk5mB6PL6XfC8PCwrPTx93udwKUm9HRteAlTGBLiA==} + engines: {node: ^20.19.0 || >=22.12.0} + hasBin: true + + saxes@6.0.0: + resolution: {integrity: sha512-xAg7SOnEhrm5zI3puOOKyy1OMcMlIJZYNJY7xLBwSze0UjhPLnWfj2GF2EpT0jmzaJKIWKHLsaSSajf35bcYnA==} + engines: {node: '>=v12.22.7'} + + scheduler@0.27.0: + resolution: {integrity: sha512-eNv+WrVbKu1f3vbYJT/xtiF5syA5HPIMtf9IgY/nKg0sWqzAUEvqY/xm7OcZc/qafLx/iO9FgOmeSAp4v5ti/Q==} + + set-cookie-parser@2.7.2: + resolution: {integrity: sha512-oeM1lpU/UvhTxw+g3cIfxXHyJRc/uidd3yK1P242gzHds0udQBYzs3y8j4gCCW+ZJ7ad0yctld8RYO+bdurlvw==} + + siginfo@2.0.0: + resolution: {integrity: sha512-ybx0WO1/8bSBLEWXZvEd7gMW3Sn3JFlW3TvX1nREbDLRNQNaeNN8WK0meBwPdAaOI7TtRRRJn/Es1zhrrCHu7g==} + + source-map-js@1.2.1: + resolution: {integrity: sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA==} + engines: {node: '>=0.10.0'} + + stackback@0.0.2: + resolution: {integrity: sha512-1XMJE5fQo1jGH6Y/7ebnwPOBEkIEnT4QF32d5R1+VXdXveM0IBMJt8zfaxX1P3QhVwrYe+576+jkANtSS2mBbw==} + + std-env@4.2.0: + resolution: {integrity: sha512-oCUKSupKTHX53EyjDtuZQ64pjLJ6yYCtpmEw0goYxtjG9KpbRe8KAsl2tBUGU9DyMcJ0RwJ8GqJAFzMXcXW1Rw==} + + strip-indent@3.0.0: + resolution: {integrity: sha512-laJTa3Jb+VQpaC6DseHhF7dXVqHTfJPCRDaEbid/drOhgitgYku/letMUqOXFoWV0zIIUbjpdH2t+tYj4bQMRQ==} + engines: {node: '>=8'} + + style-mod@4.1.3: + resolution: {integrity: sha512-i/n8VsZydrugj3Iuzll8+x/00GH2vnYsk1eomD8QiRrSAeW6ItbCQDtfXCeJHd0iwiNagqjQkvpvREEPtW3IoQ==} + + symbol-tree@3.2.4: + resolution: {integrity: sha512-9QNk5KwDF+Bvz+PyObkmSYjI5ksVUYtjW7AU22r2NKcfLJcXp96hkDWU3+XndOsUb+AQ9QhfzfCT2O+CNWT5Tw==} + + tinybench@2.9.0: + resolution: {integrity: sha512-0+DUvqWMValLmha6lr4kD8iAMK1HzV0/aKnCtWb9v9641TnP/MFb7Pc2bxoxQjTXAErryXVgUOfv2YqNllqGeg==} + + tinyexec@1.2.4: + resolution: {integrity: sha512-SHf/r48b7vOrjve9PxJo3MN5v5yuyjHvdUcrQffT3WXMUfnGmHDVbC4k3sHJaJTgZCwpUplIaAo5ANtMyp3YHg==} + engines: {node: '>=18'} + + tinyglobby@0.2.17: + resolution: {integrity: sha512-wXR/dYpcqKmfWpEdZjiKJOwCNFndD0DMnrW/cYjVGttEkBfVgcLFHoNrlj47mjOVic9yyNu65alsgF4NQyTa2g==} + engines: {node: '>=12.0.0'} + + tinyrainbow@3.1.0: + resolution: {integrity: sha512-Bf+ILmBgretUrdJxzXM0SgXLZ3XfiaUuOj/IKQHuTXip+05Xn+uyEYdVg0kYDipTBcLrCVyUzAPz7QmArb0mmw==} + engines: {node: '>=14.0.0'} + + tldts-core@7.4.8: + resolution: {integrity: sha512-c1P7u0EhACHj7lPy4MJm8iTFEU8+nB0LCtddH0fhP7noaVoXAqafMtOOeX+ulpuPBqnrRgRhw494RICT3mbhnw==} + + tldts@7.4.8: + resolution: {integrity: sha512-htwgN/8KRB3z3vnC0BOETVh2m499g5GmyTK9Wq5JBLX3FNz6tSBveAd+fQhzy9hkjif8vy2jwDMR1sGhLtZl2A==} + hasBin: true + + tough-cookie@6.0.2: + resolution: {integrity: sha512-exgYmnmL/sJpR3upZfXG5PoatXQii55xAiXGXzY+sROLZ/Y+SLcp9PgJNI9Vz37HpQ74WvDcLT8eqm+kV3FzrA==} + engines: {node: '>=16'} + + tr46@6.0.0: + resolution: {integrity: sha512-bLVMLPtstlZ4iMQHpFHTR7GAGj2jxi8Dg0s2h2MafAE4uSWF98FC/3MomU51iQAMf8/qDUbKWf5GxuvvVcXEhw==} + engines: {node: '>=20'} + + tslib@2.8.1: + resolution: {integrity: sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w==} + + typescript@7.0.2: + resolution: {integrity: sha512-8FYau96o3NKOhbjKi/qNvG/W5jhzxkbdm5sj9AbZ/5T5sWqn3hJgLfGx27sRKZWTvyzCP8dLRBTf5tBTSRVUNA==} + engines: {node: '>=16.20.0'} + hasBin: true + + undici-types@7.16.0: + resolution: {integrity: sha512-Zz+aZWSj8LE6zoxD+xrjh4VfkIG8Ya6LvYkZqtUQGJPZjYl53ypCaUwWqo7eI0x66KBGeRo+mlBEkMSeSZ38Nw==} + + undici@7.28.0: + resolution: {integrity: sha512-cRZYrTDwWznlnRiPjggAGxZXanty6M8RV1ff8Wm4LWXBp7/IG8v5DnOm74DtUBp9OONpK75YlPnIjQqX0dBDtA==} + engines: {node: '>=20.18.1'} + + vite@8.1.4: + resolution: {integrity: sha512-bTT9PsdWO+MQMNG9ZXIP/qM9wGh37DFxTV/sPq9cFpHr3w4jkgef032PkAL9jAqhk3Nz8NQw3O8n6/xFkqO4QQ==} + engines: {node: ^20.19.0 || >=22.12.0} + hasBin: true + peerDependencies: + '@types/node': ^20.19.0 || >=22.12.0 + '@vitejs/devtools': ^0.3.0 + esbuild: ^0.27.0 || ^0.28.0 + jiti: '>=1.21.0' + less: ^4.0.0 + sass: ^1.70.0 + sass-embedded: ^1.70.0 + stylus: '>=0.54.8' + sugarss: ^5.0.0 + terser: ^5.16.0 + tsx: ^4.8.1 + yaml: ^2.4.2 + peerDependenciesMeta: + '@types/node': + optional: true + '@vitejs/devtools': + optional: true + esbuild: + optional: true + jiti: + optional: true + less: + optional: true + sass: + optional: true + sass-embedded: + optional: true + stylus: + optional: true + sugarss: + optional: true + terser: + optional: true + tsx: + optional: true + yaml: + optional: true + + vitest@4.1.10: + resolution: {integrity: sha512-R9jUTe5S4Qb0HCd4TNqpC7oGcrMssMRGXLW80ubjWsW9VH5GF8y1Y0SFLY9AbqSk6nt0PnOx4H4WNJYZ13GUPw==} + engines: {node: ^20.0.0 || ^22.0.0 || >=24.0.0} + hasBin: true + peerDependencies: + '@edge-runtime/vm': '*' + '@opentelemetry/api': ^1.9.0 + '@types/node': ^20.0.0 || ^22.0.0 || >=24.0.0 + '@vitest/browser-playwright': 4.1.10 + '@vitest/browser-preview': 4.1.10 + '@vitest/browser-webdriverio': 4.1.10 + '@vitest/coverage-istanbul': 4.1.10 + '@vitest/coverage-v8': 4.1.10 + '@vitest/ui': 4.1.10 + happy-dom: '*' + jsdom: '*' + vite: ^6.0.0 || ^7.0.0 || ^8.0.0 + peerDependenciesMeta: + '@edge-runtime/vm': + optional: true + '@opentelemetry/api': + optional: true + '@types/node': + optional: true + '@vitest/browser-playwright': + optional: true + '@vitest/browser-preview': + optional: true + '@vitest/browser-webdriverio': + optional: true + '@vitest/coverage-istanbul': + optional: true + '@vitest/coverage-v8': + optional: true + '@vitest/ui': + optional: true + happy-dom: + optional: true + jsdom: + optional: true + + w3c-keyname@2.2.8: + resolution: {integrity: sha512-dpojBhNsCNN7T82Tm7k26A6G9ML3NkhDsnw9n/eoxSRlVBB4CEtIQ/KTCLI2Fwf3ataSXRhYFkQi3SlnFwPvPQ==} + + w3c-xmlserializer@5.0.0: + resolution: {integrity: sha512-o8qghlI8NZHU1lLPrpi2+Uq7abh4GGPpYANlalzWxyWteJOCsr/P+oPBA49TOLu5FTZO4d3F9MnWJfiMo4BkmA==} + engines: {node: '>=18'} + + webidl-conversions@8.0.1: + resolution: {integrity: sha512-BMhLD/Sw+GbJC21C/UgyaZX41nPt8bUTg+jWyDeg7e7YN4xOM05YPSIXceACnXVtqyEw/LMClUQMtMZ+PGGpqQ==} + engines: {node: '>=20'} + + whatwg-mimetype@3.0.0: + resolution: {integrity: sha512-nt+N2dzIutVRxARx1nghPKGv1xHikU7HKdfafKkLNLindmPU/ch3U31NOCGGA/dmPcmb1VlofO0vnKAcsm0o/Q==} + engines: {node: '>=12'} + + whatwg-mimetype@5.0.0: + resolution: {integrity: sha512-sXcNcHOC51uPGF0P/D4NVtrkjSU2fNsm9iog4ZvZJsL3rjoDAzXZhkm2MWt1y+PUdggKAYVoMAIYcs78wJ51Cw==} + engines: {node: '>=20'} + + whatwg-url@16.0.1: + resolution: {integrity: sha512-1to4zXBxmXHV3IiSSEInrreIlu02vUOvrhxJJH5vcxYTBDAx51cqZiKdyTxlecdKNSjj8EcxGBxNf6Vg+945gw==} + engines: {node: ^20.19.0 || ^22.12.0 || >=24.0.0} + + why-is-node-running@2.3.0: + resolution: {integrity: sha512-hUrmaWBdVDcxvYqnyh09zunKzROWjbZTiNy8dBEjkS7ehEDQibXJ7XvlmtbwuTclUiIyN+CyXQD4Vmko8fNm8w==} + engines: {node: '>=8'} + hasBin: true + + ws@8.21.1: + resolution: {integrity: sha512-+0NTnW77fFN/DjQi6k/Sq/Yvk4Sgajw7urW8V+asjXnRgDs9gyGkdb7EzgfhA4goXsRIZKE28fzIXBHEzhuiWw==} + engines: {node: '>=10.0.0'} + peerDependencies: + bufferutil: ^4.0.1 + utf-8-validate: '>=5.0.2' + peerDependenciesMeta: + bufferutil: + optional: true + utf-8-validate: + optional: true + + xml-name-validator@5.0.0: + resolution: {integrity: sha512-EvGK8EJ3DhaHfbRlETOWAS5pO9MZITeauHKJyb8wyajUfQUenkIg2MvLDTZ4T/TgIcm3HU0TFBgWWboAZ30UHg==} + engines: {node: '>=18'} + + xmlchars@2.2.0: + resolution: {integrity: sha512-JZnDKK8B0RCDw84FNdDAIpZK+JuJw+s7Lz8nksI7SIuU3UXJJslUthsi+uWBUYOwPFwW7W7PRLRfUKpxjtjFCw==} + +snapshots: + + '@adobe/css-tools@4.5.0': {} + + '@asamuzakjp/css-color@5.1.11': + dependencies: + '@asamuzakjp/generational-cache': 1.0.1 + '@csstools/css-calc': 3.2.1(@csstools/css-parser-algorithms@4.0.0(@csstools/css-tokenizer@4.0.0))(@csstools/css-tokenizer@4.0.0) + '@csstools/css-color-parser': 4.1.9(@csstools/css-parser-algorithms@4.0.0(@csstools/css-tokenizer@4.0.0))(@csstools/css-tokenizer@4.0.0) + '@csstools/css-parser-algorithms': 4.0.0(@csstools/css-tokenizer@4.0.0) + '@csstools/css-tokenizer': 4.0.0 + optional: true + + '@asamuzakjp/dom-selector@7.1.1': + dependencies: + '@asamuzakjp/generational-cache': 1.0.1 + '@asamuzakjp/nwsapi': 2.3.9 + bidi-js: 1.0.3 + css-tree: 3.2.1 + is-potential-custom-element-name: 1.0.1 + optional: true + + '@asamuzakjp/generational-cache@1.0.1': + optional: true + + '@asamuzakjp/nwsapi@2.3.9': + optional: true + + '@axe-core/playwright@4.12.1(playwright-core@1.61.1)': + dependencies: + axe-core: 4.12.1 + playwright-core: 1.61.1 + + '@babel/code-frame@7.29.7': + dependencies: + '@babel/helper-validator-identifier': 7.29.7 + js-tokens: 4.0.0 + picocolors: 1.1.1 + + '@babel/helper-validator-identifier@7.29.7': {} + + '@babel/runtime@7.29.7': {} + + '@bramus/specificity@2.4.2': + dependencies: + css-tree: 3.2.1 + optional: true + + '@codemirror/commands@6.10.4': + dependencies: + '@codemirror/language': 6.12.4 + '@codemirror/state': 6.7.1 + '@codemirror/view': 6.43.6 + '@lezer/common': 1.5.2 + + '@codemirror/lang-json@6.0.2': + dependencies: + '@codemirror/language': 6.12.4 + '@lezer/json': 1.0.3 + + '@codemirror/language@6.12.4': + dependencies: + '@codemirror/state': 6.7.1 + '@codemirror/view': 6.43.6 + '@lezer/common': 1.5.2 + '@lezer/highlight': 1.2.3 + '@lezer/lr': 1.4.10 + style-mod: 4.1.3 + + '@codemirror/state@6.7.1': + dependencies: + '@marijn/find-cluster-break': 1.0.3 + + '@codemirror/view@6.43.6': + dependencies: + '@codemirror/state': 6.7.1 + crelt: 1.0.7 + style-mod: 4.1.3 + w3c-keyname: 2.2.8 + + '@csstools/color-helpers@6.1.0': + optional: true + + '@csstools/css-calc@3.2.1(@csstools/css-parser-algorithms@4.0.0(@csstools/css-tokenizer@4.0.0))(@csstools/css-tokenizer@4.0.0)': + dependencies: + '@csstools/css-parser-algorithms': 4.0.0(@csstools/css-tokenizer@4.0.0) + '@csstools/css-tokenizer': 4.0.0 + optional: true + + '@csstools/css-color-parser@4.1.9(@csstools/css-parser-algorithms@4.0.0(@csstools/css-tokenizer@4.0.0))(@csstools/css-tokenizer@4.0.0)': + dependencies: + '@csstools/color-helpers': 6.1.0 + '@csstools/css-calc': 3.2.1(@csstools/css-parser-algorithms@4.0.0(@csstools/css-tokenizer@4.0.0))(@csstools/css-tokenizer@4.0.0) + '@csstools/css-parser-algorithms': 4.0.0(@csstools/css-tokenizer@4.0.0) + '@csstools/css-tokenizer': 4.0.0 + optional: true + + '@csstools/css-parser-algorithms@4.0.0(@csstools/css-tokenizer@4.0.0)': + dependencies: + '@csstools/css-tokenizer': 4.0.0 + optional: true + + '@csstools/css-syntax-patches-for-csstree@1.1.6(css-tree@3.2.1)': + optionalDependencies: + css-tree: 3.2.1 + optional: true + + '@csstools/css-tokenizer@4.0.0': + optional: true + + '@emnapi/core@1.11.1': + dependencies: + '@emnapi/wasi-threads': 1.2.2 + tslib: 2.8.1 + optional: true + + '@emnapi/runtime@1.11.1': + dependencies: + tslib: 2.8.1 + optional: true + + '@emnapi/wasi-threads@1.2.2': + dependencies: + tslib: 2.8.1 + optional: true + + '@esbuild/aix-ppc64@0.28.1': + optional: true + + '@esbuild/android-arm64@0.28.1': + optional: true + + '@esbuild/android-arm@0.28.1': + optional: true + + '@esbuild/android-x64@0.28.1': + optional: true + + '@esbuild/darwin-arm64@0.28.1': + optional: true + + '@esbuild/darwin-x64@0.28.1': + optional: true + + '@esbuild/freebsd-arm64@0.28.1': + optional: true + + '@esbuild/freebsd-x64@0.28.1': + optional: true + + '@esbuild/linux-arm64@0.28.1': + optional: true + + '@esbuild/linux-arm@0.28.1': + optional: true + + '@esbuild/linux-ia32@0.28.1': + optional: true + + '@esbuild/linux-loong64@0.28.1': + optional: true + + '@esbuild/linux-mips64el@0.28.1': + optional: true + + '@esbuild/linux-ppc64@0.28.1': + optional: true + + '@esbuild/linux-riscv64@0.28.1': + optional: true + + '@esbuild/linux-s390x@0.28.1': + optional: true + + '@esbuild/linux-x64@0.28.1': + optional: true + + '@esbuild/netbsd-arm64@0.28.1': + optional: true + + '@esbuild/netbsd-x64@0.28.1': + optional: true + + '@esbuild/openbsd-arm64@0.28.1': + optional: true + + '@esbuild/openbsd-x64@0.28.1': + optional: true + + '@esbuild/openharmony-arm64@0.28.1': + optional: true + + '@esbuild/sunos-x64@0.28.1': + optional: true + + '@esbuild/win32-arm64@0.28.1': + optional: true + + '@esbuild/win32-ia32@0.28.1': + optional: true + + '@esbuild/win32-x64@0.28.1': + optional: true + + '@exodus/bytes@1.15.1': + optional: true + + '@jridgewell/sourcemap-codec@1.5.5': {} + + '@lezer/common@1.5.2': {} + + '@lezer/highlight@1.2.3': + dependencies: + '@lezer/common': 1.5.2 + + '@lezer/json@1.0.3': + dependencies: + '@lezer/common': 1.5.2 + '@lezer/highlight': 1.2.3 + '@lezer/lr': 1.4.10 + + '@lezer/lr@1.4.10': + dependencies: + '@lezer/common': 1.5.2 + + '@marijn/find-cluster-break@1.0.3': {} + + '@napi-rs/wasm-runtime@1.1.6(@emnapi/core@1.11.1)(@emnapi/runtime@1.11.1)': + dependencies: + '@emnapi/core': 1.11.1 + '@emnapi/runtime': 1.11.1 + '@tybys/wasm-util': 0.10.3 + optional: true + + '@oxc-project/types@0.139.0': {} + + '@playwright/test@1.61.1': + dependencies: + playwright: 1.61.1 + + '@rolldown/binding-android-arm64@1.1.5': + optional: true + + '@rolldown/binding-darwin-arm64@1.1.5': + optional: true + + '@rolldown/binding-darwin-x64@1.1.5': + optional: true + + '@rolldown/binding-freebsd-x64@1.1.5': + optional: true + + '@rolldown/binding-linux-arm-gnueabihf@1.1.5': + optional: true + + '@rolldown/binding-linux-arm64-gnu@1.1.5': + optional: true + + '@rolldown/binding-linux-arm64-musl@1.1.5': + optional: true + + '@rolldown/binding-linux-ppc64-gnu@1.1.5': + optional: true + + '@rolldown/binding-linux-s390x-gnu@1.1.5': + optional: true + + '@rolldown/binding-linux-x64-gnu@1.1.5': + optional: true + + '@rolldown/binding-linux-x64-musl@1.1.5': + optional: true + + '@rolldown/binding-openharmony-arm64@1.1.5': + optional: true + + '@rolldown/binding-wasm32-wasi@1.1.5': + dependencies: + '@emnapi/core': 1.11.1 + '@emnapi/runtime': 1.11.1 + '@napi-rs/wasm-runtime': 1.1.6(@emnapi/core@1.11.1)(@emnapi/runtime@1.11.1) + optional: true + + '@rolldown/binding-win32-arm64-msvc@1.1.5': + optional: true + + '@rolldown/binding-win32-x64-msvc@1.1.5': + optional: true + + '@rolldown/pluginutils@1.0.1': {} + + '@standard-schema/spec@1.1.0': {} + + '@testing-library/dom@10.4.1': + dependencies: + '@babel/code-frame': 7.29.7 + '@babel/runtime': 7.29.7 + '@types/aria-query': 5.0.4 + aria-query: 5.3.0 + dom-accessibility-api: 0.5.16 + lz-string: 1.5.0 + picocolors: 1.1.1 + pretty-format: 27.5.1 + + '@testing-library/jest-dom@6.9.1': + dependencies: + '@adobe/css-tools': 4.5.0 + aria-query: 5.3.0 + css.escape: 1.5.1 + dom-accessibility-api: 0.6.3 + picocolors: 1.1.1 + redent: 3.0.0 + + '@testing-library/react@16.3.2(@testing-library/dom@10.4.1)(@types/react-dom@19.2.3(@types/react@19.2.17))(@types/react@19.2.17)(react-dom@19.2.7(react@19.2.7))(react@19.2.7)': + dependencies: + '@babel/runtime': 7.29.7 + '@testing-library/dom': 10.4.1 + react: 19.2.7 + react-dom: 19.2.7(react@19.2.7) + optionalDependencies: + '@types/react': 19.2.17 + '@types/react-dom': 19.2.3(@types/react@19.2.17) + + '@testing-library/user-event@14.6.1(@testing-library/dom@10.4.1)': + dependencies: + '@testing-library/dom': 10.4.1 + + '@tybys/wasm-util@0.10.3': + dependencies: + tslib: 2.8.1 + optional: true + + '@types/aria-query@5.0.4': {} + + '@types/chai@5.2.3': + dependencies: + '@types/deep-eql': 4.0.2 + assertion-error: 2.0.1 + + '@types/deep-eql@4.0.2': {} + + '@types/estree@1.0.9': {} + + '@types/node@24.10.0': + dependencies: + undici-types: 7.16.0 + + '@types/react-dom@19.2.3(@types/react@19.2.17)': + dependencies: + '@types/react': 19.2.17 + + '@types/react@19.2.17': + dependencies: + csstype: 3.2.3 + + '@types/whatwg-mimetype@3.0.2': {} + + '@types/ws@8.18.1': + dependencies: + '@types/node': 24.10.0 + + '@typescript/typescript-aix-ppc64@7.0.2': + optional: true + + '@typescript/typescript-darwin-arm64@7.0.2': + optional: true + + '@typescript/typescript-darwin-x64@7.0.2': + optional: true + + '@typescript/typescript-freebsd-arm64@7.0.2': + optional: true + + '@typescript/typescript-freebsd-x64@7.0.2': + optional: true + + '@typescript/typescript-linux-arm64@7.0.2': + optional: true + + '@typescript/typescript-linux-arm@7.0.2': + optional: true + + '@typescript/typescript-linux-loong64@7.0.2': + optional: true + + '@typescript/typescript-linux-mips64el@7.0.2': + optional: true + + '@typescript/typescript-linux-ppc64@7.0.2': + optional: true + + '@typescript/typescript-linux-riscv64@7.0.2': + optional: true + + '@typescript/typescript-linux-s390x@7.0.2': + optional: true + + '@typescript/typescript-linux-x64@7.0.2': + optional: true + + '@typescript/typescript-netbsd-arm64@7.0.2': + optional: true + + '@typescript/typescript-netbsd-x64@7.0.2': + optional: true + + '@typescript/typescript-openbsd-arm64@7.0.2': + optional: true + + '@typescript/typescript-openbsd-x64@7.0.2': + optional: true + + '@typescript/typescript-sunos-x64@7.0.2': + optional: true + + '@typescript/typescript-win32-arm64@7.0.2': + optional: true + + '@typescript/typescript-win32-x64@7.0.2': + optional: true + + '@vitejs/plugin-react@6.0.3(vite@8.1.4(@types/node@24.10.0)(esbuild@0.28.1))': + dependencies: + '@rolldown/pluginutils': 1.0.1 + vite: 8.1.4(@types/node@24.10.0)(esbuild@0.28.1) + + '@vitest/expect@4.1.10': + dependencies: + '@standard-schema/spec': 1.1.0 + '@types/chai': 5.2.3 + '@vitest/spy': 4.1.10 + '@vitest/utils': 4.1.10 + chai: 6.2.2 + tinyrainbow: 3.1.0 + + '@vitest/mocker@4.1.10(vite@8.1.4(@types/node@24.10.0)(esbuild@0.28.1))': + dependencies: + '@vitest/spy': 4.1.10 + estree-walker: 3.0.3 + magic-string: 0.30.21 + optionalDependencies: + vite: 8.1.4(@types/node@24.10.0)(esbuild@0.28.1) + + '@vitest/pretty-format@4.1.10': + dependencies: + tinyrainbow: 3.1.0 + + '@vitest/runner@4.1.10': + dependencies: + '@vitest/utils': 4.1.10 + pathe: 2.0.3 + + '@vitest/snapshot@4.1.10': + dependencies: + '@vitest/pretty-format': 4.1.10 + '@vitest/utils': 4.1.10 + magic-string: 0.30.21 + pathe: 2.0.3 + + '@vitest/spy@4.1.10': {} + + '@vitest/utils@4.1.10': + dependencies: + '@vitest/pretty-format': 4.1.10 + convert-source-map: 2.0.0 + tinyrainbow: 3.1.0 + + ansi-regex@5.0.1: {} + + ansi-styles@5.2.0: {} + + aria-query@5.3.0: + dependencies: + dequal: 2.0.3 + + assertion-error@2.0.1: {} + + axe-core@4.12.1: {} + + bidi-js@1.0.3: + dependencies: + require-from-string: 2.0.2 + optional: true + + buffer-image-size@0.6.4: + dependencies: + '@types/node': 24.10.0 + + chai@6.2.2: {} + + convert-source-map@2.0.0: {} + + cookie@1.1.1: {} + + crelt@1.0.7: {} + + css-tree@3.2.1: + dependencies: + mdn-data: 2.27.1 + source-map-js: 1.2.1 + optional: true + + css.escape@1.5.1: {} + + csstype@3.2.3: {} + + data-urls@7.0.0: + dependencies: + whatwg-mimetype: 5.0.0 + whatwg-url: 16.0.1 + transitivePeerDependencies: + - '@noble/hashes' + optional: true + + decimal.js@10.6.0: + optional: true + + dequal@2.0.3: {} + + detect-libc@2.1.2: {} + + dom-accessibility-api@0.5.16: {} + + dom-accessibility-api@0.6.3: {} + + entities@7.0.1: {} + + entities@8.0.0: + optional: true + + es-module-lexer@2.3.1: {} + + esbuild@0.28.1: + optionalDependencies: + '@esbuild/aix-ppc64': 0.28.1 + '@esbuild/android-arm': 0.28.1 + '@esbuild/android-arm64': 0.28.1 + '@esbuild/android-x64': 0.28.1 + '@esbuild/darwin-arm64': 0.28.1 + '@esbuild/darwin-x64': 0.28.1 + '@esbuild/freebsd-arm64': 0.28.1 + '@esbuild/freebsd-x64': 0.28.1 + '@esbuild/linux-arm': 0.28.1 + '@esbuild/linux-arm64': 0.28.1 + '@esbuild/linux-ia32': 0.28.1 + '@esbuild/linux-loong64': 0.28.1 + '@esbuild/linux-mips64el': 0.28.1 + '@esbuild/linux-ppc64': 0.28.1 + '@esbuild/linux-riscv64': 0.28.1 + '@esbuild/linux-s390x': 0.28.1 + '@esbuild/linux-x64': 0.28.1 + '@esbuild/netbsd-arm64': 0.28.1 + '@esbuild/netbsd-x64': 0.28.1 + '@esbuild/openbsd-arm64': 0.28.1 + '@esbuild/openbsd-x64': 0.28.1 + '@esbuild/openharmony-arm64': 0.28.1 + '@esbuild/sunos-x64': 0.28.1 + '@esbuild/win32-arm64': 0.28.1 + '@esbuild/win32-ia32': 0.28.1 + '@esbuild/win32-x64': 0.28.1 + optional: true + + estree-walker@3.0.3: + dependencies: + '@types/estree': 1.0.9 + + expect-type@1.4.0: {} + + fdir@6.5.0(picomatch@4.0.5): + optionalDependencies: + picomatch: 4.0.5 + + fsevents@2.3.2: + optional: true + + fsevents@2.3.3: + optional: true + + happy-dom@20.10.6: + dependencies: + '@types/node': 24.10.0 + '@types/whatwg-mimetype': 3.0.2 + '@types/ws': 8.18.1 + buffer-image-size: 0.6.4 + entities: 7.0.1 + whatwg-mimetype: 3.0.0 + ws: 8.21.1 + transitivePeerDependencies: + - bufferutil + - utf-8-validate + + html-encoding-sniffer@6.0.0: + dependencies: + '@exodus/bytes': 1.15.1 + transitivePeerDependencies: + - '@noble/hashes' + optional: true + + indent-string@4.0.0: {} + + is-potential-custom-element-name@1.0.1: + optional: true + + js-tokens@4.0.0: {} + + jsdom@29.1.1: + dependencies: + '@asamuzakjp/css-color': 5.1.11 + '@asamuzakjp/dom-selector': 7.1.1 + '@bramus/specificity': 2.4.2 + '@csstools/css-syntax-patches-for-csstree': 1.1.6(css-tree@3.2.1) + '@exodus/bytes': 1.15.1 + css-tree: 3.2.1 + data-urls: 7.0.0 + decimal.js: 10.6.0 + html-encoding-sniffer: 6.0.0 + is-potential-custom-element-name: 1.0.1 + lru-cache: 11.5.2 + parse5: 8.0.1 + saxes: 6.0.0 + symbol-tree: 3.2.4 + tough-cookie: 6.0.2 + undici: 7.28.0 + w3c-xmlserializer: 5.0.0 + webidl-conversions: 8.0.1 + whatwg-mimetype: 5.0.0 + whatwg-url: 16.0.1 + xml-name-validator: 5.0.0 + transitivePeerDependencies: + - '@noble/hashes' + optional: true + + lightningcss-android-arm64@1.32.0: + optional: true + + lightningcss-darwin-arm64@1.32.0: + optional: true + + lightningcss-darwin-x64@1.32.0: + optional: true + + lightningcss-freebsd-x64@1.32.0: + optional: true + + lightningcss-linux-arm-gnueabihf@1.32.0: + optional: true + + lightningcss-linux-arm64-gnu@1.32.0: + optional: true + + lightningcss-linux-arm64-musl@1.32.0: + optional: true + + lightningcss-linux-x64-gnu@1.32.0: + optional: true + + lightningcss-linux-x64-musl@1.32.0: + optional: true + + lightningcss-win32-arm64-msvc@1.32.0: + optional: true + + lightningcss-win32-x64-msvc@1.32.0: + optional: true + + lightningcss@1.32.0: + dependencies: + detect-libc: 2.1.2 + optionalDependencies: + lightningcss-android-arm64: 1.32.0 + lightningcss-darwin-arm64: 1.32.0 + lightningcss-darwin-x64: 1.32.0 + lightningcss-freebsd-x64: 1.32.0 + lightningcss-linux-arm-gnueabihf: 1.32.0 + lightningcss-linux-arm64-gnu: 1.32.0 + lightningcss-linux-arm64-musl: 1.32.0 + lightningcss-linux-x64-gnu: 1.32.0 + lightningcss-linux-x64-musl: 1.32.0 + lightningcss-win32-arm64-msvc: 1.32.0 + lightningcss-win32-x64-msvc: 1.32.0 + + lru-cache@11.5.2: + optional: true + + lucide-react@1.24.0(react@19.2.7): + dependencies: + react: 19.2.7 + + lz-string@1.5.0: {} + + magic-string@0.30.21: + dependencies: + '@jridgewell/sourcemap-codec': 1.5.5 + + mdn-data@2.27.1: + optional: true + + min-indent@1.0.1: {} + + nanoid@3.3.16: {} + + obug@2.1.3: {} + + parse5@8.0.1: + dependencies: + entities: 8.0.0 + optional: true + + pathe@2.0.3: {} + + picocolors@1.1.1: {} + + picomatch@4.0.5: {} + + playwright-core@1.61.1: {} + + playwright@1.61.1: + dependencies: + playwright-core: 1.61.1 + optionalDependencies: + fsevents: 2.3.2 + + postcss@8.5.19: + dependencies: + nanoid: 3.3.16 + picocolors: 1.1.1 + source-map-js: 1.2.1 + + pretty-format@27.5.1: + dependencies: + ansi-regex: 5.0.1 + ansi-styles: 5.2.0 + react-is: 17.0.2 + + punycode@2.3.1: + optional: true + + react-dom@19.2.7(react@19.2.7): + dependencies: + react: 19.2.7 + scheduler: 0.27.0 + + react-is@17.0.2: {} + + react-router-dom@7.18.1(react-dom@19.2.7(react@19.2.7))(react@19.2.7): + dependencies: + react: 19.2.7 + react-dom: 19.2.7(react@19.2.7) + react-router: 7.18.1(react-dom@19.2.7(react@19.2.7))(react@19.2.7) + + react-router@7.18.1(react-dom@19.2.7(react@19.2.7))(react@19.2.7): + dependencies: + cookie: 1.1.1 + react: 19.2.7 + set-cookie-parser: 2.7.2 + optionalDependencies: + react-dom: 19.2.7(react@19.2.7) + + react@19.2.7: {} + + redent@3.0.0: + dependencies: + indent-string: 4.0.0 + strip-indent: 3.0.0 + + require-from-string@2.0.2: + optional: true + + rolldown@1.1.5: + dependencies: + '@oxc-project/types': 0.139.0 + '@rolldown/pluginutils': 1.0.1 + optionalDependencies: + '@rolldown/binding-android-arm64': 1.1.5 + '@rolldown/binding-darwin-arm64': 1.1.5 + '@rolldown/binding-darwin-x64': 1.1.5 + '@rolldown/binding-freebsd-x64': 1.1.5 + '@rolldown/binding-linux-arm-gnueabihf': 1.1.5 + '@rolldown/binding-linux-arm64-gnu': 1.1.5 + '@rolldown/binding-linux-arm64-musl': 1.1.5 + '@rolldown/binding-linux-ppc64-gnu': 1.1.5 + '@rolldown/binding-linux-s390x-gnu': 1.1.5 + '@rolldown/binding-linux-x64-gnu': 1.1.5 + '@rolldown/binding-linux-x64-musl': 1.1.5 + '@rolldown/binding-openharmony-arm64': 1.1.5 + '@rolldown/binding-wasm32-wasi': 1.1.5 + '@rolldown/binding-win32-arm64-msvc': 1.1.5 + '@rolldown/binding-win32-x64-msvc': 1.1.5 + + saxes@6.0.0: + dependencies: + xmlchars: 2.2.0 + optional: true + + scheduler@0.27.0: {} + + set-cookie-parser@2.7.2: {} + + siginfo@2.0.0: {} + + source-map-js@1.2.1: {} + + stackback@0.0.2: {} + + std-env@4.2.0: {} + + strip-indent@3.0.0: + dependencies: + min-indent: 1.0.1 + + style-mod@4.1.3: {} + + symbol-tree@3.2.4: + optional: true + + tinybench@2.9.0: {} + + tinyexec@1.2.4: {} + + tinyglobby@0.2.17: + dependencies: + fdir: 6.5.0(picomatch@4.0.5) + picomatch: 4.0.5 + + tinyrainbow@3.1.0: {} + + tldts-core@7.4.8: + optional: true + + tldts@7.4.8: + dependencies: + tldts-core: 7.4.8 + optional: true + + tough-cookie@6.0.2: + dependencies: + tldts: 7.4.8 + optional: true + + tr46@6.0.0: + dependencies: + punycode: 2.3.1 + optional: true + + tslib@2.8.1: + optional: true + + typescript@7.0.2: + optionalDependencies: + '@typescript/typescript-aix-ppc64': 7.0.2 + '@typescript/typescript-darwin-arm64': 7.0.2 + '@typescript/typescript-darwin-x64': 7.0.2 + '@typescript/typescript-freebsd-arm64': 7.0.2 + '@typescript/typescript-freebsd-x64': 7.0.2 + '@typescript/typescript-linux-arm': 7.0.2 + '@typescript/typescript-linux-arm64': 7.0.2 + '@typescript/typescript-linux-loong64': 7.0.2 + '@typescript/typescript-linux-mips64el': 7.0.2 + '@typescript/typescript-linux-ppc64': 7.0.2 + '@typescript/typescript-linux-riscv64': 7.0.2 + '@typescript/typescript-linux-s390x': 7.0.2 + '@typescript/typescript-linux-x64': 7.0.2 + '@typescript/typescript-netbsd-arm64': 7.0.2 + '@typescript/typescript-netbsd-x64': 7.0.2 + '@typescript/typescript-openbsd-arm64': 7.0.2 + '@typescript/typescript-openbsd-x64': 7.0.2 + '@typescript/typescript-sunos-x64': 7.0.2 + '@typescript/typescript-win32-arm64': 7.0.2 + '@typescript/typescript-win32-x64': 7.0.2 + + undici-types@7.16.0: {} + + undici@7.28.0: + optional: true + + vite@8.1.4(@types/node@24.10.0)(esbuild@0.28.1): + dependencies: + lightningcss: 1.32.0 + picomatch: 4.0.5 + postcss: 8.5.19 + rolldown: 1.1.5 + tinyglobby: 0.2.17 + optionalDependencies: + '@types/node': 24.10.0 + esbuild: 0.28.1 + fsevents: 2.3.3 + + vitest@4.1.10(@types/node@24.10.0)(happy-dom@20.10.6)(jsdom@29.1.1)(vite@8.1.4(@types/node@24.10.0)(esbuild@0.28.1)): + dependencies: + '@vitest/expect': 4.1.10 + '@vitest/mocker': 4.1.10(vite@8.1.4(@types/node@24.10.0)(esbuild@0.28.1)) + '@vitest/pretty-format': 4.1.10 + '@vitest/runner': 4.1.10 + '@vitest/snapshot': 4.1.10 + '@vitest/spy': 4.1.10 + '@vitest/utils': 4.1.10 + es-module-lexer: 2.3.1 + expect-type: 1.4.0 + magic-string: 0.30.21 + obug: 2.1.3 + pathe: 2.0.3 + picomatch: 4.0.5 + std-env: 4.2.0 + tinybench: 2.9.0 + tinyexec: 1.2.4 + tinyglobby: 0.2.17 + tinyrainbow: 3.1.0 + vite: 8.1.4(@types/node@24.10.0)(esbuild@0.28.1) + why-is-node-running: 2.3.0 + optionalDependencies: + '@types/node': 24.10.0 + happy-dom: 20.10.6 + jsdom: 29.1.1 + transitivePeerDependencies: + - msw + + w3c-keyname@2.2.8: {} + + w3c-xmlserializer@5.0.0: + dependencies: + xml-name-validator: 5.0.0 + optional: true + + webidl-conversions@8.0.1: + optional: true + + whatwg-mimetype@3.0.0: {} + + whatwg-mimetype@5.0.0: + optional: true + + whatwg-url@16.0.1: + dependencies: + '@exodus/bytes': 1.15.1 + tr46: 6.0.0 + webidl-conversions: 8.0.1 + transitivePeerDependencies: + - '@noble/hashes' + optional: true + + why-is-node-running@2.3.0: + dependencies: + siginfo: 2.0.0 + stackback: 0.0.2 + + ws@8.21.1: {} + + xml-name-validator@5.0.0: + optional: true + + xmlchars@2.2.0: + optional: true diff --git a/pnpm-workspace.yaml b/pnpm-workspace.yaml new file mode 100644 index 0000000..5ed0b5a --- /dev/null +++ b/pnpm-workspace.yaml @@ -0,0 +1,2 @@ +allowBuilds: + esbuild: true diff --git a/pretest.html b/pretest.html index 759b9ab..2a84753 100644 --- a/pretest.html +++ b/pretest.html @@ -4,6 +4,7 @@ CCA-F Pre-Test + @@ -68,7 +71,7 @@ -
    +

    🧪 CCA-F Pre-Test

    30 questions · finds your starting line, not your worth

    @@ -78,9 +81,16 @@

    🧪 CCA-F Pre-Test

    How to take it: Don't look anything up. Pick the answer you think is right. If you're guessing, tick the little 🤔 guessing box. A low score is expected — that's the point. Your answers auto-save, so you can stop and come back.
    +
    +

    +
    + + + +
    -
    +

    @@ -94,9 +104,8 @@

    🧪 CCA-F Pre-Test

    -
    + -
    Copied 👍
    -
    +
    Copied 👍
    @@ -49,7 +64,7 @@

    📈 Your attempts

    function param(n){var m=new RegExp("[?&]"+n+"=([^&]+)").exec(location.search);return m?decodeURIComponent(m[1]):null;} // ---- mark-unit-done (quiz -> timeline/course progress chain) ---- -var UPATH=(window.CCAF&&CCAF.ORDER)?CCAF.ORDER.slice():["o1","a1","a2","m3","m1","m2","m4","o3","o4","o2","rel","t1","t2","p1","px","p2"]; +var UPATH=(window.CCAF&&CCAF.ORDER)?CCAF.ORDER.slice():["w1","w2","w3","w4","w5","a1","m3","m1","m2","o1","a2","d1","d2","m4","o3","o4","o2","rel","t1","t2","p1","px","p2"]; var UTITLES=(window.CCAF&&CCAF.TITLES)?CCAF.TITLES:{}; function curState(){try{var s=JSON.parse(localStorage.getItem("ccaf-curriculum")||"{}");if(s&&typeof s==="object"){s.done=s.done||{};s.opened=s.opened||{};return s;}}catch(e){}return {done:{},opened:{}};} function targetUnit(){var u=param("unit");if(u&&UTITLES[u])return u; @@ -128,6 +143,7 @@

    📈 Your attempts

    // so scores mean knowledge — not remembered letter positions. var QLIST=null, HK=null, QTITLE=null; function shuffle(a){for(var i=a.length-1;i>0;i--){var j=Math.floor(Math.random()*(i+1));var t=a[i];a[i]=a[j];a[j]=t;}return a;} +function stableQuestionId(text){var h=2166136261;for(var i=0;i>>0).toString(36);} function shufOpts(q){var idx=shuffle([0,1,2,3]); return {q:q.q,opts:idx.map(function(i){return q.opts[i];}),ans:idx.indexOf(q.ans),why:q.why};} function buildLesson(u){ @@ -167,10 +183,11 @@

    📈 Your attempts

    function showQuiz(){ document.getElementById("quizview").style.display="block"; document.getElementById("qtitle").textContent=QTITLE; + if(uparam&&window.CCAFFlow)CCAFFlow.mount("lesson-flow",{unit:uparam,stage:"quiz"}); var form=document.getElementById("quiz"); QLIST.forEach(function(item,qi){ - var card=document.createElement("div");card.className="card"; - var p=document.createElement("p");p.style.fontWeight="700";p.textContent=(qi+1)+". "+item.q;card.appendChild(p); + var card=document.createElement("div");card.className="card quiz-question";card.setAttribute("data-question",String(qi)); + var p=document.createElement("p");p.style.fontWeight="700";p.tabIndex=-1;p.textContent=(qi+1)+". "+item.q;card.appendChild(p); item.opts.forEach(function(t,i){ var lab=document.createElement("label");lab.className="opt";lab.id="o"+qi+"-"+i; lab.innerHTML=''+LETTERS[i]+''+t+''; @@ -180,7 +197,27 @@

    📈 Your attempts

    var w=document.createElement("div");w.className="why";w.id="why"+qi;w.textContent="💡 "+item.why;card.appendChild(w); form.appendChild(card); }); + var pageIndex=0; + function drawPage(focus){ + var cards=document.querySelectorAll(".quiz-question"),answered=0; + cards.forEach(function(card,index){card.classList.toggle("is-active",index===pageIndex);if(card.querySelector('input[type="radio"]:checked'))answered++;}); + document.getElementById("qpos").textContent="Question "+(pageIndex+1)+" of "+QLIST.length; + document.getElementById("qanswered").textContent=answered+" answered"; + document.getElementById("qbar").style.width=Math.round((pageIndex+1)/QLIST.length*100)+"%"; + document.getElementById("qprev").disabled=pageIndex===0; + document.getElementById("qnext").style.display=pageIndex===QLIST.length-1?"none":"inline-block"; + document.getElementById("scoreBtn").style.display=pageIndex===QLIST.length-1?"inline-block":"none"; + if(focus){var heading=cards[pageIndex].querySelector("p");if(heading)heading.focus();} + } + form.addEventListener("change",function(){drawPage(false);}); + document.getElementById("qprev").addEventListener("click",function(){pageIndex=Math.max(0,pageIndex-1);drawPage(true);}); + document.getElementById("qnext").addEventListener("click",function(){ + if(!document.querySelector('.quiz-question[data-question="'+pageIndex+'"] input[type="radio"]:checked'))document.getElementById("qstatus").textContent="You can continue, but this question is still unanswered.";else document.getElementById("qstatus").textContent=""; + pageIndex=Math.min(QLIST.length-1,pageIndex+1);drawPage(true); + }); + drawPage(false); document.getElementById("scoreBtn").addEventListener("click",function(){grade();}); + document.getElementById("quiz").addEventListener("submit",function(event){event.preventDefault();grade();}); document.getElementById("againBtn").addEventListener("click",function(){location.reload();}); // reload = fresh draw + fresh option order document.getElementById("copyBtn").addEventListener("click",function(){copyResult();}); } @@ -198,7 +235,7 @@

    📈 Your attempts

    document.getElementById("o"+qi+"-"+item.ans).classList.add("correct"); document.getElementById("why"+qi).classList.add("show"); if(a===item.ans){correct++;if(wasGuess)guessedCorrect++;} else {missed.push(qi+1); if(a!==null) document.getElementById("o"+qi+"-"+a).classList.add("wrong");} - if(wasGuess||a!==item.ans){reviewCards.push({id:(HK+"-"+qi+"-"+item.q.slice(0,24)).replace(/[^a-zA-Z0-9-]/g,"-"),unit:targetUnit()||"general",front:item.q,back:item.opts[item.ans]+". "+item.why,source:wasGuess&&a===item.ans?"guessed-correct":"missed"});} + if(wasGuess||a!==item.ans){reviewCards.push({id:"mistake-"+stableQuestionId(item.q),unit:targetUnit()||"general",front:item.q,back:item.opts[item.ans]+". "+item.why,source:wasGuess&&a===item.ans?"guessed-correct":"missed"});} }); var total=QLIST.length; last={score:correct,total:total,guessed:guessed,missed:missed}; @@ -207,7 +244,8 @@

    📈 Your attempts

    try{var rc0=JSON.parse(localStorage.getItem("ccaf-mistake-cards")||"{}");reviewCards.forEach(function(c){rc0[c.id]=c;});localStorage.setItem("ccaf-mistake-cards",JSON.stringify(rc0));}catch(e){} // save the result AGAINST THE UNIT it was taken for — a lesson's first close requires this record try{qun=targetUnit();if(qun){var qd0=JSON.parse(localStorage.getItem("ccaf-quizdone")||"{}"); - qd0[qun]={score:correct,total:total,guessed:guessed,set:HK,ts:new Date().toLocaleDateString()}; + var latest={score:correct,total:total,guessed:guessed,set:HK,ts:new Date().toLocaleDateString()}; + qd0[qun]=(window.CCAF&&CCAF.mergeQuizResult)?CCAF.mergeQuizResult(qd0[qun],latest):latest; localStorage.setItem("ccaf-quizdone",JSON.stringify(qd0));}}catch(e){} document.getElementById("score").textContent="Score: "+correct+" / "+total; var c=document.getElementById("conf"); @@ -215,10 +253,14 @@

    📈 Your attempts

    c.className="callout "+(correct/total>=0.8?"ok":(correct/total>=0.5?"tip":"warn")); c.innerHTML=""+(correct===total?"Perfect! 🎉":(correct/total>=0.8?"Strong.":(correct/total>=0.5?"Getting there.":"Early days — that's fine.")))+" You guessed on "+guessed+". Confident correct ≈ "+Math.max(0,secure)+". The 💡 notes under each question explain the right answer."+ (qun&&UTITLES[qun]?'
    🧾 This take counts for: '+UTITLES[qun]+' — saved.':''); - document.getElementById("results").style.display="block"; - document.getElementById("results").scrollIntoView({behavior:"smooth"}); + var results=document.getElementById("results");results.style.display="block"; + document.querySelectorAll(".quiz-question").forEach(function(card){card.classList.add("is-active");}); + document.getElementById("quiz-progress").style.display="none";document.getElementById("quiz-actions").style.display="none";document.getElementById("qstatus").textContent="Quiz scored. Review the explanations below."; + var reduce=window.matchMedia&&window.matchMedia("(prefers-reduced-motion: reduce)").matches; + results.scrollIntoView({behavior:reduce?"auto":"smooth"});results.focus({preventScroll:true}); renderHistory(); renderUnitDone(correct/total); + if(qun&&window.CCAFFlow){CCAFFlow.mount("lesson-flow",{unit:qun,stage:"quiz"});CCAFFlow.mountNext("next-step",qun,{stage:"review",context:"Quiz result saved.",label:"Next: review these cards"});} } function renderHistory(){ var h=history(HK); var html="
      "; diff --git a/quizzes.html b/quizzes.html index 1543574..c167009 100644 --- a/quizzes.html +++ b/quizzes.html @@ -18,16 +18,18 @@ -
      +

      🎯 Practice

      -

      Everything you practice with, in one place — quizzes, flashcards, exercises, and the visual repair guide.

      +

      Your checks and optional extra practice, in one place.

      + Review queue 🧪 Pre-Test (30 Q diagnostic) - 🃏 Flashcards (5 decks) + Flashcard library (optional) 🏋️ Build exercises 🩹 Repair guide (pictures)
      +

      Review queue is part of each lesson. The flashcard library is extra practice.

      📊 Checkpoint quizzes

      Short checks woven through the plan. Take one at the end of each phase — they show you (and your tutor) exactly where you're at.

      @@ -37,7 +39,7 @@

      📊 Checkpoint quizzes

      -
      + -
      -
      -

      Review queue

      +
      +
      +

      +

      Review cards

      Loading cards

      -
      Short rule: wrong returns tomorrow; hard returns in 2 days; got it stretches from 4 days toward 30. A correct guess still returns for review.
      -
      -
      + +
      + +
      +
      Card 1
      + +
      -
      -
      +

      +
      Answer
      +
      + +
      +
      -
      - -
      -
      Back to lessonPractice hub
      +
      + +
      +
      + +
      + How review timing works +

      Again returns tomorrow. Hard returns in 2 days. Got it starts at 4 days and stretches toward 30. A correct guess still belongs in review.

      +
      +
      diff --git a/scripts/build_legacy_archive.py b/scripts/build_legacy_archive.py new file mode 100644 index 0000000..41d5754 --- /dev/null +++ b/scripts/build_legacy_archive.py @@ -0,0 +1,62 @@ +#!/usr/bin/env python3 +"""Build the explicitly allowlisted legacy asset archive for local Studio use.""" + +from __future__ import annotations + +import shutil +import sys +import threading +from collections.abc import Callable +from pathlib import Path +from typing import TypeVar + +ROOT = Path(__file__).resolve().parents[1] +if str(ROOT) not in sys.path: + sys.path.insert(0, str(ROOT)) + +from studio_server.legacy_assets import LEGACY_ASSETS, PRIVATE_IMPORT, verify_archive # noqa: E402 + + +T = TypeVar("T") + + +def run_with_heartbeat( + label: str, + operation: Callable[[], T], + *, + interval_seconds: float = 20.0, +) -> T: + """Keep long setup work visibly alive without changing the operation.""" + stopped = threading.Event() + + def report() -> None: + while not stopped.wait(interval_seconds): + print(f"{label} Still working...", flush=True) + + reporter = threading.Thread(target=report, name="ccaf-progress-heartbeat", daemon=True) + reporter.start() + try: + return operation() + finally: + stopped.set() + reporter.join(timeout=1.0) + + +def build_archive(source: Path, destination: Path) -> None: + source = source.resolve() + destination = destination.resolve() + destination.mkdir(parents=True, exist_ok=True) + destination.chmod(0o700) + for relative in sorted(LEGACY_ASSETS): + source_path = source / relative + if not source_path.is_file() or source_path.is_symlink(): + raise FileNotFoundError(f"Allowlisted legacy asset is missing: {source_path}") + target = destination / relative + target.parent.mkdir(parents=True, exist_ok=True) + shutil.copyfile(source_path, target) + progress = source / PRIVATE_IMPORT + if progress.is_file() and not progress.is_symlink(): + private_import = destination / PRIVATE_IMPORT + shutil.copyfile(progress, private_import) + private_import.chmod(0o600) + verify_archive(destination) diff --git a/scripts/check-syntax.mjs b/scripts/check-syntax.mjs new file mode 100644 index 0000000..1cd7fdd --- /dev/null +++ b/scripts/check-syntax.mjs @@ -0,0 +1,13 @@ +import fs from "node:fs"; +import path from "node:path"; +import vm from "node:vm"; + +const root = path.resolve(import.meta.dirname, ".."); +const files = fs.readdirSync(root) + .filter((name) => name.endsWith(".js")) + .concat(fs.readdirSync(path.join(root, "tests", "e2e")).filter((name) => name.endsWith(".js")).map((name) => `tests/e2e/${name}`)); + +for (const file of files) { + new vm.Script(fs.readFileSync(path.join(root, file), "utf8"), { filename: file }); +} +console.log(`Syntax audit: ${files.length} JavaScript files passed.`); diff --git a/scripts/e2e_studio_server.py b/scripts/e2e_studio_server.py new file mode 100644 index 0000000..ad01bac --- /dev/null +++ b/scripts/e2e_studio_server.py @@ -0,0 +1,31 @@ +#!/usr/bin/env python3 +"""Run an isolated Studio server for browser tests.""" + +from __future__ import annotations + +import os +import sys +import tempfile +from pathlib import Path + +import uvicorn + +ROOT = Path(__file__).resolve().parents[1] +if str(ROOT) not in sys.path: + sys.path.insert(0, str(ROOT)) +if str(ROOT / "scripts") not in sys.path: + sys.path.insert(0, str(ROOT / "scripts")) + +from build_legacy_archive import build_archive, run_with_heartbeat +from studio_server.app import create_app + + +if __name__ == "__main__": + with tempfile.TemporaryDirectory(prefix="ccaf-studio-e2e-") as data: + archive = Path(data) / "legacy" + print("[studio-e2e] Building the verified archive and temporary database...", flush=True) + run_with_heartbeat("[studio-e2e]", lambda: build_archive(ROOT, archive)) + app = create_app(archive, Path(data), ROOT / "studio" / "dist") + port = int(os.environ.get("CCA_STUDIO_E2E_PORT", "8765")) + print(f"[studio-e2e] Temporary Studio ready on http://127.0.0.1:{port}", flush=True) + uvicorn.run(app, host="127.0.0.1", port=port, log_level="warning") diff --git a/scripts/export-studio-manifest.mjs b/scripts/export-studio-manifest.mjs new file mode 100644 index 0000000..a1e5e05 --- /dev/null +++ b/scripts/export-studio-manifest.mjs @@ -0,0 +1,85 @@ +import fs from "node:fs"; +import path from "node:path"; +import vm from "node:vm"; +import { fileURLToPath } from "node:url"; + +const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), ".."); +const sourcePath = path.join(root, "course-data.js"); +const mediaSourcePath = path.join(root, "video-data.js"); +const outputPath = path.join(root, "studio", "src", "content", "course-manifest.json"); +const source = fs.readFileSync(sourcePath, "utf8"); +const mediaSource = fs.readFileSync(mediaSourcePath, "utf8"); +const sandbox = { window: {} }; + +vm.createContext(sandbox); +vm.runInContext(source, sandbox, { filename: sourcePath, timeout: 1_000 }); +vm.runInContext(mediaSource, sandbox, { filename: mediaSourcePath, timeout: 1_000 }); + +const course = sandbox.window.CCAF_COURSE; +if (!course || !Array.isArray(course.units) || course.units.length !== 23) { + throw new Error("course-data.js did not expose the expected 23-unit manifest"); +} + +const media = sandbox.window.CCAF_MEDIA; +if (!media || !media.episodes || !media.clips || !media.playlistUrl) { + throw new Error("video-data.js did not expose the expected reviewed media library"); +} + +const clipsByEpisode = new Map( + Object.values(media.clips).map((clip) => [clip.episode, clip]) +); +const videos = Object.entries(media.episodes) + .filter(([, episode]) => ["used", "reference"].includes(episode.status) && episode.id) + .map(([episodeKey, episode]) => { + const clip = clipsByEpisode.get(episodeKey) ?? null; + return { + id: episode.id, + episodeKey, + number: episode.number, + title: episode.title, + channel: episode.channel, + uploaded: episode.uploaded, + durationSec: episode.durationSec, + kind: episode.status === "used" ? "lesson" : "extra", + lessonIds: episode.lessons, + focus: clip?.focus ?? episode.note, + note: episode.note, + reviewedAt: episode.reviewedAt, + url: media.youtubeUrl(episode.id, clip?.startSec ?? 0), + fullUrl: media.youtubeUrl(episode.id, 0), + thumbnailId: episode.id, + clip: clip ? { + id: clip.id, + startSec: clip.startSec, + endSec: clip.endSec, + captionSource: clip.captionSource + } : null + }; + }); + +const manifest = { + sourceVersion: course.version, + generatedFrom: "course-data.js", + units: course.units, + lessons: course.lessons, + banks: course.banks, + cards: course.cards, + media: { + generatedFrom: "video-data.js", + playlistUrl: media.playlistUrl, + reviewedAt: media.reviewedAt, + communityNotice: media.communityNotice, + videos + } +}; + +const rendered = `${JSON.stringify(manifest, null, 2)}\n`; +if (process.argv.includes("--check")) { + const current = fs.existsSync(outputPath) ? fs.readFileSync(outputPath, "utf8") : ""; + if (current !== rendered) throw new Error("Studio manifest is stale. Run pnpm run studio:manifest."); + console.log(`Studio manifest check: ${course.units.length} canonical units match.`); +} else { + fs.mkdirSync(path.dirname(outputPath), { recursive: true }); + fs.writeFileSync(outputPath, rendered); + console.log(`Studio manifest: ${course.units.length} units -> ${path.relative(root, outputPath)}`); +} diff --git a/scripts/release_identity.py b/scripts/release_identity.py new file mode 100644 index 0000000..ee4a1fa --- /dev/null +++ b/scripts/release_identity.py @@ -0,0 +1,207 @@ +#!/usr/bin/env python3 +"""Generate and verify the content identity for a built Studio site.""" + +from __future__ import annotations + +import argparse +import hashlib +import json +import os +from pathlib import Path, PurePosixPath +from typing import Any + + +RELEASE_NAME = "release.json" +APP_ID = "ccaf-study-studio" +SUPPORTED_SCHEMA_MIN = 3 +SUPPORTED_SCHEMA_MAX = 3 +MANIFEST_RELATIVE = Path("studio/src/content/course-manifest.json") +REQUIREMENTS_RELATIVE = Path("requirements.txt") +REPO_ROOT = Path(__file__).resolve().parents[1] +PRODUCTION_SCRIPTS = ( + Path("scripts/build_legacy_archive.py"), + Path("scripts/release_identity.py"), + Path("scripts/run_frontier_mcp.py"), + Path("scripts/run_studio_runtime.py"), + Path("scripts/start_studio.py"), +) + + +def _sha256(path: Path) -> str: + digest = hashlib.sha256() + with path.open("rb") as handle: + for chunk in iter(lambda: handle.read(1024 * 1024), b""): + digest.update(chunk) + return digest.hexdigest() + + +def _backend_files(root: Path) -> list[Path]: + server = root / "studio_server" + files = [item for item in server.rglob("*.py") if "__pycache__" not in item.parts] + files.extend(root / relative for relative in PRODUCTION_SCRIPTS) + files.extend([root / MANIFEST_RELATIVE, root / REQUIREMENTS_RELATIVE]) + return sorted(files, key=lambda item: item.relative_to(root).as_posix()) + + +def backend_content_hash(root: Path = REPO_ROOT) -> str: + root = root.resolve() + value = hashlib.sha256() + for item in _backend_files(root): + if not item.is_file(): + raise ValueError(f"Backend release input is missing: {item}") + value.update(item.relative_to(root).as_posix().encode("utf-8")) + value.update(b"\0") + value.update(bytes.fromhex(_sha256(item))) + return value.hexdigest() + + +def manifest_hash(root: Path = REPO_ROOT) -> str: + manifest = root.resolve() / MANIFEST_RELATIVE + if not manifest.is_file(): + raise ValueError(f"Protected course manifest is missing: {manifest}") + return _sha256(manifest) + + +def release_id(frontend_hash: str, backend_hash: str, protected_manifest_hash: str) -> str: + value = f"frontend:{frontend_hash}\0backend:{backend_hash}\0manifest:{protected_manifest_hash}".encode("utf-8") + return f"sha256:{hashlib.sha256(value).hexdigest()}" + + +def _relative_files(dist: Path) -> list[Path]: + return sorted( + ( + item + for item in dist.rglob("*") + if item.is_file() + and item.name != RELEASE_NAME + and not item.name.startswith(f".{RELEASE_NAME}.") + ), + key=lambda item: item.relative_to(dist).as_posix(), + ) + + +def _entries(dist: Path) -> list[dict[str, Any]]: + entries = [] + for path in _relative_files(dist): + if path.is_symlink(): + raise ValueError(f"Release cannot contain symlinks: {path.relative_to(dist)}") + relative = path.relative_to(dist).as_posix() + entries.append({"path": relative, "bytes": path.stat().st_size, "sha256": _sha256(path)}) + return entries + + +def tree_hash(entries: list[dict[str, Any]]) -> str: + encoded = "".join( + f"{entry['path']}\0{entry['bytes']}\0{entry['sha256']}\n" for entry in entries + ).encode("utf-8") + return hashlib.sha256(encoded).hexdigest() + + +def release_document(dist: Path, root: Path = REPO_ROOT) -> dict[str, Any]: + entries = _entries(dist) + frontend_hash = tree_hash(entries) + protected_manifest_hash = manifest_hash(root) + backend_hash = backend_content_hash(root) + return { + "schema": SUPPORTED_SCHEMA_MAX, + "kind": "cca-f-study-studio", + "appId": APP_ID, + "releaseId": release_id(frontend_hash, backend_hash, protected_manifest_hash), + "frontendContentSha256": frontend_hash, + "contentSha256": frontend_hash, + "manifestHash": protected_manifest_hash, + "backendContentSha256": backend_hash, + "supportedSchemaMin": SUPPORTED_SCHEMA_MIN, + "supportedSchemaMax": SUPPORTED_SCHEMA_MAX, + "files": entries, + } + + +def write_release(dist: Path, root: Path = REPO_ROOT) -> dict[str, Any]: + dist = dist.resolve() + if not (dist / "index.html").is_file(): + raise ValueError(f"Studio build is missing {dist / 'index.html'}") + document = release_document(dist, root) + temporary = dist / f".{RELEASE_NAME}.{os.getpid()}.tmp" + temporary.write_text(json.dumps(document, indent=2, sort_keys=True) + "\n", encoding="utf-8") + os.replace(temporary, dist / RELEASE_NAME) + return document + + +def read_release(dist: Path) -> dict[str, Any]: + path = dist / RELEASE_NAME + try: + document = json.loads(path.read_text(encoding="utf-8")) + except (OSError, UnicodeDecodeError, json.JSONDecodeError) as error: + raise ValueError(f"Cannot read {path}: {error}") from error + if not isinstance(document, dict): + raise ValueError(f"{path} must contain a JSON object") + return document + + +def verify_release(dist: Path, root: Path = REPO_ROOT) -> dict[str, Any]: + dist = dist.resolve() + document = read_release(dist) + if document.get("schema") != SUPPORTED_SCHEMA_MAX or document.get("kind") != "cca-f-study-studio": + raise ValueError(f"{dist / RELEASE_NAME} has an unsupported release identity") + if document.get("appId") != APP_ID: + raise ValueError(f"{dist / RELEASE_NAME} has an unsupported app identity") + if document.get("supportedSchemaMin") != SUPPORTED_SCHEMA_MIN or document.get("supportedSchemaMax") != SUPPORTED_SCHEMA_MAX: + raise ValueError(f"{dist / RELEASE_NAME} has an unsupported schema range") + files = document.get("files") + if not isinstance(files, list) or not files: + raise ValueError(f"{dist / RELEASE_NAME} has no generated files") + + expected_paths: set[str] = set() + for entry in files: + if not isinstance(entry, dict) or set(entry) != {"path", "bytes", "sha256"}: + raise ValueError(f"{dist / RELEASE_NAME} has a malformed file entry") + relative = entry["path"] + if not isinstance(relative, str) or not relative or relative == RELEASE_NAME: + raise ValueError(f"{dist / RELEASE_NAME} contains an invalid file path") + parsed = PurePosixPath(relative) + if parsed.is_absolute() or ".." in parsed.parts or "\\" in relative: + raise ValueError(f"{dist / RELEASE_NAME} contains an unsafe file path: {relative}") + if relative in expected_paths: + raise ValueError(f"{dist / RELEASE_NAME} contains a duplicate file path: {relative}") + expected_paths.add(relative) + path = dist / Path(*parsed.parts) + if path.is_symlink() or not path.is_file() or dist not in path.resolve().parents: + raise ValueError(f"Release file is missing: {relative}") + if entry["bytes"] != path.stat().st_size or entry["sha256"] != _sha256(path): + raise ValueError(f"Release file hash mismatch: {relative}") + + actual_paths = {path.relative_to(dist).as_posix() for path in _relative_files(dist)} + if actual_paths != expected_paths: + extra = sorted(actual_paths - expected_paths) + missing = sorted(expected_paths - actual_paths) + raise ValueError(f"Release file set mismatch; extra={extra}, missing={missing}") + + entries = sorted(files, key=lambda entry: entry["path"]) + frontend_hash = tree_hash(entries) + expected_manifest_hash = manifest_hash(root) + expected_backend_hash = backend_content_hash(root) + if document.get("frontendContentSha256") != frontend_hash or document.get("contentSha256") != frontend_hash: + raise ValueError(f"{dist / RELEASE_NAME} has a frontend content hash mismatch") + if document.get("manifestHash") != expected_manifest_hash: + raise ValueError(f"{dist / RELEASE_NAME} has a protected manifest hash mismatch") + if document.get("backendContentSha256") != expected_backend_hash: + raise ValueError(f"{dist / RELEASE_NAME} has a backend content hash mismatch") + if document.get("releaseId") != release_id(frontend_hash, expected_backend_hash, expected_manifest_hash): + raise ValueError(f"{dist / RELEASE_NAME} has a content hash mismatch") + return document + + +def main() -> int: + parser = argparse.ArgumentParser(description=__doc__) + parser.add_argument("action", choices=("generate", "verify")) + parser.add_argument("--dist", type=Path, default=Path("studio/dist")) + parser.add_argument("--root", type=Path, default=REPO_ROOT) + args = parser.parse_args() + document = write_release(args.dist, args.root) if args.action == "generate" else verify_release(args.dist, args.root) + print(f"Studio release {document['releaseId']} ({len(document['files'])} files)") + return 0 + + +if __name__ == "__main__": + raise SystemExit(main()) diff --git a/scripts/run_frontier_mcp.py b/scripts/run_frontier_mcp.py new file mode 100644 index 0000000..1308997 --- /dev/null +++ b/scripts/run_frontier_mcp.py @@ -0,0 +1,51 @@ +#!/usr/bin/env python3 +"""Launch the HTTP-only Study Studio stdio MCP bridge. + +This process never starts Study Studio and never opens its database. The MCP +tools return a clear unavailable response until the learner has launched the +local app and its supervisor endpoint is healthy. +""" + +from __future__ import annotations + +import os +import sys + +from start_studio import APP, DATA, REQUIREMENTS, VENV, file_digest, sync_app + + +def fail(message: str) -> int: + print(message, file=sys.stderr, flush=True) + return 2 + + +def main() -> int: + runtime = VENV / "bin" / "python" + marker = VENV / ".requirements-sha256" + expected = file_digest(REQUIREMENTS) + installed = marker.read_text(encoding="utf-8").strip() if marker.is_file() else "" + if not runtime.is_file() or installed != expected: + return fail("Study Studio runtime is not ready. Launch 'Start CCA-F Study Studio.command' once, then reconnect the MCP server.") + + # Refresh only the packaged Python module. sync_app copies source files; + # it does not import the app or open the learner database. + try: + sync_app() + except OSError as error: + return fail(f"Could not refresh the Study Studio MCP bridge: {error}") + + environment = os.environ.copy() + existing_path = environment.get("PYTHONPATH") + environment["PYTHONPATH"] = str(APP) if not existing_path else f"{APP}{os.pathsep}{existing_path}" + environment.setdefault("CCA_STUDIO_SERVER_URL", "http://127.0.0.1:8765") + environment["CCA_STUDIO_DATA_DIR"] = str(DATA) + os.execve( + str(runtime), + [str(runtime), "-m", "studio_server.mcp_server"], + environment, + ) + return 0 + + +if __name__ == "__main__": + raise SystemExit(main()) diff --git a/scripts/run_studio_runtime.py b/scripts/run_studio_runtime.py new file mode 100755 index 0000000..0f374e8 --- /dev/null +++ b/scripts/run_studio_runtime.py @@ -0,0 +1,183 @@ +#!/usr/bin/env python3 +"""Cached runtime entry point. Use start_studio.py instead of calling directly.""" + +from __future__ import annotations + +import argparse +import json +import os +import socket +import sys +import threading +import time +import urllib.request +import webbrowser +from pathlib import Path +from urllib.parse import urlsplit + + +def port_available(port: int) -> bool: + with socket.socket() as probe: + try: + probe.bind(("127.0.0.1", port)) + return True + except OSError: + return False + + +def _json_response(url: str) -> dict[str, object] | None: + try: + with urllib.request.urlopen(url, timeout=0.5) as response: + if response.status != 200: + return None + payload = json.loads(response.read().decode("utf-8")) + return payload if isinstance(payload, dict) else None + except (OSError, UnicodeDecodeError, json.JSONDecodeError): + return None + + +def health_ok( + port: int, + expected_release_id: str | None = None, + expected_manifest_hash: str | None = None, + expected_backend_hash: str | None = None, +) -> bool: + payload = _json_response(f"http://127.0.0.1:{port}/__health") + if not payload or not all(payload.get(key) is True for key in ("ok", "sqlite", "save")): + return False + expected_fields = { + "appId": os.environ.get("CCA_STUDIO_APP_ID"), + "releaseId": expected_release_id, + "manifestHash": expected_manifest_hash, + "backendContentSha256": expected_backend_hash, + } + if payload.get("schemaVersion") not in {None, 3}: + return False + if any(expected is not None and payload.get(field) != expected for field, expected in expected_fields.items()): + return False + if expected_release_id is None: + return True + release = _json_response(f"http://127.0.0.1:{port}/release.json") + return bool( + release + and all( + expected is None or release.get(field) == expected + for field, expected in expected_fields.items() + ) + ) + + +def open_when_ready( + url: str, + port: int, + expected_release_id: str | None = None, + expected_manifest_hash: str | None = None, + expected_backend_hash: str | None = None, +) -> None: + for _ in range(40): + if health_ok(port, expected_release_id, expected_manifest_hash, expected_backend_hash): + webbrowser.open(url) + return + time.sleep(0.1) + + +def recovery_app(app_id: str, release_id: str): + """Return a read-only local screen when the authoritative store is locked.""" + from fastapi import FastAPI, Request + from fastapi.responses import HTMLResponse, JSONResponse + + allowed_hosts = {"localhost", "127.0.0.1", "::1"} + app = FastAPI(title="CCA-F Study Studio recovery", docs_url=None, redoc_url=None) + + @app.middleware("http") + async def local_only(request: Request, call_next): + host = request.headers.get("host", "") + try: + hostname = (urlsplit(f"http://{host}").hostname or "").lower() + except ValueError: + hostname = "" + if hostname not in allowed_hosts: + return JSONResponse({"detail": "Local requests only"}, status_code=403) + origin = request.headers.get("origin") + if origin: + try: + origin_host = (urlsplit(origin).hostname or "").lower() + except ValueError: + origin_host = "" + if origin_host not in allowed_hosts or origin_host != hostname: + return JSONResponse({"detail": "Local requests only"}, status_code=403) + return await call_next(request) + + @app.get("/__health") + def recovery_health() -> dict[str, object]: + return { + "ok": False, + "appId": app_id, + "releaseId": release_id, + "status": "recovery_required", + } + + @app.get("/{path:path}", response_class=HTMLResponse) + def recovery_screen(path: str = "") -> str: + return """ + +CCA-F Study Studio recovery + +

      Study Studio recovery required

      +

      Normal Study Studio is blocked because local progress storage could not be opened safely.

      +

      Recovery copies and backups were preserved. Restore a known-good copy, then restart Study Studio.

      +

      No learning data was changed by this recovery screen.

      +""" + + return app + + +def main() -> None: + parser = argparse.ArgumentParser(description="Launch CCA-F Study Studio") + parser.add_argument("--port", type=int, default=8765) + parser.add_argument("--no-open", action="store_true") + args = parser.parse_args() + expected_release_id = os.environ.get("CCA_STUDIO_RELEASE_ID") + expected_app_id = os.environ.get("CCA_STUDIO_APP_ID") + expected_manifest_hash = os.environ.get("CCA_STUDIO_MANIFEST_HASH") + expected_backend_hash = os.environ.get("CCA_STUDIO_BACKEND_HASH") + if not expected_app_id or not expected_release_id or not expected_manifest_hash or not expected_backend_hash: + raise SystemExit("Studio release identity is missing. Rebuild the Studio before launching.") + + if not port_available(args.port): + if health_ok(args.port, expected_release_id, expected_manifest_hash, expected_backend_hash): + url = f"http://127.0.0.1:{args.port}/" + print(f"Study Studio is already running: {url}") + if not args.no_open: + webbrowser.open(url) + return + raise SystemExit(f"Port {args.port} is busy. Try --port {args.port + 1}.") + + source = Path(os.environ["CCA_STUDIO_SOURCE_ROOT"]) + app_dir = Path(os.environ["CCA_STUDIO_APP_DIR"]) + data = Path(os.environ["CCA_STUDIO_DATA_DIR"]) + site = Path(os.environ["CCA_STUDIO_DIST_DIR"]) + sys.path.insert(0, str(app_dir)) + + from studio_server.app import create_app + import uvicorn + + url = f"http://127.0.0.1:{args.port}/" + print(f"CCA-F Study Studio: {url}", flush=True) + print("Progress is stored privately in macOS Application Support. Press Control-C to stop.", flush=True) + if not args.no_open: + threading.Thread( + target=open_when_ready, + args=(url, args.port, expected_release_id, expected_manifest_hash, expected_backend_hash), + daemon=True, + ).start() + try: + application = create_app(source, data, site) + except RuntimeError: + print("Study Studio entered local recovery mode because storage could not be opened safely.", file=sys.stderr, flush=True) + application = recovery_app(os.environ["CCA_STUDIO_APP_ID"], expected_release_id) + uvicorn.run(application, host="127.0.0.1", port=args.port, log_level="warning") + + +if __name__ == "__main__": + main() diff --git a/scripts/serve_legacy_archive.py b/scripts/serve_legacy_archive.py new file mode 100644 index 0000000..bad5d30 --- /dev/null +++ b/scripts/serve_legacy_archive.py @@ -0,0 +1,58 @@ +#!/usr/bin/env python3 +"""Serve only the generated legacy asset archive for browser tests.""" + +from __future__ import annotations + +import argparse +import tempfile +from http.server import SimpleHTTPRequestHandler, ThreadingHTTPServer +from pathlib import Path +from urllib.parse import unquote, urlsplit + +from build_legacy_archive import build_archive, run_with_heartbeat + + +ROOT = Path(__file__).resolve().parents[1] +BLOCKED_NAMES = {".git", ".agents", ".claude", ".studio-data", "my-progress.json", "my-progress.backup.json"} + + +class ArchiveHandler(SimpleHTTPRequestHandler): + def _blocked(self) -> bool: + parts = [part for part in Path(unquote(urlsplit(self.path).path)).parts if part not in {"/", "\\"}] + return any(part in BLOCKED_NAMES or part.startswith(".") or part.endswith(".tmp") for part in parts) + + def do_GET(self) -> None: + if self._blocked(): + self.send_error(404) + return + super().do_GET() + + def do_HEAD(self) -> None: + if self._blocked(): + self.send_error(404) + return + super().do_HEAD() + + def log_message(self, *_: object) -> None: + return + + +def main() -> None: + parser = argparse.ArgumentParser(description=__doc__) + parser.add_argument("--port", type=int, default=4173) + args = parser.parse_args() + with tempfile.TemporaryDirectory(prefix="ccaf-legacy-e2e-") as data: + archive = Path(data) / "legacy" + print("[legacy-e2e] Building the verified read-only archive...", flush=True) + run_with_heartbeat("[legacy-e2e]", lambda: build_archive(ROOT, archive)) + print(f"[legacy-e2e] Archive ready on http://127.0.0.1:{args.port}", flush=True) + handler = lambda *args_, **kwargs: ArchiveHandler(*args_, directory=str(archive), **kwargs) + server = ThreadingHTTPServer(("127.0.0.1", args.port), handler) + try: + server.serve_forever() + finally: + server.server_close() + + +if __name__ == "__main__": + main() diff --git a/scripts/start_studio.py b/scripts/start_studio.py new file mode 100755 index 0000000..1d2d800 --- /dev/null +++ b/scripts/start_studio.py @@ -0,0 +1,324 @@ +#!/usr/bin/env python3 +"""Prepare and launch Study Studio from fast, Mac-local runtime folders.""" + +from __future__ import annotations + +import hashlib +import json +import os +import shutil +import subprocess +import sys +from pathlib import Path + +from build_legacy_archive import build_archive, verify_archive +from release_identity import backend_content_hash, verify_release +from studio_server.legacy_assets import LEGACY_ASSETS + + +ROOT = Path(__file__).resolve().parents[1] +CACHE = Path.home() / "Library" / "Caches" / "CCA-F Study Studio" +DATA = Path.home() / "Library" / "Application Support" / "CCA-F Study Studio" +VENV = CACHE / "runtime" +SITE = CACHE / "site" +APP = CACHE / "app" +ARCHIVE = CACHE / "legacy" +REQUIREMENTS = ROOT / "requirements.txt" +APP_SIGNATURE = ".app-signature" +LEGACY_SIGNATURE = CACHE / ".legacy-source-signature" + + +def python_version(executable: Path) -> tuple[int, int] | None: + try: + result = subprocess.run( + [str(executable), "-c", "import sys; print(f'{sys.version_info.major}.{sys.version_info.minor}')"], + check=True, + capture_output=True, + text=True, + timeout=3, + ) + major, minor = result.stdout.strip().split(".", 1) + return int(major), int(minor) + except (OSError, subprocess.SubprocessError, ValueError): + return None + + +def find_base_python() -> Path: + candidates: list[Path] = [] + if os.environ.get("CCA_STUDIO_PYTHON"): + candidates.append(Path(os.environ["CCA_STUDIO_PYTHON"]).expanduser()) + candidates.append(Path(sys.executable)) + candidates.extend(sorted((Path.home() / ".cache" / "codex-runtimes").glob("*/dependencies/python/bin/python3"), reverse=True)) + candidates.extend([Path("/opt/homebrew/bin/python3"), Path("/usr/local/bin/python3")]) + checked: set[Path] = set() + for candidate in candidates: + resolved = candidate.resolve() if candidate.exists() else candidate + if resolved in checked: + continue + checked.add(resolved) + version = python_version(candidate) + if version is not None and version >= (3, 11): + return candidate + raise SystemExit("Study Studio needs Python 3.11 or newer. Open it from Codex, or install a current Python from python.org.") + + +def file_digest(path: Path) -> str: + return hashlib.sha256(path.read_bytes()).hexdigest() + + +def app_content_hash(root: Path) -> str: + if not root.is_dir() or root.is_symlink(): + raise ValueError("Cached Studio app is missing or is not a regular directory") + files: list[Path] = [] + for item in root.rglob("*"): + if item.is_symlink(): + raise ValueError(f"Cached Studio app contains a symlink: {item.relative_to(root)}") + if not item.is_file() or item.name == APP_SIGNATURE or "__pycache__" in item.parts or item.suffix == ".pyc": + continue + files.append(item) + value = hashlib.sha256() + for item in sorted(files, key=lambda path: path.relative_to(root).as_posix()): + value.update(item.relative_to(root).as_posix().encode("utf-8")) + value.update(b"\0") + value.update(hashlib.sha256(item.read_bytes()).digest()) + return value.hexdigest() + + +def verify_app_cache(root: Path, expected_backend_hash: str) -> dict[str, str]: + marker = root / APP_SIGNATURE + try: + descriptor = json.loads(marker.read_text(encoding="utf-8")) + except (OSError, json.JSONDecodeError, UnicodeDecodeError) as error: + raise ValueError("Cached Studio app identity is missing or malformed") from error + if not isinstance(descriptor, dict) or descriptor.get("backendContentSha256") != expected_backend_hash: + raise ValueError("Cached Studio backend identity does not match the release") + actual = app_content_hash(root) + if descriptor.get("appContentSha256") != actual: + raise ValueError("Cached Studio app file hash does not match its identity") + return {"backendContentSha256": expected_backend_hash, "appContentSha256": actual} + + +def replace_tree(temporary: Path, target: Path, verifier=None) -> None: + """Promote a verified staged directory while retaining the prior release.""" + if verifier is not None: + verifier(temporary) + previous = target.with_name(f"{target.name}.previous") + older_previous = target.with_name(f"{target.name}.previous.old") + shutil.rmtree(older_previous, ignore_errors=True) + if previous.exists(): + previous.rename(older_previous) + moved_previous = False + promoted = False + try: + if target.exists(): + target.rename(previous) + moved_previous = True + temporary.rename(target) + promoted = True + if verifier is not None: + verifier(target) + except Exception: + if promoted and target.exists(): + shutil.rmtree(target, ignore_errors=True) + if not target.exists() and previous.exists(): + previous.rename(target) + if older_previous.exists() and not previous.exists(): + older_previous.rename(previous) + raise + shutil.rmtree(older_previous, ignore_errors=True) + + +def ensure_runtime() -> Path: + CACHE.mkdir(parents=True, exist_ok=True) + DATA.mkdir(parents=True, exist_ok=True) + CACHE.chmod(0o700) + DATA.chmod(0o700) + runtime_python = VENV / "bin" / "python" + marker = VENV / ".requirements-sha256" + base_marker = VENV / ".base-python" + base_python = find_base_python() + base_identity = f"{base_python.resolve()}:{python_version(base_python)}" + required = file_digest(REQUIREMENTS) + existing_base = base_marker.read_text(encoding="utf-8").strip() if base_marker.is_file() else "" + if not runtime_python.is_file() or existing_base != base_identity: + print("Preparing the local Study Studio runtime once...", flush=True) + shutil.rmtree(VENV, ignore_errors=True) + try: + subprocess.run([str(base_python), "-m", "venv", str(VENV)], check=True) + except subprocess.CalledProcessError as error: + raise SystemExit( + "Study Studio could not create its private Python workspace. " + "Free a little disk space, then double-click the launcher again." + ) from error + base_marker.write_text(base_identity, encoding="utf-8") + installed = marker.read_text(encoding="utf-8").strip() if marker.is_file() else "" + if installed != required: + try: + subprocess.run( + [str(runtime_python), "-m", "pip", "install", "--disable-pip-version-check", "-r", str(REQUIREMENTS)], + check=True, + ) + except subprocess.CalledProcessError as error: + raise SystemExit( + "Study Studio needs an internet connection once to finish setting up. " + "Connect to the internet, then double-click the launcher again." + ) from error + marker.write_text(required, encoding="utf-8") + return runtime_python + + +def sync_site(source: Path | None = None, target: Path | None = None) -> dict[str, object]: + source = (source or ROOT / "studio" / "dist").resolve() + target = (target or SITE).resolve() + if not (source / "index.html").is_file(): + raise SystemExit("The Studio build is missing. Run `pnpm run studio:build` once, then launch again.") + try: + source_release = verify_release(source, ROOT) + except ValueError as error: + raise SystemExit(f"Studio build identity is invalid: {error}") from error + source_id = str(source_release["releaseId"]) + try: + current_release = verify_release(target, ROOT) + except ValueError: + current_release = None + if current_release and current_release.get("releaseId") == source_id: + return current_release + temporary = CACHE / f"site-{os.getpid()}.tmp" + shutil.rmtree(temporary, ignore_errors=True) + try: + shutil.copytree(source, temporary) + except Exception: + shutil.rmtree(temporary, ignore_errors=True) + raise + replace_tree(temporary, target, verifier=lambda path: verify_release(path, ROOT)) + return source_release + + +def sync_app(root: Path | None = None, target: Path | None = None, cache: Path | None = None) -> None: + root = (root or ROOT).resolve() + target = (target or APP).resolve() + cache = (cache or CACHE).resolve() + server = root / "studio_server" + runner = root / "scripts" / "run_studio_runtime.py" + manifest = root / "studio" / "src" / "content" / "course-manifest.json" + source_hash = backend_content_hash(root) + try: + verify_app_cache(target, source_hash) + return + except ValueError: + pass + cache.mkdir(parents=True, exist_ok=True) + temporary = cache / f"app-{os.getpid()}.tmp" + shutil.rmtree(temporary, ignore_errors=True) + try: + shutil.copytree(server, temporary / "studio_server", ignore=shutil.ignore_patterns("__pycache__", "*.pyc")) + target_manifest = temporary / "studio" / "src" / "content" / "course-manifest.json" + target_manifest.parent.mkdir(parents=True, exist_ok=True) + shutil.copy2(manifest, target_manifest) + shutil.copy2(runner, temporary / "run_studio_runtime.py") + except Exception: + shutil.rmtree(temporary, ignore_errors=True) + raise + signature = { + "backendContentSha256": source_hash, + "appContentSha256": app_content_hash(temporary), + } + (temporary / APP_SIGNATURE).write_text(json.dumps(signature, sort_keys=True), encoding="utf-8") + replace_tree(temporary, target, verifier=lambda path: verify_app_cache(path, source_hash)) + + +def archive_source_signature(root: Path | None = None) -> str: + """Fingerprint allowlisted metadata without hydrating cloud-offloaded files.""" + root = root or ROOT + value = hashlib.sha256() + for relative in sorted(LEGACY_ASSETS): + stat = (root / relative).stat() + value.update(relative.encode("utf-8")) + value.update(b"\0") + value.update(str(stat.st_size).encode("ascii")) + value.update(b"\0") + value.update(str(stat.st_mtime_ns).encode("ascii")) + value.update(b"\0") + return value.hexdigest() + + +def cached_archive_matches_source(source: Path | None = None, archive: Path | None = None) -> bool: + """Bootstrap older verified caches without forcing source-file downloads.""" + source = source or ROOT + archive = archive or ARCHIVE + try: + verify_archive(archive) + return all((source / relative).stat().st_size == (archive / relative).stat().st_size for relative in LEGACY_ASSETS) + except (OSError, ValueError): + return False + + +def write_legacy_signature(signature: str) -> None: + temporary = LEGACY_SIGNATURE.with_name(f"{LEGACY_SIGNATURE.name}-{os.getpid()}.tmp") + temporary.write_text(signature, encoding="utf-8") + os.replace(temporary, LEGACY_SIGNATURE) + + +def sync_archive() -> None: + source_signature = archive_source_signature() + try: + cached_signature = LEGACY_SIGNATURE.read_text(encoding="utf-8").strip() + except OSError: + cached_signature = "" + if cached_signature == source_signature: + try: + verify_archive(ARCHIVE) + return + except (OSError, ValueError): + pass + if not cached_signature and cached_archive_matches_source(): + write_legacy_signature(source_signature) + return + temporary = CACHE / f"legacy-{os.getpid()}.tmp" + shutil.rmtree(temporary, ignore_errors=True) + try: + build_archive(ROOT, temporary) + except Exception: + shutil.rmtree(temporary, ignore_errors=True) + raise + replace_tree(temporary, ARCHIVE, verifier=verify_archive) + write_legacy_signature(source_signature) + + +def clear_stale_temporaries() -> None: + """Interrupted launches leave per-PID staging folders behind; the runtime's + single-instance port bind means no other launch is mid-copy here.""" + for leftover in CACHE.glob("*.tmp"): + shutil.rmtree(leftover, ignore_errors=True) + + +def main() -> None: + runtime_python = ensure_runtime() + clear_stale_temporaries() + sync_app() + sync_archive() + release = sync_site() + try: + verify_app_cache(APP, str(release["backendContentSha256"])) + except ValueError as error: + raise SystemExit("Cached Study Studio app identity does not match the verified release. Rebuild the cache and retry.") + environment = os.environ.copy() + environment.update({ + "CCA_STUDIO_SOURCE_ROOT": str(ARCHIVE), + "CCA_STUDIO_APP_DIR": str(APP), + "CCA_STUDIO_DATA_DIR": str(DATA), + "CCA_STUDIO_DIST_DIR": str(SITE), + "CCA_STUDIO_RELEASE_ID": str(release["releaseId"]), + "CCA_STUDIO_APP_ID": str(release["appId"]), + "CCA_STUDIO_MANIFEST_HASH": str(release["manifestHash"]), + "CCA_STUDIO_BACKEND_HASH": str(release["backendContentSha256"]), + }) + os.execve( + str(runtime_python), + [str(runtime_python), str(APP / "run_studio_runtime.py"), *sys.argv[1:]], + environment, + ) + + +if __name__ == "__main__": + main() diff --git a/scripts/verify-preview-bundle.mjs b/scripts/verify-preview-bundle.mjs new file mode 100644 index 0000000..6e7084e --- /dev/null +++ b/scripts/verify-preview-bundle.mjs @@ -0,0 +1,39 @@ +import fs from "node:fs"; +import path from "node:path"; +import process from "node:process"; + +const root = process.cwd(); +const dist = path.resolve(root, process.argv[2] || "studio/dist"); +const files = []; + +function collect(directory) { + for (const entry of fs.readdirSync(directory, { withFileTypes: true })) { + const full = path.join(directory, entry.name); + if (entry.isDirectory()) collect(full); + else if (entry.isFile() && /\.(?:html|js|css)$/.test(entry.name)) files.push(full); + } +} + +if (!fs.existsSync(dist)) throw new Error(`Preview bundle is missing: ${dist}`); +collect(dist); +const bundle = files.map((file) => fs.readFileSync(file, "utf8")).join("\n"); +const required = "Preview only. Progress is not saved."; +const forbidden = [ + "/api/", + "X-CCA-Instance", + ".ccaf-backup", + "Download backup", + "Import legacy checks", + "Loading your saved progress", + "Completed work stays saved", + "No progress was overwritten", + "Review saved.", + "The saved queue is complete.", + "Your W1 completion is saved here", + "Your saved evidence stays available" +]; + +if (!bundle.includes(required)) throw new Error("Preview notice is missing from the built bundle"); +const leaked = forbidden.filter((value) => bundle.includes(value)); +if (leaked.length) throw new Error(`Preview bundle contains local-only behavior: ${leaked.join(", ")}`); +console.log(`Preview bundle: PASS (${files.length} text assets, no local persistence surface)`); diff --git a/scripts/verify-studio-baseline.mjs b/scripts/verify-studio-baseline.mjs new file mode 100644 index 0000000..20927dd --- /dev/null +++ b/scripts/verify-studio-baseline.mjs @@ -0,0 +1,20 @@ +import crypto from "node:crypto"; +import fs from "node:fs"; +import path from "node:path"; +import { fileURLToPath } from "node:url"; + +const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), ".."); +const baseline = JSON.parse(fs.readFileSync(path.join(root, "studio", "curriculum-baseline.json"), "utf8")); +const failures = []; + +for (const [relativePath, expected] of Object.entries(baseline.sha256)) { + const absolutePath = path.join(root, relativePath); + const actual = crypto.createHash("sha256").update(fs.readFileSync(absolutePath)).digest("hex"); + if (actual !== expected) failures.push(`${relativePath}: expected ${expected}, received ${actual}`); +} + +if (failures.length) { + throw new Error(`Protected curriculum content changed:\n${failures.join("\n")}`); +} + +console.log(`Curriculum baseline: ${Object.keys(baseline.sha256).length} protected files unchanged.`); diff --git a/serve.py b/serve.py index 4a3a021..00bf620 100644 --- a/serve.py +++ b/serve.py @@ -16,16 +16,129 @@ An optional address is available for embedded browsers that cannot reach the host machine through their own localhost. """ -import hmac, json, os, secrets, sys +import hmac, json, math, os, re, secrets, shutil, sys, threading from http.cookies import SimpleCookie from http.server import SimpleHTTPRequestHandler, ThreadingHTTPServer -from urllib.parse import parse_qs, urlsplit +from urllib.parse import parse_qs, unquote, urlsplit ROOT = os.path.dirname(os.path.abspath(__file__)) SAVE = os.path.join(ROOT, "my-progress.json") BAK = os.path.join(ROOT, "my-progress.backup.json") +SAVE_LOCK = threading.Lock() +MAX_BODY = 2_000_000 +MAX_KEYS = 1000 +MAX_KEY = 128 +MAX_VALUE = 1_000_000 +MAX_TOTAL = 1_800_000 +KEY_RE = re.compile(r"^ccaf-[A-Za-z0-9][A-Za-z0-9._-]*$") + + +def validate_progress(payload): + if type(payload) is not dict: + return False + timestamp = payload.get("ts") + data = payload.get("data") + if isinstance(timestamp, bool) or not isinstance(timestamp, (int, float)): + return False + if not math.isfinite(timestamp) or timestamp < 0 or type(data) is not dict: + return False + if len(data) > MAX_KEYS: + return False + total = 0 + for key, value in data.items(): + if not isinstance(key, str) or len(key) > MAX_KEY or not KEY_RE.fullmatch(key) or key == "ccaf-sync-ts": + return False + if not isinstance(value, str) or len(value) > MAX_VALUE: + return False + total += len(key) + len(value) + if total > MAX_TOTAL: + return False + return True + + +def write_progress(payload): + tmp = f"{SAVE}.{os.getpid()}.{threading.get_ident()}.tmp" + backup_tmp = f"{BAK}.{os.getpid()}.{threading.get_ident()}.tmp" + try: + with open(tmp, "w", encoding="utf-8") as handle: + json.dump(payload, handle, indent=1) + handle.flush() + os.fsync(handle.fileno()) + with SAVE_LOCK: + current_timestamp = -1 + if os.path.exists(SAVE): + try: + with open(SAVE, encoding="utf-8") as handle: + current = json.load(handle) + if validate_progress(current): + current_timestamp = current["ts"] + except (OSError, ValueError): + pass + if payload["ts"] <= current_timestamp: + return False, current_timestamp + if os.path.exists(SAVE): + shutil.copyfile(SAVE, backup_tmp) + with open(backup_tmp, "rb") as handle: + os.fsync(handle.fileno()) + os.replace(backup_tmp, BAK) + os.replace(tmp, SAVE) + return True, payload["ts"] + finally: + for path in (tmp, backup_tmp): + try: + os.remove(path) + except FileNotFoundError: + pass class Handler(SimpleHTTPRequestHandler): + def _host_allowed(self): + try: + raw = self.headers.get("Host", "") + parsed = urlsplit(f"http://{raw}") + host = (parsed.hostname or "").lower() + except ValueError: + return False + allowed = getattr(self.server, "allowed_hosts", {"localhost", "127.0.0.1", "::1"}) + return host in allowed + + def _origin_allowed(self): + origin = self.headers.get("Origin") + if not origin: + return True + try: + parsed_origin = urlsplit(origin) + parsed_host = urlsplit(f"http://{self.headers.get('Host', '')}") + return ( + parsed_origin.scheme == "http" + and parsed_origin.hostname == parsed_host.hostname + and (parsed_origin.port or 80) == (parsed_host.port or 80) + ) + except ValueError: + return False + + def _send_progress(self, include_body=True): + try: + with open(SAVE, "rb") as handle: + response = handle.read(MAX_BODY + 1) + except FileNotFoundError: + self.send_error(404); return + except OSError: + self.send_error(500); return + if len(response) > MAX_BODY: + self.send_error(413); return + self.send_response(200) + self.send_header("Content-Type", "application/json") + self.send_header("Content-Length", str(len(response))) + self.end_headers() + if include_body: + self.wfile.write(response) + + def _private_path(self): + path = unquote(urlsplit(self.path).path) + parts = [part for part in path.split("/") if part] + blocked = {".git", ".agents", ".claude", ".studio-data", "my-progress.backup.json", "my-progress.json.tmp"} + return any(part.startswith(".") or part in blocked or part.endswith(".tmp") for part in parts) + def _authorized(self): token = getattr(self.server, "access_token", None) if not token: @@ -44,38 +157,59 @@ def _authorized(self): return False def do_GET(self): + if not self._host_allowed(): + self.send_error(403); return if not self._authorized(): self.send_error(403); return + path = urlsplit(self.path).path + if path == "/my-progress.json": + self._send_progress(); return + if path == "/__health": + response = b'{"save":true}' + self.send_response(200) + self.send_header("Content-Type", "application/json") + self.send_header("Content-Length", str(len(response))) + self.end_headers() + self.wfile.write(response) + return + if self._private_path(): + self.send_error(404); return super().do_GET() def do_HEAD(self): + if not self._host_allowed(): + self.send_error(403); return if not self._authorized(): self.send_error(403); return + if urlsplit(self.path).path == "/my-progress.json": + self._send_progress(include_body=False); return + if self._private_path(): + self.send_error(404); return super().do_HEAD() def do_POST(self): + if not self._host_allowed() or not self._origin_allowed(): + self.send_error(403); return if not self._authorized(): self.send_error(403); return if self.path.split("?")[0] != "/__save": self.send_error(404); return try: n = int(self.headers.get("Content-Length", 0)) - if not 0 < n <= 2_000_000: + if not 0 < n <= MAX_BODY: self.send_error(413); return + if self.headers.get_content_type() != "application/json": + self.send_error(415); return data = json.loads(self.rfile.read(n)) - if not (isinstance(data.get("ts"), (int, float)) and isinstance(data.get("data"), dict)): + if not validate_progress(data): self.send_error(400); return - # keep the previous save as a one-step backup, write atomically - if os.path.exists(SAVE): - os.replace(SAVE, BAK) - tmp = SAVE + ".tmp" - with open(tmp, "w") as f: - json.dump(data, f, indent=1) - os.replace(tmp, SAVE) + stored, timestamp = write_progress(data) + response = json.dumps({"ok": True, "stored": stored, "ts": timestamp}).encode() self.send_response(200) self.send_header("Content-Type", "application/json") + self.send_header("Content-Length", str(len(response))) self.end_headers() - self.wfile.write(b'{"ok":true}') + self.wfile.write(response) except Exception: self.send_error(400) @@ -87,11 +221,15 @@ def end_headers(self): ) self.send_header("Referrer-Policy", "no-referrer") self.send_header("X-Content-Type-Options", "nosniff") - # Local study pages change frequently; embedded previews must not keep - # a stale script after a repair or progress migration. + # Revalidate course files instead of downloading every asset again on + # every page. Progress stays private and is never cached. path = self.path.split("?")[0] - if path.endswith((".html", ".js", ".css", ".json")): + if path in {"/my-progress.json", "/my-progress.backup.json", "/__save", "/__health"}: self.send_header("Cache-Control", "no-store") + elif path.endswith((".html", ".js", ".css", ".json")): + self.send_header("Cache-Control", "no-cache") + elif path.endswith((".woff", ".woff2", ".png", ".jpg", ".jpeg", ".webp", ".gif", ".mp3", ".wav")): + self.send_header("Cache-Control", "public, max-age=3600") SimpleHTTPRequestHandler.end_headers(self) def log_message(self, *args): @@ -111,4 +249,5 @@ def log_message(self, *args): ) server = ThreadingHTTPServer((host, port), Handler) server.access_token = access_token + server.allowed_hosts = {"localhost", "127.0.0.1", "::1", host.lower(), display_host.lower()} server.serve_forever() diff --git a/studio/curriculum-baseline.json b/studio/curriculum-baseline.json new file mode 100644 index 0000000..5e9c221 --- /dev/null +++ b/studio/curriculum-baseline.json @@ -0,0 +1,10 @@ +{ + "capturedFrom": "1d603bc04a7ee75e97f5651941d1ce417bd7a9ff", + "purpose": "Protect curriculum facts, quiz answers, required builds, and flashcard ordering during the Studio rebuild.", + "sha256": { + "course-data.js": "a46b1df0f77900ef32ca3e1da7bf03d541da4dfb0dff4e1bf115dfdd1f4e0d72", + "quizzes.js": "73cedee78ef982959dbe0e63379ef5e2e75741f400608ccba0e1a296931a7029", + "exercise-library.js": "5c661fcf67f3a2adbbe4a4f0b374e345938ccdb1570a325020fcb7a87f494c26", + "flashcards.js": "adcc5edf53b1a15f901ac42cfccdd1490a16815f0797b3c0ec90cae7cbbd937d" + } +} diff --git a/studio/index.html b/studio/index.html new file mode 100644 index 0000000..99c1f8d --- /dev/null +++ b/studio/index.html @@ -0,0 +1,15 @@ + + + + + + + + CCA-F Study Studio + + + +
      + + + diff --git a/studio/src/App.tsx b/studio/src/App.tsx new file mode 100644 index 0000000..7e4d2c3 --- /dev/null +++ b/studio/src/App.tsx @@ -0,0 +1,30 @@ +import { Navigate, Route, Routes } from "react-router-dom"; +import { AppShell } from "./components/organisms/AppShell"; +import { ArchivePage } from "./pages/ArchivePage"; +import { ComponentGalleryPage } from "./pages/ComponentGalleryPage"; +import { CoursePage } from "./pages/CoursePage"; +import { FrontierInboxPage } from "./pages/FrontierInboxPage"; +import { HomePage } from "./pages/HomePage"; +import { LibraryPage } from "./pages/LibraryPage"; +import { ReviewHubPage } from "./pages/ReviewHubPage"; +import { SessionPage } from "./pages/SessionPage"; +import { SettingsPage } from "./pages/SettingsPage"; + +export function App() { + return ( + + }> + } /> + } /> + } /> + } /> + } /> + } /> + } /> + } /> + } /> + } /> + + + ); +} diff --git a/studio/src/StudioContext.tsx b/studio/src/StudioContext.tsx new file mode 100644 index 0000000..e532586 --- /dev/null +++ b/studio/src/StudioContext.tsx @@ -0,0 +1,294 @@ +import { createContext, useCallback, useContext, useEffect, useMemo, useRef, useState } from "react"; +import { ApiRequestError, askTutor, cancelTutor, fetchCurrentSession, initializeApi, prepareFrontierReview, rateReviewCard as persistReviewCard, recordContentGap, submitAttempt } from "./api"; +import type { OllamaState } from "./api"; +import type { AttemptResponse, Feedback, ReviewCard, ReviewRating, ReviewRatingResponse, SessionState, StageId, TutorResult } from "./types"; + +interface StudioContextValue { + session: SessionState | null; + loading: boolean; + startupError: string | null; + saving: boolean; + demo: boolean; + ollamaAvailable: boolean; + ollama: OllamaState; + feedback: Feedback | null; + tutorResult: TutorResult | null; + tutorState: "off" | "waking" | "thinking" | "ready" | "error"; + completeStage: (stage: StageId, payload: Record, confidence?: string) => Promise; + rateReviewCard: (reviewId: string, cardId: string, rating: ReviewRating, elapsedMs: number, ratingId: string, queue: ReviewCard[]) => Promise; + getTutorHelp: (mode: "hint" | "simplify" | "classify", learnerText?: string) => Promise; + closeTutor: () => void; + reportGap: () => Promise; + clearFeedback: () => void; + refreshSession: () => Promise; + prepareReview: () => Promise<{ prepared: boolean; reviewId?: string; demo?: boolean }>; +} + +const StudioContext = createContext(null); + +export function StudioProvider({ children }: { children: React.ReactNode }) { + const [session, setSession] = useState(null); + const [loading, setLoading] = useState(true); + const [startupError, setStartupError] = useState(null); + const [saving, setSaving] = useState(false); + const [demo, setDemo] = useState(false); + const [ollamaAvailable, setOllamaAvailable] = useState(false); + const [ollama, setOllama] = useState({ available: false, status: "unavailable" }); + const [feedback, setFeedback] = useState(null); + const [tutorResult, setTutorResult] = useState(null); + const [tutorState, setTutorState] = useState("off"); + const activeTutor = useRef<{ turnId: string; controller: AbortController } | null>(null); + const savingRef = useRef(false); + const pendingAttempt = useRef<{ key: string; attemptId: string } | null>(null); + + useEffect(() => { + document.documentElement.dataset.largeText = localStorage.getItem("ccaf-studio-large-text") === "on" ? "true" : "false"; + document.documentElement.dataset.quietMotion = localStorage.getItem("ccaf-studio-quiet-motion") === "on" ? "true" : "false"; + let active = true; + initializeApi() + .then((value) => { + if (!active) return; + setSession(value.session); + setDemo(value.demo); + setOllamaAvailable(value.ollama.available); + setOllama(value.ollama); + setLoading(false); + }) + .catch(() => { + if (!active) return; + setStartupError("Your saved progress could not be loaded. Nothing was changed. Restart Study Studio, then try again."); + setLoading(false); + }); + return () => { active = false; }; + }, []); + + useEffect(() => () => { + activeTutor.current?.controller.abort(); + window.speechSynthesis?.cancel(); + }, []); + + const completeStage = useCallback(async (stage: StageId, payload: Record, confidence?: string) => { + if (!session) throw new Error("Session is not ready."); + if (savingRef.current) return null; + const key = JSON.stringify({ stage, payload, confidence, stateVersion: session.stateVersion, manifestHash: session.manifestHash }); + const attemptId = pendingAttempt.current?.key === key ? pendingAttempt.current.attemptId : crypto.randomUUID(); + pendingAttempt.current = { key, attemptId }; + savingRef.current = true; + setSaving(true); + try { + const response = await submitAttempt(session, stage, payload, confidence, attemptId); + pendingAttempt.current = null; + setSession(response.session); + setFeedback(response.feedback); + return response; + } catch (error) { + if (error instanceof ApiRequestError && error.status === 401) { + setFeedback({ + tone: "repair", + title: "Study Studio restarted", + message: "Reload this page to reconnect, then try again. Your work is still on this screen.", + nextAction: stage + }); + } else if (error instanceof ApiRequestError && error.status === 409) { + setFeedback({ + tone: "repair", + title: "Not saved — this page is out of date", + message: `${error.message} Your work is still on this screen.`, + nextAction: stage + }); + try { + setSession(await fetchCurrentSession()); + } catch { + // The conflict message above already tells the learner to reload. + } + } else { + setFeedback({ + tone: "repair", + title: "Not saved yet", + message: "Your work is still on this screen. Study Studio checked its saved receipt before offering another try.", + nextAction: stage + }); + } + return null; + } finally { + savingRef.current = false; + setSaving(false); + } + }, [session]); + + const rateReviewCard = useCallback(async (reviewId: string, cardId: string, rating: ReviewRating, elapsedMs: number, ratingId: string, queue: ReviewCard[]) => { + if (!session || savingRef.current) return null; + savingRef.current = true; + setSaving(true); + try { + const response = await persistReviewCard(session, reviewId, cardId, rating, elapsedMs, ratingId, queue); + setSession(response.session); + setFeedback(response.feedback); + return response; + } catch (error) { + if (error instanceof ApiRequestError && error.status === 401) { + setFeedback({ + tone: "repair", + title: "Study Studio restarted", + message: "Reload this page to reconnect, then rate the card again.", + nextAction: "review" + }); + } else if (error instanceof ApiRequestError && error.status === 409) { + setFeedback({ + tone: "repair", + title: "Rating not saved — this page is out of date", + message: `${error.message} Your selected rating is still ready to retry.`, + nextAction: "review" + }); + try { + setSession(await fetchCurrentSession()); + } catch { + // The conflict message above already tells the learner to reload. + } + } else { + setFeedback({ + tone: "repair", + title: "Rating not saved yet", + message: "Your selected rating is still ready to retry.", + nextAction: "review" + }); + } + return null; + } finally { + savingRef.current = false; + setSaving(false); + } + }, [session]); + + const getTutorHelp = useCallback(async (mode: "hint" | "simplify" | "classify", learnerText = "") => { + if (!session) return; + setTutorResult(null); + const localTutorEnabled = localStorage.getItem("ccaf-studio-local-ai") !== "off"; + if (!localTutorEnabled || !ollamaAvailable) { + setTutorResult({ + advisory: true, + summary: mode === "simplify" ? "A folder holds things. A file is one saved thing. A path is the route to it." : "Start at the final dot: the extension tells you the file type. Then trace the folders before it.", + nextNudge: "Which part of /Users/me/study/card.json is the file?", + sourceIds: ["course:w1"], + uncertain: false, + fallback: true + }); + setTutorState("ready"); + return; + } + const turnId = crypto.randomUUID(); + const controller = new AbortController(); + activeTutor.current = { turnId, controller }; + setTutorState("waking"); + try { + await new Promise((resolve, reject) => { + const timer = window.setTimeout(resolve, 120); + controller.signal.addEventListener("abort", () => { + window.clearTimeout(timer); + reject(new DOMException("Tutor request stopped", "AbortError")); + }, { once: true }); + }); + if (activeTutor.current?.turnId !== turnId) return; + setTutorState("thinking"); + const result = await askTutor(session.unitId, `${session.unitId}:${session.stage}`, mode, learnerText, turnId, controller.signal); + if (activeTutor.current?.turnId !== turnId) return; + setTutorResult(result); + setTutorState("ready"); + } catch (error) { + if (error instanceof DOMException && error.name === "AbortError") return; + setTutorResult({ + advisory: true, + summary: "The local tutor could not start, so the lesson is using its saved hint.", + nextNudge: "Follow the folder names from left to right, then identify the final file name.", + sourceIds: ["course:w1"], + uncertain: false, + fallback: true + }); + setTutorState("error"); + } finally { + if (activeTutor.current?.turnId === turnId) activeTutor.current = null; + } + }, [session, ollamaAvailable]); + + const closeTutor = useCallback(() => { + const active = activeTutor.current; + if (active) { + active.controller.abort(); + void cancelTutor(active.turnId).catch(() => undefined); + activeTutor.current = null; + } + window.speechSynthesis?.cancel(); + setTutorResult(null); + setTutorState("off"); + }, []); + + const reportGap = useCallback(async () => { + if (!session) return; + try { + await recordContentGap(session.unitId, `${session.unitId}:${session.stage}`, `I have not learned the prerequisite for the ${session.stage} stage yet.`); + setFeedback({ + tone: "info", + title: "Knowledge gap recorded", + message: "This did not count against you. It is waiting for course review.", + nextAction: session.stage + }); + } catch { + setFeedback({ + tone: "repair", + title: "Gap not recorded yet", + message: "Your note stayed private on this screen. Restart Study Studio and try again.", + nextAction: session.stage + }); + } + }, [session]); + + const prepareReview = useCallback(async () => { + try { + return await prepareFrontierReview(); + } catch { + setFeedback({ + tone: "repair", + title: "Review packet not prepared", + message: "Study Studio could not reach the local server. No progress changed.", + nextAction: session?.stage + }); + return { prepared: false }; + } + }, [session?.stage]); + + const refreshSession = useCallback(async () => { + const nextSession = await fetchCurrentSession(); + setSession(nextSession); + }, []); + + const clearFeedback = useCallback(() => setFeedback(null), []); + + const value = useMemo(() => ({ + session, + loading, + startupError, + saving, + demo, + ollamaAvailable, + ollama, + feedback, + tutorResult, + tutorState, + completeStage, + rateReviewCard, + getTutorHelp, + closeTutor, + reportGap, + clearFeedback, + prepareReview, + refreshSession + }), [session, loading, startupError, saving, demo, ollamaAvailable, ollama, feedback, tutorResult, tutorState, completeStage, rateReviewCard, getTutorHelp, closeTutor, reportGap, clearFeedback, prepareReview, refreshSession]); + + return {children}; +} + +export function useStudio() { + const value = useContext(StudioContext); + if (!value) throw new Error("useStudio must be used within StudioProvider"); + return value; +} diff --git a/studio/src/api.preview.ts b/studio/src/api.preview.ts new file mode 100644 index 0000000..f08be12 --- /dev/null +++ b/studio/src/api.preview.ts @@ -0,0 +1,145 @@ +import { buildStages, demoSession } from "./content"; +import type { + AttemptResponse, + BackupInspection, + FrontierInboxDetail, + FrontierInboxItem, + ReviewCard, + ReviewRating, + ReviewRatingResponse, + SessionState, + StageId, + TutorResult +} from "./types"; + +export interface OllamaState { + available: boolean; + status: "ready" | "protected" | "unavailable"; + reason?: string | null; +} + +const stageIds: StageId[] = ["learn", "draw", "build", "teach", "quiz", "review"]; + +export async function fetchCurrentSession(): Promise { + return demoSession(); +} + +export async function initializeApi() { + return { + session: demoSession(), + demo: true, + ollama: { available: false, status: "unavailable" as const, reason: "AI is disabled in preview mode." } + }; +} + +export async function submitAttempt( + session: SessionState, + _stage: StageId, + _payload: Record, + _confidence?: string, + attemptId: string = crypto.randomUUID() +): Promise { + const nextIndex = Math.min(session.stageIndex + 1, stageIds.length - 1); + const completed = session.stageIndex === stageIds.length - 1; + const nextSession: SessionState = { + ...session, + stageIndex: nextIndex, + stage: completed ? "review" : stageIds[nextIndex], + stages: buildStages(completed ? stageIds.length : nextIndex), + progressPercent: completed ? 100 : Math.round((nextIndex / stageIds.length) * 100), + mastery: completed ? "mastered" : "practiced", + stateVersion: session.stateVersion + 1 + }; + return { + session: nextSession, + feedback: { + tone: "success", + title: completed ? "Preview lesson complete" : "Preview step complete", + message: "This preview action is temporary. Progress is not saved." + }, + attemptId, + stateVersion: nextSession.stateVersion, + manifestHash: nextSession.manifestHash + }; +} + +export async function askTutor( + _unitId: string, + _activityId: string, + mode: "hint" | "simplify" | "classify", + _learnerText = "", + _turnId?: string, + _signal?: AbortSignal +): Promise { + return { + advisory: true, + summary: mode === "simplify" + ? "A folder holds things. A file is one saved thing. A path is the route to it." + : "Start at the final dot: the extension tells you the file type. Then trace the folders before it.", + nextNudge: "Which part of /Users/me/study/card.json is the file?", + sourceIds: ["course:w1"], + uncertain: false, + fallback: true + }; +} + +export async function cancelTutor(_turnId: string): Promise {} + +export async function fetchPendingReview(): Promise { + return null; +} + +export async function rateReviewCard( + session: SessionState, + reviewId: string, + cardId: string, + rating: ReviewRating, + _elapsedMs: number, + ratingId: string, + demoQueue: ReviewCard[] = [] +): Promise { + const card = demoQueue.find((item) => item.id === cardId); + const queue = demoQueue.filter((item) => item.id !== cardId); + if (rating === "again" && card) queue.push({ ...card, repetitions: (card.repetitions ?? 0) + 1 }); + const reviewComplete = queue.length === 0; + const nextSession = reviewComplete ? { + ...session, + stages: buildStages(6), + progressPercent: 100, + mastery: "mastered" as const, + stateVersion: session.stateVersion + 1 + } : session; + return { + ratingId, + reviewId, + cardId, + rating, + repeat: rating === "again", + reviewComplete, + remaining: queue.length, + queue, + session: nextSession, + feedback: { + tone: "success", + title: reviewComplete ? "Preview review complete" : "Preview rating complete", + message: "This preview action is temporary. Progress is not saved." + }, + stateVersion: nextSession.stateVersion + }; +} + +function localOnly(): never { + throw new Error("This control is available only in local Study Studio."); +} + +export async function downloadBackup(): Promise<{ blob: Blob; filename: string }> { return localOnly(); } +export async function inspectBackup(_file: File): Promise { return localOnly(); } +export async function commitBackup(_token: string): Promise<{ imported: boolean; databaseId: string; stateDigest: string }> { return localOnly(); } +export async function fetchMigrationReport(): Promise { return localOnly(); } +export async function commitLegacyImport(_hash: string): Promise<{ imported: boolean; changed: boolean; session: SessionState }> { return localOnly(); } +export async function fetchFrontierInbox(): Promise { return localOnly(); } +export async function fetchFrontierInboxDetail(_id: string): Promise { return localOnly(); } +export async function decideProposal(_id: string, _decision: "accepted" | "rejected"): Promise { return localOnly(); } +export async function recordContentGap(_unitId: string, _activityId: string, _note: string): Promise {} +export async function prepareFrontierReview() { return { prepared: false, demo: true }; } +export function isDemoMode() { return true; } diff --git a/studio/src/api.test.ts b/studio/src/api.test.ts new file mode 100644 index 0000000..27983c9 --- /dev/null +++ b/studio/src/api.test.ts @@ -0,0 +1,71 @@ +import { afterEach, beforeEach, describe, expect, it, vi } from "vitest"; + +const setUrl = (url: string) => { + (window as typeof window & { happyDOM: { setURL: (value: string) => void } }).happyDOM.setURL(url); +}; + +describe("API initialization", () => { + beforeEach(() => { + vi.resetModules(); + vi.stubGlobal("fetch", vi.fn().mockRejectedValue(new TypeError("server unavailable"))); + }); + + afterEach(() => { + vi.unstubAllGlobals(); + vi.unstubAllEnvs(); + }); + + it("does not disguise a local startup failure as unsaved demo mode", async () => { + setUrl("http://localhost:8765/"); + const { initializeApi } = await import("./api"); + await expect(initializeApi()).rejects.toThrow("server unavailable"); + }); + + it("keeps the static public course preview available without an API", async () => { + setUrl("https://course.example/"); + vi.stubEnv("VITE_CCAF_PUBLIC_PREVIEW", "true"); + const { initializeApi } = await import("./api"); + const result = await initializeApi(); + expect(result.demo).toBe(true); + expect(result.session.progressPercent).toBe(0); + const attempt = await (await import("./api")).submitAttempt(result.session, "learn", { understoodPath: true }); + expect(attempt.feedback.message).toMatch(/not saved/i); + }); + + it("reconciles a timed-out attempt with its saved receipt before retrying", async () => { + const attemptId = "11111111-1111-4111-8111-111111111111"; + const session = { + unitId: "w1", + title: "Files, folders, and plain text", + stage: "learn" as const, + stageIndex: 0, + stages: [], + progressPercent: 0, + dueReviews: 0, + weeklyTopThree: [], + legacyImported: false, + stateVersion: 4, + manifestHash: "a".repeat(64) + }; + const receipt = { + session, + feedback: { tone: "success" as const, title: "Saved", message: "Recorded" }, + attemptId, + stateVersion: 5, + manifestHash: "a".repeat(64) + }; + const fetch = vi.fn() + .mockRejectedValueOnce(new DOMException("timed out", "AbortError")) + .mockResolvedValueOnce({ ok: true, json: async () => receipt }); + vi.stubGlobal("fetch", fetch); + const { submitAttempt } = await import("./api"); + + await expect(submitAttempt(session, "learn", { understoodPath: true }, undefined, attemptId)).resolves.toEqual(receipt); + expect(JSON.parse(fetch.mock.calls[0][1].body)).toMatchObject({ + attemptId, + clientStateVersion: 4, + manifestHash: "a".repeat(64) + }); + expect(fetch.mock.calls[1][0]).toBe(`/api/attempts/${attemptId}`); + }); +}); diff --git a/studio/src/api.ts b/studio/src/api.ts new file mode 100644 index 0000000..e6dc815 --- /dev/null +++ b/studio/src/api.ts @@ -0,0 +1,308 @@ +import { buildStages, demoSession } from "./content"; +import { PUBLIC_PREVIEW } from "./preview"; +import type { AttemptResponse, BackupInspection, FrontierInboxDetail, FrontierInboxItem, MigrationReport, ReviewCard, ReviewRating, ReviewRatingResponse, SessionState, StageId, TutorResult } from "./types"; + +let instanceToken = ""; +let demoMode = false; +export interface OllamaState { + available: boolean; + status: "ready" | "protected" | "unavailable"; + reason?: string | null; +} + +let initialization: Promise<{ session: SessionState; demo: boolean; ollama: OllamaState }> | null = null; + +export class ApiRequestError extends Error { + constructor(readonly status: number, message: string) { + super(message); + } +} + +async function request(path: string, init: RequestInit = {}): Promise { + const response = await requestResponse(path, init); + return response.json() as Promise; +} + +async function requestResponse(path: string, init: RequestInit = {}): Promise { + const headers = new Headers(init.headers); + if (init.body && !headers.has("Content-Type")) headers.set("Content-Type", "application/json"); + if (instanceToken) headers.set("X-CCA-Instance", instanceToken); + const controller = new AbortController(); + const timeout = window.setTimeout(() => controller.abort(), path === "/api/tutor/turn" ? 46_000 : 10_000); + const forwardAbort = () => controller.abort(init.signal?.reason); + init.signal?.addEventListener("abort", forwardAbort, { once: true }); + try { + const response = await fetch(path, { ...init, headers, signal: controller.signal }); + if (!response.ok) { + let detail = ""; + try { + const body = (await response.json()) as { detail?: unknown }; + if (typeof body.detail === "string") detail = body.detail; + } catch { + // Non-JSON error bodies fall back to the status line. + } + throw new ApiRequestError(response.status, detail || `${response.status} ${response.statusText}`); + } + return response; + } finally { + window.clearTimeout(timeout); + init.signal?.removeEventListener("abort", forwardAbort); + } +} + +export async function fetchCurrentSession(): Promise { + if (demoMode) return demoSession(); + return request("/api/session/current"); +} + +export async function initializeApi(): Promise<{ session: SessionState; demo: boolean; ollama: OllamaState }> { + if (!initialization) { + initialization = (async () => { + demoMode = PUBLIC_PREVIEW; + if (demoMode) { + return { session: demoSession(), demo: true, ollama: { available: false, status: "unavailable", reason: "AI is disabled in preview mode." } }; + } + try { + const bootstrap = await request<{ instanceToken: string; ollama?: OllamaState }>("/api/bootstrap"); + instanceToken = bootstrap.instanceToken; + const session = await request("/api/session/current"); + return { + session, + demo: false, + ollama: bootstrap.ollama ?? { available: false, status: "unavailable", reason: "Ollama status was not returned." } + }; + } catch (error) { + instanceToken = ""; + throw error; + } + })(); + } + return initialization; +} + +export async function submitAttempt( + session: SessionState, + stage: StageId, + payload: Record, + confidence?: string, + attemptId: string = crypto.randomUUID() +): Promise { + if (!demoMode) { + try { + return await request("/api/attempts", { + method: "POST", + body: JSON.stringify({ + unitId: session.unitId, + stage, + confidence, + payload, + attemptId, + clientStateVersion: session.stateVersion, + manifestHash: session.manifestHash + }) + }); + } catch (error) { + if (!isAmbiguousRequestFailure(error)) throw error; + try { + const receipt = await fetchAttemptReceipt(attemptId); + if (receipt) return receipt; + } catch { + // The original error is more useful if receipt reconciliation also cannot reach the server. + } + throw error; + } + } + + const nextIndex = Math.min(session.stageIndex + 1, 5); + const isDone = session.stageIndex === 5; + const next = { + ...session, + stageIndex: nextIndex, + stage: (isDone ? "review" : ["learn", "draw", "build", "teach", "quiz", "review"][nextIndex]) as StageId, + stages: buildStages(nextIndex), + progressPercent: isDone ? 100 : Math.round((nextIndex / 6) * 100), + mastery: isDone ? "mastered" as const : "practiced" as const, + stateVersion: session.stateVersion + 1 + }; + return { + session: next, + feedback: { + tone: "success", + title: isDone ? "W1 complete" : "Preview step complete", + message: isDone ? "Your preview lesson is complete. Progress is not saved." : "This preview action is temporary. Progress is not saved." + }, + attemptId, + stateVersion: next.stateVersion, + manifestHash: next.manifestHash + }; +} + +function isAmbiguousRequestFailure(error: unknown) { + return error instanceof TypeError || (error instanceof DOMException && error.name === "AbortError"); +} + +export async function fetchAttemptReceipt(attemptId: string): Promise { + try { + return await request(`/api/attempts/${encodeURIComponent(attemptId)}`); + } catch (error) { + if (error instanceof ApiRequestError && error.status === 404) return null; + throw error; + } +} + +export async function askTutor( + unitId: string, + activityId: string, + mode: "hint" | "simplify" | "classify", + learnerText = "", + turnId?: string, + signal?: AbortSignal +): Promise { + if (demoMode) { + return { + advisory: true, + summary: "A path is the route through folders to one item.", + nextNudge: "Start at your home folder, then name each folder you open before the file.", + sourceIds: ["course:w1"], + uncertain: false, + fallback: true + }; + } + return request("/api/tutor/turn", { + method: "POST", + body: JSON.stringify({ unitId, activityId, mode, learnerText, turnId }), + signal + }); +} + +export async function cancelTutor(turnId: string): Promise { + if (demoMode) return; + await request(`/api/tutor/cancel/${encodeURIComponent(turnId)}`, { method: "POST" }); +} + +export async function fetchPendingReview(): Promise<{ reviewId: string; cards: ReviewCard[] } | null> { + if (demoMode) return null; + const response = await request<{ reviews: { id: string; packet?: { cards?: ReviewCard[] } }[] }>("/api/reviews/pending"); + const review = response.reviews.find((item) => Array.isArray(item.packet?.cards) && item.packet.cards.length > 0); + return review ? { reviewId: review.id, cards: review.packet?.cards ?? [] } : null; +} + +export async function rateReviewCard( + session: SessionState, + reviewId: string, + cardId: string, + rating: ReviewRating, + elapsedMs: number, + ratingId: string, + demoQueue: ReviewCard[] = [] +): Promise { + if (!demoMode) { + return request(`/api/reviews/${encodeURIComponent(reviewId)}/cards/${encodeURIComponent(cardId)}`, { + method: "POST", + body: JSON.stringify({ ratingId, rating, elapsedMs }) + }); + } + const card = demoQueue.find((item) => item.id === cardId); + const queue = demoQueue.filter((item) => item.id !== cardId); + if (rating === "again" && card) queue.push({ ...card, repetitions: (card.repetitions ?? 0) + 1 }); + const reviewComplete = queue.length === 0; + const nextSession: SessionState = reviewComplete ? { + ...session, + stages: buildStages(6), + progressPercent: 100, + mastery: "mastered", + stateVersion: session.stateVersion + 1 + } : session; + return { + ratingId, + reviewId, + cardId, + rating, + repeat: rating === "again", + reviewComplete, + remaining: queue.length, + queue, + session: nextSession, + feedback: { + tone: "success", + title: reviewComplete ? "Preview review complete" : rating === "again" ? "Again recorded (preview)" : "Rating recorded (preview)", + message: reviewComplete ? "Your demo review is complete. Progress is not saved." : "Your next review card is ready. Progress is not saved." + }, + stateVersion: nextSession.stateVersion + }; +} + +function requireLocalMode() { + if (demoMode) throw new Error("This control is available only in local mode."); +} + +export async function downloadBackup(): Promise<{ blob: Blob; filename: string }> { + requireLocalMode(); + const response = await requestResponse("/api/backups/export"); + const disposition = response.headers.get("content-disposition") ?? ""; + const filename = disposition.match(/filename=\"?([^\";]+)\"?/)?.[1] ?? "ccaf-study-studio.ccaf-backup"; + return { blob: await response.blob(), filename }; +} + +export async function inspectBackup(file: File): Promise { + requireLocalMode(); + return request("/api/backups/import/inspect", { + method: "POST", + headers: { "Content-Type": "application/octet-stream" }, + body: file + }); +} + +export async function commitBackup(importToken: string): Promise<{ imported: boolean; databaseId: string; stateDigest: string }> { + requireLocalMode(); + return request("/api/backups/import/commit", { method: "POST", body: JSON.stringify({ importToken }) }); +} + +export async function fetchMigrationReport(): Promise { + requireLocalMode(); + return request("/api/migration/report"); +} + +export async function commitLegacyImport(sourceSha256: string): Promise<{ imported: boolean; changed: boolean; session: SessionState }> { + requireLocalMode(); + return request("/api/migration/legacy/commit", { method: "POST", body: JSON.stringify({ sourceSha256 }) }); +} + +export async function fetchFrontierInbox(): Promise { + requireLocalMode(); + const response = await request<{ items: FrontierInboxItem[] }>("/api/frontier/inbox"); + return response.items; +} + +export async function fetchFrontierInboxDetail(proposalId: string): Promise { + requireLocalMode(); + const response = await request<{ item: FrontierInboxDetail }>(`/api/frontier/inbox/${encodeURIComponent(proposalId)}`); + return response.item; +} + +export async function decideProposal(proposalId: string, decision: "accepted" | "rejected") { + requireLocalMode(); + return request<{ proposal: { id: string; status: "accepted" | "rejected"; advisoryOnly: true } }>(`/api/proposals/${encodeURIComponent(proposalId)}/decision`, { + method: "POST", + body: JSON.stringify({ decision }) + }); +} + +export async function recordContentGap(unitId: string, activityId: string, note: string): Promise { + if (demoMode) return; + await request("/api/content-gaps", { + method: "POST", + body: JSON.stringify({ unitId, activityId, note }) + }); +} + +export async function prepareFrontierReview() { + // Frontier Inbox is intentionally not rendered until the backend exposes typed items, + // ownership, timestamps, and read-state semantics rather than only packet preparation. + if (demoMode) return { prepared: false, demo: true }; + return request<{ prepared: boolean; reviewId: string }>("/api/reviews/prepare", { method: "POST" }); +} + +export function isDemoMode() { + return demoMode; +} diff --git a/studio/src/assets/video-thumbnails/7kaJdZ7veDs.jpg b/studio/src/assets/video-thumbnails/7kaJdZ7veDs.jpg new file mode 100644 index 0000000..6171e9c Binary files /dev/null and b/studio/src/assets/video-thumbnails/7kaJdZ7veDs.jpg differ diff --git a/studio/src/assets/video-thumbnails/BXs7QoLQxX0.jpg b/studio/src/assets/video-thumbnails/BXs7QoLQxX0.jpg new file mode 100644 index 0000000..b411807 Binary files /dev/null and b/studio/src/assets/video-thumbnails/BXs7QoLQxX0.jpg differ diff --git a/studio/src/assets/video-thumbnails/CaDaLn7DcQ0.jpg b/studio/src/assets/video-thumbnails/CaDaLn7DcQ0.jpg new file mode 100644 index 0000000..0126f0d Binary files /dev/null and b/studio/src/assets/video-thumbnails/CaDaLn7DcQ0.jpg differ diff --git a/studio/src/assets/video-thumbnails/FbIcU6YFrhw.jpg b/studio/src/assets/video-thumbnails/FbIcU6YFrhw.jpg new file mode 100644 index 0000000..4217c7f Binary files /dev/null and b/studio/src/assets/video-thumbnails/FbIcU6YFrhw.jpg differ diff --git a/studio/src/assets/video-thumbnails/GWCnDhgH840.jpg b/studio/src/assets/video-thumbnails/GWCnDhgH840.jpg new file mode 100644 index 0000000..50541d1 Binary files /dev/null and b/studio/src/assets/video-thumbnails/GWCnDhgH840.jpg differ diff --git a/studio/src/assets/video-thumbnails/HqwULqy1egw.jpg b/studio/src/assets/video-thumbnails/HqwULqy1egw.jpg new file mode 100644 index 0000000..e67734f Binary files /dev/null and b/studio/src/assets/video-thumbnails/HqwULqy1egw.jpg differ diff --git a/studio/src/assets/video-thumbnails/IVUxGTxSuH8.jpg b/studio/src/assets/video-thumbnails/IVUxGTxSuH8.jpg new file mode 100644 index 0000000..16a3721 Binary files /dev/null and b/studio/src/assets/video-thumbnails/IVUxGTxSuH8.jpg differ diff --git a/studio/src/assets/video-thumbnails/JJBcpwpsKzk.jpg b/studio/src/assets/video-thumbnails/JJBcpwpsKzk.jpg new file mode 100644 index 0000000..c91496d Binary files /dev/null and b/studio/src/assets/video-thumbnails/JJBcpwpsKzk.jpg differ diff --git a/studio/src/assets/video-thumbnails/MqnElZw6NYk.jpg b/studio/src/assets/video-thumbnails/MqnElZw6NYk.jpg new file mode 100644 index 0000000..abc47c2 Binary files /dev/null and b/studio/src/assets/video-thumbnails/MqnElZw6NYk.jpg differ diff --git a/studio/src/assets/video-thumbnails/a2N6vKdQUfE.jpg b/studio/src/assets/video-thumbnails/a2N6vKdQUfE.jpg new file mode 100644 index 0000000..1b8953d Binary files /dev/null and b/studio/src/assets/video-thumbnails/a2N6vKdQUfE.jpg differ diff --git a/studio/src/assets/video-thumbnails/e7ijjK173zI.jpg b/studio/src/assets/video-thumbnails/e7ijjK173zI.jpg new file mode 100644 index 0000000..6b7d61f Binary files /dev/null and b/studio/src/assets/video-thumbnails/e7ijjK173zI.jpg differ diff --git a/studio/src/assets/video-thumbnails/eZj6FtTVV58.jpg b/studio/src/assets/video-thumbnails/eZj6FtTVV58.jpg new file mode 100644 index 0000000..b2bb095 Binary files /dev/null and b/studio/src/assets/video-thumbnails/eZj6FtTVV58.jpg differ diff --git a/studio/src/assets/video-thumbnails/eh-xxQpfBBY.jpg b/studio/src/assets/video-thumbnails/eh-xxQpfBBY.jpg new file mode 100644 index 0000000..5d1a613 Binary files /dev/null and b/studio/src/assets/video-thumbnails/eh-xxQpfBBY.jpg differ diff --git a/studio/src/assets/video-thumbnails/ejPWvBcc_DU.jpg b/studio/src/assets/video-thumbnails/ejPWvBcc_DU.jpg new file mode 100644 index 0000000..6a0819e Binary files /dev/null and b/studio/src/assets/video-thumbnails/ejPWvBcc_DU.jpg differ diff --git a/studio/src/assets/video-thumbnails/ldqOnljDINc.jpg b/studio/src/assets/video-thumbnails/ldqOnljDINc.jpg new file mode 100644 index 0000000..07670bf Binary files /dev/null and b/studio/src/assets/video-thumbnails/ldqOnljDINc.jpg differ diff --git a/studio/src/assets/video-thumbnails/q-n1cut5e7c.jpg b/studio/src/assets/video-thumbnails/q-n1cut5e7c.jpg new file mode 100644 index 0000000..d4e9b6a Binary files /dev/null and b/studio/src/assets/video-thumbnails/q-n1cut5e7c.jpg differ diff --git a/studio/src/assets/video-thumbnails/qIee1aqSAwY.jpg b/studio/src/assets/video-thumbnails/qIee1aqSAwY.jpg new file mode 100644 index 0000000..1558abb Binary files /dev/null and b/studio/src/assets/video-thumbnails/qIee1aqSAwY.jpg differ diff --git a/studio/src/assets/video-thumbnails/s1j1vTnCKns.jpg b/studio/src/assets/video-thumbnails/s1j1vTnCKns.jpg new file mode 100644 index 0000000..29b1b55 Binary files /dev/null and b/studio/src/assets/video-thumbnails/s1j1vTnCKns.jpg differ diff --git a/studio/src/assets/video-thumbnails/tsIxzFg76Nw.jpg b/studio/src/assets/video-thumbnails/tsIxzFg76Nw.jpg new file mode 100644 index 0000000..a342ee0 Binary files /dev/null and b/studio/src/assets/video-thumbnails/tsIxzFg76Nw.jpg differ diff --git a/studio/src/assets/video-thumbnails/v3tMqTmgg2Q.jpg b/studio/src/assets/video-thumbnails/v3tMqTmgg2Q.jpg new file mode 100644 index 0000000..2bb9c45 Binary files /dev/null and b/studio/src/assets/video-thumbnails/v3tMqTmgg2Q.jpg differ diff --git a/studio/src/components/atoms/Button.tsx b/studio/src/components/atoms/Button.tsx new file mode 100644 index 0000000..cd44621 --- /dev/null +++ b/studio/src/components/atoms/Button.tsx @@ -0,0 +1,19 @@ +import type { ButtonHTMLAttributes, ReactNode } from "react"; + +type ButtonKind = "primary" | "secondary" | "quiet" | "danger"; + +export function Button({ + kind = "secondary", + icon, + className = "", + type = "button", + children, + ...props +}: ButtonHTMLAttributes & { kind?: ButtonKind; icon?: ReactNode }) { + return ( + + ); +} diff --git a/studio/src/components/molecules/FeedbackBanner.tsx b/studio/src/components/molecules/FeedbackBanner.tsx new file mode 100644 index 0000000..f71ffd8 --- /dev/null +++ b/studio/src/components/molecules/FeedbackBanner.tsx @@ -0,0 +1,15 @@ +import { CheckCircle2, Info, RotateCcw, X } from "../../icons"; +import { useStudio } from "../../StudioContext"; + +export function FeedbackBanner() { + const { feedback, clearFeedback } = useStudio(); + if (!feedback) return null; + const Icon = feedback.tone === "success" ? CheckCircle2 : feedback.tone === "repair" ? RotateCcw : Info; + return ( +
      +
      + ); +} diff --git a/studio/src/components/molecules/ProgressRail.test.tsx b/studio/src/components/molecules/ProgressRail.test.tsx new file mode 100644 index 0000000..9e4da2e --- /dev/null +++ b/studio/src/components/molecules/ProgressRail.test.tsx @@ -0,0 +1,13 @@ +import { render, screen } from "@testing-library/react"; +import { describe, expect, it } from "vitest"; +import { buildStages } from "../../content"; +import { ProgressRail } from "./ProgressRail"; + +describe("ProgressRail", () => { + it("announces progress and the one current stage", () => { + render(); + expect(screen.getByRole("progressbar", { name: "Lesson completion" })).toHaveAttribute("aria-valuenow", "33"); + expect(screen.getByText("Build").closest("li")).toHaveAttribute("aria-current", "step"); + expect(screen.getAllByRole("listitem")).toHaveLength(6); + }); +}); diff --git a/studio/src/components/molecules/ProgressRail.tsx b/studio/src/components/molecules/ProgressRail.tsx new file mode 100644 index 0000000..fadaeb3 --- /dev/null +++ b/studio/src/components/molecules/ProgressRail.tsx @@ -0,0 +1,26 @@ +import { Check, Circle } from "../../icons"; +import type { StageState } from "../../types"; + +export function ProgressRail({ stages, percent }: { stages: StageState[]; percent: number }) { + return ( +
      +
      + Current lesson + {percent}% complete +
      +
      + +
      +
        + {stages.map((stage) => ( +
      1. + + {stage.label} +
        2. + ))} +
      +
      + ); +} diff --git a/studio/src/components/organisms/AppShell.tsx b/studio/src/components/organisms/AppShell.tsx new file mode 100644 index 0000000..a290187 --- /dev/null +++ b/studio/src/components/organisms/AppShell.tsx @@ -0,0 +1,88 @@ +import { + BookOpen, + CircleAlert, + ChevronLeft, + ChevronRight, + GraduationCap, + Home, + Inbox, + Library, + PanelLeftClose, + PanelLeftOpen, + RotateCcw, + Settings +} from "../../icons"; +import { useEffect, useState } from "react"; +import { NavLink, Outlet, useLocation } from "react-router-dom"; +import { useStudio } from "../../StudioContext"; +import { PREVIEW_NOTICE, PUBLIC_PREVIEW } from "../../preview"; +import { Button } from "../atoms/Button"; + +const links = [ + { to: "/", label: "Home", icon: Home }, + { to: "/course", label: "Course", icon: GraduationCap }, + { to: "/review", label: "Review", icon: RotateCcw }, + { to: "/library", label: "Library", icon: Library }, + { to: "/settings", label: "Settings", icon: Settings } +]; + +export function AppShell() { + const [collapsed, setCollapsed] = useState(false); + const { session, demo, startupError, clearFeedback } = useStudio(); + const location = useLocation(); + const localMode = !demo && !PUBLIC_PREVIEW; + + useEffect(() => { + clearFeedback(); + window.scrollTo({ top: 0, left: 0, behavior: "auto" }); + document.getElementById("studio-main")?.focus({ preventScroll: true }); + }, [clearFeedback, location.pathname]); + return ( +
      + +
      +
      +
      + + +
      +
      + {session?.title ?? "Loading your lesson"} + {session ? session.mastery === "mastered" ? session.dueReviews > 0 ? "Review due" : "Complete" : `${session.stages[session.stageIndex]?.label ?? "Course"} stage` : ""} +
      + {demo ? AI-disabled preview : Legacy tutor} +
      + {PUBLIC_PREVIEW ?
      {PREVIEW_NOTICE}
      : null} +
      + {startupError ? ( +
      +
      + ) : } +
      +
      +
      + ); +} diff --git a/studio/src/components/organisms/CodeEditor.tsx b/studio/src/components/organisms/CodeEditor.tsx new file mode 100644 index 0000000..1573c72 --- /dev/null +++ b/studio/src/components/organisms/CodeEditor.tsx @@ -0,0 +1,49 @@ +import { json } from "@codemirror/lang-json"; +import { EditorState } from "@codemirror/state"; +import { EditorView, keymap } from "@codemirror/view"; +import { defaultKeymap, history, historyKeymap } from "@codemirror/commands"; +import { useEffect, useRef } from "react"; + +export function CodeEditor({ value, onChange, label }: { value: string; onChange: (value: string) => void; label: string }) { + const host = useRef(null); + const viewRef = useRef(null); + const changeRef = useRef(onChange); + changeRef.current = onChange; + + useEffect(() => { + if (!host.current) return; + const state = EditorState.create({ + doc: value, + extensions: [ + history(), + keymap.of([...defaultKeymap, ...historyKeymap]), + json(), + EditorView.lineWrapping, + EditorView.contentAttributes.of({ "aria-label": label }), + EditorView.theme({ + "&": { minHeight: "220px", fontSize: "18px" }, + ".cm-content": { padding: "18px", fontFamily: "ui-monospace, SFMono-Regular, Menlo, monospace" }, + ".cm-scroller": { lineHeight: "1.6" }, + "&.cm-focused": { outline: "4px solid #f2b544", outlineOffset: "3px" } + }), + EditorView.updateListener.of((update) => { + if (update.docChanged) changeRef.current(update.state.doc.toString()); + }) + ] + }); + const view = new EditorView({ state, parent: host.current }); + viewRef.current = view; + return () => { + viewRef.current = null; + view.destroy(); + }; + }, [label]); + + useEffect(() => { + const view = viewRef.current; + if (!view || view.state.doc.toString() === value) return; + view.dispatch({ changes: { from: 0, to: view.state.doc.length, insert: value } }); + }, [value]); + + return
      ; +} diff --git a/studio/src/components/organisms/TutorDrawer.tsx b/studio/src/components/organisms/TutorDrawer.tsx new file mode 100644 index 0000000..4acb76b --- /dev/null +++ b/studio/src/components/organisms/TutorDrawer.tsx @@ -0,0 +1,71 @@ +import { Bot, CircleAlert, Eye, Lightbulb, LoaderCircle, PanelRightClose, Sparkles, StopCircle, Volume2 } from "../../icons"; +import { useEffect, useState } from "react"; +import { useStudio } from "../../StudioContext"; +import { Button } from "../atoms/Button"; + +export function TutorDrawer({ learnerText = "" }: { learnerText?: string }) { + const { getTutorHelp, closeTutor, reportGap, tutorResult, tutorState, ollamaAvailable } = useStudio(); + const [expanded, setExpanded] = useState(false); + const active = tutorState !== "off"; + + useEffect(() => () => window.speechSynthesis?.cancel(), []); + + function showVisual() { + const visual = document.querySelector(".path-visual, .sketch-pad, .concept-strip, .rubric-panel"); + const quiet = localStorage.getItem("ccaf-studio-quiet-motion") === "on" || window.matchMedia("(prefers-reduced-motion: reduce)").matches; + visual?.scrollIntoView({ behavior: quiet ? "auto" : "smooth", block: "center" }); + } + + function readAloud() { + window.speechSynthesis.cancel(); + const text = document.querySelector(".lesson-scene")?.innerText ?? ""; + if (text) window.speechSynthesis.speak(new SpeechSynthesisUtterance(text.slice(0, 2_000))); + } + + function close() { + closeTutor(); + setExpanded(false); + } + + return ( + + ); +} diff --git a/studio/src/content.test.ts b/studio/src/content.test.ts new file mode 100644 index 0000000..8311bc3 --- /dev/null +++ b/studio/src/content.test.ts @@ -0,0 +1,24 @@ +import { describe, expect, it } from "vitest"; +import { manifest, STAGES, validateManifest } from "./content"; + +describe("course manifest", () => { + it("keeps all canonical units and valid prerequisites", () => { + expect(manifest.units).toHaveLength(23); + expect(validateManifest()).toEqual([]); + expect(new Set(manifest.units.map((unit) => unit.id)).size).toBe(23); + }); + + it("keeps a complete six-stage learner loop", () => { + expect(STAGES.map((stage) => stage.id)).toEqual(["learn", "draw", "build", "teach", "quiz", "review"]); + }); + + it("keeps answer keys and explanations paired", () => { + for (const bank of Object.values(manifest.banks)) { + for (const question of bank.questions) { + expect(question.ans).toBeGreaterThanOrEqual(0); + expect(question.ans).toBeLessThan(question.opts.length); + expect(question.why.trim().length).toBeGreaterThan(0); + } + } + }); +}); diff --git a/studio/src/content.ts b/studio/src/content.ts new file mode 100644 index 0000000..32962e0 --- /dev/null +++ b/studio/src/content.ts @@ -0,0 +1,82 @@ +import manifestJson from "./content/course-manifest.json"; +import type { CourseManifest, SessionState, StageId, StageState } from "./types"; + +function parseManifest(value: unknown): CourseManifest { + if (!value || typeof value !== "object") throw new Error("Course manifest must be an object."); + const candidate = value as Record; + if (!Array.isArray(candidate.units) || candidate.units.length !== 23) throw new Error("Course manifest must contain 23 units."); + if (!candidate.media || typeof candidate.media !== "object") throw new Error("Course manifest must contain the reviewed media library."); + const media = candidate.media as Record; + if (!Array.isArray(media.videos) || typeof media.playlistUrl !== "string") throw new Error("Course media library is incomplete."); + for (const rawUnit of candidate.units) { + if (!rawUnit || typeof rawUnit !== "object") throw new Error("Every course unit must be an object."); + const unit = rawUnit as Record; + if (typeof unit.id !== "string" || !Array.isArray(unit.prereq) || !Array.isArray(unit.watch)) throw new Error("Course unit fields are incomplete."); + if (!unit.watch.every((item) => Array.isArray(item) && item.length === 3 && item.every((part) => typeof part === "string"))) { + throw new Error(`${unit.id} has an invalid video mapping.`); + } + } + return value as CourseManifest; +} + +export const manifest = parseManifest(manifestJson); + +export const STAGES: { id: StageId; label: string }[] = [ + { id: "learn", label: "Learn" }, + { id: "draw", label: "Draw" }, + { id: "build", label: "Build" }, + { id: "teach", label: "Teach" }, + { id: "quiz", label: "Quiz" }, + { id: "review", label: "Review" } +]; + +export function buildStages(currentIndex: number, needsReview = false): StageState[] { + return STAGES.map((stage, index) => ({ + ...stage, + status: index < currentIndex + ? "complete" + : index === currentIndex + ? needsReview ? "needs-review" : "current" + : "upcoming" + })); +} + +export function demoSession(): SessionState { + return { + unitId: "w1", + title: "Files, folders, and plain text", + stage: "learn", + stageIndex: 0, + stages: buildStages(0), + progressPercent: 0, + dueReviews: 0, + weeklyTopThree: [ + "Finish the Files and folders lesson", + "Create and verify tiny-order.json", + "Explain the file path in your own words" + ], + legacyImported: false, + stateVersion: 0, + manifestHash: "preview", + mastery: "seen" + }; +} + +export function unitById(unitId: string) { + return manifest.units.find((unit) => unit.id === unitId) ?? manifest.units[0]; +} + +export function validateManifest(): string[] { + const errors: string[] = []; + const ids = new Set(manifest.units.map((unit) => unit.id)); + if (manifest.units.length !== 23) errors.push("The course must contain exactly 23 units."); + if (ids.size !== manifest.units.length) errors.push("Unit IDs must be unique."); + for (const unit of manifest.units) { + for (const prerequisite of unit.prereq) { + if (!ids.has(prerequisite)) errors.push(`${unit.id} has missing prerequisite ${prerequisite}.`); + } + if (!unit.watch.length) errors.push(`${unit.id} needs at least one learning resource.`); + if (unit.watch.some((item) => item.length !== 3)) errors.push(`${unit.id} has an incomplete video mapping.`); + } + return errors; +} diff --git a/studio/src/content/course-manifest.json b/studio/src/content/course-manifest.json new file mode 100644 index 0000000..d2714a7 --- /dev/null +++ b/studio/src/content/course-manifest.json @@ -0,0 +1,2030 @@ +{ + "sourceVersion": 2, + "generatedFrom": "course-data.js", + "units": [ + { + "id": "w1", + "level": "Foundation Workbench", + "title": "Files, folders, and plain text", + "one": "Know where a file lives, what its ending means, and which app edits it.", + "prereq": [], + "concepts": [ + "file", + "folder", + "path", + "extension", + "plain-text" + ], + "exercise": "file-map", + "quiz": "quiz.html", + "notes": "foundation-lab.html?unit=w1", + "ask": "Teach me files, folders, paths, extensions, and plain text as a complete beginner. Use one Finder example, one boxes-and-arrows sketch, then make me point to each part of a path.", + "watch": [ + [ + "foundation-lab.html?unit=w1", + "Foundation Workbench | Files and folders", + "Focus: Finder, file endings, and why TextEdit must use plain text." + ], + [ + "https://edu.gcfglobal.org/en/basic-computer-skills/understanding-file-extensions/1/", + "GCFGlobal | Understanding File Extensions", + "Focus: the ending tells you the file type; .json is not .txt." + ] + ] + }, + { + "id": "w2", + "level": "Foundation Workbench", + "title": "JSON by hand", + "one": "Build valid labeled data with braces, quotes, colons, and commas.", + "prereq": [ + "w1" + ], + "concepts": [ + "json-object", + "key", + "value", + "array", + "validation" + ], + "exercise": "json-card", + "quiz": "quiz.html", + "notes": "foundation-lab.html?unit=w2", + "ask": "Teach me JSON from zero. Show one tiny object, label every symbol, let me repair one broken example, then quiz me without showing the answer.", + "watch": [ + [ + "foundation-lab.html?unit=w2", + "Foundation Workbench | JSON by hand", + "Focus: key/value pairs and the four punctuation rules." + ], + [ + "https://developer.mozilla.org/en-US/docs/Learn_web_development/Core/Scripting/JSON", + "MDN | Working with JSON", + "Focus: JSON is text that carries structured data between programs." + ] + ] + }, + { + "id": "w3", + "level": "Foundation Workbench", + "title": "Programs, functions, and errors", + "one": "Follow input into a function, see an output, and read an error as a clue.", + "prereq": [ + "w2" + ], + "concepts": [ + "program", + "function", + "argument", + "return-value", + "error" + ], + "exercise": "function-machine", + "quiz": "quiz.html", + "notes": "foundation-lab.html?unit=w3", + "ask": "Teach me program, function, argument, return value, and error from zero. Use a toaster-like input-process-output example and one tiny pseudo-code function.", + "watch": [ + [ + "foundation-lab.html?unit=w3", + "Foundation Workbench | Programs and functions", + "Focus: input -> named action -> output, and errors as useful messages." + ] + ] + }, + { + "id": "w4", + "level": "Foundation Workbench", + "title": "API request and response", + "one": "See how one program asks another program for work and receives a result.", + "prereq": [ + "w3" + ], + "concepts": [ + "api", + "request", + "response", + "status", + "environment-variable" + ], + "exercise": "api-envelope", + "quiz": "quiz.html", + "notes": "foundation-lab.html?unit=w4", + "ask": "Teach me an API request and response from zero. Label the URL, headers, body, status, and response. Explain why API keys live in environment variables.", + "watch": [ + [ + "foundation-lab.html?unit=w4", + "Foundation Workbench | API request and response", + "Focus: request goes out, response comes back, secret stays outside the file." + ], + [ + "https://anthropic.skilljar.com/claude-platform-101", + "Anthropic Academy | Claude Platform 101", + "Focus: watch one Claude API request travel to the model and back." + ] + ] + }, + { + "id": "w5", + "level": "Foundation Workbench", + "title": "Safe Terminal basics", + "one": "Navigate, inspect, and validate without using risky commands.", + "prereq": [ + "w4" + ], + "concepts": [ + "terminal", + "command", + "working-directory", + "relative-path", + "exit-code" + ], + "exercise": "terminal-simulator", + "quiz": "quiz.html", + "notes": "foundation-lab.html?unit=w5", + "ask": "Teach me safe Terminal basics on a Mac. Explain pwd, ls, cd, cat, and exit codes. Do not ask me to delete, overwrite, or install anything.", + "watch": [ + [ + "foundation-lab.html?unit=w5", + "Foundation Workbench | Safe Terminal basics", + "Focus: pwd tells where you are; ls looks; cd moves; validation checks safely." + ] + ] + }, + { + "id": "a1", + "level": "Atoms", + "title": "Core vocabulary", + "one": "API, JSON, schema, token, context window, prompt, tool, and model.", + "prereq": [ + "w5" + ], + "concepts": [ + "schema", + "token", + "context-window", + "prompt", + "tool", + "model" + ], + "exercise": "vocabulary-flow", + "quiz": "quiz.html?set=foundations", + "notes": "notes.html?unit=a1", + "ask": "Quiz me on the 8 core CCA-F terms in plain words, one at a time. Ask me to give an example, not just repeat a definition.", + "watch": [ + [ + "https://anthropic.skilljar.com/claude-101/383389", + "Claude 101 | Meet Claude", + "Focus: identify model, prompt, context, and response." + ], + [ + "https://anthropic.skilljar.com/claude-platform-101", + "Claude Platform 101", + "Focus: connect API, JSON, and model in one request." + ] + ] + }, + { + "id": "m3", + "level": "Molecules", + "title": "Prompt techniques", + "one": "Write clear criteria, examples, output format, and small chains.", + "prereq": [ + "a1" + ], + "concepts": [ + "explicit-criteria", + "few-shot", + "output-format", + "prompt-chain" + ], + "exercise": "prompt-clinic", + "quiz": "quiz.html?set=prompting", + "notes": "notes.html?unit=m3", + "ask": "Teach me explicit criteria, few-shot examples, output format, and prompt chaining. Use one support-ticket example, then have me improve a vague prompt.", + "watch": [ + [ + "https://anthropic.skilljar.com/claude-with-the-anthropic-api", + "Building with the Claude API | Prompting", + "Focus: compare a vague prompt with explicit criteria and examples." + ] + ] + }, + { + "id": "m1", + "level": "Molecules", + "title": "A structured-output call", + "one": "Prompt plus schema produces validated JSON that still needs meaning checks.", + "prereq": [ + "m3" + ], + "concepts": [ + "required", + "nullable", + "enum", + "structured-output", + "semantic-validation" + ], + "exercise": "schema-lab", + "quiz": "quiz.html?set=prompting", + "notes": "notes.html?unit=m1", + "ask": "Teach me structured output with required, nullable, enum, validation, and retry. Show why schema-valid data can still be factually wrong.", + "watch": [ + [ + "https://anthropic.skilljar.com/claude-with-the-anthropic-api", + "Building with the Claude API | Structured data", + "Focus: schema controls shape; application checks meaning." + ] + ] + }, + { + "id": "m2", + "level": "Molecules", + "title": "One tool call", + "one": "Claude requests one action; the application runs it and returns a result.", + "prereq": [ + "m1" + ], + "concepts": [ + "tool-description", + "tool-use", + "tool-result", + "is-error", + "tool-choice" + ], + "exercise": "tool-call-envelope", + "quiz": "quiz.html?set=tools-mcp", + "notes": "notes.html?unit=m2", + "ask": "Teach me one complete tool call: definition -> tool_use -> application action -> tool_result -> final response. Label every handoff and show one error.", + "watch": [ + [ + "https://anthropic.skilljar.com/claude-with-the-anthropic-api", + "Building with the Claude API | Tool use", + "Focus: the application, not Claude, runs the requested action." + ] + ] + }, + { + "id": "o1", + "level": "Organisms", + "title": "The Agent Loop", + "one": "Model plus tools repeats until stop_reason says the turn is done.", + "prereq": [ + "m2" + ], + "concepts": [ + "agent-loop", + "stop-reason", + "tool-use-loop", + "guardrail", + "workflow-vs-agent" + ], + "exercise": "agent-loop-board", + "quiz": "quiz.html?set=agentic", + "notes": "notes.html?unit=o1", + "ask": "Teach me the agent loop: model -> tool request -> application -> tool result -> model. Cover stop_reason, runaway guards, and when one call is enough.", + "watch": [ + [ + "article-effective-agents.html", + "Building effective agents | Visual article", + "Focus: workflow holds a fixed map; agent chooses its next step." + ], + [ + "https://platform.claude.com/docs/en/build-with-claude/handling-stop-reasons", + "Anthropic docs | Handling stop reasons", + "Focus: branch on the returned reason; tool_use requires a tool result." + ] + ] + }, + { + "id": "a2", + "level": "Atoms", + "title": "Model physics and economics", + "one": "Pick the right model, cache stable prefixes, and batch work that can wait.", + "prereq": [ + "o1" + ], + "concepts": [ + "model-routing", + "latency", + "prompt-caching", + "batch-api", + "token-cost" + ], + "exercise": "model-router", + "quiz": "quiz.html?set=foundations", + "notes": "notes.html?unit=a2", + "ask": "Teach me model choice, token cost, latency, prompt caching, and batch versus real-time. Give me three jobs and make me choose.", + "watch": [ + [ + "https://platform.claude.com/docs/en/about-claude/models/choosing-a-model", + "Anthropic docs | Choosing a model", + "Focus: match capability and cost to the job." + ], + [ + "https://platform.claude.com/docs/en/build-with-claude/prompt-caching", + "Anthropic docs | Prompt caching", + "Focus: stable prefix first." + ], + [ + "https://platform.claude.com/docs/en/build-with-claude/batch-processing", + "Anthropic docs | Batch processing", + "Focus: delayed bulk work can cost less." + ] + ] + }, + { + "id": "d1", + "level": "Developer Bridge", + "title": "Repositories, trees, and diffs", + "one": "Read a project as a folder tree and inspect exactly what changed.", + "prereq": [ + "a2" + ], + "concepts": [ + "repository", + "file-tree", + "diff", + "added-line", + "removed-line" + ], + "exercise": "diff-reader", + "quiz": "quiz.html", + "notes": "foundation-lab.html?unit=d1", + "ask": "Teach me repository, file tree, and diff from zero. Show a three-line before-and-after diff and make me say what changed.", + "watch": [ + [ + "foundation-lab.html?unit=d1", + "Developer Bridge | Repositories and diffs", + "Focus: a repository is a tracked project folder; a diff is the change, not the whole file." + ], + [ + "https://docs.github.com/en/get-started/start-your-journey/hello-world", + "GitHub | Hello World", + "Focus: repository and branch before commits and pull requests." + ] + ] + }, + { + "id": "d2", + "level": "Developer Bridge", + "title": "Commits, pull requests, and CI", + "one": "Package a change, request review, and let automatic checks run.", + "prereq": [ + "d1" + ], + "concepts": [ + "branch", + "commit", + "pull-request", + "review", + "continuous-integration" + ], + "exercise": "pr-paper-sim", + "quiz": "quiz.html", + "notes": "foundation-lab.html?unit=d2", + "ask": "Teach me branch, commit, pull request, review, and CI from zero. Use one typo fix moving through the whole flow.", + "watch": [ + [ + "foundation-lab.html?unit=d2", + "Developer Bridge | Commits, PRs, and CI", + "Focus: commit records a change; PR asks to merge it; CI checks it." + ], + [ + "https://github.com/skills/introduction-to-github", + "GitHub Skills | Introduction to GitHub", + "Focus: create branch -> commit -> pull request -> merge." + ] + ] + }, + { + "id": "m4", + "level": "Molecules", + "title": "Built-in tools", + "one": "Choose Read, Write, Edit, Bash, Grep, or Glob for the job.", + "prereq": [ + "d2" + ], + "concepts": [ + "read-tool", + "edit-tool", + "grep", + "glob", + "bash-tool" + ], + "exercise": "tool-picker", + "quiz": "quiz.html?set=tools-mcp", + "notes": "notes.html?unit=m4", + "ask": "Teach me when to use Read, Write, Edit, Bash, Grep, and Glob. Give one file-tree task at a time and make me pick the safest tool.", + "watch": [ + [ + "https://anthropic.skilljar.com/claude-code-101/469789", + "Claude Code 101 | How it works", + "Focus: watch Claude inspect before it edits." + ], + [ + "https://anthropic.skilljar.com/claude-code-in-action", + "Claude Code in Action", + "Focus: follow search -> read -> edit -> test." + ] + ] + }, + { + "id": "o3", + "level": "Organisms", + "title": "An MCP server", + "one": "Expose actions, read-only data, and reusable workflows through a standard connection.", + "prereq": [ + "m4" + ], + "concepts": [ + "mcp", + "mcp-tool", + "mcp-resource", + "mcp-prompt", + "transport" + ], + "exercise": "mcp-menu", + "quiz": "quiz.html?set=tools-mcp", + "notes": "notes.html?unit=o3", + "ask": "Teach me MCP tools, resources, prompts, transports, scope, and secrets. Make me classify six capabilities.", + "watch": [ + [ + "https://anthropic.skilljar.com/claude-code-101/469797", + "Claude Code 101 | MCP", + "Focus: see an MCP connection inside Claude Code." + ], + [ + "https://anthropic.skilljar.com/introduction-to-model-context-protocol", + "Introduction to MCP", + "Focus: tool is an action; resource is read-only context; prompt is user-chosen workflow." + ] + ] + }, + { + "id": "o4", + "level": "Organisms", + "title": "Claude Code workflows", + "one": "Use project rules, skills, subagents, hooks, and headless runs deliberately.", + "prereq": [ + "o3" + ], + "concepts": [ + "claude-md", + "skill", + "subagent", + "hook", + "headless" + ], + "exercise": "claude-code-blueprint", + "quiz": "quiz.html?set=claude-code", + "notes": "notes.html?unit=o4", + "ask": "Teach me CLAUDE.md, skills, subagents, hooks, plan mode, and headless claude -p. Make me choose prompt versus hook for each rule.", + "watch": [ + [ + "https://anthropic.skilljar.com/claude-code-101/469789", + "Claude Code 101 | How it works", + "Focus: project context and tool permissions." + ], + [ + "https://anthropic.skilljar.com/claude-code-101/469795", + "Claude Code 101 | CLAUDE.md", + "Focus: durable project instructions, not secrets." + ], + [ + "https://anthropic.skilljar.com/claude-code-in-action", + "Claude Code in Action", + "Focus: build, check, and revise a real change." + ] + ] + }, + { + "id": "o2", + "level": "Organisms", + "title": "Orchestrator-Workers", + "one": "A coordinator chooses subtasks, passes context, and combines worker results.", + "prereq": [ + "o4" + ], + "concepts": [ + "orchestrator", + "worker", + "decomposition", + "context-passing", + "provenance" + ], + "exercise": "orchestrator-board", + "quiz": "quiz.html?set=agentic", + "notes": "notes.html?unit=o2", + "ask": "Teach me orchestrator-workers versus fixed parallelization. Show coordinator -> workers -> synthesis and the explicit context each worker needs.", + "watch": [ + [ + "https://anthropic.skilljar.com/claude-code-101/469796", + "Claude Code 101 | Subagents", + "Focus: each subagent starts with fresh context." + ], + [ + "article-multi-agent.html", + "Multi-agent research | Visual article", + "Focus: coordinator delegates and synthesizes; workers do not chat directly." + ] + ] + }, + { + "id": "rel", + "level": "Reliability Rail", + "title": "Reliability, context, and evals", + "one": "Design for failures, changing context, verification, and human review.", + "prereq": [ + "o2" + ], + "concepts": [ + "lost-in-middle", + "compaction", + "eval", + "retry", + "human-in-loop", + "provenance-conflict" + ], + "exercise": "reliability-lab", + "quiz": "quiz.html?set=reliability", + "notes": "notes.html?unit=rel", + "ask": "Teach me reliability deeply: context loss, compaction, RAG versus long context, retries, evals, provenance, guardrails, and human review. Use one failure at a time.", + "watch": [ + [ + "https://anthropic.skilljar.com/claude-code-101/469793", + "Claude Code 101 | Context management", + "Focus: what survives and what gets summarized." + ], + [ + "https://www.anthropic.com/engineering/effective-context-engineering-for-ai-agents", + "Anthropic | Effective context engineering", + "Focus: keep the smallest high-signal context that supports the next decision." + ] + ] + }, + { + "id": "t1", + "level": "Templates", + "title": "Support-agent system", + "one": "Combine tools, deterministic limits, normalization, and structured handoff.", + "prereq": [ + "rel" + ], + "concepts": [ + "support-agent", + "pre-tool-hook", + "post-tool-hook", + "escalation", + "handoff" + ], + "exercise": "support-blueprint", + "quiz": "quiz.html?set=agentic", + "notes": "notes.html?unit=t1", + "ask": "Walk me through a support agent with lookup, refund, deterministic refund limit, normalization, and human handoff. Ask me where each rule belongs.", + "watch": [ + [ + "https://anthropic.skilljar.com/claude-code-101/469798", + "Claude Code 101 | Hooks", + "Focus: critical limits belong in deterministic code." + ], + [ + "article-effective-agents.html", + "Building effective agents | Visual article", + "Focus: choose the simplest pattern that works." + ] + ] + }, + { + "id": "t2", + "level": "Templates", + "title": "Research multi-agent system", + "one": "Decompose, search, deduplicate, verify provenance, and synthesize.", + "prereq": [ + "t1" + ], + "concepts": [ + "research-plan", + "source-slice", + "deduplication", + "synthesis", + "finding" + ], + "exercise": "research-blueprint", + "quiz": "quiz.html?set=agentic", + "notes": "notes.html?unit=t2", + "ask": "Walk me through a research multi-agent system. Make me choose worker slices, context, finding fields, a second-round gap check, and when not to use it.", + "watch": [ + [ + "https://anthropic.skilljar.com/claude-code-101/469796", + "Claude Code 101 | Subagents", + "Focus: distinct worker scopes prevent duplicate work." + ], + [ + "article-multi-agent.html", + "Multi-agent research | Visual article", + "Focus: claim + source + date + confidence." + ] + ] + }, + { + "id": "p1", + "level": "Pages", + "title": "Production scenarios", + "one": "Read a whole system, choose an approach, and defend the tradeoff.", + "prereq": [ + "t2" + ], + "concepts": [ + "scenario", + "tradeoff", + "constraint", + "architecture-choice", + "failure-mode" + ], + "exercise": "scenario-decision", + "quiz": "pretest.html", + "notes": "notes.html?unit=p1", + "ask": "Give me one unofficial CCA-F-style production scenario. Make me choose the architecture, name a tradeoff and failure mode, and defend my choice before you grade it.", + "watch": [ + [ + "pretest.html", + "Course practice | Pre-Test scenarios", + "Focus: identify the constraint before choosing a pattern." + ], + [ + "article-effective-agents.html", + "Building effective agents | Visual article", + "Focus: complexity must earn its cost." + ] + ] + }, + { + "id": "px", + "level": "Pages", + "title": "Anti-patterns and decisions", + "one": "Spot attractive wrong answers and replace them with reliable designs.", + "prereq": [ + "p1" + ], + "concepts": [ + "anti-pattern", + "deterministic-gate", + "complexity-escalation", + "tool-scope", + "independent-review" + ], + "exercise": "anti-pattern-repair", + "quiz": "pretest.html", + "notes": "notes.html?unit=px", + "ask": "Drill me on architecture anti-patterns one scenario at a time. Do not reveal the answer until I choose and explain it.", + "watch": [ + [ + "repair-map.html", + "Repair guide | Classic wrong answers", + "Focus: replace each tempting shortcut with its reliable control." + ], + [ + "article-multi-agent.html", + "Multi-agent research | Visual article", + "Focus: extra agents add cost and new failure modes." + ] + ] + }, + { + "id": "p2", + "level": "Pages", + "title": "Capstone: PR-review pipeline", + "one": "Build a narrow end-to-end review path with validation and one hard guardrail.", + "prereq": [ + "px" + ], + "concepts": [ + "pr-review", + "file-pass", + "integration-pass", + "guardrail", + "human-review" + ], + "exercise": "capstone-scope", + "quiz": "projects.html", + "notes": "notes.html?unit=p2", + "ask": "Help me scope a small PR-review pipeline with one file pass, one integration pass, JSON validation, one code guardrail, and human review. Keep it finishable.", + "watch": [ + [ + "projects.html", + "Projects and rubrics | Capstone", + "Focus: read the rubric before building." + ], + [ + "https://anthropic.skilljar.com/claude-code-101/469794", + "Claude Code 101 | Code review", + "Focus: inspect the change and produce verifiable findings." + ], + [ + "https://anthropic.skilljar.com/claude-code-in-action", + "Claude Code in Action", + "Focus: run, check, and revise end to end." + ] + ] + } + ], + "lessons": { + "w1": { + "plain": "A file is one saved item. A folder holds files. A path is the full route to an item. An extension is the ending after the final dot.", + "example": "/Users/student/Documents/study/tiny-order.json", + "diagram": [ + "Finder", + "study folder", + "tiny-order.json", + "JSON text" + ], + "danger": "Saving rich text or adding .txt changes the file you meant to create." + }, + "w2": { + "plain": "JSON is plain text arranged as labeled key and value pairs. The punctuation is part of the format.", + "example": "{ \"item\": \"tea\", \"quantity\": 2 }", + "diagram": [ + "{ object }", + "\"key\"", + "value", + "validator" + ], + "danger": "Missing quotes, extra commas, and smart quotes make JSON invalid." + }, + "w3": { + "plain": "A program follows instructions. A function is a named action. Arguments go in, a return value comes out, and an error explains why it could not finish.", + "example": "total(2, 3) -> 5", + "diagram": [ + "arguments", + "function", + "return value", + "caller" + ], + "danger": "An error is not proof you failed. It is evidence about the next repair." + }, + "w4": { + "plain": "An API lets one program ask another program to do work. The request goes out; the response comes back.", + "example": "order app -> GET /orders/42 -> order service -> 200 + JSON", + "diagram": [ + "your app", + "request", + "API", + "response" + ], + "danger": "An API key is a secret. Keep it in an environment variable, not inside a shared file." + }, + "w5": { + "plain": "The Terminal runs typed commands in a working directory. Start by looking, then move carefully, then validate.", + "example": "pwd -> ls -> cd study -> pwd", + "diagram": [ + "prompt", + "command", + "working directory", + "output + exit code" + ], + "danger": "Do not run delete, overwrite, install, or administrator commands until you understand and intend every part." + }, + "d1": { + "plain": "A repository is a tracked project folder. A file tree shows its shape. A diff shows only what changed.", + "example": "- old title\n+ clearer title", + "diagram": [ + "repository", + "file tree", + "changed file", + "diff" + ], + "danger": "A diff is not the whole project. Read surrounding code before judging a change." + }, + "d2": { + "plain": "A branch isolates work. A commit records a meaningful change. A pull request asks to merge it. CI runs automatic checks.", + "example": "branch -> edit -> commit -> pull request -> CI -> review -> merge", + "diagram": [ + "branch", + "commit", + "pull request", + "CI + review" + ], + "danger": "A green CI check means the configured checks passed, not that every possible problem is absent." + } + }, + "banks": { + "w1": { + "questions": [ + { + "q": "Which item is a file?", + "opts": [ + "study", + "Documents", + "tiny-order.json", + "/Users/student" + ], + "ans": 2, + "why": "The .json item is one saved file; the others name folders or a partial path." + }, + { + "q": "TextEdit saved tiny-order.json.txt. What happened?", + "opts": [ + "It became an API", + "A .txt extension was added", + "The folder was deleted", + "JSON requires .txt" + ], + "ans": 1, + "why": "The final extension is now .txt, so it is not the filename the task requested." + }, + { + "q": "What does a path tell you?", + "opts": [ + "The route to a file or folder", + "The file's password", + "The program's output", + "The JSON schema" + ], + "ans": 0, + "why": "A path names the folders to follow to reach an item." + }, + { + "q": "Why use plain text for JSON?", + "opts": [ + "It removes formatting codes", + "It encrypts the file", + "It makes every value a number", + "It runs the file" + ], + "ans": 0, + "why": "JSON is a text data format; rich-text formatting can add content JSON parsers do not understand." + }, + { + "q": "You want to edit JSON by clicking in an app. Which category fits?", + "opts": [ + "Text editor", + "Terminal command", + "API response", + "Model" + ], + "ans": 0, + "why": "A text editor edits file contents; a terminal runs typed commands." + } + ] + }, + "w2": { + "questions": [ + { + "q": "In JSON, what is the key in { \"city\": \"Berkeley\" }?", + "opts": [ + "Berkeley", + "city", + "Both values", + "The braces" + ], + "ans": 1, + "why": "The key is the label before the colon." + }, + { + "q": "Which is valid JSON?", + "opts": [ + "{ item: \"tea\" }", + "{ \"item\": \"tea\", }", + "{ \"item\": \"tea\" }", + "{ “item”: “tea” }" + ], + "ans": 2, + "why": "JSON keys use straight double quotes and there is no trailing comma." + }, + { + "q": "What does a JSON array hold?", + "opts": [ + "An ordered list of values", + "Only one key", + "A secret", + "A command" + ], + "ans": 0, + "why": "Square brackets contain an ordered list." + }, + { + "q": "A validator reports a missing comma. Best next step?", + "opts": [ + "Read the exact location and repair it", + "Retry the same file forever", + "Change every value", + "Hide the error" + ], + "ans": 0, + "why": "Specific validation feedback points to the repair." + }, + { + "q": "Valid JSON guarantees what?", + "opts": [ + "Correct punctuation and structure", + "Every fact is true", + "The API is online", + "The model is safe" + ], + "ans": 0, + "why": "Syntax validity does not prove the facts are correct." + } + ] + }, + "w3": { + "questions": [ + { + "q": "In add(2, 3), what are 2 and 3?", + "opts": [ + "Arguments", + "Errors", + "Files", + "Return statements" + ], + "ans": 0, + "why": "Arguments are input values passed into a function." + }, + { + "q": "What is a return value?", + "opts": [ + "The output a function gives back", + "A folder path", + "A terminal prompt", + "A secret key" + ], + "ans": 0, + "why": "The caller receives the returned result." + }, + { + "q": "A function cannot find an order ID. What should it do?", + "opts": [ + "Return or raise a clear error", + "Invent an order", + "Silently return success", + "Delete the request" + ], + "ans": 0, + "why": "A specific error lets the caller recover or ask for better input." + }, + { + "q": "Which sketch matches a function?", + "opts": [ + "input -> named action -> output", + "output -> delete -> secret", + "folder -> folder -> folder", + "model -> no result" + ], + "ans": 0, + "why": "Functions transform inputs into outputs." + }, + { + "q": "Why read an error message?", + "opts": [ + "It contains evidence about what failed", + "It always blames the learner", + "It is a final score", + "It is the same as output" + ], + "ans": 0, + "why": "Errors are diagnostic information." + } + ] + }, + "w4": { + "questions": [ + { + "q": "Who sends an API request?", + "opts": [ + "A client program", + "The file extension", + "A folder", + "A schema alone" + ], + "ans": 0, + "why": "The client asks a server or service for work." + }, + { + "q": "What comes back from an API?", + "opts": [ + "A response", + "A folder", + "A branch", + "A prompt only" + ], + "ans": 0, + "why": "The response contains status and data or an error." + }, + { + "q": "Where should an API key live?", + "opts": [ + "An environment variable", + "A public README", + "The JSON example", + "A screenshot" + ], + "ans": 0, + "why": "Keep secrets outside shared source files." + }, + { + "q": "A response has status 404. What does that usually mean?", + "opts": [ + "The requested item was not found", + "Everything succeeded", + "The JSON is an array", + "The model needs more tokens" + ], + "ans": 0, + "why": "404 is a not-found response status." + }, + { + "q": "Which flow is correct?", + "opts": [ + "app -> request -> API -> response -> app", + "API -> folder -> branch", + "response -> no request -> app", + "key -> public log -> API" + ], + "ans": 0, + "why": "The client sends a request and receives a response." + } + ] + }, + "w5": { + "questions": [ + { + "q": "What does pwd show?", + "opts": [ + "Your current working directory", + "Every file on the computer", + "A password", + "The last error only" + ], + "ans": 0, + "why": "pwd means print working directory." + }, + { + "q": "What does ls do?", + "opts": [ + "Lists items in a directory", + "Deletes a file", + "Installs software", + "Changes JSON" + ], + "ans": 0, + "why": "ls is a look command." + }, + { + "q": "Before running a command that changes files, what should a beginner do?", + "opts": [ + "Confirm the directory and understand every part", + "Add sudo", + "Run it twice", + "Hide the output" + ], + "ans": 0, + "why": "Orientation and intent come before mutation." + }, + { + "q": "What does a zero exit code usually mean?", + "opts": [ + "The command completed successfully", + "The file is empty", + "The API key leaked", + "The folder moved" + ], + "ans": 0, + "why": "Conventionally, zero means success and nonzero signals a problem." + }, + { + "q": "Which command changes the working directory?", + "opts": [ + "cd", + "pwd", + "ls", + "cat" + ], + "ans": 0, + "why": "cd means change directory." + } + ] + }, + "d1": { + "questions": [ + { + "q": "What is a repository?", + "opts": [ + "A project folder whose changes are tracked", + "One API response", + "A model context window", + "A JSON key" + ], + "ans": 0, + "why": "A repository tracks a project and its history." + }, + { + "q": "What does a diff show?", + "opts": [ + "Lines added and removed", + "Every file on the computer", + "Only test results", + "API prices" + ], + "ans": 0, + "why": "A diff focuses on the change." + }, + { + "q": "In a normal diff, what does a line starting + mean?", + "opts": [ + "Added", + "Removed", + "Secret", + "Unchanged" + ], + "ans": 0, + "why": "A plus marks an added line." + }, + { + "q": "Why inspect surrounding code after reading a diff?", + "opts": [ + "The change may depend on nearby behavior", + "The diff is always false", + "It changes the branch", + "It validates JSON" + ], + "ans": 0, + "why": "Context reveals contracts and side effects the changed lines rely on." + }, + { + "q": "What does a file tree show?", + "opts": [ + "Folders and files arranged by location", + "Only deleted lines", + "A model answer", + "A network request" + ], + "ans": 0, + "why": "It is the project's folder structure." + } + ] + }, + "d2": { + "questions": [ + { + "q": "Why create a branch?", + "opts": [ + "To isolate a change from the main line", + "To store an API key", + "To validate JSON", + "To increase context size" + ], + "ans": 0, + "why": "A branch gives the work its own line until review." + }, + { + "q": "What is a commit?", + "opts": [ + "A recorded project change with a message", + "A live API request", + "A folder extension", + "A model refusal" + ], + "ans": 0, + "why": "A commit records a coherent change in version history." + }, + { + "q": "What does a pull request ask for?", + "opts": [ + "Review and merge of branch changes", + "A larger model", + "A new JSON key", + "A terminal password" + ], + "ans": 0, + "why": "A PR presents a branch for checks, discussion, and merge." + }, + { + "q": "What is CI?", + "opts": [ + "Automatic checks triggered by changes", + "A manual folder", + "A prompt technique", + "An MCP resource" + ], + "ans": 0, + "why": "Continuous integration runs configured tests and checks automatically." + }, + { + "q": "CI is green. What can you conclude?", + "opts": [ + "The configured checks passed", + "The change has no possible bug", + "Human review is unnecessary", + "Every requirement was tested" + ], + "ans": 0, + "why": "Green CI is evidence, not proof of everything." + } + ] + } + }, + "cards": { + "w1": [ + [ + "File", + "One saved item, such as tiny-order.json." + ], + [ + "Path", + "The route through folders to reach an item." + ], + [ + "Plain text", + "Text without hidden rich formatting." + ] + ], + "w2": [ + [ + "JSON key", + "A quoted label before a colon." + ], + [ + "JSON value", + "The data after a key's colon." + ], + [ + "Validation", + "Checking data against syntax or shape rules." + ] + ], + "w3": [ + [ + "Function", + "A named action that receives inputs and returns an output." + ], + [ + "Argument", + "An input value passed to a function." + ], + [ + "Error", + "A useful signal that explains why work could not finish." + ] + ], + "w4": [ + [ + "API request", + "A program's structured message asking a service for work." + ], + [ + "API response", + "The status and data returned to the requester." + ], + [ + "Environment variable", + "A value stored outside source code, often used for secrets." + ] + ], + "w5": [ + [ + "Working directory", + "The folder where a terminal command currently operates." + ], + [ + "pwd", + "Print the current working directory." + ], + [ + "Exit code", + "A number reporting whether a command succeeded or failed." + ] + ], + "a1": [ + [ + "Context window", + "The text budget the model can use for one request." + ], + [ + "Schema", + "Rules for the expected shape and types of data." + ], + [ + "Tool", + "An action an application lets a model request." + ] + ], + "m3": [ + [ + "Few-shot", + "A few examples inside a prompt that demonstrate the desired pattern." + ], + [ + "Explicit criteria", + "Concrete rules that say what counts as correct." + ], + [ + "Prompt chain", + "Multiple calls where one step's output feeds the next." + ] + ], + "m1": [ + [ + "Nullable", + "A field may honestly contain null when the fact is absent." + ], + [ + "Enum", + "A field limited to a fixed set of allowed values." + ], + [ + "Semantic validation", + "Checking whether validly shaped data also makes sense." + ] + ], + "m2": [ + [ + "tool_use", + "A model request for the application to run a tool." + ], + [ + "tool_result", + "The application's returned output for a tool request." + ], + [ + "is_error", + "A real tool-result signal that the tool failed." + ] + ], + "o1": [ + [ + "Agent loop", + "Model -> tool request -> result -> model, repeated until done." + ], + [ + "stop_reason", + "The response field that says why generation stopped." + ], + [ + "Guardrail", + "A control that limits or blocks unsafe behavior." + ] + ], + "a2": [ + [ + "Prompt caching", + "Reusing a stable prompt prefix instead of processing it fresh." + ], + [ + "Batch API", + "Delayed bulk processing for work that does not need an immediate result." + ], + [ + "Model routing", + "Choosing a model based on difficulty, cost, and latency." + ] + ], + "d1": [ + [ + "Repository", + "A tracked project folder and its history." + ], + [ + "Diff", + "The lines added and removed by a change." + ], + [ + "File tree", + "The nested map of project folders and files." + ] + ], + "d2": [ + [ + "Commit", + "A recorded coherent change with a message." + ], + [ + "Pull request", + "A proposal to review and merge branch changes." + ], + [ + "CI", + "Automatic checks run when project changes occur." + ] + ], + "m4": [ + [ + "Grep", + "Search inside files for matching text." + ], + [ + "Glob", + "Match file names or paths by a pattern." + ], + [ + "Edit", + "Change a specific, uniquely identified piece of a file." + ] + ], + "o3": [ + [ + "MCP tool", + "A model-controlled action exposed by an MCP server." + ], + [ + "MCP resource", + "Read-only context selected by the application." + ], + [ + "MCP prompt", + "A reusable workflow selected by a user." + ] + ], + "o4": [ + [ + "CLAUDE.md", + "Project instructions Claude Code reads for work in that project." + ], + [ + "Hook", + "Deterministic code run before or after a tool event." + ], + [ + "Subagent", + "A worker with fresh context and a scoped prompt and tools." + ] + ], + "o2": [ + [ + "Orchestrator", + "The coordinator that chooses tasks, delegates, and synthesizes." + ], + [ + "Explicit context passing", + "Putting everything a fresh worker needs into its prompt." + ], + [ + "Provenance", + "A record of where each finding came from." + ] + ], + "rel": [ + [ + "Eval", + "A saved case and rubric rerun to measure behavior." + ], + [ + "Lost in the middle", + "Important text is present but buried and overlooked." + ], + [ + "Human in the loop", + "A person reviews risky, uncertain, or policy-sensitive cases." + ] + ], + "t1": [ + [ + "PreToolUse hook", + "A deterministic check before a tool runs." + ], + [ + "PostToolUse hook", + "A deterministic check or normalization after a tool runs." + ], + [ + "Structured handoff", + "Fixed fields that give a human the facts and recommended next action." + ] + ], + "t2": [ + [ + "Finding", + "A claim plus source, date, and confidence." + ], + [ + "Deduplication", + "Removing repeated findings before synthesis." + ], + [ + "Second-round delegation", + "Sending workers to fill gaps found after the first results." + ] + ], + "p1": [ + [ + "Tradeoff", + "A benefit gained by accepting a cost or limitation." + ], + [ + "Constraint", + "A condition the architecture must satisfy." + ], + [ + "Failure mode", + "A specific way the system can break." + ] + ], + "px": [ + [ + "Anti-pattern", + "A tempting design that repeatedly causes problems." + ], + [ + "Deterministic gate", + "Code that enforces a rule instead of merely asking a model." + ], + [ + "Independent review", + "A fresh evaluator that is less biased by the original run." + ] + ], + "p2": [ + [ + "File pass", + "Review each changed file for local problems." + ], + [ + "Integration pass", + "Review interactions across files after local checks." + ], + [ + "PR guardrail", + "A deterministic block for a critical merge rule." + ] + ] + }, + "media": { + "generatedFrom": "video-data.js", + "playlistUrl": "https://www.youtube.com/playlist?list=PLviC8AFqAj5A9MHkRIn2fU5Ac2lEdJxNf", + "reviewedAt": "2026-07-15", + "communityNotice": "Community explanation from Peace Of Code. It is not official Anthropic guidance or an official exam specification.", + "videos": [ + { + "id": "ldqOnljDINc", + "episodeKey": "ep01", + "number": "01", + "title": "Agentic Loops and stop_reason Explained", + "channel": "Peace Of Code", + "uploaded": "2026-04-05", + "durationSec": 2967, + "kind": "lesson", + "lessonIds": [ + "o1" + ], + "focus": "See chat become a loop: reason, call a tool, read the result, and decide again.", + "note": "The assigned clip stops before the inaccurate claim that only two stop reasons exist. The full episode simplifies the current API behavior.", + "reviewedAt": "2026-07-15", + "url": "https://www.youtube.com/watch?v=ldqOnljDINc&t=1157s", + "fullUrl": "https://www.youtube.com/watch?v=ldqOnljDINc", + "thumbnailId": "ldqOnljDINc", + "clip": { + "id": "agent-loop-basics", + "startSec": 1157, + "endSec": 1306, + "captionSource": "YouTube native captions" + } + }, + { + "id": "ejPWvBcc_DU", + "episodeKey": "ep02", + "number": "02", + "title": "Multi-Agent Systems and Coordinator Patterns", + "channel": "Peace Of Code", + "uploaded": "2026-04-07", + "durationSec": 1955, + "kind": "lesson", + "lessonIds": [ + "o2" + ], + "focus": "Name the coordinator's jobs before adding workers.", + "note": "Use the short coordinator clip; the official subagents lesson remains the authority.", + "reviewedAt": "2026-07-15", + "url": "https://www.youtube.com/watch?v=ejPWvBcc_DU&t=362s", + "fullUrl": "https://www.youtube.com/watch?v=ejPWvBcc_DU", + "thumbnailId": "ejPWvBcc_DU", + "clip": { + "id": "coordinator-role", + "startSec": 362, + "endSec": 514, + "captionSource": "YouTube native captions" + } + }, + { + "id": "a2N6vKdQUfE", + "episodeKey": "ep03", + "number": "03", + "title": "Subagent Context Passing and Session Management", + "channel": "Peace Of Code", + "uploaded": "2026-04-12", + "durationSec": 2016, + "kind": "lesson", + "lessonIds": [ + "t2" + ], + "focus": "Pass sources with findings and resolve conflicts before synthesis.", + "note": "The selected clip focuses on provenance and conflicting findings.", + "reviewedAt": "2026-07-15", + "url": "https://www.youtube.com/watch?v=a2N6vKdQUfE&t=640s", + "fullUrl": "https://www.youtube.com/watch?v=a2N6vKdQUfE", + "thumbnailId": "a2N6vKdQUfE", + "clip": { + "id": "provenance-conflicts", + "startSec": 640, + "endSec": 1104, + "captionSource": "YouTube native captions" + } + }, + { + "id": "e7ijjK173zI", + "episodeKey": "ep04", + "number": "04", + "title": "Multi-Agent System in Python and Claude SDK | Hands On", + "channel": "Peace Of Code", + "uploaded": "2026-04-17", + "durationSec": 767, + "kind": "extra", + "lessonIds": [ + "o2", + "t2" + ], + "focus": "Useful full build-along after the orchestration lessons; not required in the core path.", + "note": "Useful full build-along after the orchestration lessons; not required in the core path.", + "reviewedAt": "2026-07-15", + "url": "https://www.youtube.com/watch?v=e7ijjK173zI", + "fullUrl": "https://www.youtube.com/watch?v=e7ijjK173zI", + "thumbnailId": "e7ijjK173zI", + "clip": null + }, + { + "id": "JJBcpwpsKzk", + "episodeKey": "ep05", + "number": "05", + "title": "PreToolUse, PostToolUse Hooks and Task Decomposition", + "channel": "Peace Of Code", + "uploaded": "2026-04-19", + "durationSec": 2723, + "kind": "lesson", + "lessonIds": [ + "t1" + ], + "focus": "Use code to block an action until a required fact is verified.", + "note": "The assigned clip shows deterministic prerequisite gates.", + "reviewedAt": "2026-07-15", + "url": "https://www.youtube.com/watch?v=JJBcpwpsKzk&t=1338s", + "fullUrl": "https://www.youtube.com/watch?v=JJBcpwpsKzk", + "thumbnailId": "JJBcpwpsKzk", + "clip": { + "id": "deterministic-gates", + "startSec": 1338, + "endSec": 1660, + "captionSource": "YouTube native captions" + } + }, + { + "id": "s1j1vTnCKns", + "episodeKey": "ep06", + "number": "06", + "title": "Tool Descriptions and Tool Misrouting", + "channel": "Peace Of Code", + "uploaded": "2026-04-24", + "durationSec": 1490, + "kind": "lesson", + "lessonIds": [ + "m2" + ], + "focus": "See how names, descriptions, and overlap change tool selection.", + "note": "The assigned clip shows why names and descriptions change tool selection.", + "reviewedAt": "2026-07-15", + "url": "https://www.youtube.com/watch?v=s1j1vTnCKns&t=58s", + "fullUrl": "https://www.youtube.com/watch?v=s1j1vTnCKns", + "thumbnailId": "s1j1vTnCKns", + "clip": { + "id": "tool-descriptions", + "startSec": 58, + "endSec": 588, + "captionSource": "YouTube native captions" + } + }, + { + "id": "eZj6FtTVV58", + "episodeKey": "ep07", + "number": "07", + "title": "Agent Error Handling and tool_choice", + "channel": "Peace Of Code", + "uploaded": "2026-04-26", + "durationSec": 2286, + "kind": "extra", + "lessonIds": [ + "m2", + "rel" + ], + "focus": "Useful extra review for tool errors; the core lesson already covers the same ground more briefly.", + "note": "Useful extra review for tool errors; the core lesson already covers the same ground more briefly.", + "reviewedAt": "2026-07-15", + "url": "https://www.youtube.com/watch?v=eZj6FtTVV58", + "fullUrl": "https://www.youtube.com/watch?v=eZj6FtTVV58", + "thumbnailId": "eZj6FtTVV58", + "clip": null + }, + { + "id": "IVUxGTxSuH8", + "episodeKey": "ep08", + "number": "08", + "title": "MCP Servers, Configuration, Cline and More", + "channel": "Peace Of Code", + "uploaded": "2026-04-29", + "durationSec": 5348, + "kind": "lesson", + "lessonIds": [ + "o3" + ], + "focus": "See the MCP client-server picture and what MCP connects.", + "note": "The assigned MCP introduction is current. A later full-episode section saying all MCP tools load at once is outdated: Claude Code now uses Tool Search by default.", + "reviewedAt": "2026-07-15", + "url": "https://www.youtube.com/watch?v=IVUxGTxSuH8&t=104s", + "fullUrl": "https://www.youtube.com/watch?v=IVUxGTxSuH8", + "thumbnailId": "IVUxGTxSuH8", + "clip": { + "id": "mcp-basics", + "startSec": 104, + "endSec": 684, + "captionSource": "YouTube native captions" + } + }, + { + "id": "eh-xxQpfBBY", + "episodeKey": "ep09", + "number": "09", + "title": "Claude Built-in Tools Explained", + "channel": "Peace Of Code", + "uploaded": "2026-05-01", + "durationSec": 2139, + "kind": "lesson", + "lessonIds": [ + "m4" + ], + "focus": "Follow search -> read -> edit instead of guessing where code lives.", + "note": "The assigned clip demonstrates a search, read, and edit exploration path.", + "reviewedAt": "2026-07-15", + "url": "https://www.youtube.com/watch?v=eh-xxQpfBBY&t=1216s", + "fullUrl": "https://www.youtube.com/watch?v=eh-xxQpfBBY", + "thumbnailId": "eh-xxQpfBBY", + "clip": { + "id": "codebase-exploration", + "startSec": 1216, + "endSec": 1648, + "captionSource": "YouTube native captions" + } + }, + { + "id": "qIee1aqSAwY", + "episodeKey": "ep10", + "number": "10", + "title": "CLAUDE.md Hierarchy and Configuration Rules", + "channel": "Peace Of Code", + "uploaded": "2026-05-03", + "durationSec": 1896, + "kind": "extra", + "lessonIds": [ + "o4" + ], + "focus": "Reference only. Current CLAUDE.md loading and post-compaction behavior should be learned from the official memory documentation.", + "note": "Reference only. Current CLAUDE.md loading and post-compaction behavior should be learned from the official memory documentation.", + "reviewedAt": "2026-07-15", + "url": "https://www.youtube.com/watch?v=qIee1aqSAwY", + "fullUrl": "https://www.youtube.com/watch?v=qIee1aqSAwY", + "thumbnailId": "qIee1aqSAwY", + "clip": null + }, + { + "id": "v3tMqTmgg2Q", + "episodeKey": "ep11", + "number": "11", + "title": "Custom Slash Commands and Skills", + "channel": "Peace Of Code", + "uploaded": "2026-05-06", + "durationSec": 1997, + "kind": "extra", + "lessonIds": [ + "o4" + ], + "focus": "Reference only. Custom commands have since merged into Skills; .claude/commands remains compatible.", + "note": "Reference only. Custom commands have since merged into Skills; .claude/commands remains compatible.", + "reviewedAt": "2026-07-15", + "url": "https://www.youtube.com/watch?v=v3tMqTmgg2Q", + "fullUrl": "https://www.youtube.com/watch?v=v3tMqTmgg2Q", + "thumbnailId": "v3tMqTmgg2Q", + "clip": null + }, + { + "id": "q-n1cut5e7c", + "episodeKey": "ep12", + "number": "12", + "title": "Plan Mode vs Execute in Claude Code", + "channel": "Peace Of Code", + "uploaded": "2026-05-10", + "durationSec": 3102, + "kind": "lesson", + "lessonIds": [ + "o4" + ], + "focus": "Choose plan mode for complex, ambiguous, or risky work.", + "note": "The assigned clip gives a clear decision rule for planning before execution.", + "reviewedAt": "2026-07-15", + "url": "https://www.youtube.com/watch?v=q-n1cut5e7c&t=280s", + "fullUrl": "https://www.youtube.com/watch?v=q-n1cut5e7c", + "thumbnailId": "q-n1cut5e7c", + "clip": { + "id": "plan-mode", + "startSec": 280, + "endSec": 548, + "captionSource": "YouTube native captions" + } + }, + { + "id": "GWCnDhgH840", + "episodeKey": "ep13", + "number": "13", + "title": "Claude Code CI/CD Pipelines", + "channel": "Peace Of Code", + "uploaded": "2026-05-13", + "durationSec": 1881, + "kind": "lesson", + "lessonIds": [ + "d2" + ], + "focus": "Connect pull-request changes to automatic Claude Code checks.", + "note": "The assigned clip connects a pull request to automated Claude Code checks.", + "reviewedAt": "2026-07-15", + "url": "https://www.youtube.com/watch?v=GWCnDhgH840&t=342s", + "fullUrl": "https://www.youtube.com/watch?v=GWCnDhgH840", + "thumbnailId": "GWCnDhgH840", + "clip": { + "id": "ci-integration", + "startSec": 342, + "endSec": 502, + "captionSource": "YouTube native captions" + } + }, + { + "id": "HqwULqy1egw", + "episodeKey": "ep14", + "number": "14", + "title": "Prompt Engineering: Explicit Criteria and False Positives", + "channel": "Peace Of Code", + "uploaded": "2026-05-17", + "durationSec": 2065, + "kind": "lesson", + "lessonIds": [ + "m3" + ], + "focus": "Replace vague guidance with concrete pass and fail criteria.", + "note": "Primary playlist lesson for explicit criteria.", + "reviewedAt": "2026-07-15", + "url": "https://www.youtube.com/watch?v=HqwULqy1egw&t=902s", + "fullUrl": "https://www.youtube.com/watch?v=HqwULqy1egw", + "thumbnailId": "HqwULqy1egw", + "clip": { + "id": "explicit-criteria", + "startSec": 902, + "endSec": 1320, + "captionSource": "YouTube native captions" + } + }, + { + "id": "FbIcU6YFrhw", + "episodeKey": "ep15", + "number": "15", + "title": "Few-Shot Prompting Explained", + "channel": "Peace Of Code", + "uploaded": "2026-05-20", + "durationSec": 1662, + "kind": "lesson", + "lessonIds": [ + "m3" + ], + "focus": "Use a few examples that target the ambiguous edge cases.", + "note": "Optional clip for targeted examples after explicit criteria.", + "reviewedAt": "2026-07-15", + "url": "https://www.youtube.com/watch?v=FbIcU6YFrhw&t=772s", + "fullUrl": "https://www.youtube.com/watch?v=FbIcU6YFrhw", + "thumbnailId": "FbIcU6YFrhw", + "clip": { + "id": "targeted-examples", + "startSec": 772, + "endSec": 1046, + "captionSource": "YouTube native captions" + } + }, + { + "id": "CaDaLn7DcQ0", + "episodeKey": "ep16", + "number": "16", + "title": "Structured Output and JSON Schema", + "channel": "Peace Of Code", + "uploaded": "2026-05-25", + "durationSec": 2211, + "kind": "extra", + "lessonIds": [ + "m1" + ], + "focus": "Reference only. Its fake-tool forcing method is historical; current JSON outputs use output_config.format and strict tools use strict: true.", + "note": "Reference only. Its fake-tool forcing method is historical; current JSON outputs use output_config.format and strict tools use strict: true.", + "reviewedAt": "2026-07-15", + "url": "https://www.youtube.com/watch?v=CaDaLn7DcQ0", + "fullUrl": "https://www.youtube.com/watch?v=CaDaLn7DcQ0", + "thumbnailId": "CaDaLn7DcQ0", + "clip": null + }, + { + "id": "BXs7QoLQxX0", + "episodeKey": "ep17", + "number": "17", + "title": "Batch API and Multi-Pass Review", + "channel": "Peace Of Code", + "uploaded": "2026-05-29", + "durationSec": 2044, + "kind": "lesson", + "lessonIds": [ + "p2" + ], + "focus": "Review each item first, then run a second integration pass.", + "note": "The selected multi-pass section is current. Earlier Batch API limitations in the full episode no longer describe all supported tool-use and multi-turn cases.", + "reviewedAt": "2026-07-15", + "url": "https://www.youtube.com/watch?v=BXs7QoLQxX0&t=1246s", + "fullUrl": "https://www.youtube.com/watch?v=BXs7QoLQxX0", + "thumbnailId": "BXs7QoLQxX0", + "clip": { + "id": "multi-pass-review", + "startSec": 1246, + "endSec": 1726, + "captionSource": "YouTube native captions" + } + }, + { + "id": "7kaJdZ7veDs", + "episodeKey": "ep18", + "number": "18", + "title": "Why AI Agents Forget: Context Engineering", + "channel": "Peace Of Code", + "uploaded": "2026-06-02", + "durationSec": 2598, + "kind": "lesson", + "lessonIds": [ + "rel" + ], + "focus": "Separate working context from durable memory and see why summaries lose detail.", + "note": "Treat context as working input, not durable memory. Compaction and summaries are useful but lossy.", + "reviewedAt": "2026-07-15", + "url": "https://www.youtube.com/watch?v=7kaJdZ7veDs&t=206s", + "fullUrl": "https://www.youtube.com/watch?v=7kaJdZ7veDs", + "thumbnailId": "7kaJdZ7veDs", + "clip": { + "id": "context-and-summaries", + "startSec": 206, + "endSec": 702, + "captionSource": "YouTube native captions" + } + }, + { + "id": "MqnElZw6NYk", + "episodeKey": "ep19", + "number": "19", + "title": "Subagent Error Propagation and Context Management", + "channel": "Peace Of Code", + "uploaded": "2026-06-07", + "durationSec": 2546, + "kind": "extra", + "lessonIds": [ + "rel", + "o2" + ], + "focus": "Useful extra review. A scratchpad persists only when the application writes it and deliberately reads it again.", + "note": "Useful extra review. A scratchpad persists only when the application writes it and deliberately reads it again.", + "reviewedAt": "2026-07-15", + "url": "https://www.youtube.com/watch?v=MqnElZw6NYk", + "fullUrl": "https://www.youtube.com/watch?v=MqnElZw6NYk", + "thumbnailId": "MqnElZw6NYk", + "clip": null + }, + { + "id": "tsIxzFg76Nw", + "episodeKey": "ep20", + "number": "20", + "title": "When AI Needs a Human", + "channel": "Peace Of Code", + "uploaded": "2026-06-10", + "durationSec": 3078, + "kind": "lesson", + "lessonIds": [ + "px" + ], + "focus": "See why high-risk synthesis still needs a human checkpoint.", + "note": "The assigned clip focuses on synthesis risk and human review.", + "reviewedAt": "2026-07-15", + "url": "https://www.youtube.com/watch?v=tsIxzFg76Nw&t=2544s", + "fullUrl": "https://www.youtube.com/watch?v=tsIxzFg76Nw", + "thumbnailId": "tsIxzFg76Nw", + "clip": { + "id": "synthesis-risk", + "startSec": 2544, + "endSec": 2742, + "captionSource": "YouTube native captions" + } + } + ] + } +} diff --git a/studio/src/icons.ts b/studio/src/icons.ts new file mode 100644 index 0000000..4f75166 --- /dev/null +++ b/studio/src/icons.ts @@ -0,0 +1,57 @@ +export { default as AlertCircle } from "lucide-react/dist/esm/icons/alert-circle.mjs"; +export { default as ArrowRight } from "lucide-react/dist/esm/icons/arrow-right.mjs"; +export { default as BookOpen } from "lucide-react/dist/esm/icons/book-open.mjs"; +export { default as BookOpenCheck } from "lucide-react/dist/esm/icons/book-open-check.mjs"; +export { default as Bot } from "lucide-react/dist/esm/icons/bot.mjs"; +export { default as CalendarDays } from "lucide-react/dist/esm/icons/calendar-days.mjs"; +export { default as Check } from "lucide-react/dist/esm/icons/check.mjs"; +export { default as CheckCircle2 } from "lucide-react/dist/esm/icons/check-circle-2.mjs"; +export { default as ChevronLeft } from "lucide-react/dist/esm/icons/chevron-left.mjs"; +export { default as ChevronRight } from "lucide-react/dist/esm/icons/chevron-right.mjs"; +export { default as ChevronDown } from "lucide-react/dist/esm/icons/chevron-down.mjs"; +export { default as Circle } from "lucide-react/dist/esm/icons/circle.mjs"; +export { default as CircleAlert } from "lucide-react/dist/esm/icons/circle-alert.mjs"; +export { default as Clock3 } from "lucide-react/dist/esm/icons/clock-3.mjs"; +export { default as Cpu } from "lucide-react/dist/esm/icons/cpu.mjs"; +export { default as Eraser } from "lucide-react/dist/esm/icons/eraser.mjs"; +export { default as ExternalLink } from "lucide-react/dist/esm/icons/external-link.mjs"; +export { default as Eye } from "lucide-react/dist/esm/icons/eye.mjs"; +export { default as FileCheck2 } from "lucide-react/dist/esm/icons/file-check-2.mjs"; +export { default as FileJson } from "lucide-react/dist/esm/icons/file-json.mjs"; +export { default as FileText } from "lucide-react/dist/esm/icons/file-text.mjs"; +export { default as Folder } from "lucide-react/dist/esm/icons/folder.mjs"; +export { default as FolderOpen } from "lucide-react/dist/esm/icons/folder-open.mjs"; +export { default as Gauge } from "lucide-react/dist/esm/icons/gauge.mjs"; +export { default as GraduationCap } from "lucide-react/dist/esm/icons/graduation-cap.mjs"; +export { default as Headphones } from "lucide-react/dist/esm/icons/headphones.mjs"; +export { default as HelpCircle } from "lucide-react/dist/esm/icons/help-circle.mjs"; +export { default as Home } from "lucide-react/dist/esm/icons/home.mjs"; +export { default as Info } from "lucide-react/dist/esm/icons/info.mjs"; +export { default as Inbox } from "lucide-react/dist/esm/icons/inbox.mjs"; +export { default as Library } from "lucide-react/dist/esm/icons/library.mjs"; +export { default as Lightbulb } from "lucide-react/dist/esm/icons/lightbulb.mjs"; +export { default as LinkIcon } from "lucide-react/dist/esm/icons/link.mjs"; +export { default as LoaderCircle } from "lucide-react/dist/esm/icons/loader-circle.mjs"; +export { default as LockKeyhole } from "lucide-react/dist/esm/icons/lock-keyhole.mjs"; +export { default as Mic } from "lucide-react/dist/esm/icons/mic.mjs"; +export { default as MonitorUp } from "lucide-react/dist/esm/icons/monitor-up.mjs"; +export { default as Download } from "lucide-react/dist/esm/icons/download.mjs"; +export { default as Upload } from "lucide-react/dist/esm/icons/upload.mjs"; +export { default as PanelLeftClose } from "lucide-react/dist/esm/icons/panel-left-close.mjs"; +export { default as PanelLeftOpen } from "lucide-react/dist/esm/icons/panel-left-open.mjs"; +export { default as PanelRightClose } from "lucide-react/dist/esm/icons/panel-right-close.mjs"; +export { default as PencilLine } from "lucide-react/dist/esm/icons/pencil-line.mjs"; +export { default as Play } from "lucide-react/dist/esm/icons/play.mjs"; +export { default as RotateCcw } from "lucide-react/dist/esm/icons/rotate-ccw.mjs"; +export { default as Search } from "lucide-react/dist/esm/icons/search.mjs"; +export { default as Server } from "lucide-react/dist/esm/icons/server.mjs"; +export { default as Settings } from "lucide-react/dist/esm/icons/settings.mjs"; +export { default as ShieldCheck } from "lucide-react/dist/esm/icons/shield-check.mjs"; +export { default as Sparkles } from "lucide-react/dist/esm/icons/sparkles.mjs"; +export { default as Square } from "lucide-react/dist/esm/icons/square.mjs"; +export { default as StopCircle } from "lucide-react/dist/esm/icons/stop-circle.mjs"; +export { default as Trash2 } from "lucide-react/dist/esm/icons/trash-2.mjs"; +export { default as Video } from "lucide-react/dist/esm/icons/video.mjs"; +export { default as Volume2 } from "lucide-react/dist/esm/icons/volume-2.mjs"; +export { default as X } from "lucide-react/dist/esm/icons/x.mjs"; +export { default as XCircle } from "lucide-react/dist/esm/icons/x-circle.mjs"; diff --git a/studio/src/lucide-icons.d.ts b/studio/src/lucide-icons.d.ts new file mode 100644 index 0000000..799e731 --- /dev/null +++ b/studio/src/lucide-icons.d.ts @@ -0,0 +1,6 @@ +declare module "lucide-react/dist/esm/icons/*.mjs" { + import type { ComponentType, SVGProps } from "react"; + + const Icon: ComponentType & { size?: string | number }>; + export default Icon; +} diff --git a/studio/src/main.tsx b/studio/src/main.tsx new file mode 100644 index 0000000..9129e01 --- /dev/null +++ b/studio/src/main.tsx @@ -0,0 +1,23 @@ +import React from "react"; +import ReactDOM from "react-dom/client"; +import { HashRouter } from "react-router-dom"; +import { App } from "./App"; +import { StudioProvider } from "./StudioContext"; +import "./styles.css"; + +// HashRouter would read the skip link's "#studio-main" as a route and bounce +// the keyboard user to Home; focus the main region directly instead. +document.querySelector(".skip-link")?.addEventListener("click", (event) => { + event.preventDefault(); + document.getElementById("studio-main")?.focus(); +}); + +ReactDOM.createRoot(document.getElementById("root")!).render( + + + + + + + +); diff --git a/studio/src/pages/ArchivePage.test.tsx b/studio/src/pages/ArchivePage.test.tsx new file mode 100644 index 0000000..3560a20 --- /dev/null +++ b/studio/src/pages/ArchivePage.test.tsx @@ -0,0 +1,22 @@ +import { render, screen } from "@testing-library/react"; +import { describe, expect, it, vi } from "vitest"; +import { ArchivePage } from "./ArchivePage"; + +const mocks = vi.hoisted(() => ({ mastered: true })); +vi.mock("../StudioContext", () => ({ useStudio: () => ({ session: { mastery: mocks.mastered ? "mastered" : "practiced" } }) })); + +describe("ArchivePage", () => { + it("offers one disclosed Week 2 archive action after W1 mastery", () => { + render(); + const link = screen.getByRole("link", { name: "Continue to Week 2 archive" }); + expect(link).toHaveAttribute("href", "/legacy/notes.html?unit=w2"); + expect(screen.getByText("Opens legacy archive.")).toBeInTheDocument(); + expect(screen.getAllByRole("link")).toHaveLength(1); + }); + + it("does not offer Week 2 before W1 is mastered", () => { + mocks.mastered = false; + render(); + expect(screen.queryByRole("link", { name: "Continue to Week 2 archive" })).not.toBeInTheDocument(); + }); +}); diff --git a/studio/src/pages/ArchivePage.tsx b/studio/src/pages/ArchivePage.tsx new file mode 100644 index 0000000..827398a --- /dev/null +++ b/studio/src/pages/ArchivePage.tsx @@ -0,0 +1,26 @@ +import { ArrowRight, CheckCircle2, ExternalLink } from "../icons"; +import { useStudio } from "../StudioContext"; +import { PUBLIC_PREVIEW } from "../preview"; + +export function ArchivePage() { + const { session } = useStudio(); + const completed = session?.mastery === "mastered"; + + return ( +
      +
      + Completed lesson +

      W1 archive

      +

      {completed ? PUBLIC_PREVIEW ? "Your preview run is complete. It will reset when you leave." : "Your W1 completion is saved here. Return when a spaced-review card is due." : "W1 evidence appears here after the lesson is complete."}

      +
      +
      +
      + {completed && !PUBLIC_PREVIEW ?
      + Continue to Week 2 archive +

      +
      : completed ?

      Week 2 is available in the private local Study Studio.

      : null} +
      + ); +} diff --git a/studio/src/pages/ComponentGalleryPage.tsx b/studio/src/pages/ComponentGalleryPage.tsx new file mode 100644 index 0000000..ed51206 --- /dev/null +++ b/studio/src/pages/ComponentGalleryPage.tsx @@ -0,0 +1,13 @@ +import { AlertCircle, CheckCircle2, Info } from "../icons"; +import { Button } from "../components/atoms/Button"; + +export function ComponentGalleryPage() { + return ( +
      +
      Development only

      Component states

      Atomic components shown with real, empty, loading, error, and long-text states.

      +

      Actions

      +

      Feedback

      Saved

      Your independent evidence is stored.

      One repair

      The filename ends in .txt. Rename it to tiny-order.json.

      Local tutor off

      The deterministic lesson remains fully available.

      +

      Long content

      A deliberately long learner explanation must wrap without covering the next action. The file is one saved item, while the folder is the container that helps organize it, and the path describes every folder followed to reach the final item.

      +
      + ); +} diff --git a/studio/src/pages/CoursePage.tsx b/studio/src/pages/CoursePage.tsx new file mode 100644 index 0000000..9268e70 --- /dev/null +++ b/studio/src/pages/CoursePage.tsx @@ -0,0 +1,29 @@ +import { Check, LockKeyhole, Play } from "../icons"; +import { Link } from "react-router-dom"; +import { useStudio } from "../StudioContext"; +import { manifest } from "../content"; + +export function CoursePage() { + const { session } = useStudio(); + const currentIndex = manifest.units.findIndex((unit) => unit.id === session?.unitId); + return ( +
      +
      23 required units

      Course map

      The map supports the current lesson. It does not create a second definition of “next.”

      +
      + {manifest.units.map((unit, index) => { + const currentMastered = index === currentIndex && session?.mastery === "mastered"; + const state = index < currentIndex || currentMastered ? "complete" : index === currentIndex ? "current" : "upcoming"; + const Icon = state === "complete" ? Check : state === "current" ? Play : LockKeyhole; + return ( +
      + {index + 1} +
      {unit.level}

      {unit.title}

      {unit.one}

      + + {state === "current" ? Continue : null} +
      + ); + })} +
      +
      + ); +} diff --git a/studio/src/pages/FrontierInboxPage.test.tsx b/studio/src/pages/FrontierInboxPage.test.tsx new file mode 100644 index 0000000..43c9c7f --- /dev/null +++ b/studio/src/pages/FrontierInboxPage.test.tsx @@ -0,0 +1,31 @@ +import { render, screen, waitFor } from "@testing-library/react"; +import userEvent from "@testing-library/user-event"; +import { beforeEach, describe, expect, it, vi } from "vitest"; +import { FrontierInboxPage } from "./FrontierInboxPage"; + +const mocks = vi.hoisted(() => ({ demo: false, fetchInbox: vi.fn(), fetchDetail: vi.fn(), decide: vi.fn() })); +vi.mock("../StudioContext", () => ({ useStudio: () => ({ demo: mocks.demo }) })); +vi.mock("../api", () => ({ fetchFrontierInbox: mocks.fetchInbox, fetchFrontierInboxDetail: mocks.fetchDetail, decideProposal: mocks.decide })); + +describe("FrontierInboxPage", () => { + beforeEach(() => { + mocks.demo = false; + mocks.fetchInbox.mockReset().mockResolvedValue([{ id: "proposal-1", kind: "content_gap", summary: "Needs one more path visual.", status: "pending", createdAt: "now", advisoryOnly: true }]); + mocks.fetchDetail.mockReset().mockResolvedValue({ id: "proposal-1", kind: "content_gap", summary: "Needs one more path visual.", status: "pending", createdAt: "now", advisoryOnly: true, payload: { gap: "Needs one more path visual." } }); + mocks.decide.mockReset().mockResolvedValue({ proposal: { id: "proposal-1", status: "accepted", advisoryOnly: true } }); + }); + + it("opens an advisory item and records an explicit accept decision", async () => { + const user = userEvent.setup(); + render(); + + await screen.findByText("Needs one more path visual."); + await user.click(screen.getByRole("button", { name: "Open" })); + expect(await screen.findByText(/\"gap\"/)).toBeInTheDocument(); + await user.click(screen.getByRole("button", { name: "Accept" })); + + await waitFor(() => expect(mocks.decide).toHaveBeenCalledWith("proposal-1", "accepted")); + const status = screen.getByText("Proposal accepted. It remains advisory."); + await waitFor(() => expect(status).toHaveFocus()); + }); +}); diff --git a/studio/src/pages/FrontierInboxPage.tsx b/studio/src/pages/FrontierInboxPage.tsx new file mode 100644 index 0000000..fff02ed --- /dev/null +++ b/studio/src/pages/FrontierInboxPage.tsx @@ -0,0 +1,80 @@ +import { Check, Inbox, LoaderCircle, X } from "../icons"; +import { useEffect, useRef, useState } from "react"; +import { Navigate } from "react-router-dom"; +import { ApiRequestError, decideProposal, fetchFrontierInbox, fetchFrontierInboxDetail } from "../api"; +import { useStudio } from "../StudioContext"; +import type { FrontierInboxDetail, FrontierInboxItem } from "../types"; +import { Button } from "../components/atoms/Button"; +import { PUBLIC_PREVIEW } from "../preview"; + +type Status = { tone: "success" | "error"; message: string } | null; + +export function FrontierInboxPage() { + const { demo } = useStudio(); + const [items, setItems] = useState([]); + const [detail, setDetail] = useState(null); + const [loading, setLoading] = useState(true); + const [saving, setSaving] = useState(false); + const [status, setStatus] = useState(null); + const statusRef = useRef(null); + + useEffect(() => { + if (demo || PUBLIC_PREVIEW) return; + fetchFrontierInbox().then(setItems).catch(() => setStatus({ tone: "error", message: "Inbox did not load." })).finally(() => setLoading(false)); + }, [demo]); + + useEffect(() => { + if (status) statusRef.current?.focus({ preventScroll: true }); + }, [status]); + + if (demo || PUBLIC_PREVIEW) return ; + + async function open(item: FrontierInboxItem) { + setDetail(null); + setStatus(null); + try { + setDetail(await fetchFrontierInboxDetail(item.id)); + } catch { + setStatus({ tone: "error", message: "Item detail did not load." }); + } + } + + async function decide(decision: "accepted" | "rejected") { + if (!detail) return; + setSaving(true); + setStatus(null); + try { + const result = await decideProposal(detail.id, decision); + setItems((current) => current.map((item) => item.id === detail.id ? { ...item, status: result.proposal.status } : item)); + setDetail((current) => current ? { ...current, status: result.proposal.status } : current); + setStatus({ tone: "success", message: decision === "accepted" ? "Proposal accepted. It remains advisory." : "Proposal rejected." }); + } catch (error) { + if (error instanceof ApiRequestError && error.status === 409) { + setStatus({ tone: "error", message: "This proposal was already decided elsewhere. Showing its current state." }); + try { + const fresh = await fetchFrontierInboxDetail(detail.id); + setDetail(fresh); + setItems((current) => current.map((item) => item.id === fresh.id ? { ...item, status: fresh.status } : item)); + } catch { + // The message above already explains the stale state. + } + } else { + setStatus({ tone: "error", message: "Decision did not save." }); + } + } finally { + setSaving(false); + } + } + + return ( +
      +
      Advisory only

      Frontier Inbox

      Review suggestions. They never change progress on their own.

      + {loading ?
      : null} + {!loading ?
      + {items.length ? items.map((item) =>
      ) :

      No inbox items

      New advisory proposals appear here.

      } +
      : null} + {detail ?
      Advisory proposal

      {detail.kind.replaceAll("_", " ")}

      {detail.summary}

      {JSON.stringify(detail.payload, null, 2)}
      {detail.status === "pending" ?
      :

      Decision: {detail.status}.

      }
      : null} + {status ?
      {status.message}
      : null} +
      + ); +} diff --git a/studio/src/pages/HomePage.tsx b/studio/src/pages/HomePage.tsx new file mode 100644 index 0000000..282c31a --- /dev/null +++ b/studio/src/pages/HomePage.tsx @@ -0,0 +1,61 @@ +import { ArrowRight, BookOpenCheck, CalendarDays, CheckCircle2, Clock3, Server, ShieldCheck } from "../icons"; +import { useState } from "react"; +import { Link } from "react-router-dom"; +import { useStudio } from "../StudioContext"; +import { Button } from "../components/atoms/Button"; +import { ProgressRail } from "../components/molecules/ProgressRail"; +import { PUBLIC_PREVIEW } from "../preview"; + +export function HomePage() { + const { session, loading, demo, prepareReview } = useStudio(); + const [reviewStatus, setReviewStatus] = useState(""); + if (loading || !session) return
      {PUBLIC_PREVIEW ? "Opening the preview…" : "Loading your saved progress…"}
      ; + const mastered = session.mastery === "mastered"; + const reviewDue = mastered && session.dueReviews > 0; + const currentLabel = session.stages[session.stageIndex]?.label ?? "lesson"; + + async function prepare() { + const result = await prepareReview(); + setReviewStatus(result.prepared ? "Review packet ready in Codex or Claude." : demo ? "Deep review is available in local mode." : "Review packet was not prepared. Try again after restarting Study Studio."); + } + + return ( +
      +
      +
      + {reviewDue ? "Review due" : mastered ? "Lesson mastered" : "Continue where you stopped"} +

      {session.title}

      +

      {PUBLIC_PREVIEW + ? mastered ? "All six preview stages are complete. This run is not saved." : <>Your next step is {currentLabel}. Preview actions reset when you leave. + : reviewDue ? `${session.dueReviews} saved card${session.dueReviews === 1 ? " is" : "s are"} ready for a short review.` : mastered ? "All six lesson stages are complete. Your evidence and zero-guess result stay saved." : <>Your next step is {currentLabel}. Completed work stays saved.}

      +
      + {reviewDue ? "Start review" : mastered ? "Open W1 archive" : "Continue lesson"}
      + + + +
      +
      +
      +

      {reviewDue ? "Review the due card once. The next interval is set from your rating." : mastered ? "Nothing is overdue. Return only when a review card is due or when you are ready for the next unit." : <>Complete the {currentLabel.toLowerCase()} step. Anything else is a bonus.}

      +
      +
      + +
      +
      + {mastered ? ( +
      + ) : ( + <>
        {session.weeklyTopThree.map((item) =>
      1. {item}
        2. )}

      Unfinished work carries forward. The finish week can move.

      + )} +
      +
      + +
      +
      {PUBLIC_PREVIEW ?
      + {!demo ? : null} + {!demo && reviewStatus ? {reviewStatus} : null} +
      +
      + ); +} diff --git a/studio/src/pages/LibraryPage.test.tsx b/studio/src/pages/LibraryPage.test.tsx new file mode 100644 index 0000000..1047ecc --- /dev/null +++ b/studio/src/pages/LibraryPage.test.tsx @@ -0,0 +1,41 @@ +import { render, screen } from "@testing-library/react"; +import userEvent from "@testing-library/user-event"; +import { MemoryRouter } from "react-router-dom"; +import { describe, expect, it, vi } from "vitest"; +import { manifest } from "../content"; +import { LibraryPage } from "./LibraryPage"; + +vi.mock("../StudioContext", () => ({ useStudio: () => ({ session: { unitId: "w1" } }) })); + +function renderLibrary() { + return render(); +} + +describe("LibraryPage", () => { + it("shows the current lesson and the complete course directory", () => { + renderLibrary(); + expect(screen.getByRole("heading", { name: "Study library" })).toBeInTheDocument(); + expect(screen.getByRole("heading", { name: "Files, folders, and plain text" })).toBeInTheDocument(); + expect(screen.getByText("23", { selector: "dd" })).toBeInTheDocument(); + expect(screen.getByRole("tab", { name: `Videos ${manifest.media.videos.length}` })).toBeInTheDocument(); + expect(screen.getByText("JSON by hand")).toBeInTheDocument(); + }); + + it("searches lesson folders by topic", async () => { + const user = userEvent.setup(); + renderLibrary(); + await user.type(screen.getByRole("textbox", { name: "Search library" }), "MCP"); + expect(screen.getByText("An MCP server")).toBeInTheDocument(); + expect(screen.queryByText("JSON by hand")).not.toBeInTheDocument(); + }); + + it("exposes reviewed lesson clips and extra videos without unofficial exam coaching", async () => { + const user = userEvent.setup(); + renderLibrary(); + await user.click(screen.getByRole("tab", { name: `Videos ${manifest.media.videos.length}` })); + expect(screen.getByText("Agentic Loops and stop_reason Explained")).toBeInTheDocument(); + expect(screen.getByText("Multi-Agent System in Python and Claude SDK | Hands On")).toBeInTheDocument(); + expect(screen.queryByText("Exam Questions Solved and Exam Traps")).not.toBeInTheDocument(); + expect(screen.getByText(/Community video collection/)).toBeInTheDocument(); + }); +}); diff --git a/studio/src/pages/LibraryPage.tsx b/studio/src/pages/LibraryPage.tsx new file mode 100644 index 0000000..3ef3341 --- /dev/null +++ b/studio/src/pages/LibraryPage.tsx @@ -0,0 +1,218 @@ +import { useMemo, useState } from "react"; +import { Link } from "react-router-dom"; +import { ChevronDown, ExternalLink, FileText, Headphones, Play, Search, Video } from "../icons"; +import { manifest, unitById } from "../content"; +import { useStudio } from "../StudioContext"; +import type { CourseUnit, CourseVideo } from "../types"; + +type LibraryView = "lessons" | "videos"; +type VideoFilter = "all" | "lesson" | "extra"; + +const OFFICIAL_HOSTS = /(?:anthropic\.skilljar\.com|anthropic\.com|claude\.com|platform\.claude\.com|code\.claude\.com)/i; +const VIDEO_THUMBNAILS = import.meta.glob("../assets/video-thumbnails/*.jpg", { eager: true, import: "default", query: "?url" }) as Record; + +function isExternal(url: string) { + return /^https?:/i.test(url); +} + +function sourceLabel(url: string, index: number) { + if (!isExternal(url)) return index === 0 ? "Course visual" : "Course resource"; + return OFFICIAL_HOSTS.test(url) ? "Official source" : "External lesson"; +} + +function sourceHref(url: string) { + return isExternal(url) ? url : `/legacy/${url.replace(/^\//, "")}`; +} + +function formatTime(totalSeconds: number) { + const minutes = Math.floor(totalSeconds / 60); + const seconds = totalSeconds % 60; + return `${minutes}:${String(seconds).padStart(2, "0")}`; +} + +function ResourceRow({ unit, source, index, current, compact = false }: { + unit: CourseUnit; + source: [string, string, string]; + index: number; + current: boolean; + compact?: boolean; +}) { + const [url, title, focus] = source; + const openInLesson = current && index === 0 && !isExternal(url); + const label = sourceLabel(url, index); + const Heading = compact ? "h4" : "h3"; + return ( +
      + {index === 0 ? +
      + {label} + {title} +

      {focus}

      +

      +
      + {openInLesson ? ( + Open lesson + ) : ( + + Open source + )} +
      + ); +} + +function VideoRow({ video }: { video: CourseVideo }) { + const lessons = video.lessonIds.map((id) => unitById(id).title).join(" · "); + const clipLength = video.clip ? video.clip.endSec - video.clip.startSec : 0; + const thumbnail = VIDEO_THUMBNAILS[`../assets/video-thumbnails/${video.thumbnailId}.jpg`]; + return ( +
      + +
      + Episode {video.number} · {video.kind === "lesson" ? `Lesson clip ${formatTime(clipLength)}` : "Extra review"} +

      {video.title}

      +

      {video.focus}

      + {lessons &&

      Course connection: {lessons}

      } + {video.note && video.note !== video.focus &&

      Source note: {video.note}

      } +
      + +
      + ); +} + +export function LibraryPage() { + const { session } = useStudio(); + const currentUnit = unitById(session?.unitId ?? "w1"); + const [view, setView] = useState("lessons"); + const [query, setQuery] = useState(""); + const [phase, setPhase] = useState("all"); + const [videoFilter, setVideoFilter] = useState("all"); + const [expandedUnitIds, setExpandedUnitIds] = useState([currentUnit.id]); + + const phases = useMemo(() => Array.from(new Set(manifest.units.map((unit) => unit.level))), []); + const normalizedQuery = query.trim().toLowerCase(); + const lessonSourceCount = manifest.units.reduce((total, unit) => total + unit.watch.length, 0); + + const visibleUnits = useMemo(() => manifest.units.filter((unit) => { + if (phase !== "all" && unit.level !== phase) return false; + if (!normalizedQuery) return true; + return [unit.title, unit.level, unit.one, ...unit.concepts, ...unit.watch.flat()] + .join(" ") + .toLowerCase() + .includes(normalizedQuery); + }), [normalizedQuery, phase]); + + const visibleVideos = useMemo(() => manifest.media.videos.filter((video) => { + if (videoFilter !== "all" && video.kind !== videoFilter) return false; + if (!normalizedQuery) return true; + const lessonNames = video.lessonIds.map((id) => unitById(id).title); + return [video.title, video.focus, video.note, video.channel, ...lessonNames] + .join(" ") + .toLowerCase() + .includes(normalizedQuery); + }), [normalizedQuery, videoFilter]); + + const resultCount = view === "lessons" ? visibleUnits.length : visibleVideos.length; + + return ( +
      +
      + Visual study resources +

      Study library

      +

      Start with your lesson. Search the full course when you need another explanation or a quick review.

      +
      + +
      +
      Lesson folders
      {manifest.units.length}
      +
      Learning sources
      {lessonSourceCount}
      +
      Reviewed videos
      {manifest.media.videos.length}
      +
      + +
      +
      +
      + Start here · current lesson +

      {currentUnit.title}

      +

      Use these before opening the full collection.

      +
      + Continue lesson +
      +
      + {currentUnit.watch.map((source, index) => ( + + ))} +
      +
      + +
      +
      +
      + Browse everything +

      All course resources

      +

      Choose a lesson folder or the reviewed video collection.

      +
      + Open full playlist +
      + +
      + +
      + + +
      + {view === "lessons" ? ( + + ) : ( + + )} +
      + +

      Showing {resultCount} {view === "lessons" ? "lesson folders" : "videos"}.

      + + {view === "lessons" ? ( +
      + {visibleUnits.map((unit, index) => ( +
      { + if (normalizedQuery) return; + const isOpen = event.currentTarget.open; + setExpandedUnitIds((current) => isOpen + ? Array.from(new Set([...current, unit.id])) + : current.filter((id) => id !== unit.id)); + }} + > + + {String(manifest.units.indexOf(unit) + 1).padStart(2, "0")} + {unit.level}{unit.title} + {unit.watch.length} {unit.watch.length === 1 ? "source" : "sources"} + +
      + {unit.watch.map((source, sourceIndex) => )} +
      +
      + ))} + {!visibleUnits.length &&

      No lesson folders found

      Try a broader word, or choose All phases.

      } +
      + ) : ( +
      +
      +
      {visibleVideos.map((video) => )}
      + {!visibleVideos.length &&

      No videos found

      Try a broader word, or choose All reviewed videos.

      } +
      + )} +
      +
      + ); +} diff --git a/studio/src/pages/ReviewHubPage.tsx b/studio/src/pages/ReviewHubPage.tsx new file mode 100644 index 0000000..7821b58 --- /dev/null +++ b/studio/src/pages/ReviewHubPage.tsx @@ -0,0 +1,19 @@ +import { ArrowRight, RotateCcw } from "../icons"; +import { Link } from "react-router-dom"; +import { useStudio } from "../StudioContext"; + +export function ReviewHubPage() { + const { session } = useStudio(); + const due = session?.dueReviews ?? 0; + const hasDueReview = due > 0; + return ( +
      +
      Spaced practice

      Review queue

      Wrong answers and correct guesses return here.

      +
      +
      +
      + ); +} diff --git a/studio/src/pages/SessionPage.tsx b/studio/src/pages/SessionPage.tsx new file mode 100644 index 0000000..b1ee9de --- /dev/null +++ b/studio/src/pages/SessionPage.tsx @@ -0,0 +1,57 @@ +import { ArrowRight, CheckCircle2 } from "../icons"; +import { Link } from "react-router-dom"; +import { useStudio } from "../StudioContext"; +import { FeedbackBanner } from "../components/molecules/FeedbackBanner"; +import { ProgressRail } from "../components/molecules/ProgressRail"; +import { TutorDrawer } from "../components/organisms/TutorDrawer"; +import { BuildStage } from "../stages/BuildStage"; +import { DrawStage } from "../stages/DrawStage"; +import { LearnStage } from "../stages/LearnStage"; +import { QuizStage } from "../stages/QuizStage"; +import { ReviewStage } from "../stages/ReviewStage"; +import { TeachStage } from "../stages/TeachStage"; +import { useSceneFocus } from "../useSceneFocus"; +import { PUBLIC_PREVIEW } from "../preview"; + +const stages = { + learn: LearnStage, + draw: DrawStage, + build: BuildStage, + teach: TeachStage, + quiz: QuizStage, + review: ReviewStage +}; + +export function SessionPage() { + const { session, loading } = useStudio(); + useSceneFocus(`${session?.stage ?? "loading"}:${session?.mastery ?? "seen"}`); + if (loading || !session) return
      Opening your lesson…
      ; + if (session.mastery === "mastered" && session.dueReviews === 0) { + return ( +
      + + +
      +
      +
      + ); + } + const Stage = stages[session.stage]; + return ( +
      + + +
      + + +
      +
      + ); +} diff --git a/studio/src/pages/SettingsPage.test.tsx b/studio/src/pages/SettingsPage.test.tsx new file mode 100644 index 0000000..2d0c16d --- /dev/null +++ b/studio/src/pages/SettingsPage.test.tsx @@ -0,0 +1,106 @@ +import { render, screen, waitFor } from "@testing-library/react"; +import userEvent from "@testing-library/user-event"; +import { beforeEach, describe, expect, it, vi } from "vitest"; +import { SettingsPage } from "./SettingsPage"; + +const mocks = vi.hoisted(() => ({ + demo: false, + refreshSession: vi.fn(), + fetchMigrationReport: vi.fn(), + inspectBackup: vi.fn(), + commitBackup: vi.fn(), + commitLegacyImport: vi.fn(), + downloadBackup: vi.fn(), + ollamaAvailable: false, + ollama: { status: "unavailable" } +})); + +vi.mock("../StudioContext", () => ({ + useStudio: () => ({ demo: mocks.demo, refreshSession: mocks.refreshSession, ollamaAvailable: mocks.ollamaAvailable, ollama: mocks.ollama }) +})); +vi.mock("../api", () => ({ + fetchMigrationReport: mocks.fetchMigrationReport, + inspectBackup: mocks.inspectBackup, + commitBackup: mocks.commitBackup, + commitLegacyImport: mocks.commitLegacyImport, + downloadBackup: mocks.downloadBackup +})); + +describe("Settings recovery", () => { + beforeEach(() => { + localStorage.clear(); + mocks.demo = false; + mocks.ollamaAvailable = false; + mocks.ollama = { status: "unavailable" }; + mocks.refreshSession.mockReset().mockResolvedValue(undefined); + mocks.fetchMigrationReport.mockReset().mockResolvedValue({ sourceFound: false, sourceUnchanged: true, status: "not_found" }); + mocks.inspectBackup.mockReset(); + mocks.commitBackup.mockReset(); + mocks.commitLegacyImport.mockReset(); + mocks.downloadBackup.mockReset(); + }); + + it("hides every recovery control in preview mode", () => { + mocks.demo = true; + render(); + expect(screen.queryByRole("heading", { name: "Recovery" })).not.toBeInTheDocument(); + expect(mocks.fetchMigrationReport).not.toHaveBeenCalled(); + }); + + it("explains when an enabled local tutor is temporarily protected", () => { + mocks.ollama = { status: "protected" }; + render(); + + expect(screen.getByRole("switch", { name: /Local tutor/i })).toBeChecked(); + expect(screen.getByText(/On, but paused to protect this Mac's memory/i)).toBeInTheDocument(); + }); + + it("describes the local tutor as off when its switch is off", () => { + localStorage.setItem("ccaf-studio-local-ai", "off"); + render(); + + expect(screen.getByRole("switch", { name: /Local tutor/i })).not.toBeChecked(); + expect(screen.getByText("Off. Saved hints remain available.")).toBeInTheDocument(); + }); + + it("inspects a backup before an explicit restore and reloads the session", async () => { + mocks.inspectBackup.mockResolvedValue({ + importToken: "11111111-1111-4111-8111-111111111111", + valid: true, + schemaVersion: 3, + databaseId: "db-1", + stateDigest: "digest-1", + warning: "Confirm" + }); + mocks.commitBackup.mockResolvedValue({ imported: true, databaseId: "db-1", stateDigest: "digest-1" }); + const user = userEvent.setup(); + render(); + + await user.upload(screen.getByLabelText("Choose backup"), new File(["backup"], "study.ccaf-backup", { type: "application/zip" })); + expect(await screen.findByText("db-1")).toBeInTheDocument(); + await user.click(screen.getByRole("button", { name: "Confirm restore" })); + + await waitFor(() => expect(mocks.commitBackup).toHaveBeenCalledWith("11111111-1111-4111-8111-111111111111")); + expect(mocks.refreshSession).toHaveBeenCalledOnce(); + const status = screen.getByText("Backup restored. Session reloaded."); + await waitFor(() => expect(status).toHaveFocus()); + }); + + it("shows and confirms only a pending legacy import", async () => { + mocks.fetchMigrationReport.mockResolvedValue({ + status: "pending_confirmation", + sourceFound: true, + sourceSha256: "a".repeat(64), + sourceUnchanged: true, + w1CandidateChecks: [true, true, false, false, false, false] + }); + mocks.commitLegacyImport.mockResolvedValue({ imported: true, changed: true, session: {} }); + const user = userEvent.setup(); + render(); + + expect(await screen.findByText(/Candidate W1 checks: 2\/6\./)).toBeInTheDocument(); + await user.click(screen.getByRole("button", { name: "Import legacy checks" })); + await waitFor(() => expect(mocks.commitLegacyImport).toHaveBeenCalledWith("a".repeat(64))); + expect(mocks.refreshSession).toHaveBeenCalledOnce(); + }); +}); diff --git a/studio/src/pages/SettingsPage.tsx b/studio/src/pages/SettingsPage.tsx new file mode 100644 index 0000000..212e6bf --- /dev/null +++ b/studio/src/pages/SettingsPage.tsx @@ -0,0 +1,171 @@ +import { Cpu, Download, Eye, Gauge, RotateCcw, Upload, Volume2 } from "../icons"; +import { useCallback, useEffect, useRef, useState } from "react"; +import { commitBackup, commitLegacyImport, downloadBackup, fetchMigrationReport, inspectBackup } from "../api"; +import { useStudio } from "../StudioContext"; +import type { BackupInspection, MigrationReport } from "../types"; +import { Button } from "../components/atoms/Button"; +import { PUBLIC_PREVIEW } from "../preview"; + +type Status = { tone: "success" | "error"; message: string } | null; + +function RecoverySection() { + const { refreshSession } = useStudio(); + const [inspection, setInspection] = useState(null); + const [migration, setMigration] = useState(null); + const [busy, setBusy] = useState<"download" | "inspect" | "restore" | "legacy" | null>(null); + const [status, setStatus] = useState(null); + const [migrationError, setMigrationError] = useState(false); + const statusRef = useRef(null); + + const loadMigration = useCallback(() => { + setMigrationError(false); + void fetchMigrationReport().then(setMigration).catch(() => setMigrationError(true)); + }, []); + + useEffect(() => { + loadMigration(); + }, [loadMigration]); + + useEffect(() => { + if (status) statusRef.current?.focus({ preventScroll: true }); + }, [status]); + + async function download() { + setBusy("download"); + setStatus(null); + try { + const backup = await downloadBackup(); + const href = URL.createObjectURL(backup.blob); + const link = document.createElement("a"); + link.href = href; + link.download = backup.filename; + link.click(); + URL.revokeObjectURL(href); + setStatus({ tone: "success", message: "Backup downloaded." }); + } catch { + setStatus({ tone: "error", message: "Backup download did not start." }); + } finally { + setBusy(null); + } + } + + async function chooseBackup(file: File | undefined) { + if (!file) return; + setBusy("inspect"); + setInspection(null); + setStatus(null); + try { + setInspection(await inspectBackup(file)); + setStatus({ tone: "success", message: "Backup checked. Confirm restore to continue." }); + } catch { + setStatus({ tone: "error", message: "That backup could not be checked." }); + } finally { + setBusy(null); + } + } + + async function restore() { + if (!inspection) return; + setBusy("restore"); + setStatus(null); + let committed = false; + try { + await commitBackup(inspection.importToken); + committed = true; + setInspection(null); + await refreshSession(); + setStatus({ tone: "success", message: "Backup restored. Session reloaded." }); + } catch { + if (committed) { + setStatus({ tone: "success", message: "Backup restored. Reload this page to see it." }); + } else { + setStatus({ tone: "error", message: "Restore did not finish. Your current database was kept." }); + } + } finally { + setBusy(null); + } + } + + async function importLegacy() { + if (!migration?.sourceSha256) return; + setBusy("legacy"); + setStatus(null); + let committed = false; + try { + await commitLegacyImport(migration.sourceSha256); + committed = true; + setMigration((report) => report ? { ...report, status: "imported" } : report); + await refreshSession(); + setStatus({ tone: "success", message: "Legacy checks imported. Session reloaded." }); + } catch { + if (committed) { + setStatus({ tone: "success", message: "Legacy checks imported. Reload this page to see them." }); + } else { + setStatus({ tone: "error", message: "Legacy import did not finish. Source progress was not changed." }); + } + } finally { + setBusy(null); + } + } + + const candidateChecks = migration?.w1CandidateChecks?.filter(Boolean).length ?? 0; + return ( +
      +
      +
      +
      BackupDownload a private recovery copy.
      + +
      +
      +
      Restore a backupCheck a .ccaf-backup file before it can replace Studio progress.
      + +
      + {inspection ?
      Database{inspection.databaseId}Schema{inspection.schemaVersion}Digest{inspection.stateDigest}{typeof inspection.incomingStateVersion === "number" && typeof inspection.currentStateVersion === "number" && inspection.incomingStateVersion < inspection.currentStateVersion ? CarefulThis backup is older than your current progress. : null}
      : null} + {migration?.status === "pending_confirmation" ?
      +
      Legacy import{`Source unchanged: ${migration.sourceUnchanged ? "yes" : "no"}. Candidate W1 checks: ${candidateChecks}/6.`}
      + +
      : null} + {migrationError ?
      +
      Legacy importStudy Studio could not check for legacy progress just now.
      + +
      : null} + {status ?
      {status.message}
      : null} +
      + ); +} + +export function SettingsPage() { + const { ollamaAvailable, ollama, demo } = useStudio(); + const [localAi, setLocalAi] = useState(() => localStorage.getItem("ccaf-studio-local-ai") !== "off"); + const [largeText, setLargeText] = useState(() => localStorage.getItem("ccaf-studio-large-text") === "on"); + const [quietMotion, setQuietMotion] = useState(() => localStorage.getItem("ccaf-studio-quiet-motion") === "on"); + + useEffect(() => { + document.documentElement.dataset.largeText = largeText ? "true" : "false"; + document.documentElement.dataset.quietMotion = quietMotion ? "true" : "false"; + localStorage.setItem("ccaf-studio-local-ai", localAi ? "on" : "off"); + localStorage.setItem("ccaf-studio-large-text", largeText ? "on" : "off"); + localStorage.setItem("ccaf-studio-quiet-motion", quietMotion ? "on" : "off"); + }, [localAi, largeText, quietMotion]); + + const localTutorStatus = !localAi + ? "Off. Saved hints remain available." + : ollamaAvailable + ? "On. llama3.2:3b is ready and unloads after each answer." + : ollama.status === "protected" + ? "On, but paused to protect this Mac's memory. Saved hints stay available." + : "On. Saved hints are used while Ollama is unavailable."; + + return ( +
      +
      Mac study preferences

      Settings

      +
      + + + +
      +
      + {!demo && !PUBLIC_PREVIEW ? : null} +
      + ); +} diff --git a/studio/src/preview.ts b/studio/src/preview.ts new file mode 100644 index 0000000..80750ca --- /dev/null +++ b/studio/src/preview.ts @@ -0,0 +1,3 @@ +export const PUBLIC_PREVIEW = import.meta.env.VITE_CCAF_PUBLIC_PREVIEW === "true"; + +export const PREVIEW_NOTICE = "Preview only. Progress is not saved."; diff --git a/studio/src/stages/BuildStage.test.tsx b/studio/src/stages/BuildStage.test.tsx new file mode 100644 index 0000000..ea1844a --- /dev/null +++ b/studio/src/stages/BuildStage.test.tsx @@ -0,0 +1,21 @@ +import { render, screen } from "@testing-library/react"; +import userEvent from "@testing-library/user-event"; +import { describe, expect, it, vi } from "vitest"; +import { BuildStage } from "./BuildStage"; + +const mocks = vi.hoisted(() => ({ completeStage: vi.fn() })); +vi.mock("../StudioContext", () => ({ useStudio: () => ({ completeStage: mocks.completeStage }) })); + +describe("BuildStage prerequisite bridge", () => { + it("explains the boundary before opening the editor", async () => { + const user = userEvent.setup(); + render(); + + expect(screen.getByRole("heading", { name: /learning the file, not JSON punctuation/i })).toBeInTheDocument(); + expect(screen.getByText(/W2 teaches JSON/i)).toBeInTheDocument(); + expect(screen.queryByText(/replace the blank/i)).not.toBeInTheDocument(); + + await user.click(screen.getByRole("button", { name: /open the practice workbench/i })); + expect(await screen.findByRole("heading", { name: /inspect one complete text file/i })).toBeInTheDocument(); + }); +}); diff --git a/studio/src/stages/BuildStage.tsx b/studio/src/stages/BuildStage.tsx new file mode 100644 index 0000000..df3b48f --- /dev/null +++ b/studio/src/stages/BuildStage.tsx @@ -0,0 +1,149 @@ +import { CheckCircle2, FileCheck2, FolderOpen, MonitorUp, ShieldCheck } from "../icons"; +import { lazy, Suspense, type ChangeEvent, useMemo, useState } from "react"; +import { useStudio } from "../StudioContext"; +import { Button } from "../components/atoms/Button"; +import { useSceneFocus } from "../useSceneFocus"; + +const CodeEditor = lazy(() => import("../components/organisms/CodeEditor").then((module) => ({ default: module.CodeEditor }))); + +const STARTER = `{ + "item": "tea", + "quantity": 2 +}`; + +type BuildPart = "bridge" | "practice" | "mac"; + +export function BuildStage() { + const { saving, completeStage, demo } = useStudio(); + const [part, setPart] = useState("bridge"); + useSceneFocus(`build-${part}`); + const [code, setCode] = useState(STARTER); + const [practiceMessage, setPracticeMessage] = useState(""); + const [fileName, setFileName] = useState(""); + const [fileText, setFileText] = useState(""); + const [fileError, setFileError] = useState(""); + const [path, setPath] = useState(""); + const [plainText, setPlainText] = useState(false); + const [independent, setIndependent] = useState(false); + + const practiceValid = useMemo(() => { + try { JSON.parse(code); return true; } catch { return false; } + }, [code]); + const fileValid = fileName === "tiny-order.json" && fileText.trim().length > 0; + const pathValid = path.trim().endsWith("tiny-order.json") && path.includes("/"); + const ready = fileValid && pathValid && plainText && independent; + + async function chooseFile(event: ChangeEvent) { + const file = event.target.files?.[0]; + if (!file) return; + setFileError(""); + setFileName(file.name); + // The local server rejects bodies over 1 MB; tiny-order.json is a few lines. + if (file.size > 200_000) { + setFileText(""); + setFileError("That file is too big to be tiny-order.json. Choose the small file you saved in TextEdit."); + return; + } + try { + setFileText(await file.text()); + } catch { + setFileText(""); + setFileError("That file could not be read. Choose it again."); + } + } + + if (part === "bridge") { + return ( +
      +
      + Build 1 of 3 +

      Today you are learning the file, not JSON punctuation

      +

      W2 teaches JSON. For this task, the contents are already written correctly so you can focus on saving a plain-text file with the right name and location.

      +
      +
      + + + +
      +
      +

      No blank fields

      +

      You do not need to replace ____ with anything. The complete practice content appears in the next step.

      +
      +
      +

      Next, inspect a working example before creating the real file.

      + +
      +
      + ); + } + + if (part === "practice") { + return ( +
      +
      + Build 2 of 3 +

      Inspect one complete text file

      +

      The editor is a safe practice area. The braces and quotes will be explained in W2.

      +
      + Opening the practice editor…
      }> + + +
      + {practiceValid ?
      +
      + + +
      +
      +

      The real task happens in TextEdit on your Mac.

      + +
      + + ); + } + + return ( +
      +
      + Build 3 of 3 +

      Create and verify the file on your Mac

      +

      Use TextEdit in plain-text mode. Save the file as tiny-order.json inside your study folder.

      +
      + +
        +
      1. 1
        Open TextEdit

        Choose Format → Make Plain Text.

        2. +
      2. 2
        Use the complete practice text

        Type it yourself or refer back to the workbench.

        3. +
      3. 3
        Save the exact name

        Use tiny-order.json, not tiny-order.json.txt.

        4. +
      + +
      + +
      + File check{fileName || "No file chosen"}{fileError ? fileError : fileValid ? "Exact name and readable text found" : "Choose tiny-order.json"} +
      +
      + + + +
      + + +
      + +
      +

      {ready ? "All four independent-build checks passed." : "Choose the file, enter its path, and confirm both checks."}

      + +
      +
      + ); +} diff --git a/studio/src/stages/DrawStage.tsx b/studio/src/stages/DrawStage.tsx new file mode 100644 index 0000000..4f0d0d3 --- /dev/null +++ b/studio/src/stages/DrawStage.tsx @@ -0,0 +1,120 @@ +import { Eraser, PencilLine } from "../icons"; +import { PointerEvent, useEffect, useRef, useState } from "react"; +import { useStudio } from "../StudioContext"; +import { Button } from "../components/atoms/Button"; + +interface Point { x: number; y: number } + +function paint(canvas: HTMLCanvasElement, strokes: Point[][]) { + const context = canvas.getContext("2d"); + if (!context) return; + const ratio = window.devicePixelRatio || 1; + const bounds = canvas.getBoundingClientRect(); + canvas.width = Math.max(1, Math.round(bounds.width * ratio)); + canvas.height = Math.max(1, Math.round(bounds.height * ratio)); + context.setTransform(ratio, 0, 0, ratio, 0, 0); + context.clearRect(0, 0, bounds.width, bounds.height); + context.lineCap = "round"; + context.lineJoin = "round"; + context.strokeStyle = "#176c78"; + context.lineWidth = 4; + for (const stroke of strokes) { + if (stroke.length < 2) continue; + context.beginPath(); + context.moveTo(stroke[0].x, stroke[0].y); + for (let index = 1; index < stroke.length; index += 1) context.lineTo(stroke[index].x, stroke[index].y); + context.stroke(); + } +} + +export function DrawStage() { + const { saving, completeStage, demo } = useStudio(); + const canvasRef = useRef(null); + const activeRef = useRef([]); + const [strokes, setStrokes] = useState([]); + const [description, setDescription] = useState(""); + + useEffect(() => { + const canvas = canvasRef.current; + if (!canvas) return; + const repaint = () => paint(canvas, strokes); + repaint(); + const observer = new ResizeObserver(repaint); + observer.observe(canvas); + return () => observer.disconnect(); + }, [strokes]); + + function pointFromEvent(event: PointerEvent): Point { + const bounds = event.currentTarget.getBoundingClientRect(); + return { x: event.clientX - bounds.left, y: event.clientY - bounds.top }; + } + + function startDrawing(event: PointerEvent) { + event.currentTarget.setPointerCapture(event.pointerId); + activeRef.current = [pointFromEvent(event)]; + } + + function continueDrawing(event: PointerEvent) { + if (!event.currentTarget.hasPointerCapture(event.pointerId)) return; + const points = activeRef.current; + const previous = points[points.length - 1]; + const next = pointFromEvent(event); + points.push(next); + if (!previous) return; + const context = event.currentTarget.getContext("2d"); + if (!context) return; + context.beginPath(); + context.moveTo(previous.x, previous.y); + context.lineTo(next.x, next.y); + context.stroke(); + } + + function finishDrawing(event: PointerEvent) { + if (event.currentTarget.hasPointerCapture(event.pointerId)) event.currentTarget.releasePointerCapture(event.pointerId); + const completed = activeRef.current; + activeRef.current = []; + if (completed.length) setStrokes((items) => [...items, completed]); + } + + function clearDrawing() { + activeRef.current = []; + setStrokes([]); + const canvas = canvasRef.current; + if (canvas) paint(canvas, []); + } + + const hasEvidence = strokes.length > 0 || description.trim().length >= 20; + return ( +
      +
      + Make the route visible +

      Draw folders leading to a file

      +

      Use boxes and arrows. Label the final item tiny-order.json.

      +
      + +
      + + +
      + + +
      diff --git a/tests/e2e/learner-journey.spec.js b/tests/e2e/learner-journey.spec.js new file mode 100644 index 0000000..4188133 --- /dev/null +++ b/tests/e2e/learner-journey.spec.js @@ -0,0 +1,352 @@ +const base = require("@playwright/test"); +const { expect } = base; + +const test = base.test.extend({ + page: async ({ page }, use) => { + const errors = []; + page.on("pageerror", (error) => errors.push(`page: ${error.message}`)); + page.on("console", (message) => { + if (message.type() === "error") errors.push(`console: ${message.text()}`); + }); + await page.route(/\/__health(?:\?|$)/, (route) => route.fulfill({ status: 200, contentType: "application/json", body: '{"save":true}' })); + await page.route(/\/my-progress\.json(?:\?|$)/, (route) => route.fulfill({ status: 200, contentType: "application/json", body: '{"ts":0,"data":{}}' })); + await page.route(/\/__save(?:\?|$)/, (route) => route.fulfill({ status: 200, contentType: "application/json", body: '{"ok":true}' })); + await use(page); + expect(errors, "serious browser errors").toEqual([]); + } +}); + +async function seed(page, values) { + await page.addInitScript((items) => { + for (const [key, value] of Object.entries(items)) localStorage.setItem(key, value); + }, values); +} + +test("fresh learner starts at the first foundation lesson", async ({ page }) => { + await page.goto("/dashboard.html"); + await expect(page.locator("#navBack")).toHaveCount(0); + await expect(page.locator("#where-count")).toHaveText("0 / 23 units done"); + await expect(page.locator("#where-next")).toHaveText("Files, folders, and plain text"); + const pipeline = await page.evaluate(() => JSON.parse(localStorage.getItem("ccaf-pipeline"))); + expect(pipeline.unit).toBe("w1"); + + const lessonLink = page.locator('#site-nav a[href="today.html"]'); + await expect(lessonLink).toHaveCount(1); + await Promise.all([page.waitForURL(/\/today\.html$/), lessonLink.click()]); + await expect(page.locator("#nexttitle")).toHaveText("Files, folders, and plain text"); +}); + +test("plain static-server mode never floods unsupported progress saves", async ({ page }) => { + let saves = 0; + await page.unroute(/\/__health(?:\?|$)/); + await page.route(/\/__health(?:\?|$)/, (route) => route.fulfill({ status: 200, contentType: "application/json", body: '{"save":false}' })); + await page.unroute(/\/__save(?:\?|$)/); + await page.route(/\/__save(?:\?|$)/, (route) => { saves += 1; return route.fulfill({ status: 501, body: "" }); }); + await page.goto("/dashboard.html"); + await page.evaluate(() => localStorage.setItem("ccaf-test-save", "local only")); + await page.waitForTimeout(700); + expect(await page.evaluate(() => CCAF_SYNC.mode)).toBe("nofile"); + expect(saves).toBe(0); +}); + +test("established progress resumes at the correct lesson", async ({ page }) => { + await seed(page, { + "ccaf-curriculum": JSON.stringify({ done: { w1: true }, opened: {} }), + "ccaf-everdone": JSON.stringify({ w1: true }) + }); + await page.goto("/today.html"); + await expect(page.locator("#nexttitle")).toHaveText("JSON by hand"); + await expect(page.locator("#unitsdone")).toContainText("1 / 23"); +}); + +test("curriculum summaries match the shared course manifest", async ({ page }) => { + await page.goto("/curriculum.html"); + const values = await page.evaluate(() => { + const unit = CCAF_COURSE.map.o1; + const row = document.querySelector("#u-o1"); + return { + expectedTitle: unit.title, + expectedGoal: unit.one, + title: row.querySelector(".ttl").textContent, + goal: row.querySelector(".one").textContent, + tutorPrompt: row.querySelector("[data-q]").getAttribute("data-q"), + expectedPrompt: unit.ask, + quiz: row.querySelector(".qlink").getAttribute("href"), + expectedQuiz: unit.quiz + }; + }); + expect(values.title).toBe(values.expectedTitle); + expect(values.goal).toBe(values.expectedGoal); + expect(values.tutorPrompt).toBe(values.expectedPrompt); + expect(values.quiz).toContain(values.expectedQuiz); +}); + +test("shared navigation and timeline completion work from the keyboard", async ({ page }) => { + await page.goto("/timeline.html"); + await expect(page.locator("#navBack")).toHaveCount(0); + await expect(page.locator('.skip-link[href="#main-content"]')).toHaveCount(1); + await page.evaluate(() => { + localStorage.setItem("ccaf-curriculum", JSON.stringify({ done: { w1: true }, opened: {} })); + }); + await page.reload(); + + const more = page.locator("#navMoreBtn"); + await more.focus(); + await more.press("ArrowDown"); + await expect(more).toHaveAttribute("aria-expanded", "true"); + expect(await page.evaluate(() => document.activeElement.closest("#navMenu") !== null)).toBe(true); + await page.keyboard.press("Escape"); + await expect(more).toHaveAttribute("aria-expanded", "false"); + await expect(more).toBeFocused(); + + const unmark = page.getByRole("button", { name: /Un-mark Files, folders, and plain text as done/ }); + await unmark.focus(); + page.once("dialog", (dialog) => dialog.accept()); + await Promise.all([page.waitForNavigation({ waitUntil: "domcontentloaded" }), unmark.press("Enter")]); + const done = await page.evaluate(() => JSON.parse(localStorage.getItem("ccaf-curriculum")).done); + expect(done.w1).toBeUndefined(); +}); + +test("notes boundaries and flashcard flip are accessible", async ({ page }) => { + await page.goto("/notes.html?unit=w1"); + await expect(page.locator("#nprev")).toHaveAttribute("aria-disabled", "true"); + await expect(page.locator("#nprev")).not.toHaveAttribute("href", /.+/); + await page.goto("/notes.html?unit=p2"); + await expect(page.locator("#nnext")).toHaveAttribute("aria-disabled", "true"); + + await page.goto("/flashcards.html"); + const browse = page.locator('a[href*="mode=browse"]').first(); + await Promise.all([page.waitForURL(/mode=browse/), browse.click()]); + await page.waitForLoadState("domcontentloaded"); + const card = page.locator("#bcard"); + await expect(card).toHaveAttribute("aria-pressed", "false"); + await card.focus(); + await card.press("Enter"); + await expect(card).toHaveAttribute("aria-pressed", "true"); +}); + +test("quiz scoring persists guesses without navigating away", async ({ page }) => { + await page.goto("/quiz.html?unit=w1"); + const questions = page.locator("#quiz .quiz-question"); + const count = await questions.count(); + expect(count).toBeGreaterThanOrEqual(5); + for (let index = 0; index < count; index += 1) { + const active = page.locator(".quiz-question.is-active"); + await expect(active).toHaveCount(1); + await active.locator('input[type="radio"]').first().check(); + if (index === 0) await active.locator(".gg").check(); + if (index < count - 1) await page.locator("#qnext").click(); + } + await page.locator("#scoreBtn").click(); + await expect(page.locator("#results")).toBeVisible(); + await expect(page.locator("#results")).toBeFocused(); + const result = await page.evaluate(() => JSON.parse(localStorage.getItem("ccaf-quizdone")).w1); + expect(result.total).toBe(count); + expect(result.guessed).toBe(1); +}); + +test("a later practice retake does not revoke an earned zero-guess pass", async ({ page }) => { + await seed(page, { + "ccaf-quizdone": JSON.stringify({ w1: { score: 5, total: 5, guessed: 0, set: "earlier", ts: "earlier" } }) + }); + await page.goto("/quiz.html?unit=w1"); + const wrongAnswers = await page.evaluate(() => QLIST.map((question) => (question.ans + 1) % question.opts.length)); + for (let index = 0; index < wrongAnswers.length; index += 1) { + await page.locator(`.quiz-question.is-active input[name="q${index}"][value="${wrongAnswers[index]}"]`).check(); + if (index < wrongAnswers.length - 1) await page.locator("#qnext").click(); + } + await page.locator("#scoreBtn").click(); + const state = await page.evaluate(() => ({ saved: JSON.parse(localStorage.getItem("ccaf-quizdone")).w1, quizOK: CCAF.mastery("w1").quizOK })); + expect(state.saved.score).toBe(0); + expect(state.saved.qualified).toMatchObject({ score: 5, total: 5, guessed: 0 }); + expect(state.quizOK).toBe(true); +}); + +test("build and teach-back save independent mastery evidence", async ({ page }) => { + await page.goto("/exercise.html?id=file-map"); + const answers = page.locator("textarea.ans"); + for (let index = 0; index < await answers.count(); index += 1) { + await answers.nth(index).fill(`My complete practice answer for field ${index + 1}.`); + } + await page.locator('input[name="mode"][value="independent"]').check(); + await page.locator("#btndone").click(); + await expect(page.locator("#finishmsg")).toContainText("Independent build evidence saved"); + await expect(page.locator('#next-step a[href="teachback.html?unit=w1"]')).toHaveText(/Next: teach it back/); + let evidence = await page.evaluate(() => JSON.parse(localStorage.getItem("ccaf-evidence"))); + expect(evidence.w1.build.data.mode).toBe("independent"); + await page.locator("#btndone").click(); + evidence = await page.evaluate(() => JSON.parse(localStorage.getItem("ccaf-evidence"))); + expect(evidence.w1.build).toBeUndefined(); + expect(await page.evaluate(() => CCAF.getSteps("w1")[2])).toBe(false); + await page.locator("#btndone").click(); + + await page.goto("/teachback.html?unit=w1"); + await page.locator("#words").fill("A file holds information, a folder contains files, and a path tells the computer exactly where to find one."); + const checks = page.locator("[data-r]"); + for (let index = 0; index < await checks.count(); index += 1) await checks.nth(index).check(); + await page.locator("#complete").click(); + await expect(page.locator("#status")).toContainText("Teach-back evidence saved"); + await expect(page.locator('#next-step a[href^="quiz.html"]')).toHaveText(/Next: take the quiz/); + evidence = await page.evaluate(() => JSON.parse(localStorage.getItem("ccaf-evidence"))); + expect(evidence.w1.teachback.data.complete).toBe(true); +}); + +test("an optional legacy exercise cannot satisfy a lesson's required build", async ({ page }) => { + await page.goto("/today.html"); + await page.evaluate(() => { + localStorage.setItem("ccaf-evidence", JSON.stringify({ o1: { build: { data: { exercise: "gate-chain", mode: "independent", complete: true }, ts: Date.now() } } })); + }); + expect(await page.evaluate(() => CCAF.mastery("o1").buildOK)).toBe(false); +}); + +test("review queue schedules a mistake card and announces completion", async ({ page }) => { + await seed(page, { + "ccaf-mistake-cards": JSON.stringify({ + one: { id: "one", unit: "w1", front: "What is a file?", back: "A named container for information.", source: "missed" } + }), + "ccaf-review": JSON.stringify(Object.fromEntries(Array.from({ length: 12 }, (_, index) => [`concept-w1-${index}`, { due: Date.now() + 86_400_000 }]))) + }); + await page.goto("/review.html?unit=w1"); + await page.locator("#show").click(); + await page.getByRole("button", { name: "Got it" }).click(); + await expect(page.locator("#next-card")).toBeEnabled(); + expect(await page.evaluate(() => JSON.parse(localStorage.getItem("ccaf-review")).one)).toBeUndefined(); + await page.locator("#next-card").click(); + await expect(page.locator("#done")).toContainText("Review complete"); + await expect(page.locator("#done")).toBeFocused(); + const schedule = await page.evaluate(() => JSON.parse(localStorage.getItem("ccaf-review"))); + expect(schedule.one.grade).toBe("good"); +}); + +test("the shared lesson path shows one next action across learning pages", async ({ page }) => { + for (const path of ["/dashboard.html", "/today.html?unit=w1", "/foundation-lab.html?unit=w1", "/notes.html?unit=w1", "/draw.html?unit=w1", "/exercise.html?id=file-map", "/teachback.html?unit=w1", "/quiz.html?unit=w1", "/review.html?unit=w1"]) { + await page.goto(path); + await expect(page.locator(".lesson-flow-track .lesson-stage")).toHaveCount(6); + } + await page.goto("/today.html?unit=w1"); + await expect(page.locator("#focus-action .study-primary-action")).toHaveCount(1); + await expect(page.locator("#focus-action .study-primary-action")).toHaveAttribute("href", /foundation-lab\.html|notes\.html/); +}); + +test("the drawing step saves a real sketch and hands off to Build", async ({ page }) => { + await page.goto("/draw.html?unit=w1"); + const canvas = page.locator("#sketch"); + await canvas.scrollIntoViewIfNeeded(); + const box = await canvas.boundingBox(); + expect(box).not.toBeNull(); + await page.mouse.move(box.x + 50, box.y + 60); + await page.mouse.down(); + await page.mouse.move(box.x + 180, box.y + 140, { steps: 6 }); + await page.mouse.up(); + expect(await page.evaluate(() => JSON.parse(localStorage.getItem("ccaf-draw-w1")).strokes.length)).toBe(1); + await page.locator("#complete").click(); + await expect(page.locator("#draw-status")).toContainText("Draw step saved"); + await expect(page.locator('#next-step a[href="exercise.html?id=file-map"]')).toHaveText(/Next: build it/); + expect(await page.evaluate(() => CCAF.getSteps("w1")[1])).toBe(true); +}); + +test("pre-test shows one question at a time and remembers position", async ({ page }) => { + await page.goto("/pretest.html"); + await expect(page.locator(".pre-question.is-active")).toHaveCount(1); + await expect(page.locator("#pre-pos")).toContainText("Question 1 of 30"); + await page.locator(".pre-question.is-active input[type=radio]").first().check(); + await page.locator("#pre-next").click(); + await expect(page.locator("#pre-pos")).toContainText("Question 2 of 30"); + await page.reload(); + await expect(page.locator("#pre-pos")).toContainText("Question 2 of 30"); +}); + +test("quiz controls come after the answer choices instead of covering them", async ({ page }) => { + for (const path of ["/quiz.html?unit=w1", "/pretest.html"]) { + await page.goto(path); + const card = await page.locator(path.includes("pretest") ? ".pre-question.is-active" : ".quiz-question.is-active").boundingBox(); + const actions = await page.locator(path.includes("pretest") ? "#pre-actions" : "#quiz-actions").boundingBox(); + expect(card).not.toBeNull(); + expect(actions).not.toBeNull(); + expect(actions.y).toBeGreaterThanOrEqual(card.y + card.height - 1); + } +}); + +test("weekly disclosures and checkboxes expose names to keyboard users", async ({ page }) => { + await page.goto("/daily-pipeline.html"); + const toggle = page.locator(".routine-toggle").first(); + await expect(toggle).toHaveAttribute("aria-expanded", "false"); + await toggle.focus(); + await toggle.press("Enter"); + await expect(toggle).toHaveAttribute("aria-expanded", "true"); + await expect(page.locator("#daily").getByRole("checkbox", { name: /mark learn/i })).toHaveCount(1); +}); + +test("backup export works and malformed import changes nothing", async ({ page }) => { + await page.goto("/dashboard.html"); + await page.evaluate(() => localStorage.setItem("ccaf-current", "keep")); + const downloadPromise = page.waitForEvent("download"); + await page.locator("#expBtn").click(); + const download = await downloadPromise; + expect(download.suggestedFilename()).toMatch(/^ccaf-progress-\d{4}-\d{2}-\d{2}\.json$/); + + await page.locator("#impFile").setInputFiles({ name: "bad.json", mimeType: "application/json", buffer: Buffer.from('{"data":{"other":"bad"}}') }); + await expect(page.locator("#impStatus")).toContainText("not a valid CCA-F progress backup"); + expect(await page.evaluate(() => localStorage.getItem("ccaf-current"))).toBe("keep"); +}); + +test("valid import is confirmed and unsafe resume links are ignored", async ({ page }) => { + await page.goto("/dashboard.html"); + page.once("dialog", (dialog) => dialog.accept()); + const backup = { + ts: Date.now(), + data: { + "ccaf-imported": "yes", + "ccaf-last": JSON.stringify({ href: "javascript:alert(1)", label: "Unsafe", ts: Date.now() }) + } + }; + await Promise.all([ + page.waitForNavigation({ waitUntil: "domcontentloaded" }), + page.locator("#impFile").setInputFiles({ name: "progress.json", mimeType: "application/json", buffer: Buffer.from(JSON.stringify(backup)) }) + ]); + await page.waitForFunction(() => localStorage.getItem("ccaf-imported") === "yes"); + await expect(page.locator("#where-last")).toBeHidden(); +}); + +test("@responsive key pages fit phone and desktop viewports", async ({ page }, testInfo) => { + for (const path of ["/dashboard.html", "/today.html", "/timeline.html", "/curriculum.html", "/notes.html?unit=w1", "/draw.html?unit=w1", "/quiz.html?unit=w1", "/exercise.html?id=file-map", "/teachback.html?unit=w1", "/review.html?unit=w1"]) { + await page.goto(path); + const layout = await page.evaluate(() => { + const width = document.documentElement.clientWidth; + const offenders = Array.from(document.querySelectorAll("body *")).map((element) => { + const rect = element.getBoundingClientRect(); + return { + tag: element.tagName.toLowerCase(), id: element.id, className: String(element.className || ""), + left: Math.round(rect.left), right: Math.round(rect.right), + clientWidth: element.clientWidth, scrollWidth: element.scrollWidth + }; + }).filter((item) => item.left < -1 || item.right > width + 1 || item.scrollWidth > item.clientWidth + 1).slice(0, 8); + return { overflow: document.documentElement.scrollWidth - width, offenders }; + }); + expect(layout.overflow, `${path} horizontal overflow in ${testInfo.project.name}: ${JSON.stringify(layout.offenders)}`).toBeLessThanOrEqual(1); + } + if (testInfo.project.name.includes("phone")) { + await page.goto("/dashboard.html"); + await expect(page.locator("#site-nav .nav-wide").first()).toBeHidden(); + await page.locator("#navMoreBtn").click(); + await expect(page.locator('#navMenu a[href="curriculum.html"]').last()).toBeVisible(); + await page.goto("/today.html?unit=w1"); + const action = await page.locator("#focus-action").boundingBox(); + const flow = await page.locator("#lesson-flow").boundingBox(); + expect(action.y + action.height).toBeLessThanOrEqual(flow.y + 1); + } +}); + +test("200 percent zoom, long navigation text, and reduced motion stay usable", async ({ page }, testInfo) => { + test.skip(testInfo.project.name.includes("phone"), "200% zoom is covered at desktop width"); + await page.goto("/dashboard.html"); + await page.locator("#navMoreBtn").click(); + await page.locator("#navMenu a").first().evaluate((link) => { link.textContent = "A very long study destination name that must wrap without leaving the screen"; }); + await page.setViewportSize({ width: 640, height: 720 }); + const overflow = await page.evaluate(() => document.documentElement.scrollWidth - document.documentElement.clientWidth); + expect(overflow).toBeLessThanOrEqual(1); + + await page.emulateMedia({ reducedMotion: "reduce" }); + await page.goto("/foundation-lab.html?unit=w1"); + await expect(page.locator("[data-read-text] .read-word").first()).not.toHaveAttribute("aria-hidden", "true"); +}); diff --git a/tests/e2e/studio-journey.spec.js b/tests/e2e/studio-journey.spec.js new file mode 100644 index 0000000..6312b63 --- /dev/null +++ b/tests/e2e/studio-journey.spec.js @@ -0,0 +1,156 @@ +const { test, expect } = require("@playwright/test"); + +const STUDIO = `${process.env.CCA_STUDIO_E2E_URL || "http://127.0.0.1:8765"}/`; +const answers = [2, 1, 0, 0, 0]; + +test("Studio reflows at Mac split-view widths", async ({ page }) => { + for (const width of [800, 1024, 1262, 1440, 1728]) { + await page.setViewportSize({ width, height: 900 }); + await page.goto(STUDIO); + await expect(page.getByRole("link", { name: "Frontier Inbox" })).toBeVisible(); + const homeOverflow = await page.evaluate(() => document.documentElement.scrollWidth > document.documentElement.clientWidth); + expect(homeOverflow, `home overflow at ${width}px`).toBe(false); + await expect(page.getByRole("main")).toBeVisible(); + + await page.goto(`${STUDIO}#/session`); + await expect(page.locator(".path-visual"), `path frame missing at ${width}px`).toBeVisible(); + const lessonOverflow = await page.evaluate(() => { + const frame = document.querySelector(".path-visual"); + if (!frame) { + throw new Error("Path frame missing"); + } + const splitLabels = Array.from(document.querySelectorAll(".path-node:not(.path-node--file) > span")) + .filter((label) => { + const lineHeight = Number.parseFloat(getComputedStyle(label).lineHeight); + return Number.isFinite(lineHeight) && label.getBoundingClientRect().height > lineHeight * 1.5; + }) + .map((label) => label.textContent); + return { + document: document.documentElement.scrollWidth > document.documentElement.clientWidth, + pathFrame: frame.scrollWidth > frame.clientWidth + 1, + splitLabels + }; + }); + expect(lessonOverflow.document, `lesson overflow at ${width}px`).toBe(false); + expect(lessonOverflow.pathFrame, `path frame overflow at ${width}px`).toBe(false); + expect(lessonOverflow.splitLabels, `ordinary path labels split at ${width}px`).toEqual([]); + } +}); + +test("Studio keeps icon and text navigation labels at compact widths", async ({ page }) => { + for (const width of [1000, 600]) { + await page.setViewportSize({ width, height: 900 }); + await page.goto(STUDIO); + for (const label of ["Home", "Course", "Review", "Library", "Settings"]) { + await expect(page.getByRole("link", { name: label })).toBeVisible(); + } + expect(await page.evaluate(() => document.documentElement.scrollWidth > document.documentElement.clientWidth)).toBe(false); + } +}); + +test("Studio non-AI navigation stays within the interaction budget", async ({ page }) => { + await page.goto(STUDIO); + const samples = []; + for (let index = 0; index < 20; index += 1) { + const course = index % 2 === 0; + samples.push(await page.evaluate(({ hash, selector }) => new Promise((resolve, reject) => { + const root = document.querySelector("#root"); + if (!root) { + reject(new Error("Studio root is missing")); + return; + } + const started = performance.now(); + const timeout = window.setTimeout(() => { + observer.disconnect(); + reject(new Error(`Timed out waiting for ${selector}`)); + }, 1_000); + const finish = () => { + if (!document.querySelector(selector)) return; + window.clearTimeout(timeout); + observer.disconnect(); + resolve(performance.now() - started); + }; + const observer = new MutationObserver(finish); + observer.observe(root, { childList: true, subtree: true }); + window.location.hash = hash; + window.requestAnimationFrame(finish); + }), { + hash: course ? "/course" : "/", + selector: course ? "#course-title" : "#home-title" + })); + } + + const ordered = [...samples].sort((left, right) => left - right); + const p95 = ordered[Math.ceil(ordered.length * 0.95) - 1]; + expect(p95, `non-AI navigation p95 was ${p95.toFixed(1)} ms`).toBeLessThan(150); +}); + +test("Studio completes W1 without copy and paste", async ({ page }) => { + await page.goto(STUDIO); + await page.getByRole("link", { name: "Continue lesson" }).click(); + + await expect(page.getByRole("link", { name: /opens in a new tab/i })).toBeVisible(); + + await page.getByRole("button", { name: "I can point to each part" }).click(); + await page.locator("#draw-description").fill("Home folder to Documents, then study, then tiny-order.json."); + await page.getByRole("button", { name: "Save my path" }).click(); + + await page.getByRole("button", { name: "Open the practice workbench" }).click(); + await page.getByRole("button", { name: "Create the real file" }).click(); + await page.locator('input[type="file"]').setInputFiles({ + name: "tiny-order.json", + mimeType: "application/json", + buffer: Buffer.from('{"item":"tea","quantity":2}') + }); + await page.getByLabel("Full path").fill("/Users/me/Documents/study/tiny-order.json"); + await page.getByLabel("I used TextEdit’s plain-text mode.").check(); + await page.getByLabel("I created the final file myself on my Mac.").check(); + await page.getByRole("button", { name: "Save independent build" }).click(); + + await page.locator("#teach-words").fill( + "A file is one saved item. A folder holds files. A path shows each folder leading to the file. The .json extension and plain-text format tell software how to read it." + ); + await page.getByRole("button", { name: "Save my teach-back" }).click(); + + for (let index = 0; index < answers.length; index += 1) { + await page.locator(".answer-list label").nth(answers[index]).click(); + await page.getByLabel("I know").check(); + await page.getByRole("button", { name: "Check answer" }).click(); + await page.getByRole("button", { name: index === answers.length - 1 ? "Finish quiz" : "Next question" }).click(); + } + + await page.getByRole("button", { name: "Show answer" }).click(); + await page.getByLabel("Again").check(); + const repeatRequest = page.waitForRequest(/\/api\/reviews\/[^/]+\/cards\/[^/]+$/); + await page.getByRole("button", { name: "Save rating" }).click(); + const repeated = (await repeatRequest).postDataJSON(); + expect(repeated).toMatchObject({ rating: "again" }); + expect(repeated.ratingId).toMatch(/^[0-9a-f-]{36}$/); + await expect(page.getByRole("button", { name: "Next card" })).toBeVisible(); + await page.getByRole("button", { name: "Next card" }).click(); + + await page.reload(); + await expect(page.getByRole("button", { name: "Show answer" })).toBeVisible(); + await page.getByRole("button", { name: "Show answer" }).click(); + await page.getByLabel("Got it").check(); + const finalRatingRequest = page.waitForRequest(/\/api\/reviews\/[^/]+\/cards\/[^/]+$/); + await page.getByRole("button", { name: "Save rating" }).click(); + const rating = (await finalRatingRequest).postDataJSON(); + expect(rating).toMatchObject({ rating: "good" }); + expect(rating.ratingId).toMatch(/^[0-9a-f-]{36}$/); + expect(rating.elapsedMs).toEqual(expect.any(Number)); + await expect(page.getByRole("heading", { name: "Files, folders, and plain text complete" })).toBeVisible(); + await page.getByRole("link", { name: "Open W1 archive" }).click(); + await expect(page.getByRole("heading", { name: "W1 archive" })).toBeVisible(); + await expect(page.getByText("Learn, Draw, Build, Teach, Quiz, and Review are complete.", { exact: true })).toBeVisible(); + await expect(page.getByRole("link", { name: "Continue to Week 2 archive" })).toBeVisible(); +}); + +test("Studio honors keyboard focus and reduced motion", async ({ page }) => { + await page.emulateMedia({ reducedMotion: "reduce" }); + await page.goto(STUDIO); + await page.keyboard.press("Tab"); + await expect(page.getByRole("link", { name: "Skip to lesson" })).toBeFocused(); + await page.keyboard.press("Enter"); + await expect(page.getByRole("main")).toBeFocused(); +}); diff --git a/tests/studio_server/test_app.py b/tests/studio_server/test_app.py new file mode 100644 index 0000000..c7ab3a9 --- /dev/null +++ b/tests/studio_server/test_app.py @@ -0,0 +1,464 @@ +from __future__ import annotations + +import asyncio +import json +import sqlite3 +import uuid +from concurrent.futures import ThreadPoolExecutor +from pathlib import Path +from typing import Any + +import httpx +import pytest +from fastapi.testclient import TestClient + +from studio_server.app import BodyLimitMiddleware, TutorService, create_app +from studio_server.models import TutorTurnIn +from studio_server.store import StudioStore + + +def write_progress(tmp_path: Path, checks: list[bool] | None = None, extra: dict[str, str] | None = None) -> bytes: + data = { + "ccaf-pipeline": json.dumps({"unit": "w1", "checks": checks if checks is not None else [False] * 5}), + **(extra or {}), + } + raw = json.dumps({"ts": 1, "data": data}, separators=(",", ":")).encode() + (tmp_path / "my-progress.json").write_bytes(raw) + return raw + + +def client_for(tmp_path: Path, checks: list[bool] | None = None, extra: dict[str, str] | None = None) -> tuple[TestClient, dict[str, str], Any]: + write_progress(tmp_path, checks, extra) + app = create_app(tmp_path) + report = app.state.store.migration_report() + if report.get("status") == "pending_confirmation": + app.state.store.commit_legacy_import(report["sourceSha256"]) + client = TestClient(app, base_url="http://localhost") + return client, {"X-CCA-Instance": app.state.instance_token}, app + + +def attempt(client: TestClient, headers: dict[str, str], stage: str, payload: dict[str, Any], confidence: str | None = None) -> dict[str, Any]: + response = client.post( + "/api/attempts", + headers=headers, + json={"unitId": "w1", "stage": stage, "confidence": confidence, "payload": payload}, + ) + assert response.status_code == 200, response.text + return response.json() + + +def quiz_payload(confidences: list[str] | None = None) -> dict[str, Any]: + choices = [2, 1, 0, 0, 0] + confidence = confidences or ["know"] * len(choices) + return { + "answers": [ + {"choice": choice, "confidence": confidence[index], "questionIndex": index} + for index, choice in enumerate(choices) + ] + } + + +def pending_quiz_review(client: TestClient, headers: dict[str, str]) -> dict[str, Any]: + response = client.get("/api/reviews/pending", headers=headers) + assert response.status_code == 200 + reviews = response.json()["reviews"] + assert len(reviews) == 1 + return reviews[0] + + +def rate_card( + client: TestClient, + headers: dict[str, str], + review: dict[str, Any], + rating: str, + *, + rating_id: str | None = None, +) -> dict[str, Any]: + card = review["packet"]["cards"][0] + response = client.post( + f'/api/reviews/{review["id"]}/cards/{card["id"]}', + headers=headers, + json={"ratingId": rating_id or str(uuid.uuid4()), "rating": rating, "elapsedMs": 250}, + ) + assert response.status_code == 200, response.text + return response.json() + + +@pytest.mark.asyncio +async def test_body_limit_never_reads_a_get_body() -> None: + called = False + + async def app(scope: dict[str, Any], receive: Any, send: Any) -> None: + nonlocal called + called = True + await send({"type": "http.response.start", "status": 204, "headers": []}) + await send({"type": "http.response.body", "body": b""}) + + async def receive() -> dict[str, Any]: + raise AssertionError("GET middleware must not wait for a body event") + + messages: list[dict[str, Any]] = [] + + async def send(message: dict[str, Any]) -> None: + messages.append(message) + + middleware = BodyLimitMiddleware(app) + await middleware({"type": "http", "method": "GET", "headers": []}, receive, send) + assert called is True + assert messages[0]["status"] == 204 + + +def test_legacy_import_is_lossless_confirmed_contiguous_and_reported(tmp_path: Path) -> None: + unknown = "ccaf-custom-future-key" + original = write_progress(tmp_path, [True, False, True, True, True], {unknown: "opaque-value"}) + app = create_app(tmp_path) + client = TestClient(app, base_url="http://localhost") + headers = {"X-CCA-Instance": app.state.instance_token} + + before = client.get("/api/session/current", headers=headers).json() + assert before["stage"] == "learn" + report = client.get("/api/migration/report", headers=headers).json() + assert report["status"] == "pending_confirmation" + imported = client.post( + "/api/migration/legacy/commit", + headers=headers, + json={"sourceSha256": report["sourceSha256"]}, + ) + assert imported.status_code == 200 + session = imported.json()["session"] + assert [stage["status"] for stage in session["stages"]] == [ + "complete", "current", "upcoming", "upcoming", "upcoming", "upcoming" + ] + assert (tmp_path / "my-progress.json").read_bytes() == original + assert client.get("/my-progress.json", headers=headers).json() == json.loads(original) + + report = client.get("/api/migration/report", headers=headers).json() + assert report["sourceFound"] is True + assert report["sourceUnchanged"] is True + assert report["status"] == "imported" + assert unknown in report["unknownKeysPreserved"] + + +def test_stage_order_and_frontend_payload_contract(tmp_path: Path) -> None: + client, headers, _ = client_for(tmp_path, [True, False, False, False, False]) + + locked = attempt(client, headers, "quiz", {"total": 5, "score": 5, "guessed": 0}) + assert locked["feedback"]["tone"] == "info" + assert locked["session"]["stage"] == "draw" + + draw = attempt(client, headers, "draw", {"strokeCount": 1, "description": ""}) + assert draw["feedback"]["tone"] == "success" + assert draw["session"]["stage"] == "build" + + repair = attempt(client, headers, "build", {"fileName": "tiny-order.json"}) + assert repair["feedback"]["tone"] == "repair" + + built = attempt(client, headers, "build", { + "fileName": "tiny-order.json", + "fileText": '{"item":"tea","quantity":2}', + "path": "/Users/me/Documents/study/tiny-order.json", + "plainText": True, + "independent": True, + "practiceValid": True, + }) + assert built["session"]["stage"] == "teach" + + taught = attempt(client, headers, "teach", { + "words": "A folder contains the file. Its path names every folder, and json is the extension.", + "rubric": [True, True, True, True], + }) + assert taught["session"]["stage"] == "quiz" + + +def test_guess_inflated_quiz_forces_review_and_retake(tmp_path: Path) -> None: + client, headers, _ = client_for(tmp_path, [True, True, True, True, True]) + + guessed = attempt(client, headers, "quiz", quiz_payload(["guess", "know", "know", "know", "know"]), "guess") + assert guessed["feedback"]["tone"] == "repair" + assert guessed["result"]["qualified"] is False + assert guessed["result"]["correct"] == 5 + assert guessed["result"]["guessed"] == 1 + assert guessed["session"]["stage"] == "review" + review = pending_quiz_review(client, headers) + assert len(review["packet"]["cards"]) == 1 + assert review["packet"]["cards"][0]["source"] == "Correct guess" + + reviewed = rate_card(client, headers, review, "good") + assert reviewed["session"]["stage"] == "quiz" + assert reviewed["session"]["mastery"] == "practiced" + + qualified = attempt(client, headers, "quiz", quiz_payload(), "know") + assert qualified["result"]["qualified"] is True + assert qualified["session"]["stage"] == "review" + + final_review = pending_quiz_review(client, headers) + mastered = rate_card(client, headers, final_review, "good") + assert mastered["session"]["mastery"] == "mastered" + assert mastered["session"]["progressPercent"] == 100 + + +def test_restart_keeps_authoritative_progress(tmp_path: Path) -> None: + client, headers, _ = client_for(tmp_path, [True, False, False, False, False]) + attempt(client, headers, "draw", {"strokeCount": 2, "description": ""}) + + restarted = create_app(tmp_path) + second = TestClient(restarted, base_url="http://localhost") + session = second.get("/api/session/current", headers={"X-CCA-Instance": restarted.state.instance_token}).json() + assert session["stage"] == "build" + assert session["progressPercent"] == 33 + + +def test_security_guards_token_origin_body_and_legacy_files(tmp_path: Path) -> None: + client, headers, _ = client_for(tmp_path) + assert client.get("/api/session/current").status_code == 401 + assert client.get("/api/session/current", headers={**headers, "Host": "example.com"}).status_code == 403 + assert client.get("/api/session/current", headers={**headers, "Origin": "https://example.com"}).status_code == 403 + assert client.get("/api/session/current", headers={**headers, "Origin": "http://localhost:9999"}).status_code == 403 + assert client.post("/__save", json={"ts": 1, "data": {}}).status_code == 401 + assert client.get("/legacy/.git/config").status_code == 404 + assert client.get("/legacy/.studio-data/studio.sqlite3").status_code == 404 + assert client.get("/legacy/my-progress.json").status_code == 404 + assert client.post("/api/attempts", headers=headers, content=b"x" * 1_000_001).status_code == 413 + invalid = client.post("/api/attempts", headers=headers, json={"unitId": "w1", "stage": "learn", "confidence": "certain", "payload": {}}) + assert invalid.status_code == 422 + assert client.post("/__save", headers={**headers, "Content-Type": "text/plain"}, content=b"{}").status_code == 415 + assert client.post("/__save", headers={**headers, "Content-Type": "application/json"}, content=b"{").status_code == 400 + assert client.post("/__save", headers=headers, json={"ts": -1, "data": {}}).status_code == 400 + + +def test_bootstrap_sets_private_cookie_for_direct_legacy_use(tmp_path: Path) -> None: + client, _, app = client_for(tmp_path) + bootstrap = client.get("/api/bootstrap") + assert bootstrap.status_code == 200 + assert bootstrap.cookies.get("cca_instance") == app.state.instance_token + assert client.get("/my-progress.json").status_code == 200 + + +def test_legacy_save_is_compatibility_only(tmp_path: Path) -> None: + client, headers, _ = client_for(tmp_path) + payload = {"ts": 2, "data": {"ccaf-pipeline": json.dumps({"unit": "w1", "checks": [True] * 5})}} + saved = client.post("/__save", headers=headers, json=payload) + assert saved.status_code == 200 + assert saved.json()["stored"] is True + stale = client.post("/__save", headers=headers, json={"ts": 1, "data": {}}) + assert stale.status_code == 200 + assert stale.json() == {"ok": True, "stored": False, "ts": 2.0} + assert client.get("/my-progress.json", headers=headers).json() == payload + assert client.get("/api/session/current", headers=headers).json()["stage"] == "learn" + + +def test_frontier_packet_and_content_gap_never_change_mastery(tmp_path: Path) -> None: + client, headers, app = client_for(tmp_path, [True, False, False, False, False]) + before = client.get("/api/session/current", headers=headers).json() + + packet = client.post("/api/reviews/prepare", headers=headers).json() + assert packet["prepared"] is True + saved = app.state.store.record_frontier_review("w1", "The learner needs another visual.", "revise", packet["reviewId"]) + assert saved and saved["advisoryOnly"] is True + + gap = client.post("/api/content-gaps", headers=headers, json={ + "unitId": "w1", "activityId": "w1:draw", "note": "I have not learned paths yet." + }) + assert gap.status_code == 200 + assert client.get("/api/session/current", headers=headers).json() == before + + +@pytest.mark.asyncio +async def test_ollama_request_is_small_schema_bound_and_unloaded(tmp_path: Path, monkeypatch: pytest.MonkeyPatch) -> None: + store = StudioStore(tmp_path) + service = TutorService(store) + captured: dict[str, Any] = {} + + class Response: + def raise_for_status(self) -> None: + return None + + def json(self) -> dict[str, Any]: + return {"message": {"content": json.dumps({ + "mode": "hint", "advice": "Trace the folders first.", + "nextQuestion": "Which part is the file?", "label": "needs_review" + })}} + + class Client: + def __init__(self, *args: Any, **kwargs: Any) -> None: + captured["timeout"] = kwargs.get("timeout") + + async def __aenter__(self) -> "Client": + return self + + async def __aexit__(self, *_: Any) -> None: + return None + + async def post(self, url: str, json: dict[str, Any]) -> Response: + captured["url"] = url + captured["payload"] = json + return Response() + + monkeypatch.setattr("studio_server.app.httpx.AsyncClient", Client) + monkeypatch.setattr("studio_server.app._mac_memory_status", lambda: {"allowed": True, "status": "ready", "reason": None}) + result = await service._ask_ollama(TutorTurnIn(unitId="w1", activityId="w1:learn", mode="hint", learnerText="help")) + assert result["source"] == "ollama" + assert captured["timeout"] == 42.0 + assert captured["payload"]["keep_alive"] == 0 + assert captured["payload"]["options"]["num_ctx"] == 2048 + assert captured["payload"]["options"]["num_predict"] == 256 + assert captured["payload"]["stream"] is False + assert captured["payload"]["format"]["additionalProperties"] is False + + +@pytest.mark.asyncio +async def test_tutor_turn_can_be_cancelled(tmp_path: Path, monkeypatch: pytest.MonkeyPatch) -> None: + store = StudioStore(tmp_path) + service = TutorService(store) + + async def slow(_: TutorTurnIn) -> dict[str, Any]: + await asyncio.sleep(30) + return {} + + monkeypatch.setattr(service, "_ask_ollama", slow) + body = TutorTurnIn(unitId="w1", activityId="w1:learn", mode="hint", turnId="cancel-turn-123") + task = asyncio.create_task(service.turn(body)) + for _ in range(50): + if store.tutor_turn("cancel-turn-123") is not None: + break + await asyncio.sleep(0.01) + assert await service.cancel("cancel-turn-123") is True + with pytest.raises(asyncio.CancelledError): + await task + assert store.tutor_turn("cancel-turn-123")["status"] == "cancelled" + + +def test_schema_upgrade_creates_bounded_backup(tmp_path: Path) -> None: + data_dir = tmp_path / ".studio-data" + data_dir.mkdir() + database = data_dir / "studio.sqlite3" + with sqlite3.connect(database) as db: + db.execute("CREATE TABLE marker (value TEXT)") + db.execute("INSERT INTO marker VALUES ('before-upgrade')") + db.execute("PRAGMA user_version = 0") + + StudioStore(tmp_path) + backups = list((data_dir / "backups").glob("studio-v0-*.sqlite3")) + assert len(backups) == 1 + with sqlite3.connect(backups[0]) as backup: + assert backup.execute("SELECT value FROM marker").fetchone()[0] == "before-upgrade" + + +def test_future_schema_is_rejected_without_rewriting_database(tmp_path: Path) -> None: + data_dir = tmp_path / ".studio-data" + data_dir.mkdir() + database = data_dir / "studio.sqlite3" + with sqlite3.connect(database) as db: + db.execute("CREATE TABLE marker (value TEXT)") + db.execute("INSERT INTO marker VALUES ('future')") + db.execute("PRAGMA user_version = 999") + + with pytest.raises(RuntimeError, match="newer than supported"): + StudioStore(tmp_path) + with sqlite3.connect(database) as db: + assert db.execute("PRAGMA user_version").fetchone()[0] == 999 + assert db.execute("SELECT value FROM marker").fetchone()[0] == "future" + + +def test_concurrent_writes_have_one_winner(tmp_path: Path) -> None: + write_progress(tmp_path) + store = StudioStore(tmp_path) + + with ThreadPoolExecutor(max_workers=4) as pool: + attempts = list(pool.map( + lambda _: store.record_attempt("w1", "learn", "know", {"completed": True})[1]["result"]["passed"], + range(4), + )) + assert attempts.count(True) == 1 + + with ThreadPoolExecutor(max_workers=4) as pool: + review_ids = list(pool.map(lambda _: store.prepare_review("w1")["id"], range(4))) + assert len(set(review_ids)) == 1 + + review_id = review_ids[0] + with ThreadPoolExecutor(max_workers=4) as pool: + results = list(pool.map( + lambda _: store.record_frontier_review("w1", "Needs a visual.", "revise", review_id), + range(4), + )) + assert sum(result is not None for result in results) == 1 + + +def test_duplicate_tutor_turn_and_decided_proposal_are_conflicts(tmp_path: Path) -> None: + client, headers, app = client_for(tmp_path) + body = {"unitId": "w1", "activityId": "w1:learn", "mode": "hint", "turnId": "duplicate-turn-1"} + app.state.store.create_tutor_turn("w1", "w1:learn", "hint", None, "duplicate-turn-1") + assert client.post("/api/tutor/turn", headers=headers, json=body).status_code == 409 + + proposal = app.state.store.create_proposal("study_plan", {"summary": "Keep W1 visual."}) + path = f'/api/proposals/{proposal["id"]}/decision' + assert client.post(path, headers=headers, json={"decision": "accepted"}).status_code == 200 + assert client.post(path, headers=headers, json={"decision": "rejected"}).status_code == 409 + + +def test_mastered_review_is_scheduled_and_again_cannot_finish(tmp_path: Path) -> None: + client, headers, app = client_for(tmp_path, [True, True, True, True, True]) + qualified = attempt(client, headers, "quiz", quiz_payload(), "know") + assert qualified["result"]["qualified"] is True + immediate = pending_quiz_review(client, headers) + mastered = rate_card(client, headers, immediate, "good") + assert mastered["session"]["mastery"] == "mastered" + assert mastered["session"]["dueReviews"] == 0 + assert client.get("/api/reviews/pending", headers=headers).json()["reviews"] == [] + + future = app.state.store.pending_reviews("quiz") + assert len(future) == 1 + with app.state.store._connect() as db: + state = db.execute( + "SELECT prior_interval_days FROM review_card_state WHERE review_id = ?", + (future[0]["id"],), + ).fetchone() + assert state["prior_interval_days"] == 4 + with app.state.store._connect() as db: + db.execute("UPDATE reviews SET due_at = ? WHERE id = ?", ("2000-01-01T00:00:00+00:00", future[0]["id"])) + db.execute( + "UPDATE review_card_state SET next_due_at = ?, status = 'scheduled' WHERE review_id = ?", + ("2000-01-01T00:00:00+00:00", future[0]["id"]), + ) + + assert client.get("/api/session/current", headers=headers).json()["dueReviews"] == 1 + due = pending_quiz_review(client, headers) + repeated = rate_card(client, headers, due, "again") + assert repeated["repeat"] is True + assert repeated["reviewComplete"] is False + assert repeated["session"]["mastery"] == "mastered" + assert repeated["session"]["dueReviews"] == 1 + + due_again = pending_quiz_review(client, headers) + maintained = rate_card(client, headers, due_again, "hard") + assert maintained["reviewComplete"] is True + assert maintained["feedback"]["title"] == "Review saved" + assert maintained["session"]["mastery"] == "mastered" + assert maintained["session"]["dueReviews"] == 0 + next_review = app.state.store.pending_reviews("quiz") + assert len(next_review) == 1 + with app.state.store._connect() as db: + state = db.execute( + "SELECT prior_interval_days FROM review_card_state WHERE review_id = ?", + (next_review[0]["id"],), + ).fetchone() + assert state["prior_interval_days"] == 2 + + +@pytest.mark.asyncio +async def test_memory_guard_never_starts_ollama(tmp_path: Path, monkeypatch: pytest.MonkeyPatch) -> None: + store = StudioStore(tmp_path) + service = TutorService(store) + monkeypatch.setattr( + "studio_server.app._mac_memory_status", + lambda: {"allowed": False, "status": "protected", "reason": "Memory pressure is high."}, + ) + + class ForbiddenClient: + def __init__(self, *_: Any, **__: Any) -> None: + raise AssertionError("Ollama must not be contacted while the memory guard is active") + + monkeypatch.setattr("studio_server.app.httpx.AsyncClient", ForbiddenClient) + result = await service._ask_ollama(TutorTurnIn(unitId="w1", activityId="w1:learn", mode="hint")) + assert result["source"] == "resource_guard" + assert "Memory pressure is high" in result["advice"] diff --git a/tests/studio_server/test_hardening.py b/tests/studio_server/test_hardening.py new file mode 100644 index 0000000..fb1280f --- /dev/null +++ b/tests/studio_server/test_hardening.py @@ -0,0 +1,520 @@ +from __future__ import annotations + +import io +import hashlib +import json +import stat +import sqlite3 +import time +import uuid +import zipfile +from concurrent.futures import ThreadPoolExecutor +from pathlib import Path +from typing import Any + +import pytest +from fastapi.testclient import TestClient + +from studio_server.app import TutorService, _supervisor_token, create_app +from studio_server.legacy_assets import LEGACY_ASSETS +from studio_server.store import BackupValidationError, STATE_TABLES, StudioStore + + +def write_progress(root: Path, checks: list[bool] | None = None) -> None: + payload = { + "ts": 1, + "data": { + "ccaf-pipeline": json.dumps({"unit": "w1", "checks": checks or [False] * 5}) + }, + } + (root / "my-progress.json").write_text(json.dumps(payload), encoding="utf-8") + + +def confirm_legacy(app: Any) -> None: + report = app.state.store.migration_report() + if report.get("status") == "pending_confirmation": + app.state.store.commit_legacy_import(report["sourceSha256"]) + + +def test_attempt_receipt_is_idempotent_and_rejects_stale_state(tmp_path: Path) -> None: + write_progress(tmp_path) + app = create_app(tmp_path) + client = TestClient(app, base_url="http://localhost") + headers = {"X-CCA-Instance": app.state.instance_token} + attempt_id = str(uuid.uuid4()) + body = { + "unitId": "w1", + "stage": "learn", + "confidence": "know", + "payload": {"completed": True}, + "attemptId": attempt_id, + "clientStateVersion": 0, + "manifestHash": app.state.store.manifest_hash, + } + + first = client.post("/api/attempts", headers=headers, json=body) + assert first.status_code == 200 + assert first.json()["replayed"] is False + assert first.json()["session"]["stateVersion"] == 1 + + replay = client.post("/api/attempts", headers=headers, json=body) + assert replay.status_code == 200 + assert replay.json()["replayed"] is True + assert replay.json()["attemptId"] == attempt_id + + changed = client.post( + "/api/attempts", + headers=headers, + json={**body, "payload": {"completed": False}}, + ) + assert changed.status_code == 409 + + stale = client.post( + "/api/attempts", + headers=headers, + json={ + **body, + "attemptId": str(uuid.uuid4()), + "stage": "draw", + "payload": {"strokeCount": 1}, + }, + ) + assert stale.status_code == 409 + + receipt = client.get(f"/api/attempts/{attempt_id}", headers=headers) + assert receipt.status_code == 200 + assert receipt.json()["session"] == first.json()["session"] + + +def test_idempotent_save_acknowledgement_stays_under_budget(tmp_path: Path) -> None: + write_progress(tmp_path) + app = create_app(tmp_path) + client = TestClient(app, base_url="http://localhost") + headers = {"X-CCA-Instance": app.state.instance_token} + body = { + "unitId": "w1", + "stage": "learn", + "confidence": "know", + "payload": {"completed": True}, + "attemptId": str(uuid.uuid4()), + "clientStateVersion": 0, + "manifestHash": app.state.store.manifest_hash, + } + + latencies_ms: list[float] = [] + for _ in range(20): + started = time.perf_counter() + response = client.post("/api/attempts", headers=headers, json=body) + latencies_ms.append((time.perf_counter() - started) * 1_000) + assert response.status_code == 200 + + p95 = sorted(latencies_ms)[18] + assert p95 < 500, f"idempotent save acknowledgement p95 was {p95:.1f} ms" + + +def test_build_and_teach_are_graded_from_raw_evidence(tmp_path: Path) -> None: + write_progress(tmp_path, [True, True, False, False, False]) + app = create_app(tmp_path) + confirm_legacy(app) + client = TestClient(app, base_url="http://localhost") + headers = {"X-CCA-Instance": app.state.instance_token} + + formatted = client.post( + "/api/attempts", + headers=headers, + json={ + "unitId": "w1", + "stage": "build", + "payload": { + "fileName": "tiny-order.json", + "fileText": r'{\rtf1 {"item":"tea","quantity":2}}', + "path": "/Users/student/study/tiny-order.json", + "plainText": True, + "independent": True, + "practiceValid": True, + }, + }, + ) + assert formatted.status_code == 200 + assert formatted.json()["result"]["passed"] is False + + build = client.post( + "/api/attempts", + headers=headers, + json={ + "unitId": "w1", + "stage": "build", + "payload": { + "fileName": "tiny-order.json", + "fileText": '{"item":"tea","quantity":2}', + "path": "/Users/student/study/tiny-order.json", + "plainText": False, + "independent": False, + "practiceValid": False, + }, + }, + ) + assert build.status_code == 200 + assert build.json()["result"]["passed"] is True + assert all(build.json()["result"]["objectiveChecks"].values()) + assert not any(build.json()["result"]["selfAttestations"].values()) + + fake_rubric = client.post( + "/api/attempts", + headers=headers, + json={ + "unitId": "w1", + "stage": "teach", + "payload": {"words": "This response is long enough but avoids every required technical idea on purpose completely.", "rubric": [True] * 4}, + }, + ) + assert fake_rubric.status_code == 200 + assert fake_rubric.json()["result"]["passed"] is False + + raw_words = ( + "A file is one saved item. A folder holds that file. The path shows where it lives, " + "and the .json extension says what kind of plain text it is." + ) + derived = client.post( + "/api/attempts", + headers=headers, + json={"unitId": "w1", "stage": "teach", "payload": {"words": raw_words, "rubric": [False] * 4}}, + ) + assert derived.status_code == 200 + assert derived.json()["result"]["passed"] is True + assert all(derived.json()["result"]["objectiveChecks"].values()) + + +def _qualified_review(client: TestClient, headers: dict[str, str]) -> dict[str, Any]: + choices = [2, 1, 0, 0, 0] + response = client.post( + "/api/attempts", + headers=headers, + json={ + "unitId": "w1", + "stage": "quiz", + "confidence": "know", + "payload": { + "answers": [ + {"choice": choice, "confidence": "know", "questionIndex": index} + for index, choice in enumerate(choices) + ] + }, + }, + ) + assert response.status_code == 200 + review = client.get("/api/reviews/pending", headers=headers).json()["reviews"] + assert len(review) == 1 + return review[0] + + +def test_each_review_rating_survives_retry_and_restart(tmp_path: Path) -> None: + write_progress(tmp_path, [True] * 5) + app = create_app(tmp_path) + confirm_legacy(app) + client = TestClient(app, base_url="http://localhost") + headers = {"X-CCA-Instance": app.state.instance_token} + review = _qualified_review(client, headers) + card = review["packet"]["cards"][0] + rating_id = str(uuid.uuid4()) + path = f'/api/reviews/{review["id"]}/cards/{card["id"]}' + body = {"ratingId": rating_id, "rating": "again", "elapsedMs": 500} + + first = client.post(path, headers=headers, json=body) + assert first.status_code == 200 + assert first.json()["repeat"] is True + assert first.json()["remaining"] == 1 + replay = client.post(path, headers=headers, json=body) + assert replay.status_code == 200 + assert replay.json()["replayed"] is True + + restarted = create_app(tmp_path) + second = TestClient(restarted, base_url="http://localhost") + second_headers = {"X-CCA-Instance": restarted.state.instance_token} + saved = second.get("/api/reviews/pending", headers=second_headers).json()["reviews"][0] + assert saved["packet"]["cards"][0]["repetitions"] == 1 + finished = second.post( + path, + headers=second_headers, + json={"ratingId": str(uuid.uuid4()), "rating": "good", "elapsedMs": 300}, + ) + assert finished.status_code == 200 + assert finished.json()["reviewComplete"] is True + assert finished.json()["session"]["mastery"] == "mastered" + + +def test_backup_export_inspect_and_restore_preserve_normalized_state(tmp_path: Path) -> None: + write_progress(tmp_path) + app = create_app(tmp_path) + client = TestClient(app, base_url="http://localhost") + headers = {"X-CCA-Instance": app.state.instance_token} + client.post( + "/api/attempts", + headers=headers, + json={"unitId": "w1", "stage": "learn", "payload": {"completed": True}}, + ) + exported = client.get("/api/backups/export", headers=headers) + assert exported.status_code == 200 + assert exported.headers["content-type"].startswith("application/zip") + + client.post( + "/api/attempts", + headers=headers, + json={"unitId": "w1", "stage": "draw", "payload": {"strokeCount": 1}}, + ) + assert client.get("/api/session/current", headers=headers).json()["stage"] == "build" + + inspected = client.post( + "/api/backups/import/inspect", + headers={**headers, "Content-Type": "application/octet-stream"}, + content=exported.content, + ) + assert inspected.status_code == 200 + committed = client.post( + "/api/backups/import/commit", + headers=headers, + json={"importToken": inspected.json()["importToken"]}, + ) + assert committed.status_code == 200 + assert committed.json()["stateDigest"] == inspected.json()["stateDigest"] + restored = client.get("/api/session/current", headers=headers).json() + assert restored["stage"] == "draw" + assert restored["stateVersion"] == 1 + + +def test_backup_rejects_malformed_and_foreign_manifest(tmp_path: Path) -> None: + write_progress(tmp_path) + app = create_app(tmp_path) + client = TestClient(app, base_url="http://localhost") + headers = {"X-CCA-Instance": app.state.instance_token, "Content-Type": "application/octet-stream"} + assert client.post("/api/backups/import/inspect", headers=headers, content=b"not a zip").status_code == 400 + + archive, _ = app.state.store.export_backup() + with zipfile.ZipFile(archive, "r") as source: + metadata = json.loads(source.read("metadata.json")) + database = source.read("studio.sqlite3") + metadata["manifestHash"] = "0" * 64 + forged = io.BytesIO() + with zipfile.ZipFile(forged, "w", compression=zipfile.ZIP_DEFLATED) as target: + target.writestr("metadata.json", json.dumps(metadata)) + target.writestr("studio.sqlite3", database) + assert client.post("/api/backups/import/inspect", headers=headers, content=forged.getvalue()).status_code == 400 + + +def test_backup_rejects_lookalike_schema_and_oversized_metadata(tmp_path: Path) -> None: + store = StudioStore(tmp_path) + lookalike = tmp_path / "lookalike.sqlite3" + with sqlite3.connect(lookalike) as db: + for table in STATE_TABLES: + db.execute(f'CREATE TABLE "{table}" (value TEXT)') + db.execute("PRAGMA user_version = 3") + database = lookalike.read_bytes() + metadata = { + "appId": "ccaf-study-studio", + "formatVersion": 1, + "schemaVersion": 3, + "manifestHash": store.manifest_hash, + "databaseSha256": hashlib.sha256(database).hexdigest(), + "stateDigest": "0" * 64, + } + forged = io.BytesIO() + with zipfile.ZipFile(forged, "w", compression=zipfile.ZIP_DEFLATED) as archive: + archive.writestr("metadata.json", json.dumps(metadata)) + archive.writestr("studio.sqlite3", database) + with pytest.raises(BackupValidationError, match="schema"): + store.inspect_backup(forged.getvalue()) + + exported, _ = store.export_backup() + with zipfile.ZipFile(exported, "r") as archive: + valid_database = archive.read("studio.sqlite3") + oversized = io.BytesIO() + with zipfile.ZipFile(oversized, "w", compression=zipfile.ZIP_DEFLATED) as archive: + archive.writestr("metadata.json", json.dumps({**metadata, "padding": "x" * 65_536})) + archive.writestr("studio.sqlite3", valid_database) + with pytest.raises(BackupValidationError, match="expands beyond"): + store.inspect_backup(oversized.getvalue()) + + +def test_backup_commit_rechecks_staged_database_inside_lock(tmp_path: Path) -> None: + store = StudioStore(tmp_path) + archive, _ = store.export_backup() + inspected = store.inspect_backup(archive.read_bytes()) + staged = store.import_dir / f'{inspected["importToken"]}.sqlite3' + with staged.open("ab") as handle: + handle.write(b"changed") + with pytest.raises(BackupValidationError, match="changed before import"): + store.commit_backup_import(inspected["importToken"]) + + +def test_failed_migration_rolls_back_and_preserves_recovery_copy(tmp_path: Path, monkeypatch: pytest.MonkeyPatch) -> None: + data = tmp_path / ".studio-data" + data.mkdir() + database = data / "studio.sqlite3" + with sqlite3.connect(database) as db: + db.execute("CREATE TABLE marker (value TEXT)") + db.execute("INSERT INTO marker VALUES ('before')") + db.execute("PRAGMA user_version = 2") + + def fail_migration(*_: Any) -> None: + raise RuntimeError("forced migration failure") + + monkeypatch.setattr(StudioStore, "_migrate_schema", fail_migration) + with pytest.raises(RuntimeError, match="migration failed"): + StudioStore(tmp_path) + + with sqlite3.connect(database) as db: + assert db.execute("PRAGMA user_version").fetchone()[0] == 2 + assert db.execute("SELECT value FROM marker").fetchone()[0] == "before" + assert db.execute("SELECT name FROM sqlite_master WHERE name = 'sessions'").fetchone() is None + assert list((data / "backups").glob("studio-v2-*.sqlite3")) + assert list((data / "recovery").glob("failed-*/studio.sqlite3")) + + +def test_corrupt_database_is_preserved_and_normal_startup_refuses(tmp_path: Path) -> None: + data = tmp_path / ".studio-data" + data.mkdir() + (data / "studio.sqlite3").write_bytes(b"this is not sqlite") + with pytest.raises(RuntimeError, match="Restore a verified backup"): + StudioStore(tmp_path) + copies = list((data / "recovery").glob("failed-*/studio.sqlite3")) + assert len(copies) == 1 + assert copies[0].read_bytes() == b"this is not sqlite" + + +def test_supervisor_boundary_requires_its_own_token(tmp_path: Path) -> None: + write_progress(tmp_path) + app = create_app(tmp_path) + client = TestClient(app, base_url="http://localhost") + instance = {"X-CCA-Instance": app.state.instance_token} + assert client.get("/api/supervisor/session", headers=instance).status_code == 401 + token = (app.state.store.data_dir / "supervisor.token").read_text(encoding="ascii") + response = client.get("/api/supervisor/session", headers={"X-CCA-Supervisor": token}) + assert response.status_code == 200 + assert response.json()["release"]["appId"] == "ccaf-study-studio" + health = client.get("/__health").json() + assert health["ok"] is True + assert health["schemaVersion"] == 3 + assert health["databaseId"] != "unknown" + + +def test_release_manifest_mismatch_blocks_grading(tmp_path: Path) -> None: + write_progress(tmp_path) + dist = tmp_path / "dist" + dist.mkdir() + (dist / "index.html").write_text("
      Studio
      ", encoding="utf-8") + (dist / "release.json").write_text(json.dumps({ + "appId": "ccaf-study-studio", + "releaseId": "sha256:foreign", + "manifestHash": "0" * 64, + "supportedSchemaMin": 3, + "supportedSchemaMax": 3, + }), encoding="utf-8") + app = create_app(tmp_path, dist_dir=dist) + client = TestClient(app, base_url="http://localhost") + headers = {"X-CCA-Instance": app.state.instance_token} + assert client.get("/__health").json()["ok"] is False + response = client.post( + "/api/attempts", + headers=headers, + json={"unitId": "w1", "stage": "learn", "payload": {"completed": True}}, + ) + assert response.status_code == 409 + assert client.post("/api/reviews/prepare", headers=headers).status_code == 409 + report = app.state.store.migration_report() + assert client.post( + "/api/migration/legacy/commit", + headers=headers, + json={"sourceSha256": report["sourceSha256"]}, + ).status_code == 409 + + +def test_verified_legacy_archive_is_viewable_but_server_read_only(tmp_path: Path) -> None: + archive = tmp_path / "archive" + for relative in LEGACY_ASSETS: + path = archive / relative + path.parent.mkdir(parents=True, exist_ok=True) + path.write_text("

      Archive

      " if relative == "dashboard.html" else "fixture", encoding="utf-8") + app = create_app(archive, tmp_path / "data") + client = TestClient(app, base_url="http://localhost") + headers = {"X-CCA-Instance": app.state.instance_token} + assert client.get("/legacy/dashboard.html").status_code == 200 + blocked = client.post( + "/__save", + headers=headers, + json={"ts": 2, "data": {"ccaf-pipeline": "{}"}}, + ) + assert blocked.status_code == 410 + + +def test_partial_legacy_archive_is_never_trusted(tmp_path: Path) -> None: + archive = tmp_path / "archive" + archive.mkdir() + (archive / "dashboard.html").write_text("

      Incomplete

      ", encoding="utf-8") + app = create_app(archive, tmp_path / "data") + client = TestClient(app, base_url="http://localhost") + assert client.get("/legacy/dashboard.html").status_code == 404 + + +def test_legacy_import_rechecks_source_after_inspection(tmp_path: Path) -> None: + write_progress(tmp_path) + app = create_app(tmp_path) + report = app.state.store.migration_report() + write_progress(tmp_path, [True] * 5) + client = TestClient(app, base_url="http://localhost") + response = client.post( + "/api/migration/legacy/commit", + headers={"X-CCA-Instance": app.state.instance_token}, + json={"sourceSha256": report["sourceSha256"]}, + ) + assert response.status_code == 409 + assert client.get( + "/api/session/current", headers={"X-CCA-Instance": app.state.instance_token} + ).json()["stage"] == "learn" + + +def test_supervisor_token_creation_is_private_and_race_safe(tmp_path: Path) -> None: + with ThreadPoolExecutor(max_workers=8) as pool: + tokens = list(pool.map(lambda _: _supervisor_token(tmp_path), range(16))) + assert len(set(tokens)) == 1 + assert len(tokens[0]) >= 32 + assert stat.S_IMODE((tmp_path / "supervisor.token").stat().st_mode) == 0o600 + + +def test_corrupt_review_packet_does_not_break_the_queue(tmp_path: Path) -> None: + write_progress(tmp_path, [True] * 5) + app = create_app(tmp_path) + confirm_legacy(app) + client = TestClient(app, base_url="http://localhost") + headers = {"X-CCA-Instance": app.state.instance_token} + review = _qualified_review(client, headers) + with app.state.store._connect() as db: + db.execute("UPDATE reviews SET packet_json = '{' WHERE id = ?", (review["id"],)) + response = client.get("/api/reviews/pending", headers=headers) + assert response.status_code == 200 + assert response.json() == {"reviews": []} + + +@pytest.mark.asyncio +async def test_malformed_ollama_inventory_is_treated_as_unavailable(tmp_path: Path, monkeypatch: pytest.MonkeyPatch) -> None: + write_progress(tmp_path) + service = TutorService(StudioStore(tmp_path)) + + class Response: + is_success = True + + @staticmethod + def json() -> list[str]: + return ["malformed"] + + class Client: + async def __aenter__(self) -> "Client": + return self + + async def __aexit__(self, *_: Any) -> None: + return None + + async def get(self, _: str) -> Response: + return Response() + + monkeypatch.setattr("studio_server.app.httpx.AsyncClient", lambda **_: Client()) + assert await service.available() is False diff --git a/tests/test_mcp_safety.py b/tests/test_mcp_safety.py new file mode 100644 index 0000000..460cb46 --- /dev/null +++ b/tests/test_mcp_safety.py @@ -0,0 +1,174 @@ +from __future__ import annotations + +import importlib.util +import sys +import types +from pathlib import Path +from typing import Any + +import pytest + + +ROOT = Path(__file__).resolve().parents[1] + + +class FakeFastMCP: + def __init__(self, *_: Any, **__: Any) -> None: + pass + + def tool(self): + return lambda function: function + + def run(self, **_: Any) -> None: + pass + + +@pytest.fixture +def mcp_module(monkeypatch: pytest.MonkeyPatch): + """Load the bridge with a tiny MCP stub; no MCP runtime or database is needed.""" + mcp_package = types.ModuleType("mcp") + mcp_server = types.ModuleType("mcp.server") + mcp_fastmcp = types.ModuleType("mcp.server.fastmcp") + mcp_fastmcp.FastMCP = FakeFastMCP + monkeypatch.setitem(sys.modules, "mcp", mcp_package) + monkeypatch.setitem(sys.modules, "mcp.server", mcp_server) + monkeypatch.setitem(sys.modules, "mcp.server.fastmcp", mcp_fastmcp) + + name = "mcp_safety_target" + sys.modules.pop(name, None) + spec = importlib.util.spec_from_file_location(name, ROOT / "studio_server" / "mcp_server.py") + assert spec and spec.loader + module = importlib.util.module_from_spec(spec) + sys.modules[name] = module + spec.loader.exec_module(module) + return module + + +class FakeTransport: + def __init__(self, responses: list[tuple[int, bytes]]) -> None: + self.responses = list(responses) + self.calls: list[tuple[str, str, dict[str, str], bytes | None, float]] = [] + + def __call__(self, method: str, url: str, headers: dict[str, str], body: bytes | None, timeout: float) -> tuple[int, bytes]: + self.calls.append((method, url, headers, body, timeout)) + if not self.responses: + raise AssertionError("unexpected HTTP request") + return self.responses.pop(0) + + +def json_bytes(value: dict[str, Any]) -> bytes: + import json + + return json.dumps(value).encode("utf-8") + + +def make_client(module: Any, tmp_path: Path, transport: FakeTransport) -> Any: + token_path = tmp_path / "supervisor.token" + token_path.write_text("test-supervisor-token-0123456789abcdef", encoding="ascii") + return module.SupervisorClient( + server_url="http://127.0.0.1:8765", + data_dir=tmp_path, + timeout=99, + requester=transport, + ) + + +def health() -> tuple[int, bytes]: + return 200, json_bytes({ + "ok": True, + "sqlite": True, + "save": True, + "appId": "ccaf-study-studio", + "releaseId": f'sha256:{"1" * 64}', + "schemaVersion": 3, + "manifestHash": "2" * 64, + "backendContentSha256": "3" * 64, + "databaseId": "test-database", + }) + + +def test_mcp_module_has_no_database_store_dependency() -> None: + source = (ROOT / "studio_server" / "mcp_server.py").read_text(encoding="utf-8") + assert "StudioStore" not in source + assert "sqlite3" not in source + + +def test_mcp_rejects_foreign_service_with_open_studio_message(mcp_module: Any, tmp_path: Path) -> None: + transport = FakeTransport([(200, json_bytes({"ok": True, "appId": "some-other-app"}))]) + client = make_client(mcp_module, tmp_path, transport) + + with pytest.raises(mcp_module.StudyStudioUnavailable, match="Open Study Studio first"): + client.session() + + assert len(transport.calls) == 1 + assert "X-CCA-Supervisor" not in transport.calls[0][2] + + +def test_mcp_unavailable_health_is_clear_and_bounded(mcp_module: Any, tmp_path: Path) -> None: + transport = FakeTransport([(503, b"service unavailable")]) + client = make_client(mcp_module, tmp_path, transport) + + with pytest.raises(mcp_module.StudyStudioUnavailable, match="Open Study Studio first"): + client.session() + + assert transport.calls[0][4] == 10.0 + + +def test_mcp_reads_session_through_authenticated_supervisor(mcp_module: Any, tmp_path: Path) -> None: + transport = FakeTransport([ + health(), + (200, json_bytes({"session": {"stage": "build", "mastery": "practiced"}, "release": {}})), + ]) + client = make_client(mcp_module, tmp_path, transport) + + assert client.session() == {"stage": "build", "mastery": "practiced"} + assert transport.calls[0][0:2] == ("GET", "http://127.0.0.1:8765/__health") + assert transport.calls[1][0:2] == ("GET", "http://127.0.0.1:8765/api/supervisor/session") + assert "X-CCA-Supervisor" not in transport.calls[0][2] + assert transport.calls[1][2]["X-CCA-Supervisor"] == "test-supervisor-token-0123456789abcdef" + + +def test_mcp_review_and_proposal_preserve_advisory_shapes(mcp_module: Any, tmp_path: Path) -> None: + transport = FakeTransport([ + health(), + (200, json_bytes({"review": {"id": "r1", "advisoryOnly": True}})), + health(), + (200, json_bytes({"proposal": {"id": "p1", "status": "pending"}})), + ]) + client = make_client(mcp_module, tmp_path, transport) + + assert client.review("r1") == {"id": "r1", "advisoryOnly": True} + assert client.proposal("content_gap", {"unitId": "w1", "gap": "needs a diagram"}) == {"id": "p1", "status": "pending"} + assert transport.calls[1][3] is None + assert b'"kind":"content_gap"' in (transport.calls[3][3] or b"") + + +def test_mcp_tools_route_to_supervisor_without_local_store(mcp_module: Any, tmp_path: Path) -> None: + transport = FakeTransport([ + health(), + (200, json_bytes({"review": {"id": "r1", "advisoryOnly": True}})), + ]) + client = make_client(mcp_module, tmp_path, transport) + mcp_module.client = client + + result = mcp_module.submit_frontier_review("w1", "Needs a visual.", "revise", "r1") + assert result["advisoryOnly"] is True + assert transport.calls[1][0] == "POST" + + with pytest.raises(ValueError, match="Only W1"): + mcp_module.submit_frontier_review("w2", "x", "revise") + + +def test_mcp_rejects_non_loopback_server_before_token_use(mcp_module: Any) -> None: + with pytest.raises(ValueError, match="loopback"): + mcp_module.SupervisorClient(server_url="http://192.0.2.1:8765") + with pytest.raises(ValueError, match="loopback"): + mcp_module.SupervisorClient(server_url="http://loopback.example:8765") + + +def test_mcp_rejects_incomplete_health_identity(mcp_module: Any, tmp_path: Path) -> None: + transport = FakeTransport([(200, json_bytes({"ok": True, "appId": "ccaf-study-studio"}))]) + client = make_client(mcp_module, tmp_path, transport) + with pytest.raises(mcp_module.StudyStudioUnavailable, match="Open Study Studio first"): + client.session() + assert len(transport.calls) == 1 diff --git a/tests/test_release_hardening.py b/tests/test_release_hardening.py new file mode 100644 index 0000000..e91211b --- /dev/null +++ b/tests/test_release_hardening.py @@ -0,0 +1,251 @@ +from __future__ import annotations + +import shutil +import stat +import sys +import time +from pathlib import Path + +import pytest +from fastapi.testclient import TestClient + + +ROOT = Path(__file__).resolve().parents[1] +sys.path.insert(0, str(ROOT / "scripts")) + +import build_legacy_archive # noqa: E402 +import release_identity # noqa: E402 +import start_studio # noqa: E402 +import run_studio_runtime # noqa: E402 + + +def make_dist(path: Path, label: str) -> dict[str, object]: + path.mkdir(parents=True, exist_ok=True) + (path / "index.html").write_text(f"
      {label}
      \n", encoding="utf-8") + (path / "assets").mkdir() + (path / "assets" / "main.js").write_text(f"console.log({label!r});\n", encoding="utf-8") + return release_identity.write_release(path) + + +def test_release_rejects_stale_dist_and_hash_mismatch(tmp_path: Path) -> None: + dist = tmp_path / "dist" + document = make_dist(dist, "one") + assert document["appId"] == "ccaf-study-studio" + assert document["supportedSchemaMin"] == document["supportedSchemaMax"] == 3 + assert document["manifestHash"] + assert document["backendContentSha256"] + + (dist / "assets" / "foreign.js").write_text("unexpected\n", encoding="utf-8") + with pytest.raises(ValueError, match="file set mismatch"): + release_identity.verify_release(dist) + + (dist / "assets" / "foreign.js").unlink() + (dist / "assets" / "main.js").write_text("tampered\n", encoding="utf-8") + with pytest.raises(ValueError, match="hash mismatch"): + release_identity.verify_release(dist) + + +def test_release_id_includes_backend_and_manifest_identity() -> None: + frontend = "frontend" + assert release_identity.release_id(frontend, "backend-one", "manifest") != release_identity.release_id( + frontend, "backend-two", "manifest" + ) + assert release_identity.release_id(frontend, "backend-one", "manifest") != release_identity.release_id( + frontend, "backend-one", "other-manifest" + ) + + +def test_backend_identity_covers_the_production_control_plane() -> None: + relative = {path.relative_to(ROOT).as_posix() for path in release_identity._backend_files(ROOT)} + assert { + "scripts/build_legacy_archive.py", + "scripts/release_identity.py", + "scripts/run_frontier_mcp.py", + "scripts/run_studio_runtime.py", + "scripts/start_studio.py", + "studio_server/app.py", + "studio_server/legacy_assets.py", + "studio_server/mcp_server.py", + } <= relative + + +def test_interrupted_site_copy_keeps_previous_verified_release(tmp_path: Path, monkeypatch: pytest.MonkeyPatch) -> None: + source = tmp_path / "source" + target = tmp_path / "site" + make_dist(source, "new") + old_release = make_dist(target, "old") + cache = tmp_path / "cache" + cache.mkdir() + monkeypatch.setattr(start_studio, "CACHE", cache) + original_copytree = start_studio.shutil.copytree + + def interrupted_copytree(source_path: Path, destination: Path, *args: object, **kwargs: object) -> Path: + original_copytree(source_path, destination, *args, **kwargs) + raise OSError("simulated interrupted copy") + + monkeypatch.setattr(start_studio.shutil, "copytree", interrupted_copytree) + with pytest.raises(OSError, match="interrupted"): + start_studio.sync_site(source, target) + + assert release_identity.verify_release(target)["releaseId"] == old_release["releaseId"] + assert not (target.with_name("site.previous")).exists() + assert not list(cache.glob("site-*.tmp")) + + monkeypatch.setattr(start_studio.shutil, "copytree", original_copytree) + new_release = start_studio.sync_site(source, target) + assert new_release["releaseId"] != old_release["releaseId"] + assert release_identity.verify_release(target)["releaseId"] == new_release["releaseId"] + assert release_identity.verify_release(target.with_name("site.previous"))["releaseId"] == old_release["releaseId"] + + +def test_tampered_cached_app_is_detected_and_rebuilt(tmp_path: Path) -> None: + target = tmp_path / "app" + cache = tmp_path / "cache" + expected = release_identity.backend_content_hash(ROOT) + start_studio.sync_app(ROOT, target, cache) + assert start_studio.verify_app_cache(target, expected)["backendContentSha256"] == expected + + cached_app = target / "studio_server" / "app.py" + cached_app.write_text(cached_app.read_text(encoding="utf-8") + "\n# tampered\n", encoding="utf-8") + with pytest.raises(ValueError, match="file hash"): + start_studio.verify_app_cache(target, expected) + + start_studio.sync_app(ROOT, target, cache) + assert start_studio.verify_app_cache(target, expected)["backendContentSha256"] == expected + assert "# tampered" not in cached_app.read_text(encoding="utf-8") + + +def test_archive_signature_uses_metadata_without_reading_contents(tmp_path: Path, monkeypatch: pytest.MonkeyPatch) -> None: + source = tmp_path / "source" + archive = tmp_path / "archive" + source.mkdir() + archive.mkdir() + relative = "lesson.html" + (source / relative).write_text("lesson", encoding="utf-8") + (archive / relative).write_text("lesson", encoding="utf-8") + monkeypatch.setattr(start_studio, "LEGACY_ASSETS", frozenset({relative})) + monkeypatch.setattr(start_studio, "verify_archive", lambda path: True) + + first = start_studio.archive_source_signature(source) + assert start_studio.cached_archive_matches_source(source, archive) is True + time.sleep(0.001) + (source / relative).touch() + assert start_studio.archive_source_signature(source) != first + + +def test_sync_archive_reuses_verified_matching_cache(tmp_path: Path, monkeypatch: pytest.MonkeyPatch) -> None: + root = tmp_path / "source" + cache = tmp_path / "cache" + archive = cache / "legacy" + root.mkdir() + archive.mkdir(parents=True) + relative = "lesson.html" + (root / relative).write_text("lesson", encoding="utf-8") + (archive / relative).write_text("lesson", encoding="utf-8") + marker = cache / ".legacy-source-signature" + monkeypatch.setattr(start_studio, "ROOT", root) + monkeypatch.setattr(start_studio, "CACHE", cache) + monkeypatch.setattr(start_studio, "ARCHIVE", archive) + monkeypatch.setattr(start_studio, "LEGACY_SIGNATURE", marker) + monkeypatch.setattr(start_studio, "LEGACY_ASSETS", frozenset({relative})) + monkeypatch.setattr(start_studio, "verify_archive", lambda path: True) + monkeypatch.setattr(start_studio, "build_archive", lambda source, destination: pytest.fail("cache should be reused")) + + start_studio.sync_archive() + assert marker.read_text(encoding="utf-8") == start_studio.archive_source_signature(root) + + +def test_legacy_archive_contains_only_allowlisted_generated_assets(tmp_path: Path) -> None: + source = tmp_path / "source" + archive = tmp_path / "archive" + for relative in build_legacy_archive.LEGACY_ASSETS: + source_path = ROOT / relative + target = source / relative + target.parent.mkdir(parents=True, exist_ok=True) + shutil.copy2(source_path, target) + (source / "studio_server").mkdir() + (source / "studio_server" / "app.py").write_text("private support code", encoding="utf-8") + (source / ".git").mkdir() + (source / ".git" / "config").write_text("private metadata", encoding="utf-8") + (source / "notes.md").write_text("not a legacy asset", encoding="utf-8") + (source / "my-progress.backup.json").write_text("private progress", encoding="utf-8") + (source / "my-progress.json").write_text('{"ts":1,"data":{}}', encoding="utf-8") + + build_legacy_archive.build_archive(source, archive) + + assert build_legacy_archive.verify_archive(archive) + assert not (archive / "studio_server").exists() + assert not (archive / ".git").exists() + assert not (archive / "notes.md").exists() + assert not (archive / "my-progress.backup.json").exists() + assert (archive / "my-progress.json").is_file() + assert stat.S_IMODE((archive / "my-progress.json").stat().st_mode) == 0o600 + assert stat.S_IMODE(archive.stat().st_mode) == 0o700 + + +def test_long_setup_heartbeat_reports_before_thirty_seconds(capsys: pytest.CaptureFixture[str]) -> None: + result = build_legacy_archive.run_with_heartbeat( + "[test-setup]", + lambda: time.sleep(0.035) or "done", + interval_seconds=0.01, + ) + + assert result == "done" + assert "[test-setup] Still working..." in capsys.readouterr().out + + +class FakeResponse: + def __init__(self, payload: dict[str, object], status: int = 200) -> None: + self.payload = payload + self.status = status + + def __enter__(self) -> "FakeResponse": + return self + + def __exit__(self, *_: object) -> None: + return None + + def read(self) -> bytes: + import json + + return json.dumps(self.payload).encode("utf-8") + + +def test_launcher_rejects_foreign_health_identity(monkeypatch: pytest.MonkeyPatch) -> None: + expected = "sha256:expected" + + def foreign_urlopen(url: str, timeout: float) -> FakeResponse: + assert timeout == 0.5 + if url.endswith("/__health"): + return FakeResponse({"ok": True, "sqlite": True, "save": True}) + return FakeResponse({"releaseId": "sha256:foreign"}) + + monkeypatch.setattr(run_studio_runtime.urllib.request, "urlopen", foreign_urlopen) + assert run_studio_runtime.health_ok(8765, expected) is False + + +def test_launcher_rejects_legacy_save_only_health(monkeypatch: pytest.MonkeyPatch) -> None: + monkeypatch.setattr( + run_studio_runtime.urllib.request, + "urlopen", + lambda url, timeout: FakeResponse({"save": True}), + ) + assert run_studio_runtime.health_ok(8765, "sha256:expected") is False + + +def test_locked_storage_uses_local_generic_recovery_app() -> None: + app = run_studio_runtime.recovery_app("ccaf-study-studio", "sha256:release") + client = TestClient(app, base_url="http://127.0.0.1") + + health = client.get("/__health") + assert health.status_code == 200 + assert health.json() == { + "ok": False, + "appId": "ccaf-study-studio", + "releaseId": "sha256:release", + "status": "recovery_required", + } + screen = client.get("/") + assert screen.status_code == 200 + assert "Recovery copies and backups were preserved" in screen.text + assert client.get("/", headers={"Host": "example.com"}).status_code == 403 diff --git a/tests/test_serve.py b/tests/test_serve.py new file mode 100644 index 0000000..4cc235d --- /dev/null +++ b/tests/test_serve.py @@ -0,0 +1,160 @@ +import http.client +import importlib.util +import json +import os +import tempfile +import threading +import unittest +from concurrent.futures import ThreadPoolExecutor +from http.server import ThreadingHTTPServer +from pathlib import Path + + +ROOT = Path(__file__).resolve().parents[1] +SPEC = importlib.util.spec_from_file_location("ccaf_serve", ROOT / "serve.py") +serve = importlib.util.module_from_spec(SPEC) +SPEC.loader.exec_module(serve) + + +class ServeTests(unittest.TestCase): + def setUp(self): + self.temp = tempfile.TemporaryDirectory() + self.old_paths = (serve.SAVE, serve.BAK, serve.SAVE_LOCK) + serve.SAVE = os.path.join(self.temp.name, "my-progress.json") + serve.BAK = os.path.join(self.temp.name, "my-progress.backup.json") + serve.SAVE_LOCK = threading.Lock() + self.server = ThreadingHTTPServer(("127.0.0.1", 0), serve.Handler) + self.server.access_token = None + self.thread = threading.Thread(target=self.server.serve_forever, daemon=True) + self.thread.start() + + def tearDown(self): + self.server.shutdown() + self.server.server_close() + self.thread.join(timeout=3) + serve.SAVE, serve.BAK, serve.SAVE_LOCK = self.old_paths + self.temp.cleanup() + + def request(self, method, path, body=None, headers=None): + connection = http.client.HTTPConnection("127.0.0.1", self.server.server_port, timeout=15) + connection.request(method, path, body=body, headers=headers or {}) + response = connection.getresponse() + payload = response.read() + result = (response.status, dict(response.getheaders()), payload) + connection.close() + return result + + def post(self, payload, content_type="application/json"): + body = json.dumps(payload).encode() + return self.request("POST", "/__save", body, {"Content-Type": content_type}) + + def test_valid_save_and_one_step_backup(self): + first = {"ts": 1, "data": {"ccaf-curriculum": '{"done":{}}'}} + second = {"ts": 2, "data": {"ccaf-curriculum": '{"done":{"w1":true}}'}} + self.assertEqual(self.post(first)[0], 200) + self.assertEqual(self.post(second)[0], 200) + self.assertEqual(json.loads(Path(serve.SAVE).read_text()), second) + self.assertEqual(json.loads(Path(serve.BAK).read_text()), first) + self.assertFalse(list(Path(self.temp.name).glob("*.tmp"))) + + def test_older_delayed_save_cannot_replace_newer_progress(self): + newer = {"ts": 20, "data": {"ccaf-test": "newer"}} + older = {"ts": 10, "data": {"ccaf-test": "older"}} + self.assertEqual(self.post(newer)[0], 200) + status, _, body = self.post(older) + self.assertEqual(status, 200) + self.assertFalse(json.loads(body)["stored"]) + self.assertEqual(json.loads(Path(serve.SAVE).read_text()), newer) + self.assertFalse(Path(serve.BAK).exists()) + + def test_rejects_malformed_and_out_of_contract_saves(self): + cases = [ + ({"ts": True, "data": {}}, 400), + ({"ts": float("inf"), "data": {}}, 400), + ({"ts": 1, "data": []}, 400), + ({"ts": 1, "data": {"other": "value"}}, 400), + ({"ts": 1, "data": {"ccaf-sync-ts": "1"}}, 400), + ({"ts": 1, "data": {"ccaf-ok": {"nested": True}}}, 400), + ] + for payload, status in cases: + with self.subTest(payload=payload): + self.assertEqual(self.post(payload)[0], status) + self.assertEqual(self.request("POST", "/__save", b"{", {"Content-Type": "application/json"})[0], 400) + self.assertEqual(self.post({"ts": 1, "data": {}}, "text/plain")[0], 415) + self.assertFalse(Path(serve.SAVE).exists()) + + def test_size_limit_and_invalid_route(self): + self.assertEqual(self.request("POST", "/not-save", b"{}", {"Content-Type": "application/json"})[0], 404) + connection = http.client.HTTPConnection("127.0.0.1", self.server.server_port, timeout=15) + try: + connection.putrequest("POST", "/__save") + connection.putheader("Content-Type", "application/json") + connection.putheader("Content-Length", str(serve.MAX_BODY + 1)) + connection.endheaders() + response = connection.getresponse() + self.assertEqual(response.status, 413) + response.read() + finally: + connection.close() + + def test_static_headers_and_private_paths(self): + status, headers, _ = self.request("GET", "/dashboard.html") + lowered = {key.lower(): value for key, value in headers.items()} + self.assertEqual(status, 200) + self.assertEqual(lowered.get("cache-control"), "no-cache") + self.assertEqual(lowered.get("x-content-type-options"), "nosniff") + self.assertEqual(lowered.get("referrer-policy"), "no-referrer") + self.assertEqual(self.request("GET", "/.git/config")[0], 404) + self.assertEqual(self.request("GET", "/.studio-data/studio.sqlite3")[0], 404) + self.assertEqual(self.request("GET", "/.unknown-secret")[0], 404) + self.assertEqual(self.request("GET", "/my-progress.backup.json")[0], 404) + self.assertEqual(self.request("GET", "/dashboard.html", headers={"Host": "example.com"})[0], 403) + cross_origin = f"http://127.0.0.1:{self.server.server_port + 1}" + self.assertEqual(self.request( + "POST", + "/__save", + b'{"ts":1,"data":{}}', + {"Content-Type": "application/json", "Origin": cross_origin}, + )[0], 403) + + def test_progress_is_never_cached_and_static_assets_can_revalidate(self): + Path(serve.SAVE).write_text('{"ts":0,"data":{}}') + status, headers, body = self.request("GET", "/my-progress.json") + self.assertEqual(status, 200) + self.assertEqual(dict(headers).get("Cache-Control"), "no-store") + self.assertEqual(json.loads(body), {"ts": 0, "data": {}}) + status, headers, _ = self.request("GET", "/study.css") + self.assertEqual(status, 200) + self.assertEqual(dict(headers).get("Cache-Control"), "no-cache") + + def test_health_endpoint_identifies_the_quiet_saving_server(self): + status, headers, body = self.request("GET", "/__health") + self.assertEqual(status, 200) + self.assertEqual(json.loads(body), {"save": True}) + self.assertEqual(dict(headers).get("Cache-Control"), "no-store") + + def test_access_token_protects_remote_mode(self): + self.server.access_token = "test-token" + self.assertEqual(self.request("GET", "/dashboard.html")[0], 403) + status, headers, _ = self.request("GET", "/dashboard.html?access=test-token") + self.assertEqual(status, 200) + cookie = dict(headers).get("Set-Cookie", "").split(";", 1)[0] + body = json.dumps({"ts": 1, "data": {}}).encode() + status, _, _ = self.request("POST", "/__save", body, {"Content-Type": "application/json", "Cookie": cookie}) + self.assertEqual(status, 200) + + def test_concurrent_saves_remain_valid(self): + payloads = [{"ts": i, "data": {"ccaf-test": str(i)}} for i in range(1, 9)] + with ThreadPoolExecutor(max_workers=8) as pool: + statuses = list(pool.map(lambda payload: self.post(payload)[0], payloads)) + self.assertEqual(statuses, [200] * len(payloads)) + saved = json.loads(Path(serve.SAVE).read_text()) + backup = json.loads(Path(serve.BAK).read_text()) + self.assertIn(saved, payloads) + self.assertEqual(saved["ts"], max(payload["ts"] for payload in payloads)) + self.assertIn(backup, payloads) + self.assertNotEqual(saved, backup) + + +if __name__ == "__main__": + unittest.main() diff --git a/timeline.html b/timeline.html index 45d0f93..d068af6 100644 --- a/timeline.html +++ b/timeline.html @@ -26,7 +26,7 @@ .one{color:var(--muted);font-size:.9rem;margin:2px 0 8px} .lvl{display:inline-block;font-size:.7rem;font-weight:800;color:#fff;border-radius:999px;padding:2px 10px;vertical-align:middle;margin-right:6px} .here{display:inline-block;background:#E0A106;color:#332700;font-weight:800;font-size:.7rem;padding:2px 10px;border-radius:999px;margin-left:6px} - .donetag{color:var(--green);font-weight:800;font-size:.85rem;margin-left:6px} + .donetag{color:var(--green);font:inherit;font-weight:800;font-size:.85rem;margin-left:6px;border:0;background:transparent;padding:3px 5px;cursor:pointer} .links a{display:inline-block;background:#fff;border:1px solid var(--line);border-radius:7px;padding:5px 12px;margin:2px 6px 0 0;text-decoration:none;color:var(--ink);font-weight:700;font-size:.78rem} .links a:hover{border-color:var(--accent);color:var(--accent)} details.chap{background:#F7FAFB;border:1px solid var(--line);border-radius:8px;padding:2px 12px;margin:8px 0 6px;font-size:.88rem} @@ -119,7 +119,7 @@

      🛤️ Your Course Timeline

      h+='
    • '+ ''+u.lvl+''+ ''+u.ic+" "+u.t+''+ - (st.done[u.id]?'✓ done ↩︎':'')+ + (st.done[u.id]?'':'')+ (u.id===nowId?'⭐ YOU ARE HERE':'')+ ((!st.done[u.id]&&u.id!==nowId&&st.opened[u.id])?'started':'')+ '
      '+u.one+'
      '+ diff --git a/today.html b/today.html index 5e2f7a7..3276f8d 100644 --- a/today.html +++ b/today.html @@ -6,7 +6,7 @@ Your lesson — CCA-F @@ -36,57 +43,60 @@ + + -
      +
      -

      ▶️ Your lesson

      +

      Today's lesson

      - -
      -
      -
      0%
      of the course done
      -
      Getting started
      0 / 23 lessons
      -
      -
      -

      -

      🛤️ See the whole timeline — every lesson, what's done, where you are →

      -
      - - -

      🎯 Your lesson

      + - + +
      + 0% course complete 0 / 23 lessons +
      +
      Getting started
      +
      +

      +

      See the whole timeline

      +
      +
      - -

      📋 This lesson's 5 steps

      +

      Practice habits for this lesson

      @@ -96,28 +106,19 @@

      📋 This lesson's 5 steps

      - -

      📚 The articles — as pictures

      -
      -

      Every article the course points to, retold as diagrams right here on your site — no going anywhere else. (Each page still links the original at the top if you want it.)

      - 🧩 Building effective agents - 🕸️ Multi-agent research system - 🔧 Writing tools for agents - 🩹 Pre-test repair guide -
      +
      Optional pictures and extra practice
      + Building effective agents + Multi-agent research system + Writing tools for agents + Pre-test repair guide + Flashcard library + Build library + Quiz library + Visual map +
      - -

      ⚡ Quick practice

      -
      - 🃏 Flip flashcards - 🏋️ Build exercises - 📊 Take a quiz - 🗺️ See the big picture - 🧪 Re-take the pre-test -
      - -
      Follows your current lesson by default — press ◀ ▶ to work ahead on any lesson's 5 steps (they save per lesson; only your ⭐ NOW lesson closes). · 2026-07-08
      -
      +
      Your work saves with the lesson you are viewing. Only the current lesson closes the course path.
      +
      Copied — paste it to your tutor 👍
      @@ -140,8 +141,8 @@

      ⚡ Quick practice

      ask:"Teach me Claude Code's built-in tools for CCA-F: when to use Grep vs Glob vs Read/Write vs Edit vs Bash, and the 'grep an entry point then read to follow imports' pattern. One example, 3 flashcards."}, {id:"o3",lvl:"Organisms",t:"An MCP server",one:"Tools (actions) vs resources (read-only) vs prompts (workflows)",quiz:"quiz.html?set=tools-mcp", ask:"Teach me MCP for CCA-F: tools vs resources vs prompts, who controls each, scope, secrets. The trap is using a tool when a read-only resource fits. One example, 3 flashcards."}, - {id:"o4",lvl:"Organisms",t:"Claude Code workflows",one:"CLAUDE.md, commands, skills, subagents, hooks, headless",quiz:"quiz.html?set=claude-code", - ask:"Teach me Claude Code workflows for CCA-F: CLAUDE.md, slash commands, skills, subagents, hooks, headless claude -p — and when a hook beats a prompt. One example, 3 flashcards."}, + {id:"o4",lvl:"Organisms",t:"Claude Code workflows",one:"CLAUDE.md, skills, subagents, hooks, headless",quiz:"quiz.html?set=claude-code", + ask:"Teach me current Claude Code workflows for CCA-F: CLAUDE.md, Skills, commands compatibility, subagents, hooks, headless claude -p — and when a hook beats a prompt. One example, 3 flashcards."}, {id:"o2",lvl:"Organisms",t:"Orchestrator–Workers",one:"A coordinator splits work across subagents",quiz:"quiz.html?set=agentic", ask:"Teach me Orchestrator–Workers (multi-agent) for CCA-F: coordinator role, explicit context passing, parallel work, provenance, and when NOT to use multi-agent. One example, 3 flashcards."}, {id:"rel",lvl:"Reliability thread",t:"Reliability, context & evals",one:"Lost-in-the-middle, compaction, RAG vs long context, evals, human-in-loop",quiz:"quiz.html?set=reliability", @@ -150,7 +151,7 @@

      ⚡ Quick practice

      ask:"Walk me through a support-agent system for CCA-F: the loop in context, a refund limit that must escalate, why that needs a hook not a prompt, structured handoff fields. One example, 3 flashcards."}, {id:"t2",lvl:"Templates",t:"Research multi-agent system",one:"Search → analyze → synthesize → report",quiz:"quiz.html?set=agentic", ask:"Walk me through a research multi-agent system for CCA-F: decompose, pass context, gather, attach provenance to every finding. Where does it break? One example, 3 flashcards."}, - {id:"p1",lvl:"Pages",t:"The 6 exam scenarios",one:"Whole systems, real tradeoffs — exam style",quiz:"pretest.html", + {id:"p1",lvl:"Pages",t:"Production scenarios",one:"Whole systems, real tradeoffs — reported exam style",quiz:"pretest.html", ask:"Give me one CCA-F production scenario like the exam. Make me choose the approach and justify it, name the tradeoff, the reliability angle. Then grade me."}, {id:"px",lvl:"Pages",t:"Anti-patterns & decision frameworks",one:"The wrong answers — and how to pick A vs B",quiz:"pretest.html", ask:"Drill me on CCA-F anti-patterns (the wrong answers): 8 scenario questions where one option is a classic trap (parsing text to stop a loop, iteration caps, prompt-enforcing critical rules, sentiment-based escalation, swallowing errors, too many tools, same-session review, aggregate metrics). Make me pick AND explain. Then grade me."}, @@ -183,13 +184,15 @@

      ⚡ Quick practice

      o1:["exercise.html?id=gate-chain","🚦 Flashcard Factory — chain with a gate"], m3:["exercise.html?id=gate-chain","🚦 Flashcard Factory — chain with a gate"] }; -// The shared manifest is authoritative. The legacy literals above remain only as -// an offline fallback for an old cached page. -if(window.CCAF_COURSE){ - PATH=CCAF_COURSE.units.map(function(u){return {id:u.id,lvl:u.level,t:u.title,one:u.one,quiz:u.quiz,notes:u.notes,ask:u.ask,prereq:u.prereq,concepts:u.concepts};}); - TOTAL=PATH.length;WATCH={};BUILDX={}; - CCAF_COURSE.units.forEach(function(u){WATCH[u.id]=u.watch||[];BUILDX[u.id]=["exercise.html?id="+u.exercise,u.title+" fixed build"];}); +// The shared manifest is authoritative. Never silently use an older partial path. +if(!window.CCAF_COURSE||!Array.isArray(CCAF_COURSE.units)||CCAF_COURSE.units.length!==23){ + document.getElementById("nexttitle").textContent="Course data did not load"; + document.getElementById("nextone").textContent="Reload this page. If it still appears, restart the local tutor server."; + throw new Error("CCA-F course manifest unavailable"); } +PATH=CCAF_COURSE.units.map(function(u){return {id:u.id,lvl:u.level,t:u.title,one:u.one,quiz:u.quiz,notes:u.notes,ask:u.ask,prereq:u.prereq,concepts:u.concepts};}); +TOTAL=PATH.length;WATCH={};BUILDX={}; +CCAF_COURSE.units.forEach(function(u){WATCH[u.id]=u.watch||[];BUILDX[u.id]=["exercise.html?id="+u.exercise,u.title+" fixed build"];}); // ---- read curriculum progress ---- var done={}; @@ -207,7 +210,17 @@

      ⚡ Quick practice

      document.getElementById("levelnow").textContent = next ? ("Now in: "+next.lvl) : "🎉 All lessons done!"; // ---- the lesson card: shows your CURRENT lesson; ◀ ▶ browse back or peek ahead ---- var curIdx = next ? PATH.indexOf(next) : -1; // -1 = every lesson is done -var vi = curIdx; // which lesson the card is showing right now +var requestedUnit=(location.search.match(/[?&]unit=([^&]+)/)||[])[1]; +try{requestedUnit=requestedUnit?decodeURIComponent(requestedUnit):null;}catch(e){requestedUnit=null;} +var requestedIdx=requestedUnit?PATH.findIndex(function(item){return item.id===requestedUnit;}):-1; +var vi = requestedIdx>=0?requestedIdx:curIdx; // which lesson the card is showing right now +function updateFocus(u){ + var flow=document.getElementById("lesson-flow"),action=document.getElementById("focus-action"); + if(!flow||!action||!u||!window.CCAFFlow){if(flow)flow.textContent="";if(action)action.textContent="";return;} + var nextAction=CCAFFlow.next(u.id),active=nextAction.id==="complete"?"review":nextAction.id; + CCAFFlow.mount(flow,{unit:u.id,stage:active}); + CCAFFlow.mountNext(action,u.id,{context:nextAction.id==="complete"?"All lesson activities are saved.":"Your next required activity."}); +} function renderLesson(){ var pos=document.getElementById("lpos"); document.getElementById("lprev").disabled=(vi===0); @@ -224,7 +237,7 @@

      ⚡ Quick practice

      document.getElementById("nextnotes").href="notes.html"; qE.href="pretest.html"; qE.textContent="🧪 Re-take the pre-test"; aE.setAttribute("data-q","I've finished all the units. Build me a timed exam-readiness plan for CCA-F: which quizzes to redo, how to review wrong answers, and a mock-exam routine."); - wE.innerHTML=""; hE.innerHTML="Use ◀ to revisit any lesson."; bk.style.display="none"; + wE.innerHTML=""; hE.innerHTML="Use Browse another lesson to revisit one."; bk.style.display="none";updateFocus(null); }else{ var u=PATH[vi], isCur=(vi===curIdx), isDone=!!done[u.id]; pos.textContent="Lesson "+(vi+1)+" of "+TOTAL; @@ -235,13 +248,13 @@

      ⚡ Quick practice

      qE.href=window.withUnit(u.quiz,u.id); qE.textContent=(u.quiz.indexOf("projects.html")===0)?"🔨 Its project":"🧪 Its quiz"; aE.setAttribute("data-q",u.ask); - wE.innerHTML=""; // the steps panel below now shows THIS lesson’s videos + wE.innerHTML=window.CCAFMediaUI?CCAFMediaUI.inlineHTML(u.id):""; hE.innerHTML=isCur ? 'How it closes: finish the 5 steps below + take its quiz (your score gets saved) — then the green card lets you close it. No accidental skips.' : (isDone ? 'You finished this one ✓ — rewatch it, retake its quiz, or un-mark it on the timeline.' : 'Working ahead is safe 👀 — the 5 steps below belong to THIS lesson and save as you tick. Only your ⭐ NOW lesson can close, so nothing closes by accident.'); - bk.style.display=isCur?"none":"block"; + bk.style.display=isCur?"none":"block";updateFocus(u); } } document.getElementById("lprev").addEventListener("click",function(){ vi=(vi===-1)?TOTAL-1:Math.max(0,vi-1); renderLesson(); buildSteps(); }); @@ -299,9 +312,10 @@

      ⚡ Quick practice

      // ---- pick up where you left off (written by curriculum/flashcards/guides) ---- try{ var last=JSON.parse(localStorage.getItem("ccaf-last")||"null"); - if(last && last.href && last.label && (Date.now()-(last.ts||0)) < 14*24*60*60*1000){ + var safeHref=last&&window.CCAFProgress?CCAFProgress.localPage(last.href):null; + if(last && safeHref && last.label && (Date.now()-(last.ts||0)) < 14*24*60*60*1000){ var ls=document.getElementById("lastseen"); - var a=document.createElement("a"); a.href=last.href; + var a=document.createElement("a"); a.href=safeHref; var b=document.createElement("b"); b.textContent=last.label; a.appendChild(b); ls.appendChild(document.createTextNode("⏪ Pick up where you left off: ")); ls.appendChild(a); ls.appendChild(document.createTextNode(" →")); @@ -311,7 +325,7 @@

      ⚡ Quick practice

      // ---- daily 5 steps (shared key with the dashboard) ---- var PIPE=[ - {label:"🎥 Watch / listen (15–25 min)", d:"This lesson's videos are right here 👇 Captions on; pause and sketch.", + {label:"🎥 Learn: watch + notes", d:"Watch or listen first, then read the short notes.", ask:"What exactly should I watch today for my current unit, and where? Give the course + lesson + a one-line focus."}, {label:"✏️ Draw it as boxes + arrows", d:"From memory, redraw this lesson's idea. Use the color key.", ask:"Describe the ONE boxes-and-arrows diagram for my current lesson so I can copy it."}, @@ -319,7 +333,7 @@

      ⚡ Quick practice

      ask:"Give me today's tiny build task — the smallest real thing I can do in ~20 min for my current unit, with starter steps."}, {label:"🗣️ Explain it out loud (60 sec)", d:"Say it in plain words, no notes.", ask:"I'll explain my current lesson in my own words — quiz and grade me, and tell me what I missed."}, - {label:"🃏 3 flashcards + 1 mistake card", d:"3 Q→A cards + 1 card for something you got wrong.", + {label:"🃏 Review 3 cards + 1 mistake card", d:"Reveal each answer, rate it, then move to the next card.", ask:"Turn my current lesson into 3 short flashcards (Q then A) plus 1 mistake card."} ]; var _n=new Date(),today=_n.getFullYear()+"-"+String(_n.getMonth()+1).padStart(2,"0")+"-"+String(_n.getDate()).padStart(2,"0"); // local date, not UTC @@ -336,8 +350,9 @@

      ⚡ Quick practice

      var vu=viewedU(), uid=viewedId(); var checks=stepChecks(uid); var n=checks.filter(Boolean).length; - document.getElementById("pipeprog").textContent="This lesson: "+n+" / "+PIPE.length+" done"+(n===PIPE.length?" 🎉":""); + document.getElementById("pipeprog").textContent="Habits: "+n+" / "+PIPE.length+" done"+(n===PIPE.length?" 🎉":""); document.getElementById("pipebar").style.width=(n/PIPE.length*100)+"%"; + if(vu)updateFocus(vu); var de=document.getElementById("doneearly"); if(!de)return; if(n!==PIPE.length||!vu||done[vu.id]){de.style.display="none";de.innerHTML="";return;} @@ -355,7 +370,7 @@

      ⚡ Quick practice

      var up=null; for(var uk=curIdx+1;uk>=0&&ukAll evidence is complete'+qtxt+'. "'+vu.t+'" is ready to close.

      ' :need)+ @@ -366,7 +381,7 @@

      ⚡ Quick practice

      (ready&&!advToday?'':"")+ '
    '+ (ready&&advToday?'

    You already closed a lesson today. This ready lesson stays saved for the next session.

    ':"")+ - '

    Or stop here — 5/5 is a full day; the timeline keeps your place'+(up?', or press Next ▶ up top to 🔭 work ahead on '+up.t:'')+'.

    '; + '

    Or stop here. The timeline keeps your place'+(up?', or use the lesson browser above to work ahead on '+up.t:'')+'.

    '; var nb=document.getElementById("nextUnitBtn"); if(nb){nb.addEventListener("click",function(){ nb.disabled=true; // double-clicks do nothing @@ -381,7 +396,7 @@

    ⚡ Quick practice

    location.href="today.html?started="+encodeURIComponent(up?up.id:"end"); });} } else { // 🔭 working ahead — everything saves; closing waits for the NOW lesson (council rule) - de.innerHTML='💾 All 5 steps done — saved!'+ + de.innerHTML='All 5 practice habits are saved.'+ (ready?'

    All mastery evidence is saved. It unlocks after your current lesson closes.

    ':need)+ '
    '+ (isProj @@ -390,7 +405,7 @@

    ⚡ Quick practice

    ''+ '
    '; var gb=document.getElementById("goNowBtn"); - if(gb)gb.addEventListener("click",function(){vi=curIdx;renderLesson();buildSteps();window.scrollTo({top:0,behavior:"smooth"});}); + if(gb)gb.addEventListener("click",function(){vi=curIdx;renderLesson();buildSteps();var reduce=window.matchMedia&&window.matchMedia("(prefers-reduced-motion: reduce)").matches;window.scrollTo({top:0,behavior:reduce?"auto":"smooth"});}); } de.style.display="block"; } @@ -414,19 +429,16 @@

    ⚡ Quick practice

    sh.innerHTML=""; PIPE.forEach(function(it,i){ var w=document.createElement("div");w.className="step"; - var cb=document.createElement("input");cb.type="checkbox";cb.checked=!!checks[i]; + var cb=document.createElement("input");cb.type="checkbox";cb.checked=!!checks[i];cb.id="step-"+uid+"-"+i; var body=document.createElement("div"); - body.innerHTML='
    '+it.label+'
    '+it.d+'
    '; + var labId=cb.id+"-label",descId=cb.id+"-desc"; + body.innerHTML='
    '+it.label+'
    '+it.d+'
    '; + cb.setAttribute("aria-labelledby",labId);cb.setAttribute("aria-describedby",descId); if(i===0){ - wl.forEach(function(v,wi){ // each video on its OWN row — never crammed together - var row=document.createElement("div"); - var a=document.createElement("a");a.className="watchlink";a.href=v[0]; - if(/^https?:/.test(v[0])){a.target="_blank";a.rel="noopener";} - a.textContent="▶ "+(wl.length>1?(wi+1)+" · ":"")+v[1]; - row.appendChild(a);body.appendChild(row); - if(v[2]){var focus=document.createElement("div");focus.className="d";focus.textContent=v[2];row.appendChild(focus);} - }); - if(wl.length>1){var wn=document.createElement("div");wn.className="d";wn.textContent="👆 "+wl.length+" links for this lesson — best watched in order.";body.appendChild(wn);} + var learnLink=document.createElement("a");learnLink.className="watchlink";learnLink.href=window.CCAFFlow?CCAFFlow.route(uid,"learn"):(wl[0]?wl[0][0]:"curriculum.html#u-"+uid);learnLink.textContent="Open the visual lesson and notes";body.appendChild(learnLink); + } + if(i===1){ + var drawLink=document.createElement("a");drawLink.className="watchlink";drawLink.href="draw.html?unit="+encodeURIComponent(uid);drawLink.textContent="Open the sketchpad";body.appendChild(drawLink); } if(i===2 && BUILDX[uid]){ var bl=document.createElement("a");bl.className="watchlink";bl.href=BUILDX[uid][0]; diff --git a/units-data.js b/units-data.js index b4412bb..169809b 100644 --- a/units-data.js +++ b/units-data.js @@ -1,3 +1,12 @@ /* GENERATED from curriculum.html UNITS (source of truth) — regenerate if chapters change there. Shared by timeline.html so every unit can show its chapters without duplicating the curriculum page. */ var UNIT_CHAPTERS={"a1": ["API = two programs talking", "JSON = data with labels", "Schema = the shape rules", "Context window = short-term memory", "Prompt · Tool · Token · Model"], "m1": ["required vs optional", "nullable stops hallucination", "enums for fixed choices", "enum + \"other\" + a detail string keeps categories extensible", "strict mode / output_config for validated JSON", "schema-valid ≠ semantically correct", "validate vs missing data", "retry appends the SPECIFIC validation errors, not just \"try again\"", "retry vs human-review"], "m2": ["name + description (be clear!)", "inputs / parameters", "tool_result back into the loop", "is_error for failures", "empty result [] vs a failure (timeout) — handle them differently", "keep it to ~4–5 tools per agent (not 18)", "tool_choice: auto / any / forced", "near-identical descriptions cause misrouting (analyze_content vs analyze_document)", "fix overlap: rename/split into purpose-built tools, not vague generic ones", "error types: transient / validation / business / permission — each handled differently", "design your error payload so code can route retries (e.g. a retryable flag + category) — ⚠️ but \"isRetryable\" is prep-quiz wording, NOT an official field: the real signal is is_error + a clear message", "scope each agent's tools to its role — off-role tools get misused"], "m3": ["explicit criteria", "explicit criteria beats \"be conservative\" — vague guidance won't cut false positives", "few-shot examples", "few-shot teaches the REASONING so the model generalizes to new cases", "2–4 targeted examples for ambiguous cases, not just one good + one bad", "one noisy category erodes trust in ALL of them — disable it and fix the prompt", "output format", "prompt chaining (steps feed the next)"], "m4": ["Grep = search inside files (content)", "Glob = match filenames / paths (e.g. **/*.test.ts)", "Read / Write = whole-file open & save", "Edit = change one unique piece of text; Read+Write if the match isn't unique", "Bash = run shell commands", "explore big codebases: Grep an entry point, then Read to follow imports"], "o1": ["think then tool then result then repeat", "stop_reason runs the loop: tool_use = continue, end_turn = done", "know the other values too: max_tokens, stop_sequence, pause_turn, refusal, model_context_window_exceeded", "NEVER read the text to decide when to stop — check stop_reason", "why fixed iteration caps are a weak primary stop", "model decides the next tool from context — not a fixed decision tree", "guardrails so it can't run away", "start with RAW API calls + simple patterns — a framework hides prompts, tools & errors (glass box vs magic box)"], "o2": ["coordinator role", "explicit context passing", "parallel work", "provenance on every finding", "when NOT to use multi-agent", "NOT \"advanced parallelization\": parallelization runs KNOWN subtasks — the orchestrator DECIDES them per input", "coordinator routes all inter-agent comms and errors — subagents never talk directly", "pick only the subagents a query actually needs, not the full pipeline", "narrow decomposition risk: missing whole subtopics of a broad question", "spawn subagents via the Task tool — allowedTools must include Task", "AgentDefinition sets each subagent's description, system prompt & tool limits"], "o3": ["tools = actions (model-controlled)", "resources = read-only (app-controlled)", "prompts = workflows (user-controlled)", "transport: stdio vs Streamable HTTP", "config: .mcp.json (project) vs ~/.claude.json (user)", "secrets via env vars", "tools from every connected MCP server are all available at once", "resources can double as content catalogs, cutting exploratory tool calls", "thin tool descriptions push Claude to prefer built-in tools like Grep"], "o4": ["§ ⚙️ Set it up", "CLAUDE.md = project rules Claude re-reads every request (not keys/history)", "CLAUDE.md hierarchy: project (git-shared) vs user-level (personal, NOT shared)", "slash commands & skills: project dir (shared, version-controlled) vs user dir (personal)", "§ ▶️ Run it", "plan mode (plan first, approve) + permission modes (ask-first → automatic)", "subagents run in their OWN fresh context — inherit nothing, pass context in the prompt", "hooks = deterministic gates: PreToolUse (before, can block) / PostToolUse (after, can check)", "a rule that MUST hold goes in a hook, not a polite prompt line", "headless claude -p = non-interactive CLI for automation & CI", "§ 🎯 Steer it", "refine output with 2–3 concrete I/O examples or one failing test", "🔨 practiced in the capstone: advanced hooks, SKILL.md details, session control --resume/fork"], "t1": ["the loop in a real job", "block refund over the limit in a HOOK (deterministic, not a prompt)", "prerequisite hook: block process_refund until get_customer returns a verified ID", "escalate explicit customer requests immediately", "split a multi-issue request, investigate in parallel, merge one resolution", "structured handoff fields", "handoff = customer ID + root-cause analysis + recommended action", "PostToolUse hook normalizes mixed formats (timestamps, status codes) before Claude reads them"], "t2": ["decompose the question", "assign distinct subtopics / source types per worker to avoid duplicate coverage", "send each worker context", "decomposition can adapt mid-research as workers report new findings", "gather + dedupe", "coordinator can re-delegate a second round to fill synthesis gaps", "finding = claim + source + date + confidence"], "p1": ["read the scenario carefully", "pick the box + justify it", "name the tradeoff", "add the reliability/guardrail angle"], "p2": ["§ 📚 Learn the pipeline", "what a PR-review pipeline is (reads a change, comments before a human)", "real-time (blocking checks) vs batch (overnight debt report, cheaper)", "claude -p headless + JSON output the script reads by field", "Structured Outputs = constrained decoding, but STILL validate + retry with the specific error", "file-by-file pass, THEN a cross-file integration pass", "cut false positives: explicit criteria; re-runs pass prior findings, flag only new/unaddressed", "provenance (file + line) so a human can verify each comment", "§ 🔨 Build your capstone", "scope it small + real: one narrow review path you can finish", "draw the blueprint: changed files → claude -p per file → JSON → integration pass → comments", "build the tiny version: one claude -p call on one file returning JSON issues, end to end", "add one guardrail in code (hook/app gate), e.g. block merge on a hard-coded secret — not the prompt", "add a validation step for the JSON; rank checks code > visual > LLM-judge", "route human review for uncertain/risky/policy changes (confidence is not the only gate)", "explain it in 60s: what can fail, how it's caught, what happens next — then check the rubric"], "px": ["1 · parsing text to stop a loop (use stop_reason)", "2 · iteration caps as the main stop", "3 · prompt-enforcing critical rules (use hooks)", "4 · self-reported confidence for escalation", "5 · escalating on sentiment, not complexity", "6 · generic errors that hide the cause", "7 · silently swallowing errors as success", "8 · too many tools (~18 vs 4–5)", "9 · same-session self-review (biased)", "10 · aggregate metrics hiding per-type failures", "11 · grabbing a framework before understanding what it hides — start raw (glass box vs magic box)", "Decide: hooks vs prompt · plan vs direct · sync vs batch · multi-pass vs single-pass · raw API vs framework · context always explicit"], "rel": ["context window & lost-in-the-middle", "context window ≠ memory: bigger window is not recall", "compaction / summarization keeps a long agent going but is lossy", "case-facts block: pull amounts / dates / IDs into a block outside the summary", "what survives /compact (CLAUDE.md, memory) vs what's lost", "scratchpad + memory files let agents resume after context loss", "RAG vs long context: retrieval for many/changing docs, long context for single-doc depth", "verification ladder = eval tiers: code > visual > LLM-judge", "evals: saved cases + a rubric, re-run as a regression test (not 'worked once in chat')", "guardrails: least-privilege tools — give each agent only the tools its role needs", "guardrails: human-in-the-loop approval before risky, hard-to-undo actions", "structured error context: failure type, what was tried, partial results, alternatives", "is_error / isError is real; constrained decoding still needs validation + specific-error retry", "don't silently return empty as success or abort the whole workflow on one failure", "escalate on COMPLEXITY, not sentiment", "multiple customer matches: ask for another identifier, don't guess", "provenance + handling conflicting / temporal data", "human review: stratified sampling + field-level confidence", "batch vs real-time · retries + prompt caching"], "a2": ["tokens = the unit of cost (input + output)", "cheap/fast model → extraction & routing", "strong model → planning, coding, synthesis", "start cheap, upgrade only if it falls short", "cost & latency: bigger models are slower", "long context + many tools = more tokens = more cost", "sequential chains add up their wait times", "match effort to the value of the task", "prompt caching: stable prefix first, changing text last", "cache reads are much cheaper than a fresh send", "Batch API = non-urgent bulk jobs at a discount (~half)", "batch returns results later — never for live/urgent work"]}; + +// Keep the generated timeline aligned with the current curriculum wording. +UNIT_CHAPTERS.a1[3]="Context window = limited working input, not durable memory"; +UNIT_CHAPTERS.o1[1]="branch on stop_reason: tool_use = run the tool; end_turn = natural completion"; +UNIT_CHAPTERS.o1[2]="handle max_tokens, stop_sequence, pause_turn, refusal, and model_context_window_exceeded explicitly"; +UNIT_CHAPTERS.o3[6]="Claude Code Tool Search discovers MCP tools on demand by default; some setups can load them directly"; +UNIT_CHAPTERS.o4[1]="CLAUDE.md = scoped project instructions loaded for a Claude Code session (not keys/history)"; +UNIT_CHAPTERS.o4[3]="Skills are the current workflow format; .claude/commands remains compatible"; +UNIT_CHAPTERS.rel[5]="scratchpad + memory files help only when the application writes and reloads them deliberately"; diff --git a/video-data.js b/video-data.js new file mode 100644 index 0000000..0b285db --- /dev/null +++ b/video-data.js @@ -0,0 +1,127 @@ +/* Reviewed video map for the CCA-F course. + Community videos are teaching aids, not official Anthropic exam specifications. */ +(function(){ + var PLAYLIST_URL="https://www.youtube.com/playlist?list=PLviC8AFqAj5A9MHkRIn2fU5Ac2lEdJxNf"; + var REVIEWED_AT="2026-07-15"; + + function episode(id,number,title,durationSec,uploaded,status,lessons,note){ + return {id:id,number:number,title:title,durationSec:durationSec,uploaded:uploaded,status:status,lessons:lessons||[],note:note||"",channel:"Peace Of Code",authority:"community",reviewedAt:REVIEWED_AT}; + } + + var episodes={ + ep00:episode("rcpNFm_poQs","00","The AI Certification That Will Make You Irreplaceable | Full Breakdown",544,"2026-03-25","excluded",[],"Promotional overview. It is not needed for learning and its exam claims are not official Anthropic specifications."), + ep01:episode("ldqOnljDINc","01","Agentic Loops and stop_reason Explained",2967,"2026-04-05","used",["o1"],"The assigned clip stops before the inaccurate claim that only two stop reasons exist. The full episode simplifies the current API behavior."), + ep02:episode("ejPWvBcc_DU","02","Multi-Agent Systems and Coordinator Patterns",1955,"2026-04-07","used",["o2"],"Use the short coordinator clip; the official subagents lesson remains the authority."), + ep03:episode("a2N6vKdQUfE","03","Subagent Context Passing and Session Management",2016,"2026-04-12","used",["t2"],"The selected clip focuses on provenance and conflicting findings."), + ep04:episode("e7ijjK173zI","04","Multi-Agent System in Python and Claude SDK | Hands On",767,"2026-04-17","reference",["o2","t2"],"Useful full build-along after the orchestration lessons; not required in the core path."), + ep05:episode("JJBcpwpsKzk","05","PreToolUse, PostToolUse Hooks and Task Decomposition",2723,"2026-04-19","used",["t1"],"The assigned clip shows deterministic prerequisite gates."), + ep06:episode("s1j1vTnCKns","06","Tool Descriptions and Tool Misrouting",1490,"2026-04-24","used",["m2"],"The assigned clip shows why names and descriptions change tool selection."), + ep07:episode("eZj6FtTVV58","07","Agent Error Handling and tool_choice",2286,"2026-04-26","reference",["m2","rel"],"Useful extra review for tool errors; the core lesson already covers the same ground more briefly."), + ep08:episode("IVUxGTxSuH8","08","MCP Servers, Configuration, Cline and More",5348,"2026-04-29","used",["o3"],"The assigned MCP introduction is current. A later full-episode section saying all MCP tools load at once is outdated: Claude Code now uses Tool Search by default."), + ep09:episode("eh-xxQpfBBY","09","Claude Built-in Tools Explained",2139,"2026-05-01","used",["m4"],"The assigned clip demonstrates a search, read, and edit exploration path."), + ep10:episode("qIee1aqSAwY","10","CLAUDE.md Hierarchy and Configuration Rules",1896,"2026-05-03","reference",["o4"],"Reference only. Current CLAUDE.md loading and post-compaction behavior should be learned from the official memory documentation."), + ep11:episode("v3tMqTmgg2Q","11","Custom Slash Commands and Skills",1997,"2026-05-06","reference",["o4"],"Reference only. Custom commands have since merged into Skills; .claude/commands remains compatible."), + ep12:episode("q-n1cut5e7c","12","Plan Mode vs Execute in Claude Code",3102,"2026-05-10","used",["o4"],"The assigned clip gives a clear decision rule for planning before execution."), + ep13:episode("GWCnDhgH840","13","Claude Code CI/CD Pipelines",1881,"2026-05-13","used",["d2"],"The assigned clip connects a pull request to automated Claude Code checks."), + ep14:episode("HqwULqy1egw","14","Prompt Engineering: Explicit Criteria and False Positives",2065,"2026-05-17","used",["m3"],"Primary playlist lesson for explicit criteria."), + ep15:episode("FbIcU6YFrhw","15","Few-Shot Prompting Explained",1662,"2026-05-20","used",["m3"],"Optional clip for targeted examples after explicit criteria."), + ep16:episode("CaDaLn7DcQ0","16","Structured Output and JSON Schema",2211,"2026-05-25","reference",["m1"],"Reference only. Its fake-tool forcing method is historical; current JSON outputs use output_config.format and strict tools use strict: true."), + ep17:episode("BXs7QoLQxX0","17","Batch API and Multi-Pass Review",2044,"2026-05-29","used",["p2"],"The selected multi-pass section is current. Earlier Batch API limitations in the full episode no longer describe all supported tool-use and multi-turn cases."), + ep18:episode("7kaJdZ7veDs","18","Why AI Agents Forget: Context Engineering",2598,"2026-06-02","used",["rel"],"Treat context as working input, not durable memory. Compaction and summaries are useful but lossy."), + ep19:episode("MqnElZw6NYk","19","Subagent Error Propagation and Context Management",2546,"2026-06-07","reference",["rel","o2"],"Useful extra review. A scratchpad persists only when the application writes it and deliberately reads it again."), + ep20:episode("tsIxzFg76Nw","20","When AI Needs a Human",3078,"2026-06-10","used",["px"],"The assigned clip focuses on synthesis risk and human review."), + exam:episode("-NymqBcFy6E","Bonus","Exam Questions Solved and Exam Traps",3650,"2026-06-21","excluded",["p1"],"Unofficial exam coaching. It is excluded from the teaching path so reported exam claims are not presented as facts."), + unavailable:episode("bBeuTxCiWYA","?","Unavailable playlist video",0,"","unavailable",[],"YouTube reports this video as unavailable."), + hidden:episode("","?","Hidden unavailable playlist item",0,"","unavailable",[],"The playlist reports one additional hidden or unavailable item without a usable video ID.") + }; + + function clip(id,episodeKey,startSec,endSec,focus){ + return {id:id,episode:episodeKey,startSec:startSec,endSec:endSec,focus:focus,reviewedAt:REVIEWED_AT,captionSource:"YouTube native captions",status:"current"}; + } + + var clips={ + agentLoop:clip("agent-loop-basics","ep01",1157,1306,"See chat become a loop: reason, call a tool, read the result, and decide again."), + coordinator:clip("coordinator-role","ep02",362,514,"Name the coordinator's jobs before adding workers."), + provenance:clip("provenance-conflicts","ep03",640,1104,"Pass sources with findings and resolve conflicts before synthesis."), + gates:clip("deterministic-gates","ep05",1338,1660,"Use code to block an action until a required fact is verified."), + toolDescriptions:clip("tool-descriptions","ep06",58,588,"See how names, descriptions, and overlap change tool selection."), + mcpBasics:clip("mcp-basics","ep08",104,684,"See the MCP client-server picture and what MCP connects."), + builtInTools:clip("codebase-exploration","ep09",1216,1648,"Follow search -> read -> edit instead of guessing where code lives."), + planMode:clip("plan-mode","ep12",280,548,"Choose plan mode for complex, ambiguous, or risky work."), + cicd:clip("ci-integration","ep13",342,502,"Connect pull-request changes to automatic Claude Code checks."), + criteria:clip("explicit-criteria","ep14",902,1320,"Replace vague guidance with concrete pass and fail criteria."), + fewShot:clip("targeted-examples","ep15",772,1046,"Use a few examples that target the ambiguous edge cases."), + multiPass:clip("multi-pass-review","ep17",1246,1726,"Review each item first, then run a second integration pass."), + context:clip("context-and-summaries","ep18",206,702,"Separate working context from durable memory and see why summaries lose detail."), + synthesisRisk:clip("synthesis-risk","ep20",2544,2742,"See why high-risk synthesis still needs a human checkpoint.") + }; + + function authorityFor(url){ + if(!/^https?:/i.test(url))return "local"; + if(/(?:anthropic\.skilljar\.com|anthropic\.com|claude\.com|platform\.claude\.com|code\.claude\.com)/i.test(url))return "official"; + return "external"; + } + function resource(tuple){ + return {type:"resource",url:tuple[0],title:tuple[1],focus:tuple[2]||"",authority:authorityFor(tuple[0])}; + } + function clipItem(clipKey){return {type:"clip",clip:clipKey,authority:"community"};} + + var lessons={}; + var course=window.CCAF_COURSE; + if(course&&Array.isArray(course.units)){ + course.units.forEach(function(unit){ + var original=(unit.watch||[]).map(resource); + lessons[unit.id]={primary:original.shift()||null,optional:null,references:original,noVideoReason:""}; + }); + } + + function lead(unitId,clipKey){ + var lesson=lessons[unitId];if(!lesson)return; + if(lesson.primary)lesson.references.unshift(lesson.primary); + lesson.primary=clipItem(clipKey); + } + function optional(unitId,clipKey){if(lessons[unitId])lessons[unitId].optional=clipItem(clipKey);} + + lead("m3","criteria"); + optional("m3","fewShot"); + lead("o1","agentLoop"); + optional("m2","toolDescriptions"); + optional("d2","cicd"); + optional("m4","builtInTools"); + optional("o3","mcpBasics"); + optional("o4","planMode"); + optional("o2","coordinator"); + optional("rel","context"); + optional("t1","gates"); + optional("t2","provenance"); + optional("px","synthesisRisk"); + optional("p2","multiPass"); + + function youtubeUrl(videoId,startSec){ + return "https://www.youtube.com/watch?v="+encodeURIComponent(videoId)+(startSec?"&t="+startSec+"s":""); + } + function resolve(item){ + if(!item)return null; + if(item.type!=="clip")return item; + var selected=clips[item.clip],ep=selected&&episodes[selected.episode]; + if(!selected||!ep)return null; + return { + type:"clip",clipId:selected.id,episodeKey:selected.episode,videoId:ep.id,number:ep.number, + title:ep.title,focus:selected.focus,startSec:selected.startSec,endSec:selected.endSec, + url:youtubeUrl(ep.id,selected.startSec),fullUrl:youtubeUrl(ep.id,0),thumbnail:"https://i.ytimg.com/vi/"+ep.id+"/hqdefault.jpg", + authority:"community",channel:ep.channel,uploaded:ep.uploaded,reviewedAt:selected.reviewedAt, + captionSource:selected.captionSource,note:ep.note,status:selected.status + }; + } + + window.CCAF_MEDIA={ + playlistUrl:PLAYLIST_URL, + reviewedAt:REVIEWED_AT, + episodes:episodes, + clips:clips, + lessons:lessons, + resolve:resolve, + youtubeUrl:youtubeUrl, + communityNotice:"Community explanation from Peace Of Code. It is not official Anthropic guidance or an official exam specification." + }; +})(); diff --git a/video-library.html b/video-library.html new file mode 100644 index 0000000..d28bb33 --- /dev/null +++ b/video-library.html @@ -0,0 +1,109 @@ + + + + + +Video library — CCA-F + + + + + + + + + + +
    +
    +

    🎥 Video library

    +

    Peace Of Code playlist, checked against current Anthropic documentation. Use the short lesson clip first; open the full episode when you want the complete explanation.

    +
    + Open the full YouTube playlist + Back to my lesson +
    +
    Source rule: these are community explanations. Official Anthropic Academy lessons and documentation remain the authority when product behavior changes.
    + +
    + +
    + + + + +
    + +
    +

    No videos match this view.

    +
    Transcript-first review completed July 15, 2026. Exact clips are kept under ten minutes.
    +
    + + + + diff --git a/video-ui.js b/video-ui.js new file mode 100644 index 0000000..b876cf4 --- /dev/null +++ b/video-ui.js @@ -0,0 +1,82 @@ +/* Shared dyslexia-friendly media renderer. Load after course-data.js and video-data.js. */ +(function(){ + function esc(value){return String(value==null?"":value).replace(/[&<>\"]/g,function(c){return {"&":"&","<":"<",">":">",'"':"""}[c];});} + function time(seconds){ + seconds=Math.max(0,Number(seconds)||0); + var h=Math.floor(seconds/3600),m=Math.floor((seconds%3600)/60),s=Math.floor(seconds%60); + return (h?h+":"+String(m).padStart(2,"0"):String(m))+":"+String(s).padStart(2,"0"); + } + function authorityLabel(authority){ + return authority==="official"?"Official source":authority==="local"?"Course visual":authority==="community"?"Community video":"Extra source"; + } + function resolved(item){return window.CCAF_MEDIA?CCAF_MEDIA.resolve(item):item;} + function externalAttrs(url){return /^https?:/i.test(url||"")?' target="_blank" rel="noopener"':"";} + + function resourceCard(item,role){ + var label=authorityLabel(item.authority); + var verb=item.authority==="local"?"Open visual lesson":item.authority==="official"?"Open official lesson":"Open source"; + return '
    '+ + '
    '+esc(label)+''+ + (role?''+esc(role)+'':"")+'
    '+ + '

    '+esc(item.title)+'

    '+(item.focus?'

    '+esc(item.focus.replace(/^Focus:\s*/,""))+'

    ':"")+ + '
    '+verb+'
    '; + } + + function clipCard(item,role){ + var clipLength=item.endSec-item.startSec; + var title=(item.number&&item.number!=="?"?"Episode "+item.number+" · ":"")+item.title; + return ''; + } + + function card(item,role){ + item=resolved(item);if(!item)return ""; + return item.type==="clip"?clipCard(item,role):resourceCard(item,role); + } + + function referenceLinks(items){ + if(!items||!items.length)return ""; + return '
    Official and supporting sources
    '+ + items.map(function(raw){var item=resolved(raw);return ''+esc(authorityLabel(item.authority))+''+esc(item.title)+'';}).join("")+ + '
    '; + } + + function lessonHTML(unitId,options){ + options=options||{}; + var lesson=window.CCAF_MEDIA&&CCAF_MEDIA.lessons[unitId]; + if(!lesson)return '

    Open this lesson\'s visual and notes.

    '; + var optional=lesson.optional?'
    Optional second explanation'+card(lesson.optional,"Optional")+'
    ':""; + var flow=options.hideFlow?"":''; + return '
    '+ + '
    Watch first

    '+(options.title?esc(options.title):"This lesson's visual source")+'

    '+ + 'All reviewed videos
    '+flow+ + card(lesson.primary,"Primary")+optional+(options.showReferences===false?"":referenceLinks(lesson.references))+'
    '; + } + + function inlineHTML(unitId){ + var lesson=window.CCAF_MEDIA&&CCAF_MEDIA.lessons[unitId];if(!lesson)return ""; + function one(raw,label){ + var item=resolved(raw);if(!item)return ""; + if(item.type!=="clip")return ''+esc(label+": "+item.title)+''; + return '▶ '+esc(label+" clip "+time(item.startSec)+"–"+time(item.endSec))+'Full episode'; + } + return '
    '+one(lesson.primary,"Primary")+one(lesson.optional,"Optional")+ + 'Video details
    '; + } + + window.CCAFMediaUI={formatTime:time,resolve:resolved,cardHTML:card,lessonHTML:lessonHTML,inlineHTML:inlineHTML,esc:esc}; +})();